חומרי עזר

פרמטרים

תיאורי פרמטרים ברמת הדף

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

חובה

פרמטר תיאור ודוגמאות
adPage חובה כשהמשתמש מנווט לדף התוצאות הבא או לדף התוצאות הקודם.

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

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

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

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

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

דוגמאות:

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

דוגמה: 

'styleId': '1234567890'

אופציונלי

פרמטר תיאור ודוגמאות
linkTarget אופציונלי
מציין אם לחיצה על מודעה גורמת לפתיחה באותו חלון או בחלון חדש חלון. ערך ברירת המחדל הוא '_top' . אפשר להשתמש בפרמטר הזה גם ברמת היחידה.
  • '_top': פתיחה באותו חלון.
  • '_blank': פתיחה בחלון חדש.

דוגמה: 

'linkTarget' : '_blank'
maxTermLength אופציונלי
מציין את מספר התווים המקסימלי של מונח חיפוש קשור, כולל רווחים. אם הפרמטר לא מוגדר, אין מספר מקסימלי של תווים.

דוגמה: 

'maxTermLength' : 50
referrerAdCreative אופציונלי
אם משתמש מגיע לדף תוכן שמכיל יחידת 'חיפוש קשור' לדפי תוכן בלחיצה על מודעה או על קישור באתר אחר, והמודעה או הקישור נמצאים בשליטתך, צריך להגדיר את הפרמטר הזה לטקסט הקריאייטיב של אותה מודעה או קישור, מילה במילה.

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

  • יש לספק את הפרמטר רק בבקשת 'חיפוש קשור' לדפי תוכן, המערכת תתעלם מכל בקשה אחרת.
  • צריך להשתמש בפרמטר הזה רק בתנועה שמופנית אליכם באופן מכוון ממקורות אחרים אתרים, ואין להשתמש בו בתנועה אורגנית.
  • הוא צריך לכלול את שורת הכותרת, את התיאור ו/או כל ניסוח אחר במודעה, או קריאייטיב של קישור.
  • השמטת ערכים מהקריאייטיב של המודעה או הקישור (או כולל ערכים נוספים) היא נחשבות להפרה של ההוראות הכתובות האלה.
  • הפרמטר לא תלוי רישיות.
  • הפרמטר מקבל קידוד UTF-8 תקין. יש תמיכה בתווי Unicode ובסימנים דיאקריטיים.
  • Google עשויה להשתמש בפרמטר שאתם שולחים או להתעלם ממנו. אם נעשה בו שימוש, הוא עשוי להשפיע על הבחירה ואת הדירוג של המונחים.

הערה: הפרמטר הזה הוא חובה כשמשתמשים בפרמטר terms.

דוגמאות: 

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam אופציונלי
מציין את שם הפרמטר של כתובת האתר שמשויך לשאילתת החיפוש בדף תוצאות החיפוש. אם הפרמטר לא מוגדר, ערך ברירת המחדל הוא 'q'.

דוגמה: 

'resultsPageQueryParam' : 'query'
terms אופציונלי
הפרמטר הזה מאפשר לכם לספק רשימה של מונחי חיפוש קשורים משלכם שמופרדים בפסיקים. מוחזר עם בקשת חיפוש קשור, למרות ש-Google עשויה להשתמש או לא להשתמש בתנאים שמפורטים כאן.

הערה: כשמשתמשים בפרמטר הזה, referrerAdCreative הוא גם חובה וחובה להגדיר את relatedSearchTargeting ל'תוכן'.

דוגמאות: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams אופציונלי
מציין את רשימת הפרמטרים של כתובת ה-URL של דף תוכן עם 'חיפוש קשור' לדפי תוכן אפשר להתעלם ממנה בצורה בטוחה, בלי להשפיע על התוכן העיקרי או על חוויית המשתמש.

הערה: כדי שמונחי חיפוש קשורים יוכלו להופיע באתר שלכם, Google צריכה לסרוק את הדפים שלך כדי לוודא שהמונחים רלוונטיים להקשר. אם דף עדיין לא סומן נסרק או חסום לסריקה (למשל על ידי קובץ robots.txt) על ידי הסורק של AdSense, לא נציג הצעות למונחי חיפוש קשורים שסיפקת ל-Google.

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

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

  • יש לספק את הפרמטר רק בבקשת 'חיפוש קשור' לדפי תוכן, המערכת תתעלם מכל בקשה אחרת.
  • הערך של הפרמטר הזה צריך להיות רשימה מופרדת בפסיקים של פרמטרים של כתובת אתר שעשויים מופיעות כשמשתמש מנווט לדף התוכן.
  • הפרמטר תלוי אותיות רישיות.
  • כשמסירים פרמטר של כתובת אתר מהרשימה הזו מכתובת ה-URL של דף התוכן, צריך: לא ישפיעו באופן משמעותי על התוכן, המראה או חוויית המשתמש של הדפים.
  • הכללת פרמטר של כתובת אתר שמשפיע באופן משמעותי על התוכן, המראה או חוויית המשתמש נחשבת כהפרה של ההוראות הכתובות האלה.
  • Google עשויה לבדוק מדי פעם את ההשפעה של התעלמות מהפרמטרים שסופקו של כתובת אתר.

למשל:
משתמש מבקר בדף תוכן וכתובת ה-URL שלו היא: 

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 וההשפעה של כל ערך על המודעות שמוחזרות:
  • 'high' מחזיר מודעות לכל המשפחה. הוא לא מחזיר מודעות שאינן לכל המשפחה או מודעות בעלות תוכן מיני למבוגרים בלבד.
  • 'medium' מחזיר מודעות לכל המשפחה ומודעות שאינן לכל המשפחה. הוא לא מחזיר מודעות בעלות תוכן מיני למבוגרים בלבד.
  • 'low' מחזיר את כל סוגי המודעות.

כברירת מחדל, רמת הבטיחות של המודעה (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 אופציונלי

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

ערך ברירת המחדל של ie הוא utf-8.

ערך שם סטנדרטי שפות נתמכות משויכות
latin1 עם קידוד ISO-8859-1 מערב אירופה (קטלנית, דנית, הולנדית, אנגלית, פינית, צרפתית, גרמנית, אינדונזית, איטלקית, נורווגית, פורטוגזית, ספרדית, שוודית)
latin2 ISO-8859-2 מזרח אירופה (הונגרית, סרבית, סלובקית, סלובנית, פולנית צ'כית, קרואטית, רומנית)
latin3 ISO-8859-3  
latin4 ISO-8859-4 האזור הבלטי (אסטונית, לטבית, ליטאית)
קירילי ISO-8859-5 בולגרית, רוסית
arabic ISO-8859-6  
יוונית ISO-8859-7 יוונית
hebrew ISO-8859-8 עברית
latin5 ISO-8859-9  
latin6 ISO-8859-10 איסלנדית
euc-jp EUC-JP יפנית
euc-kr EUC-KR קוריאנית
סג'יס Shift_JIS יפנית
big5 Big5 סינית מסורתית
gb GB2312 סינית פשוטה
utf-8 UTF-8 הכול
oe אופציונלי

הפרמטר oe מגדיר את סכמת קידוד התווים שבאמצעותה Google תקודד את הטקסט של המודעות. זה אמנם אופציונלי, אבל מומלץ להעביר ערך לפרמטר הזה.

ערך ברירת המחדל של oe הוא utf-8.

ערך שם סטנדרטי שפות נתמכות משויכות
latin1 עם קידוד ISO-8859-1 מערב אירופה (קטלנית, דנית, הולנדית, אנגלית, פינית, צרפתית, גרמנית, אינדונזית, איטלקית, נורווגית, פורטוגזית, ספרדית, שוודית)
latin2 ISO-8859-2 מזרח אירופה (הונגרית, סרבית, סלובקית, סלובנית, פולנית צ'כית, קרואטית, רומנית)
latin3 ISO-8859-3  
latin4 ISO-8859-4 האזור הבלטי (אסטונית, לטבית, ליטאית)
קירילי ISO-8859-5 בולגרית, רוסית
arabic ISO-8859-6  
יוונית ISO-8859-7 יוונית
hebrew ISO-8859-8 עברית
latin5 ISO-8859-9  
latin6 ISO-8859-10 איסלנדית
euc-jp EUC-JP יפנית
euc-kr EUC-KR קוריאנית
סג'יס Shift_JIS יפנית
gb GB2312 סינית פשוטה
utf-8 UTF-8 הכול
ivt אופציונלי
הפרמטר הזה מאפשר לכם לציין ערך בוליאני שמיידע את Google שאתם רוצים לאפשר הצגת מודעות שמשתמשות בקובץ Cookie לזיהוי תנועה לא חוקית בלבד. אחסון מקומי בקרב תנועת משתמשים שהביעו הסכמה וגם בקרב תנועת משתמשים שלא הביעו הסכמה.
  • true כשהפרמטר הזה לא קיים או שמגדירים אותו כ-"true", אנחנו נגדיר קובץ Cookie לזיהוי תנועה לא חוקית בלבד ונשתמש באחסון מקומי רק לתנועה שהתקבלה מההסכמה.
  • false כשמגדירים את הפרמטר הזה כ-'false' אנחנו נגדיר קובץ Cookie לזיהוי תנועה לא חוקית בלבד ונשתמש באחסון מקומי גם בקרב משתמשים שהביעו הסכמה וגם בקרב תנועת משתמשים שלא הביעו הסכמה.

כברירת מחדל, תנועה IVT מוגדרת כ-True.

דוגמה: 

'ivt': false

תיאורי פרמטרים ברמת היחידה

הפרמטרים האלה משפיעים על האופן שבו יחידות נפרדות של מודעות בדף מוצגות למשתמש. ניתן להגדיר כל פרמטר בנפרד לכל יחידת מודעות.

חובה

פרמטר תיאור ודוגמאות
container חובה
המזהה של מאגר המודעות הריק <div> שבו המודעה צריכה להופיע.

דוגמה: 

'container' : 'afscontainer1'
maxTop חובה כאשר יחידת המודעות נמצאת מעל תוצאות החיפוש.

משתמשים בפרמטר הזה כדי לציין את מספר המודעות שיוצגו ביחידת המודעות העליונה.

הערה: משתמשים בפרמטר הזה במקום number הפרמטר. יחידת המודעות הזו צריכה להיות רחבה מספיק כך שהשורה הראשונה של המודעות לא תגלוש. שימוש במקסימום בכל מיקום אחר בדף מהווה הפרת מדיניות.

דוגמה:

'maxTop' : 4
width חובה
מציינת את הרוחב של המודעה או יחידת החיפוש הקשור בפיקסלים.

דוגמה: 

'width' : '700px'
 
'width' : 700

הגדרות תצורה

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

פונקציית הקריאה החוזרת משתמשת בפרמטרים הבאים:

containerName שם המאגר של יחידת המודעה או יחידת החיפוש הקשור.
adsLoaded הערך מוגדר כ-true כשיש לפחות מודעה אחת או מונח חיפוש קשור אחד להצגה. הערך מוגדר כ-FALSE כאשר לא מוחזרות מודעות או חיפושים קשורים.
isExperimentVariant הערך צריך להיות True אם מופעל ניסוי של סגנון מותאם אישית והווריאנט של נבחר לעיבוד המודעות.
callbackOptions אובייקט JSON שמכיל את השדות הבאים:
termPositions: לבלוק של חיפוש קשור, מכיל מפה<string,int> מתוך הנתונים שסופקו על ידי בעל האפליקציה מונחים למיקום אפס באינדקס של המונחים האלה בתגובה. אם צוין מונח אך לא הוחזר, הוא לא יופיע במפה.

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

דוגמה לקריאה חוזרת (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