לטובת המשתמשים המתקדמים, ריכזנו רשימת פרמטרים לסגנונות של מודעות בחיפוש שהמערכת תומכת בהם כרגע. הקוד שיוצרים ב-AdSense מכיל את כל ההגדרות הנפוצות ביותר של הפרמטרים. יש שני פרמטרים שחובה להשתמש בהם: pubId
ו-query
. מערכת AdSense מספקת את הפרמטר pubId, אבל המשתמשים צריכים לערוך את הקוד ולקבוע ערך (pass) לפרמטר query
. כל יתר הפרמטרים הם אופציונליים ומתוארים בהמשך.
סוגי פרמטרים
קיימים 2 סוגי פרמטרים:
- פרמטרים ברמת הדף שמיושמים בכל היחידות של המודעות בדף
- פרמטרים ברמת היחידה שמיושמים ביחידות מסוימות של מודעות
זו דוגמה לפלט ממחולל הקוד שכולל 2 בלוקים של מודעות. כדי להגדיר את הקוד, צריך להגדיר את פרמטר החובה query
במפה pageOptions
(לדוגמה, “query”: myQuery
). זה כל מה שצריך לעשות כדי להתחיל להציג מודעות. ניתן גם לבחור פרמטרים אופציונליים ברמת הדף ולהגדיר אותם בבלוק ברמת הדף. באותו אופן, ניתן לבחור פרמטרים ברמת היחידה הבודדת ולהגדיר אותם במפות adblock1
ו-adblock2
.
<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 |
חובה כשהמשתמש מנווט לדף התוצאות הבא או לדף התוצאות הקודם
הפרמטר |
pubId |
חובה זהו ה-Client ID שלכם ב-AdSense. הפרמטר pubId הוא החלק מתוך ה-Client ID שמופיע אחרי המילה partner. לדוגמה, אם ה-Client ID שלכם הוא partner-test-property, הערך של הפרמטר pubId הוא test-property. זה הפרוטוקול הסטנדרטי במודעות חיפוש בהתאמה אישית. דוגמה: 'pubId' : 'test-property' |
query |
חובה זו שאילתת החיפוש שהמשתמשים מזינים. הערך של הפרמטר query צריך להיות לא מקודד. דוגמאות: |
resultsPageBaseUrl |
חובה כשיש יחידות של חיפוש קשור בדף הפרמטר הזה מציין את כתובת ה-URL של דף תוצאות החיפוש שבו שאילתת החיפוש היא מונח החיפוש הקשור שהמשתמש לחץ עליו. הפרמטר resultsPageBaseUrl עשוי לכלול פרמטרים משלו, מלבד שאילתת החיפוש שתצורף באופן אוטומטי.
דוגמה: |
styleId |
חובה הפרמטר הזה מציין את מזהה הסגנון של המודעות בחיפוש שצריך להחיל על יחידות המודעות או על היחידות של החיפוש הקשור בדף. מידע נוסף על שימוש בסגנונות חיפוש הערה: אם הפרמטר styleId מוגדר במסגרת בקשה מסוימת, מודעות או חיפושים קשורים יוצגו עם הסגנון והמערכת תתעלם מפרמטרים קודמים של סגנון. אם הפרמטר styleId לא יצוין בבקשה, יוצג סגנון ברירת המחדל של המערכת. דוגמה |
אופציונלי
פרמטר | תיאור ודוגמאות |
---|---|
linkTarget |
אופציונלי הפרמטר הזה מציין אם לחיצה על מודעה גורמת לפתיחה באותו חלון או בחלון חדש. ערך ברירת המחדל הוא '_top'. אפשר להשתמש בפרמטר הזה גם ברמת היחידה.
דוגמה: 'linkTarget' : '_blank' |
maxTermLength |
אופציונלי הפרמטר הזה מציין את מספר התווים המקסימלי של מונח חיפוש קשור, כולל רווחים. אם הפרמטר לא מוגדר, אין מספר מקסימלי של תווים. דוגמה: 'maxTermLength' : 50 |
referrerAdCreative |
אופציונלי אם יש לכם דף תוכן שמכיל יחידת 'חיפוש קשור' לדפי תוכן ומשתמש מגיע לדף הזה אחרי לחיצה על מודעה או קישור שנמצאים בשליטתכם באתר אחר, הערך של הפרמטר צריך להיות העתק מדויק של טקסט הקריאייטיב במודעה או בקישור. ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:
דוגמאות: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
אופציונלי הפרמטר הזה מציין את שם הפרמטר של כתובת האתר שמשויך לשאילתת החיפוש בדף תוצאות החיפוש. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 'q'. דוגמה: 'resultsPageQueryParam' : 'query' |
terms |
אופציונלי הפרמטר הזה מאפשר לכם להגדיר רשימה של מונחי חיפוש קשור משלכם שבקשות חיפוש קשור אמורות להחזיר. צריך להפריד בין המונחים ברשימה באמצעות פסיקים. חשוב לדעת ש-Google לא תמיד משתמשת במונחים מהרשימה הזו. דוגמה: 'terms' : 'cars rental, flight ticket' |
הגדרות אישיות
פרמטר | תיאור ודוגמאות | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
אופציונלי הפרמטר הזה מציין את כללי הסינון ש-Google צריכה ליישם במודעות שתואמות לשאילתת החיפוש. בהמשך מוצגות ההגדרות החוקיות של הפרמטר adsafe וההשפעה של כל ערך על המודעות שמוחזרות:
הערה: ערך ברירת המחדל של הפרמטר
adsafe הוא 'high'.דוגמה: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
אופציונלי הפרמטר adtest מציין שבקשה מסוימת להצגת מודעות היא בקשת בדיקה. כשהערך של הפרמטר adtest הוא 'on', Google מתייחסת לבקשה בתור בדיקה, לא סופרת את החשיפות של המודעה ולא עוקבת אחרי הקליקים.
כשהערך של הפרמטר הערה: אפשר להשתמש בפרמטר הזה במהלך בדיקות, אבל לא כדאי להשתמש בו בסביבות ייצור מאחר שלא תקבלו תשלום על המודעות שיוצגו.
ערך ברירת המחדל של הפרמטר adtest הוא 'off'. דוגמה: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
אופציונלי כדי לעקוב אחרי הביצועים של דפים שונים, אפשר לכלול ערוץ של AdSense לחיפוש. יש להזין את מזהה הערוץ הייחודי שיצרתם בחשבון AdSense. מידע נוסף על מעקב אחרי ביצועי מודעות באמצעות ערוצים מותאמים אישית. אם יש כמה ערוצים, צריך להפריד ביניהם באמצעות הסמל '+'. דוגמאות: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
אופציונלי הפרמטר הזה משמש לצורך זיהוי השפה שהמודעות המבוקשות צריכות לטרגט. ערך ברירת המחדל הוא en. Google תומכת בכל קודי השפות של Google Ads API. הערה: מפרסמים מציינים את השפות שהמודעות שלהם מטרגטות. אם מציינים את הפרמטר הזה בבקשה, Google מחזירה רק מודעות שמטרגטות את השפה הזאת או מודעות שמטרגטות את כל השפות, אבל הטקסט של המודעות לא בהכרח יהיה בשפה שצוינה.
בדרך כלל מומלץ להגדיר את הפרמטר דוגמאות: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
אופציונלי
הפרמטר ערך ברירת המחדל בפרמטר
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
אופציונלי
הפרמטר ערך ברירת המחדל של הפרמטר
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
אופציונלי הפרמטר מציין אם המשתמשים הסכימו לאפשר לבעל התוכן הדיגיטלי לשתף מידע אישי עם Google למטרות פרסום מותאם אישית.
הערה: ערך ברירת המחדל של הפרמטר
personalizedAds הוא 'true'.דוגמה: 'personalizedAds': false |
תיאורים של פרמטרים ברמת היחידה
הפרמטרים האלה משפיעים על האופן שבו יחידות נפרדות של מודעות שנמצאות בדף מסוים מוצגות למשתמש. ניתן להגדיר כל פרמטר בנפרד, לכל יחידת מודעות.
חובה
פרמטר | תיאור ודוגמאות |
---|---|
container |
חובה המזהה של מאגר המודעות הריק <div id='afscontainer1'></div> שבו המודעה אמורה להופיע.
דוגמה:
|
maxTop |
חובה
הפרמטר הזה מאפשר לציין את מספר המודעות שיוצגו ביחידת המודעות העליונה. הערה: הפרמטר הזה מחליף את הפרמטר
number . יחידת המודעות צריכה להיות רחבה מספיק כדי למנוע גלישה של השורה הראשונה של המודעות. אם משתמשים בפרמטר maxTop בכל מיקום אחר בדף, זו הפרת מדיניות.דוגמה:
|
width |
חובה הפרמטר הזה מציין את הרוחב של יחידת המודעות או יחידת החיפוש הקשור, בפיקסלים. דוגמאות: 'width' : '700px' 'width' : 700 |
הגדרות אישיות
פרמטר | תיאור ודוגמאות | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
אופציונלי הפרמטר הזה מגדיר פונקציית JavaScript שצריכה להיות מופעלת כשהמודעות או החיפושים הקשורים נטענים או כשלא מוצגות מודעות או חיפושים קשורים. הערך של הפרמטר צריך להיות פונקציית קריאה חוזרת של JavaScript שאתם מטמיעים לצורך ביצוע פעולה מסוימת אחרי השלמת הטיפול בבקשה להצגת מודעה. פונקציית הקריאה החוזרת מקבלת את הפרמטרים הבאים:
הערה: צריך לבדוק את פונקציית הקריאה החוזרת כדי לוודא שהיא לא יוצרת שגיאות, במיוחד שגיאות שעלולות להפריע לטעינת הדף.
דוגמה לקריאה חוזרת (callback) של JavaScript: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // ככל הנראה לא צריך לעשות דבר } catch (e) { alert ("Error in callback function"); // צריך לעשות משהו כדי לטפל בשגיאה באלגנטיות } } else { // מה שתמיד עושים כשאין כיסוי של מודעות מ-Google } } }; |
||||||||
number |
אופציונלי מספר המודעות שצריכות להופיע ביחידה הזו. ערך ברירת המחדל הוא '2'. דוגמה:
|
||||||||
relatedSearches |
אופציונלי מספר החיפושים הקשורים שצריכים להופיע ביחידה הזו. הפרמטר הזה מחזיר לפחות 3 חיפושים קשורים, אלא אם הערך שהוגדר לו הוא אפס. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל שלו הוא 0. דוגמה: 'relatedSearches' : 4 |