התאמה לקובצי cookie היא תכונה שמאפשרת להתאים את קובץ ה-cookie – לדוגמה, מזהה של משתמש שגלש באתר שלכם – למזהה משתמש ספציפי של Google שמיועד למגיש הצעות מחיר, ולבנות רשימות משתמשים שיכולות לעזור לכם לקבל החלטות יעילות יותר בנוגע לבידינג. במדריך הזה מתוארים מושגים המשמשים בהתאמה של קובצי Cookie, וכן תהליכי עבודה שונים להתאמה של קובצי cookie והווריאציות שהם יכולים להשתמש בהם בתרחישים מסוימים.
מושגים
מהי התאמת קובצי cookie?
בדרך כלל בעלי הדומיין מגדירים את התוכן של קובצי ה-cookie למשתמשים שגולשים באתר, ומשמשים לזיהוי משתמשים בתוך הדומיין. גם אם שני בעלי דומיינים הסכימו להחליף את הנתונים האלה, מודל האבטחה של דפדפני האינטרנט הגביל את האפשרות לקרוא קובץ cookie שהוגדר על ידי דומיין אחר.
בהקשר של פרסום בדיגיטל, Google מזהה משתמשים עם קובצי cookie ששייכים לדומיין doubleclick.net. למגישי הצעות המחיר שמשתתפים במכרז בזמן אמת עשוי להיות דומיין משלהם, שבו הם מזהים קבוצה של משתמשים שהם רוצים להציג בהם מודעות. התאמה לקובצי cookie מאפשרת למגיש הצעות המחיר להתאים את קובצי ה-cookie שלו ל-Google, וכך הוא יכול לקבוע אם חשיפה שנשלחה בבקשה להצעת מחיר משויכת לאחד מהמשתמשים שאליהם הוא מטורגט, והוא יקבל נתוני קובץ cookie משלו או מזהה משתמש ספציפי של Google לבידינג, שהם צורה מוצפנת של קובץ ה-cookie של doubleclick.net בבקשת הצעת המחיר.
שירות ההתאמה של קובצי cookie שמתואר במדריך הזה עוזר ליצור ולנהל את השיוך בין קובץ cookie של מגיש הצעות המחיר לבין מזהה המשתמש של Google, והוא גם מאפשר לאכלס רשימות משתמשים.
טבלאות של התאמות
אפשר להשתמש בטבלת התאמות כדי למפות מזהה או נתונים אחרים מדומיין אחד לדומיין אחר. מגישי הצעות המחיר יכולים להשתמש בשירות ההתאמה של קובצי cookie כדי לאכלס את טבלאות ההתאמה שלהם על ידי מיפוי קובץ ה-cookie של משתמש נתון למזהה המשתמש של המשתמש ב-Google, או לאכלס טבלת התאמה שמתארחת ב-Google. טבלאות ההתאמה הכרחיות כדי שמגיש הצעות המחיר של מגיש הצעות המחיר יקבל גישה לנתוני קובצי cookie כדי שהחשיפה תוצג למשתמש.
טבלאות של התאמות שמתארחות ב-Google
כדי להקל על תחזוקה, שיפורים בזמן האחזור וגישה לנתוני התאמה למשתמשים באזורים מסוימים, מומלץ לאפשר ל-Google לארח את טבלת ההתאמות. כך אפשר לציין מחרוזת בקידוד base64 בטוחה לאינטרנט – המכונה בהמשך נתוני התאמה מתארחת, שתמפו אל מזהה המשתמש של Google עבור משתמש נתון. אחרי יצירת ההתאמה, אפשר להשתמש בה בדרכים הבאות:
בידינג בזמן אמת: בבקשות להצעות מחיר עתידיות על חשיפות המשויכות למשתמש, Google תשלח לכם את נתוני ההתאמה המתארחים שהותאמו עם מזהה המשתמש שלו ב-Google. אם נקודת הקצה שלך לבידינג היא פרוטוקול RTB של Google, היא תדווח כבייטים מפוענחים דרך השדה
BidRequest.hosted_match_data. בהטמעת OpenRTB של Google,BidRequest.user.buyeruidיחזיר את הנתונים האלה כמחרוזת עם קידוד Base64 שבטוח לשימוש באינטרנט.רשימות משתמשים: אפשר לאכלס רשימות משתמשים במזהי משתמשים של Google או בנתוני התאמה מתארחת.
- טירגוט מראש: אפשר להגדיר טירגוט מראש כך שתקבלו רק בקשות להצעות מחיר שמכילות נתוני התאמה מתארחת. ניתן להשתמש באפשרות הזו כדי למנוע חשיפות פחות רלוונטיות למשתמשים שנמצאים מחוץ למרחב קובצי ה-cookie.
רשימות משתמשים
אפשר ליצור ולנהל רשימות משתמשים באמצעות Real-Time Bidding API. אחרי שתיצרו את הרשימות האלה, תוכלו לאכלס את הרשימות האלה בתהליכי העבודה של קובצי cookie המתוארים בהמשך, או דרך שירות ההעלאה בכמות גדולה.
תחילת העבודה
כדי להתחיל להשתמש בהתאמה לקובצי cookie, עליכם לפנות למנהל החשבונות הטכני, שיכול להפעיל תהליכי עבודה ספציפיים ולהגדיר את הדברים הבאים:
- מזהה רשת קובצי cookie (NID): מזהה מחרוזת שמזהה באופן ייחודי חשבון של מגיש הצעות מחיר עבור 'התאמה של קובצי cookie' ופעולות קשורות אחרות.
- כתובת URL להתאמת קובצי cookie: כתובת ה-URL הבסיסית של נקודת קצה (endpoint) שיקבלה טיפול ותטפל בבקשות נכנסות כחלק מתהליכי העבודה של קובצי cookie. מגישי הצעות המחיר יכולים להטמיע פקודות מאקרו בכתובת ה-URL הזו כדי לשלוט בסדר הפרמטרים שמועברים אליה בתהליכי העבודה של התאמת קובצי cookie.
- Tag Match (תג התאמה): התג שצריך להציב בדפדפן של המשתמש כדי להגדיר את תהליך העבודה להפעלת קובצי Cookie ביוזמת הבידינג. אפשר להציג אותן לצד מודעות, או למקם אותן בנכסי אינטרנט מחוץ למודעות.
- כתובת URL של דוח על התאמה של קובצי Cookie (אופציונלי): בתהליך העבודה הלא-כיווני של קובצי cookie, זוהי כתובת URL אופציונלית שאפשר לציין כדי לציין נקודת קצה (endpoint) שיקבלו פרטי שגיאה במקרה שהתאמה של קובצי cookie נכשלה דרך הפניה אוטומטית מסוג HTTP 302. כברירת מחדל, התשובות יישלחו לכתובת ה-URL הזו רק אם אירעה שגיאה בפעולת ההתאמה של קובץ ה-cookie, אבל ייתכן שהצעות המחיר ישלחו את הבקשה להפניה מחדש.
- כתובת URL ל-Cookie Match Assist: בערוצים שבהם מתבצעת הטמעה של תהליך העבודה של Cookie Match Assist, זוהי כתובת ה-URL הבסיסית של נקודת הקצה שנועדה להגיב לבקשות נכנסות.
- מכסה בסיוע קובצי cookie Match: לתכתובת של יישום קובץ ה-cookie של Cookie Match Assist, זוהי המספר המקסימלי של בקשות שכתובת האתר של ההתאמה של קובצי cookie יכולה לקבל בכל שנייה. המטרה היא למנוע עומס יתר על בקשות CMA בבקשות של ה-Exchange.
קובצי מאקרו התואמים לקובצי cookie
בכל אחד מתהליכי העבודה התואמים לקובצי cookie, בדרך כלל לכתובת ה-URL של מגיש הבקשה המבוססת על קובצי cookie משויכים פרמטרים בסדר לא מובטח. מגישי הצעות מחיר עם שילובים שדורשים סדר עקבי של פרמטרים יכולים להציב פקודות מאקרו בכתובת ה-URL של התאמת קובצי ה-cookie כדי להבטיח את המיקום שלהם.
פקודות מאקרו נתמכות
למגישי הצעות המחיר יש אפשרות להגדיר את כתובת ה-URL להתאמה לקובצי cookie כך שתכלול מאקרו אחד או יותר, באופן הבא: %%GOOGLE_<PARAM_NAME>%% או %%GOOGLE_<PARAM_NAME>_PAIR%%. רכיבי המאקרו הנתמכים והערכים המורחבים שלהם הם:
| Macro | ערך מורחב |
|---|---|
| GOOGLE_GID | GOOGLE_USER_ID |
| GOOGLE_GID_PAIR | &google_gid=GOOGLE_USER_ID |
| GOOGLE_CVER | COOKIE_VERSION_NUMBER |
| GOOGLE_CVER_PAIR | &cver=COOKIE_VERSION_NUMBER |
| שגיאה GOOGLE_ERROR | ERROR_ID |
| GOOGLE_ERROR_PAIR | &google_error=ERROR_ID |
| GOOGLE_PUSH | PIXEL_MATCH_DATA |
| GOOGLE_PUSH_PAIR | &google_push=PIXEL_MATCH_DATA |
| GOOGLE_ALL_PARAMS | google_gid=GOOGLE_USER_ID&cver=COOKIE_VERSION_NUMBER&google_error=ERROR_ID |
דוגמה למאקרו
למגיש הצעות המחיר יש שילוב של קובצי cookie שתואם לנקודת הקצה שמתארחת ב-https://user.bidder.com.cookies, וההטמעה שלו מחייבת שימוש בפרמטרים מוגדרים מראש של מגיש הצעות המחיר, בנוסף לפרמטרים של Pixel Match בסדר הבא: google_push, google_gid, google_cver ו-google_error. כדי לעשות זאת, מגיש הצעת המחיר יכול:
https://user.bidder.com/cookies?w=0%%GOOGLE_PUSH_PAIR%%&x=1%%GOOGLE_GID_PAIR%%&y=2%%GOOGLE_CVER_PAIR%%&z=3%%GOOGLE_ERROR_PAIR%%
מאוחר יותר, כש-Google תשלח בקשת התאמה למגיש הצעות המחיר הזו, היא תורחב לאחת מהאפשרויות הבאות:
https://user.bidder.com/cookies?w=0&google_push=PUSH_DATA&x=1&google_gid=GOOGLE_GID&y=2&google_cver=1&z=3
תהליכי עבודה לשירות התאמה של קובצי Cookie
שירות ההתאמה של קובצי cookie של Google תומך בשלב זה בשלושה תהליכי עבודה לתרחישים שונים של שימוש, כפי שמתואר בהמשך.
ביוזמת מגיש הצעת המחיר: התאמת קובצי cookie דו-כיוונית
התאמה דו-כיוונית של קובצי cookie מתייחסת לתהליך עבודה ביוזמת מגיש הצעת המחיר, שבו הוא ממקם תג התאמה בדפדפן של המשתמש שמפנה אותו אל Google. תהליך העבודה הזה מאפשר ל-Google ולמגיש הצעות המחיר לאכלס טבלאות של התאמות. הדוגמה הבאה היא של תהליך העבודה הזה.
שלב 1: מציבים את תג ההתאמה
כדי להתחיל בתהליך, מגיש הצעות המחיר צריך להציב את תג ההתאמה שלו כך שיוצג בדפדפן של המשתמש. תג התאמה פשוט שמחזיר רק את מזהה המשתמש של Google למגיש הצעות המחיר עשוי להיות מובנה באופן הבא:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm" />
יש פרמטרים נוספים שאפשר לכלול בתג ההתאמה כדי למלא תרחישים שונים לדוגמה. למידע נוסף על הפרמטרים האלה, ראו פרמטרים של כתובת URL של תג התאמה.
שלב 2: Google מגיבה להפניה אוטומטית, כולל נתוני התאמה
תג ההתאמה יגרום לשירות ההתאמה של קובצי cookie ב-Google לקבל בקשה מהדפדפן של המשתמש, פעולה שתוביל לכתובת HTTP 302 לכתובת ה-URL של התאמת קובצי ה-cookie של מגיש הצעות המחיר. ההפניה תכלול פרמטרים של שאילתה המציינים את מזהה המשתמש של Google ואת מספר הגרסה בכתובת האתר, ומגיש הצעות המחיר יקבל גם את קובץ ה-cookie הכלול בכותרות הבקשות. בפועל, אם כתובת ה-URL תואמת ל-cookie שצוינה בתור https://ad.network.com/pixel, כתובת ה-URL להפניה אוטומטית של תג ההתאמה הפשוט, כפי שמתואר למעלה, עשויה להיראות כך:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
מזהה המשתמש ב-Google שעובר דרך הפרמטר google_gid הוא מחרוזת מקודדת מסוג base64 בטוחה לשימוש באינטרנט. כשמגישי הצעות מחיר בוחרים לארח טבלת התאמה, מומלץ לשמור את המחרוזת המדויקת שמוחזרת על ידי שירות ההתאמה לקובצי Cookie. בבקשות הבאות להצעות מחיר, הערך הזה יהיה תואם לערכים שצוינו דרך BidRequest.google_user_id בפרוטוקול RTB של Google או ל-BidRequest.user.id בהטמעת OpenRTB של Google.
הגרסה שצוינה ב-google_cver מציינת את מספר הגרסה המספרית של User-ID של Google. לעיתים קרובות ה-User-ID של משתמש מסוים ישתנה, ולאחר מכן הוא יתווסף.
אם Google תיתקל בשגיאה במהלך העיבוד של בקשת ההתאמה, יצוין במקום זאת פרמטר google_error.
שלב 3: מגיש הצעות המחיר מעבד הפניה אוטומטית ומגיב עם פיקסל
מגיש הצעות המחיר מקבל הפניה לכתובת ה-URL שלו שתואמת לקובצי cookie, כולל הפרמטרים שהוא ציין בשלב הראשון והפרמטרים ש-Google סיפקה בשלב השני. בנוסף, הם יקבלו את קובץ ה-cookie בכותרות ה-HTTP. אם הפעולה בוצעה בהצלחה, מגיש הצעות המחיר שמארח את טבלת ההתאמה שלו יכול להתאים את קובץ ה-cookie למזהה המשתמש של Google שכלול בתגובה. מומלץ למגישי הצעות המחיר לאחסן את המחרוזת המדויקת שמוחזרת על ידי שירות ההתאמה של קובצי cookie.
אם הפעולה נכשלה, מגיש הצעות המחיר יקבל פרמטר google_error בהפניה האוטומטית. זהו ערך מספרי שתואם למצבי שגיאה שונים שמזהים את השגיאה הספציפית שאירעה. כאן תוכלו לקרוא מידע נוסף על ערכי השגיאות האפשריים.
אם תתקבל שגיאה, תוכלו לנסות למצוא התאמה נוספת למשתמש הזה על ידי הצבת תג התאמה חדש.
מגיש הבקשה תמיד חייב להגיב על ידי הצגת תמונה של פיקסל 1x1 בלתי נראה, או לחלופין להציג תגובה של HTTP 204 ללא תוכן.
תרשים של תהליך ההתאמה של קובצי cookie
תהליך העבודה הזה מוצג בתרשים הבא, שבו בקשות ותגובות מיוצגות על ידי חץ ופריטי הנתונים הנלווים מפורטים בסוגריים.
התאמה לפרמטרים של כתובת URL של תג
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) בחשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה באמצעות המשאב מגישי הצעות מחיר. |
google_cm |
מציין לשירות קובצי ה-cookie של Google שעליו להתאים את קובצי ה-cookie. המערכת מתעלמת מהערך של הפרמטר ויכול להיות שהוא יושמט. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר את קובץ ה-cookie של Google עבור המשתמש, אם אינו קיים. המערכת מתעלמת מהערך של הפרמטר ואפשר להשמיט אותו. אם משמיטים את הפרמטר, מתקבלת שגיאה אם אין קובץ cookie. |
google_no_sc |
הפרמטר הזה הוצא משימוש. המשמעות היא לשירות ההתאמה של Google בקובצי cookie, שהוא לא צריך להגדיר קובץ cookie עבור המשתמש אם לא קיים קובץ cookie. המערכת מתעלמת מהערך של הפרמטר ויכול להיות שהוא יושמט. |
google_hm |
הנתונים שמגיש הצעות המחיר רוצה לאחסן בטבלת התאמות שמתארחת ב-Google.
הערך הוא מחרוזת בקידוד base64 בטוחה לאינטרנט (מרווח אופציונלי). הנתונים הגולמיים חייבים להיות באורך של עד 40 בייטים. לדוגמה: |
google_redir |
מחרוזת בקידוד כתובת URL, שמגיש הצעות המחיר יכול לציין אם הוא רוצה להפנות את Google לכתובת ה-URL המקודדת HTTP 302. כך Google יכולה להופיע בחזית באמצעות שרשרת שיחות עם שותפים. כתוצאה מכך, תתקבל שגיאה אם היא מצוינת בלי
google_hm או עם google_cm. |
google_ula |
מחרוזת המשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
פרמטר ה-URL הזה עשוי לחזור על עצמו כדי להוסיף את המשתמש למספר רשימות. |
בנוסף לפרמטרים שהוזכרו, מגישי הצעות המחיר יכולים לציין פרמטרים משלהם. הפרמטרים האלה יתווספו כפרמטרים לכתובת ה-URL להפניה אוטומטית. הערה: המערכת תתעלם מפרמטרים שמוגדרים על ידי מגיש הצעות המחיר בשם התחילית google_, כי הם שמורים על ידי Google לצורך פיתוח עתידי, והסידור של הפרמטרים לא מובטח. תג התאמה הכולל פרמטרים שהוגדרו על ידי מגיש הצעות המחיר עשוי להיראות כך:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
פרמטרים של כתובת אתר להפניה מחדש
כתובת ה-URL להפניה אוטומטית מבוססת על כתובת ה-URL הבסיסית להתאמה של קובצי cookie, שהוגדרה בחשבון של מגיש הצעות המחיר, כולל google_ ופרמטרים שמוגדרים על ידי מגיש הצעות המחיר, בהתאם לאלו שצוינו בתג ההתאמה. אלו הפרמטרים של התגובה google_:
| פרמטר | תיאור |
|---|---|
google_gid |
מזהה משתמש של Google. צריך לציין אם הבקשה צוינה ב-google_cm והבקשה אושרה. |
google_cver |
גרסת קובץ cookie. צריך לציין אם הבקשה צוינה ב-google_cm והבקשה אושרה. |
google_error |
ערך של מספר שלם שמציין את שגיאת הבקשה הכוללת. אם ההודעה תתקבל,
לא יתבצעו פעולות ולא יוגדרו
|
google_hm |
מופיעה רק אם ניסיון הכתיבה אל טבלת ההתאמה שמתארחת ב-Google נכשל. במקרה כזה, הערך שלו הוא אחד מקודי הסטטוס הבאים:
|
google_ula |
הסטטוס של פעולת ההוספה של רשימת המשתמשים, שחוזר על עצמו אם צוינו מספר דוגמה: הפעולה
|
תרחישים לדוגמה לתהליך התאמה של קובצי cookie
התרחישים הבאים מתארים איך התאמת קובצי cookie עשויה להיראות למשתמשים אופייניים שגולשים בדף אינטרנט.
תרחיש 1: משתמש מנקה את קובצי ה-cookie וגולש באתר
דנה מנקה את המטמון מכל קובצי ה-cookie. לאחר מכן הם נכנסים לדף הבית של exampleNews.com.
הנה תיאור של התהליך:
- שירות NewsNews.com מעבד מודעות ומקשר אותן מ-Google (Ad Manager).
- מאחר שיחידת המודעות הזו כשירה להקצאה דינמית, Google שולחת בקשות להצעות מחיר ל-FeststDSP ולמגישי הצעות מחיר אחרים דרך שירות הבידינג בזמן אמת.
- האפליקציה של מגיש הצעות המחיר FiststSP מקבלת ומעבדת את הבקשה להצעת המחיר, ושולחת את התשובה שלה להצעת המחיר.
- Google מקבלת תגובות מהצעות מחיר של מגישי הצעות מחיר, כולל התשובה של PlstDSP המציינת מודעה עם תג התאמה (פיקסל).
- ב-FiststDSP ניצחה במכרז. Google מציגה את המודעה ואת תג ההתאמה של PrestDSP בפני ג'יין.
- תג ההתאמה מפעיל את שירות קובצי cookie של Google, תוך ציון הפרמטרים
google_nidו-google_cm. - שירות ההתאמה של קובצי cookie קורא את קובץ ה-cookie של Google, ושולח לדפדפן של ג'יין הפניה אוטומטית לכתובת ה-URL של התאמת קובצי ה-cookie של גורמה. הוגדרו הפרמטרים
google_user_idו-google_cver. - הדפדפן של ג'יין טוען את ההפניה האוטומטית לכתובת האתר של התאמת קובצי ה-cookie של גורמה.
- נקודת הקצה של קובצי cookie של תואם ל-FasstDSP מעבדת את הבקשה להפניה אוטומטית, שכוללת פרמטרים של כתובות אתרים שהוגדרו על ידי Google, ואת קובץ ה-cookie שלה לג'יין בכותרות ה-HTTP. עכשיו אפשר לשמור ב-FiststDSP את המיפוי של קובץ ה-cookie
ב-
google_user_idבטבלת ההתאמות. - מסעדת SuperstDSP מגיבה להפניה מחדש עם פיקסל 1x1 בלתי נראה.
תרחיש 2: משתמש עם מיפוי קיים
שבוע לאחר תרחיש 1, גלית שוב מבקרת ב-ExampleNews.com. עכשיו, אחרי שלג'יין יש קובצי cookie של מגיש הצעות המחיר ו-Ad Manager במכונה שלו, כך פועלת ההתאמה.
- דף האינטרנט מוצג וגורם ל-Google (Ad Manager) לבקש מודעות שיוצגו בדף.
- במהלך המכרז של המודעות, Google שולחת בקשה להצעת מחיר אל מגישי הצעות המחיר הרלוונטיים, כולל PlstDSP.
- מערכת ContentstDSP מקבלת את הבקשה להצעת מחיר, כולל אותות כמו
google_user_id. - FiststDSP מחפש את
google_user_idבטבלת ההתאמות שלו, ומוצא את קובץ ה-cookie שמשויך לג'יין שנוצר שבוע קודם לכן (בתרחיש 1). - בהתאם ללוגיקה של קובץ ה-cookie, לוגיקת הבידינג של גורמה יכולה להגיש הצעת מחיר על החשיפה וזוכה במכרז.
- ג'יין עשויה לראות מודעה שמותאמת לתחומי העניין שלה, על סמך המידע ששמור ב-FiststDSP.
ביוזמת מגיש הצעת המחיר: התאמות חד-כיווניות של קובצי Cookie
התאמה קובצי cookie לא-כיוונית דומה לתהליך העבודה הדו-כיווני, אלא שהיא משתנה כך שרק Google מארחת ומאכלסת טבלת התאמות. תוכלו להשתמש באפשרות הזו במקרים שבהם מגיש הצעות המחיר לא מורשה לארח מזהי משתמשים של Google בטבלת ההתאמות שלו. כדי להשתמש בתהליך הזה, מגישי הצעות המחיר צריכים לאפשר ל-Google לארח את טבלת ההתאמות, הם לא יכולים יותר לציין google_cm בבקשות לשירות ההתאמה של קובצי cookie של Google, ולכן הם לא יקבלו את google_gid לאכלוס טבלת המשחקים שלהם. אחרי ש-Google מוצאת התאמה למשתמש, מגישי הצעות המחיר יכולים להוסיף אותם לרשימות המשתמשים באמצעות נתוני קובצי ה-cookie שלהם. באופן דומה, בקשות להצעות מחיר עבור המשתמשים האלה לא יכללו את מזהה המשתמש של Google, אבל יכללו נתוני התאמה מתארחת. דוגמה פשוטה לתהליך העבודה המתוקן כוללת את השלבים הבאים.
שלב 1: מציבים את תג ההתאמה שמיועד לכתובת ה-URL של התאמת קובצי ה-cookie של מגיש הצעות המחיר
כדי להתחיל בתהליך, מגיש הצעות המחיר צריך להציב תג התאמה כך שהוא יבצע עיבוד בדפדפן של המשתמש. בשונה מזרימת העבודה עבור משתמשים שאינם ממדינה בארה"ב עם הגבלות על פרטיות, תג ההתאמה חייב להפנות את דפדפן המשתמש לכתובת ה-URL שלכם להתאמת קובצי cookie. לדוגמה, אם כתובת ה-URL תואמת לקובצי cookie מוגדרת כך: https://ad.network.com/pixel, היא תיראה כך:
<img src="https://ad.network.com/pixel" />
במהלך הטעינה בדפדפן של המשתמש, הוא מבקש פיקסל מכתובת ה-URL של התאמת מגיש הצעות המחיר לקובצי cookie. בקשה זו תכיל את קובץ ה-cookie שלהם בכותרת ה-HTTP, שיש לחלץ לשלב הבא.
שלב 2: מפנים לשירות של Google להתאמת קובצי cookie
נקודת הקצה של התאמת קובצי ה-cookie של מגיש הצעות המחיר צריכה להפנות לשירות התאמת קובצי ה-cookie של Google, כולל הפרמטר google_hm שמכיל את נתוני קובץ ה-cookie בקידוד base64 שבטוחים לשימוש באינטרנט. כתובת ה-URL של ההפניה לכתובת אחרת עשויה להיראות כך:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA
שלב 3: הדפדפן של המשתמש מופנה מחדש לשירות התאמת קובצי cookie של Google
Google תקבל הפניה לכתובת אחרת שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP.
שלב 4: Google מציגה פיקסלים להצלחה או להפניה אוטומטית אם צוינה כתובת URL של דוח
אם פעולת ההתאמה של קובצי ה-cookie בוצעה בהצלחה, או אם לא צוינה כתובת URL של דוח קובצי cookie בחשבון של מגיש הצעות המחיר, כברירת מחדל Google תציג פיקסל 1x1 שקוף. תהליך העבודה יסתיים כאן.
חשיפות של המשתמש הזה בבקשות להצעות מחיר עתידיות יכללו את נתוני ההתאמה המתארחת של מגיש הצעות המחיר ב-BidRequest.hosted_match_data עבור Protocol של Google, או את BidRequest.user.buyeruid עבור הטמעת OpenRTB של Google. מגישי הצעות המחיר יכולים גם לאכלס את רשימות המשתמשים באמצעות נתוני ההתאמה המתארחת שהם ציינו.
אחרת, אם תתרחש שגיאה, Google תשלח הפניה לכתובת האתר של מגיש הצעת המחיר עבור קובצי cookie, שבה הגורם לשגיאה שצוין בפרמטר google_error. אם כתובת ה-URL של דוח קובצי ה-cookie התואמת של מגיש הצעת המחיר הייתה https://ad.network.com/report, כתובת ה-URL להפניה אוטומטית תיראה כך:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
שלב 5: הדפדפן של המשתמש מפנה לכתובת האתר של דוח קובצי ה-cookie של התאמת הצעות המחיר
הדפדפן של המשתמש יופנה אוטומטית לכתובת ה-URL של דוח ההתאמה לקובצי cookie של מגיש הצעת המחיר, כולל הסיבה לשגיאה (אם יש כזו) שצוינה על ידי Google בפרמטר google_error. למידע נוסף על פירוש קוד השגיאה, קראו את תיאור הפרמטר.
שלב 6: מגיש הצעות המחיר מציג פיקסל שקוף בגודל 1x1
מגיש הצעת המחיר חייב להגיב על ידי הצגת פיקסל שקוף 1x1 לדפדפן של המשתמש.
תרשים של תהליך העבודה להתאמת קובצי cookie עבור משתמשים ממדינות בארה"ב עם הגבלות פרטיות
זרימת העבודה המוגדרת כברירת מחדל עבור משתמשים במדינות בארה"ב עם הגבלות על פרטיות מוצגת בתרשים הבא, שבו בקשות ותגובות מיוצגות על ידי חץ. פריטי הנתונים הנלווים מפורטים בסוגריים.
פרמטרים של כתובת אתר שמפנה למגיש הצעות המחיר מפנה לשירות קובצי cookie של Google להתאמה
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) בחשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה באמצעות המשאב מגישי הצעות מחיר. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר את קובץ ה-cookie של Google עבור המשתמש, אם אינו קיים. המערכת מתעלמת מהערך של הפרמטר ואפשר להשמיט אותו. אם משמיטים את הפרמטר, מתקבלת שגיאה אם אין קובץ cookie. |
google_no_sc |
הפרמטר הזה הוצא משימוש. המשמעות היא לשירות ההתאמה של Google בקובצי cookie, שהוא לא צריך להגדיר קובץ cookie עבור המשתמש אם לא קיים קובץ cookie. המערכת מתעלמת מהערך של הפרמטר ויכול להיות שהוא יושמט. |
google_hm |
מכיל נתונים שמגיש הצעות המחיר רוצה לאחסן בטבלת התאמות שמתארחת ב-Google. |
google_redir |
כתובת URL מקודדת שאתם רוצים ש-Google תשלח הפניה אוטומטית מסוג HTTP 302. כתובת ה-URL שצוינה תקבל הפניות אוטומטיות עם הפרמטר google_error גם לשגיאות וגם לפעולות מוצלחות. |
google_ula |
מחרוזת המשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
פרמטר ה-URL הזה עשוי לחזור על עצמו כדי להוסיף את המשתמש למספר רשימות. |
פרמטרים של כתובת URL להפניה אוטומטית מ-Google לכתובת URL של דוח קובצי cookie שנמצאה בו התאמה למגיש הצעות מחיר
| פרמטר | תיאור |
|---|---|
google_error |
ערך של מספר שלם שמציין את שגיאת הבקשה הכוללת. אם ההודעה תתקבל,
לא יתבצעו פעולות ולא יוגדרו
|
ביוזמת Google: התאמה דו-כיוונית של פיקסלים
התאמת פיקסלים דו-כיוונית היא תהליך עבודה של שירות ההתאמה של קובצי cookie של Google, שבו Google מנסה להתאים מזהה משתמש של Google למגיש הצעות מחיר שנבחר באמצעות אלגוריתם שאינו הזוכה במכירה הפומבית בזמן אמת. כשמציבים מודעה, Google תציב תג התאמה בדפדפן של המשתמש, כדי לטעון פיקסל שקוף מכתובת ה-URL של קובץ ה-cookie התואם של מגיש הצעות המחיר שנבחר. זה יאפשר ל-Google וגם למגיש הצעות המחיר לאכלס משתמש תואם בטבלת משתמשים. הדוגמה הבאה היא של תהליך העבודה הזה.
שלב 1: Google ממקמת תג התאמה
כשדף של בעל תוכן דיגיטלי משתתף נטען בדפדפן של המשתמש, ומשבצת להצגת מודעות בדף הזה ממולאת על ידי Google, ייתכן שיוטמע תג התאמה שמבקש פיקסל ממגיש הצעות מחיר שנבחר באמצעות אלגוריתם. התג Pixel Match של Google, שמשלב את כתובת ה-URL להתאמה של קובצי cookie למגיש הצעות המחיר, כולל פרמטרים נוספים שמשמשים את מגיש הצעות המחיר כדי לאכלס את טבלת ההתאמות שלו. לגבי כתובת URL תואמת לקובצי cookie שמוגדרת כ-https://ad.network.com/pixel, היא בנויה באופן הבא:
<img src="https://ad.network.com/pixel?google_gid=GOOGLE_GID&google_cver=1&google_push=PUSH_DATA" />
שלב 2: מגיש הצעת המחיר חייב להגיב עם הפניה אוטומטית לכתובת ה-URL של שירות התאמת קובצי cookie של Google
מגישי הצעות המחיר המקבלים בקשות להתאמת פיקסלים נדרשים להשיב עם הפניה לשירות ההתאמה של Google עבור קובצי cookie, שנוצר באופן הבא:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
שימו לב שכתובת ה-URL של ההפניה האוטומטית שלמעלה דומה לכתובת ה-URL שנעשה בה שימוש בתג ההתאמה בתהליך העבודה של קובצי cookie שמופעלים על ידי מגיש הצעות המחיר.
ב-Pixel Match, הפרמטר google_cm יוחלף בפרמטר google_push, והערך שלו צריך להיות שווה לערך ש-Google מספקת בבקשה. בדומה לתהליך העבודה ביוזמת מגיש הצעות המחיר, אפשר לציין פרמטרים נוספים כדי למלא תרחישים נוספים לדוגמה.
שלב 3: Google מעבדת את ההפניה האוטומטית ומגיבת עם פיקסל
Google מתעדת את יצירת ההתאמה למשתמש ומטפלת בפעולות נוספות שהתבקשו באמצעות פרמטרים של שאילתות. לבסוף, Google מגיבה עם פיקסל שקוף בגודל 1x1.
תרשים של תהליך העבודה של התאמה ל-Pixel
תהליך העבודה הזה מוצג בתרשים הבא, שבו בקשות ותגובות מיוצגות על ידי חץ ופריטי הנתונים הנלווים מפורטים בסוגריים.
פרמטרים של בקשת תג התאמה של Google
| פרמטר | תיאור |
|---|---|
google_gid |
מזהה משתמש של Google. עבור משתמשים מחוץ למדינה בארה"ב עם הגבלות על פרטיות, זה תמיד יצוין בתג ההתאמה של Google. |
google_cver |
גרסת קובץ ה-cookie. הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_push |
מציין שהבקשה הזו מפעילה את תהליך העבודה של התאמת Pixel. יש להחזיר את הערך דרך הפרמטר המתאים בתגובת ההפניה האוטומטית של מגיש הצעת המחיר. |
פרמטרים להפניה אוטומטית של Pixel שתואם למגיש הצעות המחיר
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) בחשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה באמצעות המשאב מגישי הצעות מחיר. |
google_push |
מציין שההפניה האוטומטית הזו משלימה את תהליך העבודה של התאמת Pixel. יש לציין כאן את הערך של תג ההתאמה התואם של Google. |
google_hm |
מכיל נתונים שמגיש הצעות המחיר רוצה לאחסן בטבלת התאמות שמתארחת ב-Google. |
google_ula |
מחרוזת המשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
פרמטר ה-URL הזה עשוי לחזור על עצמו כדי להוסיף את המשתמש למספר רשימות. |
ביוזמת Google: התאמה חד-כיוונית של פיקסלים
ההתאמה החד-כיוונית של פיקסלים שונה מתהליך העבודה הדו-כיווני, מאחר שתג ההתאמה של Google לא כולל פרמטר שמציין את מזהה המשתמש של Google, אבל הוא ימשיך לאכלס טבלת התאמה שמתארחת ב-Google. תוכלו להשתמש באפשרות הזו במקרים שבהם מגיש הצעות המחיר לא מורשה לארח מזהי משתמשים של Google בטבלת ההתאמות שלו. דוגמה פשוטה לתהליך העבודה המתוקן כוללת את השלבים הבאים:
שלב 1: Google ממקמת תג התאמה
Google מציבה תג התאמה עבור מגיש הצעות מחיר שנבחר באמצעות אלגוריתם. תג ההתאמה כולל את הפרמטר
google_push. לדוגמה:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
שלב 2: דפדפן המשתמש מבקש פיקסל מכתובת ה-URL התואמת של מגיש הצעת המחיר
הדפדפן של המשתמש מבקש פיקסל מכתובת ה-URL התואמת לקובצי ה-cookie של מגיש הצעת המחיר, כולל קובץ ה-cookie של מגיש הצעת המחיר בכותרות ה-HTTP.
שלב 3: הפניה אוטומטית לשירות התאמת קובצי cookie של Google
נקודת הקצה של התאמת קובצי ה-cookie של מגיש הצעות המחיר צריכה להפנות לשירות התאמת קובצי ה-cookie של Google, כולל הפרמטר google_hm שמכיל את נתוני קובץ ה-cookie בקידוד base64 שבטוחים לשימוש באינטרנט. כתובת ה-URL של ההפניה לכתובת אחרת עשויה להיראות כך:
https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_hm=HOSTED_MATCH_DATA&google_push=PUSH_DATA
שלב 4: הדפדפן של המשתמש מופנה לשירות התאמת קובצי cookie של Google
Google תקבל הפניה לכתובת אחרת שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP. אם הפעולה הצליחה, החשיפות של המשתמש הזה בבקשות הבאות להצעות מחיר יכללו את נתוני ההתאמה המתארחת של מגיש הצעת המחיר ב-BidRequest.hosted_match_data עבור פרוטוקול Google או BidRequest.user.buyeruid עבור ההטמעה של OpenRTB של Google. מגישי הצעות המחיר יכולים גם לאכלס את רשימות המשתמשים באמצעות נתוני ההתאמה המתארחת שהם ציינו.
לבסוף, Google מחזירה פיקסל שקוף בגודל 1x1 לדפדפן של המשתמש.
סיוע לקובצי cookie
Open Bidding מאפשרת לבורסות להשתמש במגיש הצעות המחיר וביוזמת Google לקובצי cookie התואמים של Google, כדי להתאים מזהה משתמש של Google לקובץ ה-cookie שלה. Assistance Match Assist (CMA) הוא תכונה נוספת בבורסות שמאפשרת להן ליצור טבלאות התאמה עם מגישי הצעות המחיר שלהן.
איך פועל הכלי Cookie Match Assist
כשאתם מציבים מודעה, Google בוחרת באמצעות אלגוריתם חילופי מודעות ומוסיפה את התג 'Cookie Match Assist' במבנה הבא:
<img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>
תג ההתאמה של CMA של Google גורם לשליחת בקשה לפיקסל לכתובת ה-URL של קובץ ה-cookie של התאמת ה-Exchange.
- נקודת הקצה של קובצי ה-cookie של Exchange מקבלת את הבקשה. שירות ההתאמה של קובצי ה-cookie שלה אחראי להתאמת מזהה המשתמש לאחד ממגישי הצעות המחיר. בתרשים הבא, שירות ההתאמה של קובצי cookie של בורסה מגיב לדפדפן של המשתמש עם הפניה אוטומטית לאחת מנקודות הקצה של מגיש הצעת המחיר.
- מגיש הצעות המחיר מקבל את הבקשה, יחד עם כל הפרמטרים שצוינו על ידי ה-Exchange כדי להתאים את ה-User-ID לקובץ ה-Cookie שלו.
ההגבלות
הגבלת תדירות הבקשות למשחקים חדשים
מגישי הצעות המחיר אחראים להגביל את מספר השיחות לשירות קובצי cookie של התאמות למשתמשים שיש להם רשומה חדשה בטבלת ההתאמה שמתארחת ב-Google. התוקף של ערך בטבלת ההתאמה המתארחת עשוי לפוג אחרי 14 יום, ולאחר מכן לרענן אותו.
תגובה לכל בקשות ההתאמה לפיקסלים
מגישי הצעות מחיר המשתמשים בתהליך העבודה של Pixel Match צפויים להגיב לכל הבקשות הנכנסות ל-Pixel Match עם תגובה, כולל הפרמטר google_push. כך Google יכולה לאכוף מדיניות על ידי מעקב אחר השימוש. אם שיעור התגובה של מגיש הצעות המחיר יורד מתחת ל-90%, Google תוסתר את מספר הבקשות ל-Pixel Match שיישלחו לחשבון שלו.
שימוש בנקודות קצה מסוג HTTPS
נקודות הקצה (endpoints) המשמשות בכל תהליכי העבודה של התאמה לקובצי cookie הן באמצעות HTTPS.
כששולחים בקשה ל-Pixel Match שנשלחה אליכם באמצעות HTTPS, עליכם להפנות את המשתמשים לשירות ההתאמה של קובצי cookie ב-HTTPS. באופן דומה, גם נקודת קצה של קובצי cookie של Assistant המפנה אוטומטית למגישי הצעות המחיר צריכה להשתמש ב-HTTPS. אם תשלחו ל-Google בקשות לעתים קרובות יותר מפעם ב-2 דקות, מספר בקשות ההתאמה שנשלחות לחשבון יווסת.
דוגמאות
הדוגמאות הבאות ממחישות כיצד להשתמש בשירות של התאמת קובצי cookie כדי להשיג יעדים ספציפיים. שימו לב: אלא אם צוין אחרת, סביר להניח שהמשתמש שנמצא בפעולה לא נמצא במדינה אמריקאית שיש לה מגבלות פרטיות.
לאכלס טבלת התאמה שמתארחת במגיש הצעות המחיר
מגיש הצעות המחיר יכול להשתמש בתהליך העבודה של התאמת קובצי cookie כדי לאכלס את טבלת ההתאמה שלו, על ידי הצגת הפרמטרים google_nid ו-google_cm בלבד בתג ההתאמה שלו. הפרטים עשויים להיראות כך:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_cm" />
אם כתובת ה-URL להתאמת קובצי cookie של מגיש הצעת המחיר היא https://ad.network.com/pixel?id=1, ופעולת ההתאמה של קובצי ה-cookie בוצעה בהצלחה, ההפניה האוטומטית ש-Google שולחת בתגובה לתג ההתאמה של מגיש הצעות המחיר עשויה להיראות כך:
https://ad.network.com/pixel?id=1&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
אם פעולת ההתאמה של קובצי ה-cookie נכשלה, כי למשתמש אין קובץ cookie של Google, התגובה תהיה:
https://ad.network.com/pixel?id=1&google_error=3
קוד השגיאה תלוי בסיבה לשגיאה. למידע נוסף על קודי שגיאה אפשריים בתהליך העבודה של התאמת קובצי cookie, ראו פרמטרים של כתובות אתרים להפניה מחדש.
הוספה לרשימת משתמשים יחידה
אפשר להוסיף את הפרמטר google_ula לתג ההתאמה של מגיש הצעת המחיר, כדי להוסיף את המשתמש לרשימת המשתמשים עם המזהה הנתון. אם טבלת המשתמשים ב-Google או באירוח הצעות המחיר כוללת רשומה חדשה עבור המשתמש, מגיש הצעות המחיר יכול להציב תג התאמה כולל הפרמטרים google_nid ו-google_ula כדי להוסיף את המשתמש לרשימה שצוינה, בלי להפעיל את תהליך העבודה המלא להתאמת קובצי cookie. להצגת מגבלות נוספות על הפעלת שירות ההתאמה של קובצי cookie, תוכלו לקרוא על עיכובים נוספים. תג ההתאמה המתאים עשוי להיראות כך:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345" />
במקרה של תגובה מוצלחת, כשכתובת ה-URL להתאמה לקובצי cookie של מגיש הצעת המחיר היא
https://ad.network.com/pixel, כתובת ה-URL להפניה אוטומטית של Google תהיה:
https://ad.network.com/pixel?google_ula=12345,0
אם יש שגיאה כללית – לדוגמה, אם אין למשתמש קובץ cookie של Google – כתובת ה-URL להפניה אוטומטית תכלול את הפרמטר google_error:
https://ad.network.com/pixel?google_error=3
אם יש שגיאה ספציפית בהוספת המשתמש לרשימה, תקבלו את google_ula בהפניה האוטומטית. בשונה מהפרמטר המתאים של תג ההתאמה, הוא מחליף את חותמת הזמן בקוד סטטוס שמציין את הצלחת הפעולה. לדוגמה, אם הבקשה נכשלה כי לחשבון של מגיש הצעות המחיר לא הייתה גישה לרשימת המשתמשים שצוינה, כתובת ה-URL להפניה אוטומטית תהיה:
https://ad.network.com/pixel?google_ula=12345,2
הוספה לרשימות משתמשים מרובות
מגישי הצעות המחיר יכולים לציין שכדי להוסיף משתמשים לרשימות משתמשים מרובות, הם צריכים לכלול כמה פרמטרים מסוג google_ula בתג ההתאמה. בפועל, זה עשוי להיראות כך:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345,7654321&google_ula=45678" />
בדומה לכך, הסטטוס של הפעולה עבור כל רשימת משתמשים מדווח באופן דומה באמצעות פרמטרים נפרדים של google_ula בהפניה לכתובת אחרת:
https://ad.network.com/pixel?google_ula=12345,2&google_ula=45678,0
בהפניה האוטומטית שלמעלה, אנחנו רואים שהפעולה של רשימת המשתמשים עם המזהה 45678 נכשלה, אבל מזהה רשימת המשתמשים 12345 נכשל, כי למגיש הצעות המחיר אין הרשאה לגשת אליו.
מדריך מפורט בנושא התאמה לקובצי cookie והוספה לרשימת המשתמשים
כדי לבצע התאמה של קובצי cookie ולהוסיף את המשתמש לרשימת משתמשים בבקשה אחת, תג ההתאמה של מגיש הצעת המחיר צריך לכלול את הפרמטרים google_cm ו-google_ula:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=ad_network_xyz&google_ula=12345&google_cm" />
כתובת ה-URL להפניה אוטומטית שצוינה על ידי Google תכלול את google_gid, google_cver ואת google_ula. כך זה יכול להיראות:
https://ad.network.com/pixel?id=&google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1&google_ula=12345,0
אחסון התאמה בטבלת התאמות שמתארחת ב-Google
אם מגיש הצעות המחיר רוצה לאחסן את נתוני קובצי ה-cookie שלו בטבלת התאמות שמתארחת ב-Google, והוא לא מתכוון לאחסן את ההתאמה עם ה-User-ID בטבלת ההתאמה שלו, תג ההתאמה שלו חייב לכלול את הפרמטר google_hm, שבו הערך שלו חייב להיות מחרוזת מקודדת בטוחה מסוג web64 לאינטרנט. עבור משתמש שבו נתוני קובץ ה-cookie שאינו מקודד של מגיש הצעות המחיר הוא Cookie number 1!, הערך המוצפן יהיה Q29va2llIG51bWJlciAxIQ==, ויש להשתמש בו בתג התאמה כמו בדוגמה הבאה:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D" />
במקרה של תגובה מוצלחת, כשכתובת ה-URL להתאמת קובצי cookie של מגיש הצעת המחיר היא https://cookie-monster.com/pixel, כתובת ה-URL להפניה אוטומטית של Google תהיה:
https://cookie-monster.com/pixel
הפרמטר google_gid לא נמצא בהפניה לכתובת אחרת, כי תג ההתאמה לא כלל את google_cm. הערך google_hm לא נכלל בתגובות המוצלחות. בבקשות עתידיות להצעות מחיר עבור החשיפות של המשתמש הזה, מגיש הצעות המחיר יקבל את נתוני ההתאמה המתארחים ב-BidRequest.hosted_match_data עבור פרוטוקול RTB של Google, או BidRequest.user.buyeruid בגין הטמעת OpenRTB של Google.
אם מגיש הצעות המחיר השתמש במקום זאת בתג התאמה, כאשר הערך של google_hm לא היה בקידוד base64 – למשל chocolate_chunk! – כתובת ה-URL להפניה אוטומטית עשויה להיראות כך:
https://cookie-monster.com/pixel?google_hm=2
כתובת ה-URL להפניה אוטומטית שלמעלה כוללת ערך google_hm של 2, שמציין שהפעולה נכשלה כי לא ניתן לפענח את הערך.
טבלאות של התאמות הצעות מחיר ו-Google מתארחות עם רשימות משתמשים
אם מגיש הצעות המחיר מארח את רשימת השימוש שלו בנוסף לרשימת המשתמשים המתארחת ב-Google, ורוצה שתג התאמה יחיד יתאים לשתי הטבלאות ויוסיף את המשתמש לרשימת משתמשים נתונה, תג ההתאמה שלו חייב לכלול את הפרמטרים google_cm, google_hm ו-google_ula. אם נתוני קובצי ה-cookie של מגיש הצעות המחיר הם Cookie number 1!, הערך המקודד יהיה Q29va2llIG51bWJlciAxIQ==, שייצור תג התאמה כמו:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=cookie-monster&google_hm=Q29va2llIG51bWJlciAxIQ%3D%3D&google_cm&google_ula=12345" />
כדי לזרז את הטיפול בבקשה, כאשר כתובת ה-URL להתאמת קובצי cookie של מגיש הצעות המחיר היא
https://cookie-monster.com/pixel, כתובת ה-URL להפניה אוטומטית של Google תיראה כך:
https://cookie-monster.com/pixel?google_gid=ABCDETC&google_cver=1&google_ula=12345,0
עם קבלת ההפניה האוטומטית, מגיש הצעות המחיר יכול להתאים למזהה המשתמש של Google שצוין ב-google_gid עם נתוני קובץ ה-cookie בטבלת ההתאמות שלו. בנוסף, הם יכולים לקבוע שפעולות טבלת הרשימות ורשימות המשתמשים שמתארחות ב-Google בוצעו בהצלחה. כתוצאה מכך, כל טירגוט מראש שהוגדר למגיש הצעות המחיר שמבוסס על המזהה של רשימת המשתמשים שצוינה יגרום לכך שמגיש הצעות המחיר יקבל בקשות להצעות מחיר על חשיפות מהמשתמש. כמו כן, בבקשות להצעות המחיר האלה, מגיש הצעות המחיר יקבל את נתוני ההתאמה המתארחים ב-BidRequest.hosted_match_data עבור פרוטוקול RTB של Google, או BidRequest.user.buyeruid בגין הטמעת OpenRTB של Google.