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

לטובת המשתמשים המתקדמים, ריכזנו רשימת פרמטרים לסגנונות של מודעות בחיפוש שהמערכת תומכת בהם כרגע. הקוד שיוצרים ב-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 ‎ // כאשר myQuery הוא משתנה JavaScript שמכיל את שאילתת החיפוש ‎
referrerAdCreative	נדרש (אם התנועה הושגה) אם משתמש מגיע לדף תוכן שלכם שמכיל "חיפוש קשור" ביחידת תוכן ממקור שבשליטתכם (כולל צדדים שלישיים כמו רשתות, שירותים או שותפים), אתם צריכים להגדיר את הפרמטר הזה בהתאם לטקסט הקריאייטיב של המקור, כמו שהוא מופיע. ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה: צריך לספק את הפרמטר רק בבקשה מסוג "חיפוש קשור לדפי תוכן". המערכת תתעלם ממנו בכל בקשה אחרת. צריך להשתמש בפרמטר הזה רק בתנועה שמופנית אליכם באופן מכוון מאתרים אחרים. הוא לא מיועד לשימוש בתנועה אורגנית. הפרמטר צריך לכלול את שורת הכותרת, את התיאור, את תמלול האודיו וכל מלל או אודיו שמופיעים בכל צורה בקריאייטיב של המקור. אם לא מציינים ערך מסוים שמופיע בקריאייטיב של המקור (או אם כוללים ערכים נוספים), זו נחשבת הפרה של ההנחיות הכתובות. הפרמטר לא תלוי-רישיות. הפרמטר מקבל ערכים עם קידוד UTF-8 תקין. יש תמיכה בתווי Unicode ובסימנים דיאקריטיים. ‫Google עשויה להשתמש בפרמטר שאתם שולחים או להתעלם ממנו. אם נעשה בו שימוש, הוא עשוי להשפיע על הבחירה והדירוג של המונחים. הערה: הפרמטר הזה נדרש כשמשתמשים בפרמטר terms. דוגמאות: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
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‎
resultsPageQueryParam	אופציונלי הפרמטר הזה מציין את שם הפרמטר של כתובת ה-URL שמשויך לשאילתת החיפוש בדף תוצאות החיפוש. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 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', אתם לא מייצרים הכנסה. הערות: אפשר להשתמש בפרמטר הזה במהלך בדיקות, אבל לא כדאי להשתמש בו במקרים אחרים כי לא תקבלו תשלום על המודעות שיוצגו. בקשות להצגת מודעה עם הערך 'on' בפרמטר adtest שמגיעות מאתר שלא אושר בדף אתרים, יחזירו מודעות עם שכבת העל "מודעת בדיקה" שאי אפשר ללחוץ עליהן. ערך ברירת המחדל של הפרמטר 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	יצא משימוש הערה: AdSense לחיפוש לא תומך יותר בהתאמה אישית של מודעות. מידע נוסף: AdSense לחיפוש ומוצרים אחרים שמיועדים להצגת מודעות לרשת החיפוש מתחילים להשתמש בשרתי פרסום חדשים, והתאמה אישית של מודעות יוצאת משימוש.

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

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

חובה

פרמטר	תיאור ודוגמאות
container	חובה המזהה של מאגר המודעות הריק <div id='afscontainer1'></div> שבו המודעה אמורה להופיע. דוגמה: ‎'container' : 'afscontainer1'‎

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

פרמטר	תיאור ודוגמאות
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 {          // most likely do nothing        } catch (e) {          alert ("Error in callback function");          // Do something to handle error gracefully        }     } else {        // as you always do when there is no ad coverage from Google     }   } };
maxTop	אופציונלי הפרמטר הזה מאפשר לציין את מספר המודעות שיוצגו ביחידת המודעות העליונה. הערה: הפרמטר הזה מחליף את הפרמטר number. יחידת המודעות צריכה להיות רחבה מספיק כדי למנוע גלישה של השורה הראשונה של המודעות. אם משתמשים בפרמטר maxTop בכל מיקום אחר בדף, זו הפרת מדיניות. דוגמה: ‎'maxTop' : 4‎
number	אופציונלי מספר המודעות שצריכות להופיע ביחידה הזו. ערך ברירת המחדל הוא '2'. דוגמה: ‎'number' : 4‎
relatedSearches	אופציונלי מספר החיפושים הקשורים שצריכים להופיע ביחידה הזו. הפרמטר הזה מחזיר לפחות 3 חיפושים קשורים, אלא אם הערך שהוגדר לו הוא אפס. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 0. דוגמה: ‎'relatedSearches' : 4‎
width	אופציונלי הפרמטר הזה מציין את הרוחב של יחידת המודעות או יחידת החיפוש הקשור, בפיקסלים. דוגמאות: ‎'width' : '700px'‎‏ ‎'width' : 700‎