עיון

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

לדוגמה:

'pubId' : 'test-property'

הערה: שימוש בפרמטר הזה ב'חיפוש קשור' בדפי תוכן יגרום לתוצאות בלתי צפויות.

דוגמאות:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

לדוגמה:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

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

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

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

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

דוגמאות:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

לדוגמה:

'styleId': '1234567890'

• '_top': פתיחה באותו חלון.
• '_blank': פתיחה בחלון חדש.

לדוגמה:

'linkTarget' : '_blank'

לדוגמה:

'maxTermLength' : 50

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

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

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

דוגמאות:

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

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'

לדוגמה:

'resultsPageQueryParam' : 'query'

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

דוגמאות:

'terms' : 'cars rental, flight ticket'

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

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

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

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

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

http://example.com/content?utm_medium=social&page_id=123&click_id=456

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• 'high' מחזיר מודעות לכל המשפחה. הוא לא מחזיר מודעות שאינן לכל המשפחה או מודעות בעלות תוכן מיני למבוגרים בלבד.
• 'medium' מחזיר מודעות לכל המשפחה ומודעות שאינן לכל המשפחה. הוא לא מחזיר מודעות בעלות תוכן מיני למבוגרים בלבד.
• 'low' מחזיר את כל סוגי המודעות.

כברירת מחדל, רמת הבטיחות של המודעה (adsafe) מוגדרת ל'גבוהה'.

לדוגמה:

'adsafe': 'medium'

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

בקשות להצגת מודעות שבהן הפרמטר adtest מוגדר כ-on (מופעל) שמגיע מדומיין שלא אושר בכרטיסייה 'אתרים' יחזיר מודעות עם שכבת-על של 'מודעת בדיקה' ואי אפשר יהיה ללחוץ עליהן.

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

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

לדוגמה:

'adtest' : 'on'

דוגמאות:

'channel' :  'testA'  

'channel' :  'testA+testB'  

Google תומכת בכל קודי השפות של AdWords API.

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

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

דוגמאות:

'hl' : 'es'

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

ערך ברירת המחדל של ie הוא utf-8.

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

ערך ברירת המחדל של oe הוא utf-8.

• true אם הפרמטר לא קיים או אם הערך שלו מוגדר כ-'true', אנחנו נגדיר קובץ Cookie לזיהוי תנועה לא חוקית בלבד ונשתמש באחסון מקומי עבור תנועה שהביעו הסכמה בלבד.
• false אם הערך של הפרמטר הזה הוא 'false', אנחנו נגדיר קובץ Cookie לזיהוי תנועה לא חוקית בלבד ונשתמש באחסון מקומי גם בתנועה של משתמשים שהביעו הסכמה וגם בקרב תנועת משתמשים שלא הביעו הסכמה.

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

לדוגמה:

'ivt': false

לדוגמה:

'container' : 'afscontainer1'

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

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

דוגמה:

'maxTop' : 4

לדוגמה:

'width' : '700px'

'width' : 700

פונקציית הקריאה החוזרת משתמשת בפרמטרים הבאים:

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

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

לדוגמה:

'relatedSearches' : 4