חומרי עזר

הפרמטר 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' משתמשים באפשרות הזו רק לחיפוש קשור בדפי תוצאות חיפוש.

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

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

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

דוגמאות:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

דוגמה:

'styleId': '1234567890'

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

דוגמה:

'linkTarget' : '_blank'

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

• צריך לספק את הפרמטר רק בבקשה מסוג "חיפוש קשור לדפי תוכן". המערכת תתעלם ממנו בכל בקשה אחרת.
• צריך להשתמש בפרמטר הזה רק בתנועה שמופנית אליכם באופן מכוון מאתרים אחרים. אסור להשתמש בו בתנועה אורגנית.
• הפרמטר צריך לכלול את שורת הכותרת, התיאור או כל ניסוח אחר בקריאייטיב של המודעה או הקישור.
• השמטת ערכים מנכס הקריאייטיב של המודעה או הקישור (או הוספת ערכים) נחשבת להפרה של ההוראות הכתובות האלה.
• הפרמטר לא תלוי-רישיות.
• הפרמטר מקבל ערכים עם קידוד 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 שסופקו.

דוגמאות:
משתמש נכנס לדף תוכן וכתובת ה-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 הוא high.

דוגמה:

'adsafe': 'medium'

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

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

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

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

דוגמה:

'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