פרמטרים
תיאורי פרמטרים ברמת הדף
את הפרמטרים האלה צריך לציין רק פעם אחת בכל דף. הן משפיעות על כל היחידות בדף.
נדרש
פרמטר | תיאור ודוגמאות |
---|---|
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 של דף תוצאות החיפוש שבו שאילתת החיפוש היא מונח החיפוש הקשור שהמשתמש לחץ עליו. הפרמטר resultsPageBaseUrl עשוי לכלול פרמטרים משלו, מלבד שאילתת החיפוש שתצורף באופן אוטומטי. לדוגמה: 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
חובה כשיש יחידות של חיפוש קשור בדף. הפרמטר הזה הוא חובה כשנשלחות בקשות ליחידות של חיפוש קשור. המדיניות הזו קובעת את סוג חוויית החיפוש הקשור שיוצג בהתאם להקשר של הדף:
הערה: פרמטר הדף relatedSearchTarget מוגדר באופן אוטומטי בתור 'query' כברירת מחדל. עם זאת, חשוב לציין שערך ברירת המחדל הזה תוכנן במיוחד לדפי תוצאות חיפוש בלבד ('חיפוש קשור' בחיפוש). אם משתמשים בחיפוש קשור בכל סוג אחר של דף (למשל, מאמרים, פוסטים בבלוג), צריך להגדיר את הפרמטר כ-'content' באופן מפורש. הערה: ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:
דוגמאות: 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
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
|
אופציונלי הפרמטר הזה מציין את רשימת הפרמטרים של כתובות ה-URL של דף תוכן עם יחידת 'חיפוש קשור' לדפי תוכן שאפשר להתעלם מהם בצורה בטוחה, בלי להשפיע על התוכן העיקרי או על חוויית המשתמש. הערה: כדי שמונחי חיפוש קשורים יוכלו להופיע באתר שלך, Google צריכה לסרוק את הדפים כדי לוודא שהמונחים רלוונטיים להקשר. אם דף עדיין לא נסרק או נחסם לסריקה (למשל על ידי קובץ robots.txt) על ידי הסורק של AdSense, לא נציג הצעות למונחי חיפוש קשורים שסיפקתם ל-Google. המוצר 'חיפוש קשור בתוכן' מסתמך על מערכת סריקת התוכן של Google כדי להוסיף דפים לאינדקס וליצור מונחי חיפוש רלוונטיים. כתובות URL של דפי תוכן שמכילות פרמטרים של שאילתות, כמו משתני מעקב, מזהי משתמשים, מזהי סשנים או מזהים דינמיים אחרים, עלולות להפריע לסורק להעריך את התוכן העיקרי של הדף, ולהוביל למונחי חיפוש קשורים לא מדויקים או לא רלוונטיים. הפרמטר הזה של הדף מורה לסורק של Google להתעלם מהפרמטרים הלא חיוניים האלה, כדי לשמור על אינדקס תקין של תוכן ולצמצם עומסי סריקה מיותרים. כך Google יכולה לזהות טוב יותר דף שכבר נסרק, ולהתחיל להציג מונחים מוצעים (גם Google וגם של השותף, אם הם עומדים בדרישות). ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:
דוגמאות:
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 וההשפעה של כל ערך על המודעות שמוחזרות:
כברירת מחדל, רמת הבטיחות של המודעה (adsafe) מוגדרת ל'גבוהה'. לדוגמה: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
אופציונלי הפרמטר adtest משמש כדי לציין שבקשה להצגת מודעות היא בדיקה. כשהערך של הפרמטר adtest הוא on (מופעל), Google מתייחסת לבקשה כבדיקה, ולא סופרת את החשיפות של המודעה או עוקבת אחר תוצאות הקליקים. כשהערך של הפרמטר adtest הוא on (מופעל), אתם לא מייצרים הכנסה. בקשות להצגת מודעות שבהן הפרמטר 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 שאתם רוצים לאפשר הצגה של מודעות שמשתמשות באחסון מקומי ובקובצי 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 |