תיאורי פרמטרים של מודעות לרשת החיפוש בהתאמה אישית

לטובת המשתמשים המתקדמים, ריכזנו רשימת פרמטרים לסגנונות של מודעות בחיפוש שהמערכת תומכת בהם כרגע. הקוד שיוצרים ב-AdSense מכיל את כל ההגדרות הנפוצות ביותר של הפרמטרים. יש שני פרמטרים שחובה להשתמש בהם: pubId ו-query. מערכת AdSense מספקת את הפרמטר pubId, אבל המשתמשים צריכים לערוך את הקוד ולקבוע ערך (pass) לפרמטר query. כל יתר הפרמטרים הם אופציונליים ומתוארים בהמשך.

סוגי פרמטרים

קיימים 2 סוגי פרמטרים:

• פרמטרים ברמת הדף שמיושמים בכל היחידות של המודעות בדף
• פרמטרים ברמת היחידה שמיושמים ביחידות מסוימות של מודעות

זו דוגמה לפלט ממחולל הקוד שכולל 2 בלוקים של מודעות. כדי להגדיר את הקוד, צריך להגדיר את פרמטר החובה query במפה pageOptions (לדוגמה, ‏‎“query”: myQuery‎). זה כל מה שצריך לעשות כדי להתחיל להציג מודעות. ניתן גם לבחור פרמטרים אופציונליים ברמת הדף ולהגדיר אותם בבלוק ברמת הדף. באותו אופן, ניתן לבחור פרמטרים ברמת היחידה הבודדת ולהגדיר אותם במפות adblock1 ו-adblock2.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // פרמטרים ברמת הדף
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // פרמטרים ברמת היחידה
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

תיאורים של פרמטרים ברמת הדף

את הפרמטרים האלה צריך לציין רק פעם אחת בכל דף. הם משפיעים על כל היחידות בדף.

חובה

פרמטר	תיאור ודוגמאות
adPage	חובה כשהמשתמש מנווט לדף התוצאות הבא או לדף התוצאות הקודם הפרמטר adPage מציין את דף התוצאות שהמודעות מוצגות בו. משתמשים בפרמטר הזה כשהמשתמשים ממשיכים לנווט מעבר לדף הראשון של תוצאות החיפוש. למשל, אם מבקשים להציג 5 מודעות ובפרמטר adPage מוגדר הערך '2', המודעות שמוחזרות יוצגו בדף השני של תוצאות החיפוש.
pubId	חובה זהו ה-Client ID שלכם ב-AdSense. הפרמטר pubId הוא החלק מתוך ה-Client ID שמופיע אחרי המילה partner. לדוגמה, אם ה-Client ID שלכם הוא partner-test-property, הערך של הפרמטר pubId הוא test-property. זה הפרוטוקול הסטנדרטי במודעות חיפוש בהתאמה אישית. דוגמה: ‎ 'pubId' : 'test-property' ‎
query	חובה זו שאילתת החיפוש שהמשתמשים מזינים. הערך של הפרמטר query צריך להיות לא מקודד. דוגמאות: ‎'query' : 'flowers'‎ ‎'query' : 'black & decker'‎ ‎'query' : myQuery // where myQuery is a JavaScript variable containing the search query ‎
resultsPageBaseUrl	חובה כשיש יחידות של חיפוש קשור בדף הפרמטר הזה מציין את כתובת ה-URL של דף תוצאות החיפוש שבו שאילתת החיפוש היא מונח החיפוש הקשור שהמשתמש לחץ עליו. הפרמטר resultsPageBaseUrl עשוי לכלול פרמטרים משלו, מלבד שאילתת החיפוש שתצורף באופן אוטומטי. דוגמה: ‎'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'‎
styleId	חובה הפרמטר הזה מציין את מזהה הסגנון של המודעות בחיפוש שצריך להחיל על יחידות המודעות או על היחידות של החיפוש הקשור בדף. מידע נוסף על שימוש בסגנונות חיפוש הערה: אם הפרמטר styleId מוגדר במסגרת בקשה מסוימת, מודעות או חיפושים קשורים יוצגו עם הסגנון והמערכת תתעלם מפרמטרים קודמים של סגנון. אם הפרמטר styleId לא יצוין בבקשה, יוצג סגנון ברירת המחדל של המערכת. דוגמה ‎'styleId': '1234567890'‎

אופציונלי

פרמטר	תיאור ודוגמאות
linkTarget	אופציונלי הפרמטר הזה מציין אם לחיצה על מודעה גורמת לפתיחה באותו חלון או בחלון חדש. ערך ברירת המחדל הוא ‎'_top'‎. אפשר להשתמש בפרמטר הזה גם ברמת היחידה. ‎'_top'‎: פתיחה באותו חלון. ‎'_blank'‎: פתיחה בחלון חדש. דוגמה: ‎'linkTarget' : '_blank'‎
maxTermLength	אופציונלי הפרמטר הזה מציין את מספר התווים המקסימלי של מונח חיפוש קשור, כולל רווחים. אם הפרמטר לא מוגדר, אין מספר מקסימלי של תווים. דוגמה: ‎'maxTermLength' : 50‎
referrerAdCreative	אופציונלי אם יש לכם דף תוכן שמכיל יחידת 'חיפוש קשור' לדפי תוכן ומשתמש מגיע לדף הזה אחרי לחיצה על מודעה או קישור שנמצאים בשליטתכם באתר אחר, הערך של הפרמטר צריך להיות העתק מדויק של טקסט הקריאייטיב במודעה או בקישור. ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה: יש לספק את הפרמטר רק בבקשת 'חיפוש קשור' לדפי תוכן. המערכת תתעלם ממנו בכל בקשה אחרת. צריך להשתמש בפרמטר הזה רק בתנועה שמופנית אליכם באופן מכוון מאתרים אחרים. אסור להשתמש בו בתנועה אורגנית. הפרמטר יכול להכיל את שורת הכותרת מהקריאייטיב של המודעה או הקישור, את התיאור מהקריאייטיב או את שניהם. הפרמטר לא תלוי רישיות. הפרמטר מקבל ערכים עם קידוד UTF-8 תקין. יש תמיכה בתווי Unicode ובסימנים דיאקריטיים. Google עשויה להשתמש בפרמטר שאתם שולחים או להתעלם ממנו. אם נעשה בו שימוש, הוא עשוי להשפיע על הבחירה והדירוג של המונחים. דוגמאות: ‎'referrerAdCreative': 'search for ads related to dental implants'‎‏ ‎'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'‎
resultsPageQueryParam	אופציונלי הפרמטר הזה מציין את שם הפרמטר של כתובת האתר שמשויך לשאילתת החיפוש בדף תוצאות החיפוש. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 'q'. דוגמה: ‎'resultsPageQueryParam' : 'query'‎
terms	אופציונלי הפרמטר הזה מאפשר לכם להגדיר רשימה של מונחי חיפוש קשור משלכם שבקשות חיפוש קשור אמורות להחזיר. צריך להפריד בין המונחים ברשימה באמצעות פסיקים. חשוב לדעת ש-Google לא תמיד משתמשת במונחים מהרשימה הזו. דוגמה: ‎'terms' : 'cars rental, flight ticket'‎

הגדרות אישיות

פרמטר	תיאור ודוגמאות
adsafe	אופציונלי הפרמטר הזה מציין את כללי הסינון ש-Google צריכה ליישם במודעות שתואמות לשאילתת החיפוש. בהמשך מוצגות ההגדרות החוקיות של הפרמטר adsafe וההשפעה של כל ערך על המודעות שמוחזרות: 'high': מוחזרות מודעות לכל המשפחה. הוא לא מחזיר מודעות שאינן לכל המשפחה או מודעות בעלות תוכן מיני למבוגרים בלבד. 'medium' מחזיר מודעות לכל המשפחה ומודעות שאינן לכל המשפחה. הוא לא מחזיר מודעות בעלות תוכן מיני למבוגרים בלבד. 'low': מוחזרות מודעות מכל הסוגים. הערה: ערך ברירת המחדל של הפרמטר adsafe הוא 'high'. דוגמה: ‎ 'adsafe': 'medium' ‎
adtest	אופציונלי הפרמטר adtest מציין שבקשה מסוימת להצגת מודעות היא בקשת בדיקה. כשהערך של הפרמטר adtest הוא 'on', ‏Google מתייחסת לבקשה בתור בדיקה, לא סופרת את החשיפות של המודעה ולא עוקבת אחרי הקליקים. כשהערך של הפרמטר adtest הוא 'on' אתם לא מייצרים הכנסה. הערה: אפשר להשתמש בפרמטר הזה במהלך בדיקות, אבל לא כדאי להשתמש בו בסביבות ייצור מאחר שלא תקבלו תשלום על המודעות שיוצגו. ערך ברירת המחדל של הפרמטר adtest הוא 'off'. דוגמה: ‎ 'adtest' : 'on' ‎
channel	אופציונלי כדי לעקוב אחרי הביצועים של דפים שונים, אפשר לכלול ערוץ של AdSense לחיפוש. יש להזין את מזהה הערוץ הייחודי שיצרתם בחשבון AdSense. מידע נוסף על מעקב אחרי ביצועי מודעות באמצעות ערוצים מותאמים אישית. אם יש כמה ערוצים, צריך להפריד ביניהם באמצעות הסמל '+'.   דוגמאות: ‎ 'channel' : 'testA' ‎‏ ‎'channel' : 'testA+testB' ‎
hl	אופציונלי הפרמטר הזה משמש לצורך זיהוי השפה שהמודעות המבוקשות צריכות לטרגט. ערך ברירת המחדל הוא en. Google תומכת בכל קודי השפות של Google Ads API. הערה: מפרסמים מציינים את השפות שהמודעות שלהם מטרגטות. אם מציינים את הפרמטר הזה בבקשה, Google מחזירה רק מודעות שמטרגטות את השפה הזאת או מודעות שמטרגטות את כל השפות, אבל הטקסט של המודעות לא בהכרח יהיה בשפה שצוינה. בדרך כלל מומלץ להגדיר את הפרמטר hl לשפה הראשית של הדף שממנו הוא נשלח. דוגמאות: ‎ 'hl' : 'es' ‎
ie	אופציונלי הפרמטר ie מגדיר את סכמת קידוד התווים שבאמצעותה תפורש מחרוזת השאילתה. ערך ברירת המחדל בפרמטר ie הוא 'utf-8'. ערך שם סטנדרטי שפות נתמכות משויכות latin1 ISO-8859-1 מערב אירופה (קטלנית, דנית, הולנדית, אנגלית, פינית, צרפתית, גרמנית, אינדונזית, איטלקית, נורווגית, פורטוגזית, ספרדית, שוודית) latin2 ISO-8859-2 מזרח אירופה (הונגרית, סרבית, סלובקית, סלובנית, פולנית צ'כית, קרואטית, רומנית) latin3 ISO-8859-3   latin4 ISO-8859-4 האזור הבלטי (אסטונית, לטבית, ליטאית) cyrillic ISO-8859-5 בולגרית, רוסית arabic ISO-8859-6   greek ISO-8859-7 יוונית hebrew ISO-8859-8 עברית latin5 ISO-8859-9   latin6 ISO-8859-10 איסלנדית euc-jp EUC-JP יפנית euc-kr EUC-KR קוריאנית sjis Shift_JIS יפנית big5 Big5 סינית מסורתית gb GB2312 סינית מפושטת utf-8 UTF-8 כל השפות
oe	אופציונלי הפרמטר oe מגדיר את סכמת קידוד התווים שבאמצעותה Google תקודד את הטקסט של המודעות. זה אמנם פרמטר אופציונלי, אבל מומלץ לציין בו ערך. ערך ברירת המחדל של הפרמטר oe הוא 'utf-8'. ערך שם סטנדרטי שפות נתמכות משויכות latin1 ISO-8859-1 מערב אירופה (קטלנית, דנית, הולנדית, אנגלית, פינית, צרפתית, גרמנית, אינדונזית, איטלקית, נורווגית, פורטוגזית, ספרדית, שוודית) latin2 ISO-8859-2 מזרח אירופה (הונגרית, סרבית, סלובקית, סלובנית, פולנית צ'כית, קרואטית, רומנית) latin3 ISO-8859-3   latin4 ISO-8859-4 האזור הבלטי (אסטונית, לטבית, ליטאית) cyrillic ISO-8859-5 בולגרית, רוסית arabic ISO-8859-6   greek ISO-8859-7 יוונית hebrew ISO-8859-8 עברית latin5 ISO-8859-9   latin6 ISO-8859-10 איסלנדית euc-jp EUC-JP יפנית euc-kr EUC-KR קוריאנית sjis Shift_JIS יפנית gb GB2312 סינית מפושטת utf-8 UTF-8 כל השפות
personalizedAds	אופציונלי הפרמטר מציין אם המשתמשים הסכימו לאפשר לבעל התוכן הדיגיטלי לשתף מידע אישי עם Google למטרות פרסום מותאם אישית. true: מוחזרות מודעות שמטרגטות שאילתות. בנוסף, מוחזרות מודעות מסוימות שהטרגוט שלהן עשוי להיות מבוסס על קובצי ה-Cookie של Google שמשויכים למשתמש. אם המשתמש נמצא באיחוד האירופי, עליו להסכים תחילה לאפשר לאתר לשתף מידע אישי עם Google כדי לאפשר פרסום מותאם אישית. הפרמטר false מחזיר רק מודעות הממוקדות לשאילתות. הוא לא מחזיר מודעות שממוקדות באמצעות קובצי ה-Cookie של Google המשויכים למשתמש. אם המשתמש לא הסכים לאפשר לאתר שלכם לשתף מידע אישי עם Google למטרות פרסום מותאם אישית, הערך של הפרמטר חייב להיות false. הערה: ערך ברירת המחדל של הפרמטר personalizedAds הוא 'true'. דוגמה: ‎ 'personalizedAds': false ‎

תיאורים של פרמטרים ברמת היחידה

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

חובה

פרמטר	תיאור ודוגמאות
container	חובה המזהה של מאגר המודעות הריק <div id='afscontainer1'></div> שבו המודעה אמורה להופיע. דוגמה: ‎'container' : 'afscontainer1'‎
maxTop	חובה הפרמטר הזה מאפשר לציין את מספר המודעות שיוצגו ביחידת המודעות העליונה. הערה: הפרמטר הזה מחליף את הפרמטר number. יחידת המודעות צריכה להיות רחבה מספיק כדי למנוע גלישה של השורה הראשונה של המודעות. אם משתמשים בפרמטר maxTop בכל מיקום אחר בדף, זו הפרת מדיניות. דוגמה: ‎'maxTop' : 4‎
width	חובה הפרמטר הזה מציין את הרוחב של יחידת המודעות או יחידת החיפוש הקשור, בפיקסלים. דוגמאות: ‎'width' : '700px'‎‏ ‎'width' : 700‎

הגדרות אישיות

פרמטר	תיאור ודוגמאות
adLoadedCallback	אופציונלי הפרמטר הזה מגדיר פונקציית JavaScript שצריכה להיות מופעלת כשהמודעות או החיפושים הקשורים נטענים או כשלא מוצגות מודעות או חיפושים קשורים. הערך של הפרמטר צריך להיות פונקציית קריאה חוזרת של JavaScript שאתם מטמיעים לצורך ביצוע פעולה מסוימת אחרי השלמת הטיפול בבקשה להצגת מודעה. פונקציית הקריאה החוזרת מקבלת את הפרמטרים הבאים: containerName שם המאגר של יחידת המודעות או יחידת החיפוש הקשור. adsLoaded הערך של הפרמטר הזה צריך להיות true אם יש לפחות מודעה אחת או מונח אחד של חיפוש קשור שמיועדים להצגה. הערך צריך להיות false אם לא מוחזרים חיפושים קשורים או מודעות. isExperimentVariant הערך של הפרמטר הזה צריך להיות true אם מופעל ניסוי של סגנונות מותאמים אישית והווריאציה מהניסוי נבחרת לצורך הצגת המודעות. callbackOptions אובייקט JSON שמכיל את השדות הבאים: termPositions: השדה הזה מתייחס לקבוצת מונחים של חיפוש קשור. הוא מכיל מפת ‎map<string,int>‎ שמאפשרת להתאים בין רשימה של מונחים שסיפק בעל התוכן הדיגיטלי לבין המונחים ש-Google הציגה בפועל. המספר שמוצג הוא המקום הראשון ברשימת המונחים שהוצגו בפועל (החל ממקום אפס) שבו הופיע אחד מהמונחים של בעל התוכן הדיגיטלי. אם מונח מסוים יצוין אך לא יוחזר, הוא לא יופיע במפה. הערה: צריך לבדוק את פונקציית הקריאה החוזרת כדי לוודא שהיא לא יוצרת שגיאות, במיוחד שגיאות שעלולות להפריע לטעינת הדף. דוגמה לקריאה חוזרת (callback) של JavaScript: var adblock1 = {   'container' : 'adblock1_div_id',   'adLoadedCallback' : function(containerName, adsLoaded,     isExperimentVariant, callbackOptions) {     if (adsLoaded) {        try {          // ככל הנראה לא צריך לעשות דבר        } catch (e) {          alert ("Error in callback function");          // צריך לעשות משהו כדי לטפל בשגיאה באלגנטיות        }     } else {        // מה שתמיד עושים כשאין כיסוי של מודעות מ-Google     }   } };
number	אופציונלי מספר המודעות שצריכות להופיע ביחידה הזו. ערך ברירת המחדל הוא '2'. דוגמה: ‎'number' : 4‎
relatedSearches	אופציונלי מספר החיפושים הקשורים שצריכים להופיע ביחידה הזו. הפרמטר הזה מחזיר לפחות 3 חיפושים קשורים, אלא אם הערך שהוגדר לו הוא אפס. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 0. דוגמה: ‎'relatedSearches' : 4‎