עיון

פרמטרים

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

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

חובה

פרמטר תיאור ודוגמאות
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 של דף תוצאות החיפוש שבו שאילתת החיפוש היא מונח החיפוש הקשור שהמשתמש לחץ עליו. הפרמטר resultsPageBaseUrl עשוי לכלול פרמטרים משלו, מלבד שאילתת החיפוש שתצורף באופן אוטומטי.

דוגמה: 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting חובה כשיש יחידות של חיפוש קשור בדף.
חובה לכלול את הפרמטר הזה כשמבקשים יחידות של חיפוש קשור. הוא קובע איזה סוג של חוויית חיפוש קשור יוצג, בהתאם להקשר של הדף:
  • 'content' משתמשים באפשרות הזו לחיפוש קשור בדפי תוכן (למשל, מאמרים, פוסטים בבלוג).
  • 'query' השתמשו באפשרות הזו בלבד לחיפוש קשור בדפי תוצאות החיפוש.

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

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

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

דוגמאות:

'relatedSearchTargeting' : 'content'
 
'relatedSearchTargeting' : 'query'
styleId חובה
הפרמטרים האלה מציינים את המזהה של סגנון החיפוש המותאם אישית שיש להחיל על המודעה או על היחידות של החיפוש הקשור בדף. מידע נוסף על שימוש בסגנונות מותאמים אישית של המודעות בחיפוש הערה: אם הפרמטר styleId מוגדר במסגרת בקשה מסוימת, מודעות או חיפושים קשורים יוצגו עם הסגנון והמערכת תתעלם מפרמטרים קודמים של סגנון. אם הפרמטר styleId לא יצוין בבקשה, יוצג סגנון ברירת המחדל של המערכת.

דוגמה: 

'styleId': '1234567890'

אופציונלי

פרמטר תיאור ודוגמאות
linkTarget אופציונלי
הפרמטר הזה מציין אם לחיצה על מודעה פותחת אותה באותו חלון או בחלון חדש. ערך ברירת המחדל הוא ‎ '_top'‎. אפשר להשתמש בפרמטר הזה גם ברמת היחידה.
  • '_top' נפתח באותו חלון.
  • '_blank' הקישור ייפתח בחלון חדש.

דוגמה: 

'linkTarget' : '_blank'
referrerAdCreative אופציונלי
אם משתמש מגיע לדף התוכן שלכם שכולל יחידה של 'חיפוש קשור' לדפי תוכן אחרי שהוא לוחץ על מודעה או על קישור שנמצאים בשליטתכם באתר אחר, הערך של הפרמטר צריך להיות זהה לטקסט הקריאייטיב במודעה או בקישור.

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

  • צריך לספק את הפרמטר רק בבקשה מסוג 'חיפוש קשור' לדפי תוכן. המערכת תתעלם ממנו בכל בקשה אחרת.
  • צריך להשתמש בפרמטר הזה רק בתנועה שמופנית אליכם באופן מכוון מאתרים אחרים, ולא בתנועה אורגנית.
  • הוא צריך לכלול את שורת הכותרת, את התיאור ו/או כל ניסוח אחר בקריאייטיב של המודעה או הקישור.
  • השמטת ערכים מהקריאייטיב של המודעה או הקישור (או הוספת ערכים נוספים) נחשבת להפרה של ההוראות הכתוביות האלה.
  • הפרמטר לא תלוי-רישיות.
  • הפרמטר מקבל ערכים עם קידוד UTF-8 תקין. יש תמיכה בתווי Unicode ובסימנים דיאקריטיים.
  • ‫Google עשויה להשתמש בפרמטר שאתם שולחים או להתעלם ממנו. אם נעשה בו שימוש, הוא עשוי להשפיע על הבחירה והדירוג של המונחים.

הערה: הפרמטר הזה נדרש כשמשתמשים בפרמטר terms.

דוגמאות: 

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

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

דוגמה: 

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

הערה: כשמשתמשים בפרמטר הזה, צריך גם להגדיר את referrerAdCreative כ-חובה, וגם את relatedSearchTargeting כחובה, ולהגדיר אותו כ-'content'.

דוגמאות: 

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

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

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

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

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

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

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

הגדרות תצורה

פרמטר תיאור ודוגמאות
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 תומכת בכל קודי השפות של 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 האזור הבלטי (אסטונית, לטבית, ליטאית)
cyrillic 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-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  
יוונית 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 הכול
ivt אופציונלי
האפשרות הזו מאפשרת לכם לספק ערך בוליאני שמציין ל-Google שאתם רוצים לאפשר מודעות שמשתמשות באחסון מקומי ובקובצי Cookie לזיהוי תנועה לא חוקית בלבד, ולהציג אותן גם למשתמשים שהביעו הסכמה לשימוש בקובצי Cookie וגם למשתמשים שלא הביעו הסכמה.
  • true אם הפרמטר הזה לא קיים או שהגדרתם אותו כ-true, נגדיר קובץ cookie לזיהוי תנועה לא חוקית בלבד ונשתמש באחסון מקומי רק בתנועה שהבעלים הביעו לגביה הסכמה.
  • false כשמגדירים את הפרמטר הזה כ-'false', אנחנו מגדירים קובץ cookie לזיהוי תנועה לא חוקית בלבד ומשתמשים באחסון מקומי גם בתנועה שהמשתמשים הביעו לגביה הסכמה וגם בתנועה שהמשתמשים לא הביעו לגביה הסכמה.

ברירת המחדל של IVT היא true.

דוגמה: 

'ivt': false

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

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

חובה

פרמטר תיאור ודוגמאות
container חובה
ה-id של מאגר המודעות הריק <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 {
         // 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