יצירת דף חיפוש בהתאמה אישית

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge

כדי לאפשר חיפוש של התוכן שזמין לציבור בפורטל, אפשר ליצור דף חיפוש ייעודי ולהטמיע בו מנוע חיפוש מותאם אישית (CSE) של Google.

לפני שמטמיעים מנוע חיפוש בהתאמה אישית של Google, חשוב לשים לב לנקודות הבאות:

• חיפוש באמצעות מנוע חיפוש בהתאמה אישית של Google יכול להחזיר רק תוצאות של תוכן שזמין לציבור. כלומר, משתמש בפורטל לא צריך להיכנס לפורטל כדי לצפות בתוכן.
• בשלב הזה, אי אפשר להשבית את המודעות בתוצאות החיפוש, אלא אם יש לכם אתר שאושר כאתר של עמותה.
• חיפוש מותאם אישית של Google לא נכלל ברישיון Apigee. (אנחנו מתכננים להוסיף פתרון חיפוש מוכן לשימוש בפורטל המשולב בגרסה עתידית).
• Google Search Console (שגם הוא לא כלול ברישיון Apigee) הוא כלי נוסף שאפשר להשתמש בו כדי להסיר את הפורטל שלכם מאינדקס החיפוש של Google או לנהל את הנוכחות שלו שם.

כדי ליצור דף חיפוש בהתאמה אישית:

1. פרסום התוכן בפורטל.

2. כדי ליצור מנוע חיפוש מותאם אישית של Google:

   1. עוברים לדף ההגדרה של חיפוש מותאם אישית של Google.
   2. לוחצים על הוספה כדי ליצור מנוע חיפוש מותאם אישית חדש.
   3. מגדירים את מנוע החיפוש המותאם אישית ומזהים את הדומיין של אתר הפורטל. אפשר לעיין במאמר יצירת מנוע חיפוש במרכז העזרה של Google Custom Search. התצורה של החיפוש המותאם אישית מחזירה משהו כמו הדוגמה הבאה:
      ‫

      <script async src="https://cse.google.com/cse.js?cx=e13bcb52d46f04dfd"></script>
      <div class="gcse-search"></div>

      כאשר cx=e13bcb52d46f04dfd הוא המזהה של מנוע החיפוש של Google.
   טיפ: כדי לזרז את הוספת האתר לאינדקס, אפשר לאמת את האתר ולשלוח אותו באמצעות Google Search Console. אפשר לעיין במאמר אימות האתר ב-Search Console במרכז העזרה של Google Search Console.

3. מוסיפים את הסקריפט המותאם אישית הבא לפורטל. איך מוסיפים סקריפטים בהתאמה אישית

   מגדירים את המשתנה cx למזהה מנוע החיפוש שלכם ב-Google, לדוגמה e13bcb52d46f04dfd, ואת הערך path לכתובת ה-URL של דף החיפוש, לדוגמה /search.

   <script>
   window.portal = {
    pageEventListeners: {
      onLoad: (path) => {
        // Update with your search page URL
        if (path === '/your-search-page-URL') {
          // Add your Google search engine ID
          var cx = 'your-search-engine-id';
          var gcse = document.createElement('script');
          gcse.type = 'text/javascript';
          gcse.async = true;
          gcse.src = 'https://cse.google.com/cse.js?cx=' + cx;
          var s = document.getElementsByTagName('script')[0];
          s.parentNode.insertBefore(gcse, s);
          gcse.onload = function () {
            var search = document.createElement('gcse:search');
            // Note the element ID name
            var searchBox = document.getElementById('search-box');
            searchBox.appendChild(search);
          };
        }
      }
    }
   };
   </script>
   

4. יוצרים דף חיפוש חדש בפורטל ומתאימים אותו אישית כמו שמתואר במאמר ניהול דפים בפורטל.

5. מוסיפים את מזהה רכיב החיפוש המותאם אישית (search-box) שהוגדר בסקריפט המותאם אישית במיקום שבו רוצים שתיבת החיפוש של Google תופיע. לדוגמה <div id="search-box"></div>

6. מוסיפים את דף החיפוש לניווט בפורטל, כמו שמתואר במאמר בנושא הגדרת ניווט.

7. מפרסמים את דף החיפוש ואת עדכוני הניווט.

יכול להיות שיעבור זמן עד ש-Google תוסיף את האתר שלכם לאינדקס, ולכן יכול להיות שלא תראו תוצאות חיפוש מיד. (תהליך ההוספה המלאה לאינדקס יכול להימשך בין כמה ימים לחודש). מומלץ להשהות את פרסום דף החיפוש עד שתבדקו את החיפוש באתר הפורטל (לאורך זמן) ותהיו מרוצים מהתוצאות שמוחזרות.