פרמטרים
תיאורים של פרמטרים ברמת הדף
את הפרמטרים האלה צריך לציין רק פעם אחת בכל דף. הם משפיעות על כל היחידות בדף.
חובה
פרמטר | תיאור ודוגמאות |
---|---|
adPage
|
חובה כשהמשתמש מנווט לדף התוצאות הבא או לדף התוצאות הקודם. הפרמטר |
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'. אפשר להשתמש בפרמטר הזה גם ברמת היחידה.
לדוגמה: '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' |
ignoredPageParams
|
אופציונלי הפרמטר הזה מציין את רשימת הפרמטרים של כתובת האתר של דף תוכן עם יחידת 'חיפוש קשור' לדפי תוכן. אפשר להתעלם ממנה בבטחה בלי להשפיע על התוכן העיקרי או על חוויית המשתמש. הערה: המוצר 'חיפוש קשור בתוכן' מסתמך על מערכת סריקת התוכן של Google כדי להוסיף דפים לאינדקס וליצור מונחי חיפוש רלוונטיים. כתובות URL של דפי תוכן שמכילות פרמטרים של שאילתות כמו משתני מעקב, מזהי משתמשים, מזהי סשנים או מזהים דינמיים אחרים עלולות להפריע לסורק להעריך את התוכן העיקרי של הדף ולהוביל למונחי חיפוש קשורים לא מדויקים או לא רלוונטיים. פרמטר הדף הזה מורה לסורק של Google להתעלם מפרמטרים לא מיותרים אלה, וכך להבטיח הוספה תקינה של תוכן לאינדקס ולהפחית את עומס הסריקה המיותר. כך Google תוכל לזהות טוב יותר דף שכבר נסרק, ולהתחיל להציג מונחים מוצעים (גם של Google וגם של השותף, אם הם עומדים בתנאים). ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:
דוגמאות:
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 וההשפעה של כל ערך על המודעות שמוחזרות:
כברירת מחדל, הערך 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
|
אופציונלי הפרמטר ערך ברירת המחדל של
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
אופציונלי הפרמטר ערך ברירת המחדל של
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
אופציונלי הפרמטר הזה מאפשר לכם להוסיף ערך בוליאני כדי ליידע את Google שאתם רוצים לאפשר ל-Google להציג מודעות שמשתמשות בקובץ Cookie לזיהוי תנועה לא חוקית בלבד ובאחסון מקומי, גם בתנועה של משתמשים שהביעו הסכמה וגם בתנועה של משתמשים שלא הביעו הסכמה.
כברירת מחדל, הערך IVT מוגדר כ-True. לדוגמה: 'ivt': false |
תיאורי הפרמטרים ברמת היחידה
הפרמטרים האלה משפיעים על האופן שבו יחידות מודעות בודדות בדף מוצגות למשתמש. ניתן להגדיר כל פרמטר בנפרד לכל יחידת מודעות.
חובה
פרמטר | תיאור ודוגמאות |
---|---|
container
|
חובה המזהה של מאגר המודעות הריק <div> שבו המודעה אמורה להופיע.
לדוגמה: 'container' : 'afscontainer1' |
maxTop
|
חובה כשיחידת המודעות נמצאת מעל לתוצאות החיפוש. הפרמטר הזה מאפשר לציין את מספר המודעות שיוצגו ביחידת המודעות העליונה. הערה: הפרמטר הזה משמש במקום הפרמטר 'number'. יחידת המודעות צריכה להיות רחבה מספיק כדי למנוע גלישה של השורה הראשונה של המודעות. שימוש בפרמטר maxTop בכל מיקום אחר בדף מהווה הפרת מדיניות. דוגמה: 'maxTop' : 4 |
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 { // 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 |