פרמטרים
תיאורי פרמטרים ברמת הדף
את הפרמטרים האלה צריך לציין רק פעם אחת בכל דף. הן משפיעות על כל היחידות בדף.
חובה
פרמטר | תיאור ודוגמאות |
---|---|
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 מוגדר באופן אוטומטי בתור: 'שאילתה' כברירת מחדל. עם זאת, חשוב לציין שערך ברירת המחדל הזה ספציפי מיועד לדפי תוצאות חיפוש בלבד ('חיפוש קשור' בחיפוש). אם אתם באמצעות חיפוש קשור בכל סוג אחר של דף (למשל: מאמרים, פוסטים בבלוגים), עליך להגדיר במפורש את הפרמטר ל'תוכן'. הערה: ההנחיות הבאות רלוונטיות לשימוש בפרמטר הזה:
דוגמאות: '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 'ignoredPageParams' : 'utm_medium,click_id,session_ref' http://example.com/content?page_id=123 |
הגדרות תצורה
פרמטר | תיאור ודוגמאות | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe
|
אופציונלי מציינת את כללי הסינון ש-Google צריכה ליישם במודעות שתואמות לשאילתת החיפוש. בהמשך מוצגות ההגדרות החוקיות של adsafe וההשפעה של כל ערך על המודעות שמוחזרות:
כברירת מחדל, רמת הבטיחות של המודעה (adsafe) מוגדרת ל'גבוהה'. דוגמה: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
אופציונלי הפרמטר adtest משמש כדי לציין שבקשה להצגת מודעות היא בדיקה. כשהערך של הפרמטר adtest הוא on (מופעל), Google מתייחסת לבקשה כבדיקה, ולא סופרת את החשיפות של המודעה או עוקבת אחר תוצאות הקליקים. כשהערך של הפרמטר adtest הוא on (מופעל), אתם לא מייצרים הכנסה. בקשות להצגת מודעות שבהן הפרמטר adtest מוגדר כמופעל ומגיעות מדומיין שלא אושר בכרטיסייה 'אתרים' יחזירו מודעות עם 'מודעת בדיקה' יוצרות שכבת-על ולא ניתן ללחוץ עליהן. אפשר להשתמש בפרמטר הזה במהלך בדיקות, אבל לא כדאי להשתמש בו בסביבות ייצור מאחר שלא תקבלו תשלום על המודעות שיוצגו. ערך ברירת המחדל של הפרמטר 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' : 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 |