עיון

פרמטרים

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

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

חובה

פרמטר תיאור ודוגמאות
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 is a variable containing the search query
resultsPageBaseUrl חובה כשיש יחידות של חיפוש קשור בדף.
מציין את כתובת ה-URL של דף תוצאות החיפוש שבו שאילתת החיפוש היא מונח החיפוש הקשור שהמשתמש לחץ עליו. resultPageBaseUrl עשוי לכלול פרמטרים משלו, מלבד שאילתת החיפוש שתצורף באופן אוטומטי.

לדוגמה: 

'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 עשויה להשתמש בפרמטר שאתם שולחים או להתעלם ממנו. אם נעשה בו שימוש, הוא עשוי להשפיע על הבחירה והדירוג של המונחים.

הערה: הפרמטר הזה הוא חובה כשמשתמשים בפרמטר terms.

לדוגמה: 

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam אופציונלי
הפרמטר הזה מציין את שם הפרמטר של כתובת האתר שמשויך לשאילתת החיפוש בדף תוצאות החיפוש. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 'q'.

לדוגמה: 

'resultsPageQueryParam' : 'query'
terms אופציונלי
הפרמטר הזה מאפשר להגדיר רשימה של מונחי חיפוש קשור משלכם שבקשות חיפוש קשור אמורות להחזיר. צריך להפריד בין המונחים ברשימה באמצעות פסיקים. חשוב לדעת ש-Google לא תמיד משתמשת במונחים מהרשימה הזו.

הערה: כשמשתמשים בפרמטר הזה, הערך referrerAdCreative הוא גם חובה.

לדוגמה: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams אופציונלי
הפרמטר הזה מציין את רשימת הפרמטרים של כתובת האתר של דף תוכן עם יחידת 'חיפוש קשור' לדפי תוכן. אפשר להתעלם ממנה בבטחה בלי להשפיע על התוכן העיקרי או על חוויית המשתמש.

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

ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:

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

דוגמאות:
משתמש נכנס לדף תוכן שבו כתובת ה-URL היא: 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
ציון הפרמטרים הבאים של כתובת אתר שניתן להתעלם מהם: 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
המערכת תתייחס לכתובת ה-URL של דף התוכן באופן הבא: 
http://example.com/content?page_id=123

הגדרות תצורה

פרמטר תיאור ודוגמאות
adsafe אופציונלי
הפרמטר הזה מציין את כללי הסינון ש-Google צריכה ליישם במודעות שתואמות לשאילתת החיפוש. בהמשך מוצגות ההגדרות החוקיות של הפרמטר adsafe וההשפעה של כל ערך על המודעות שמוחזרות:
  • 'high' מחזיר מודעות לכל המשפחה. הוא לא מחזיר מודעות שאינן לכל המשפחה או מודעות בעלות תוכן מיני למבוגרים בלבד.
  • 'medium' מחזיר מודעות לכל המשפחה ומודעות שאינן לכל המשפחה. הוא לא מחזיר מודעות בעלות תוכן מיני למבוגרים בלבד.
  • 'low' מחזירה את כל סוגי המודעות.

כברירת מחדל, הערך adsafe מוגדר לגבוה.

לדוגמה: 

'adsafe': 'medium'
adtest אופציונלי
הפרמטר adtest משמש כדי לציין שהבקשה להצגת מודעות היא בדיקה. כשהערך של הפרמטר adtest הוא on, Google מתייחסת לבקשה כבדיקה. היא לא סופרת את החשיפות של המודעה ולא עוקבת אחרי הקליקים.

כשהערך של הפרמטר adtest הוא on, אתם לא מייצרים הכנסה.

כדאי להשתמש בפרמטר הזה במהלך בדיקות, אבל לא כדאי להשתמש בו בסביבות ייצור מאחר שלא תקבלו תשלום על המודעות שיוצגו.

ערך ברירת המחדל של הפרמטר adtest כבוי.

לדוגמה: 

'adtest' : 'on'
channel אופציונלי
כדי לעקוב אחרי הביצועים של דפים שונים, אפשר לכלול ערוץ של AdSense לחיפוש. צריך לציין את מזהה הערוץ הייחודי שנוצר בחשבון AdSense או על ידי מנהל החשבונות הטכני. מידע נוסף על ערוצים זמין כאן.

אם יש כמה ערוצים, צריך להפריד ביניהם באמצעות הסמל '+'.

דוגמאות: 

'channel' :  'testA'  
'channel' :  'testA+testB'

hl אופציונלי
הפרמטר הזה משמש לצורך זיהוי השפה שהמודעות המבוקשות או החיפושים הקשורים צריכות לטרגט. ערך ברירת המחדל הוא en.

Google תומכת בכל קודי השפות של AdWords 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 האזור הבלטי (אסטונית, לטבית, ליטאית)
קירילי ISO-8859-5 בולגרית, רוסית
arabic ISO-8859-6  
יווני ISO-8859-7 יוונית
hebrew ISO-8859-8 עברית
latin5 ISO-8859-9  
latin6 ISO-8859-10 איסלנדית
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 האזור הבלטי (אסטונית, לטבית, ליטאית)
קירילי ISO-8859-5 בולגרית, רוסית
arabic ISO-8859-6  
יווני ISO-8859-7 יוונית
hebrew ISO-8859-8 עברית
latin5 ISO-8859-9  
latin6 ISO-8859-10 איסלנדית
euc-jp האיחוד האירופי-יפן יפנית
Euc-kr (הולנד) האיחוד האירופי (EUC-KR) קוריאנית
Sjis Shift_JIS יפנית
gb GB2312 סינית פשוטה
utf-8 UTF-8 הכול
ivt אופציונלי
הפרמטר הזה מאפשר לכם להוסיף ערך בוליאני כדי ליידע את Google שאתם רוצים לאפשר ל-Google להציג מודעות שמשתמשות בקובץ Cookie לזיהוי תנועה לא חוקית בלבד ובאחסון מקומי, גם בתנועה של משתמשים שהביעו הסכמה וגם בתנועה של משתמשים שלא הביעו הסכמה.
  • true אם הפרמטר הזה לא נמצא או אם הערך שהוגדר לו הוא 'true', נגדיר קובץ cookie לתנועה לא חוקית בלבד ונשתמש באחסון מקומי רק בתנועה שהתקבלה בהסכמה.
  • false אם תגדירו את הפרמטר הזה ל-False, נגדיר קובץ cookie לתנועה לא חוקית בלבד ונשתמש באחסון מקומי גם בתנועה של משתמשים שהביעו הסכמה וגם בתנועה של משתמשים שלא הביעו הסכמה.

כברירת מחדל, הערך IVT מוגדר כ-True.

לדוגמה: 

'ivt': false

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

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

חובה

פרמטר תיאור ודוגמאות
container חובה
המזהה של מאגר המודעות הריק <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: בבלוק של חיפוש קשור, מכיל מפה<string,int> של בעל התוכן הדיגיטלי שהמונחים שסופקו באינדקס, למיקום אפס באינדקס של המונחים האלה בתגובה. אם הוזן מונח אבל לא הוחזר, הוא לא יופיע במפה.

הערה: צריך לבדוק את פונקציית הקריאה החוזרת כדי לוודא שהיא לא יוצרת שגיאות, במיוחד שגיאות שעלולות להפריע לטעינת הדף.

דוגמה לקריאה חוזרת (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
    }
  }
};

number אופציונלי
מספר המודעות שצריכות להופיע ביחידה הזו. ערך ברירת המחדל הוא 2.

לדוגמה: 

'number' : 4
relatedSearches אופציונלי
מספר החיפושים הקשורים שצריכים להופיע ביחידה הזו. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 0.

לדוגמה: 

'relatedSearches' : 4