'התאמה של קובצי cookie' היא תכונה שמאפשרת להתאים את קובץ ה-cookie — לדוגמה, מזהה של משתמש שגלש באתר שלך — ל-User ID תואם ב-Google ייחודי של מגיש הצעות מחיר, וליצור רשימות משתמשים שיכולות לעזור לך לקבל החלטות יעילות יותר למתן הצעות מחיר. במדריך הזה מתוארים המושגים המשמשים להתאמת קובצי cookie, תהליכי עבודה שונים של התאמות של קובצי cookie, וכן גרסאות שונות של תרחישי שימוש מסוימים.
מושגים
מהי התאמות של קובצי cookie?
בדרך כלל בעלי דומיינים מגדירים את התוכן של קובצי ה-cookie למשתמשים שגולשים באתר שלהם. התכנים האלה משמשים לזיהוי משתמשים בדומיין. גם אם שני בעלי דומיינים יסכימו להחליף את הנתונים האלה, מודל האבטחה של דפדפני האינטרנט מגביל את הקריאה של קובץ cookie שהוגדר על ידי דומיין אחר, גם אם שני בעלי דומיינים יסכימו ביניהם.
בהקשר של פרסום בדיגיטל, Google מזהה משתמשים באמצעות קובצי cookie ששייכים לדומיין doubleclick.net, ולמגישי הצעות המחיר שמשתתפים בבידינג בזמן אמת יכול להיות דומיין משלהם שבו הם מזהים קבוצה מסוימת של משתמשים ברצונם להציג מודעות. התאמות באמצעות קובצי cookie מאפשרות למגיש הצעות המחיר להתאים את קובצי ה-cookie שלו לקבצים של Google, כדי שיוכל לקבוע אם חשיפה שנשלחה בבקשה להצעת מחיר משויכת לאחד מהמשתמשים שאליהם מתבצע טירגוט. במקרה כזה, הוא יקבל את נתוני קובצי ה-cookie שלו או מזהה משתמש Google ספציפי של מגיש הצעות המחיר, שהוא צורה מוצפנת של קובץ ה-cookie doubleclick.net בבקשה להצעת המחיר.
שירות ההתאמה של קובצי cookie המתואר במדריך הזה מאפשר ליצור ולתחזק את השיוך בין קובץ ה-cookie של מגיש הצעות מחיר ל-User-ID של Google, ומאפשר גם לאכלס רשימות משתמשים.
טבלאות של התאמות
ניתן להשתמש בטבלת התאמות כדי למפות מזהה או נתונים אחרים מדומיין אחד לדומיין אחר. מגישי הצעות מחיר יכולים להשתמש בשירות התאמת קובצי cookie כדי לאכלס טבלאות התאמה משלהם על ידי מיפוי קובץ ה-cookie שלהם עבור משתמש מסוים למזהה המשתמש של המשתמש ב-Google, או כדי לאכלס טבלת התאמות ש-Google מארחת. אפליקציית הצעות המחיר של מגיש הצעות המחיר זקוקה לטבלאות התאמות, כדי לקבל גישה לנתוני קובצי ה-cookie של המשתמש שקיבל את החשיפה.
טבלאות התאמות ב-Google
כדי להקל על התחזוקה, לשפר את זמן האחזור ולצורך גישה לנתוני התאמה של משתמשים באזורים מסוימים, מומלץ לאפשר ל-Google לארח את טבלת ההתאמות. כך תוכלו לציין מחרוזת בקידוד base64 ב-web, שנקראת להלן נתוני התאמה מתארחים, שתמופה ל-Google User ID של משתמש נתון. אחרי שיוצרים התאמה, אפשר להשתמש בה בדרכים הבאות:
בידינג בזמן אמת: בבקשות הבאות להצעות מחיר על חשיפות שמשויכות למשתמש, 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 ופעולות קשורות אחרות.
- Cookie matching URL: כתובת ה-URL הבסיסית של נקודת קצה (endpoint) שתקבל בקשות נכנסות ותטפל בהן במסגרת תהליכי העבודה של התאמות קובצי Cookie. מגישי הצעות המחיר יכולים להטמיע פקודות מאקרו בכתובת ה-URL הזו כדי לשלוט בסדר הפרמטרים שמועברים אליה בתהליכי העבודה של התאמות קובצי cookie.
- תג התאמה: התג שצריך להציב בדפדפן של המשתמש בתהליך העבודה של התאמת קובצי cookie ביוזמת מגיש הצעות המחיר. ניתן להציג אותו לצד מודעות, או למקם אותו בנכסי אינטרנט מחוץ למודעות.
- כתובת URL של דוח התאמות של קובצי Cookie (אופציונלי): בתהליך העבודה החד-כיווני של התאמות קובצי Cookie, זו כתובת URL אופציונלית שניתן לספק כדי לציין נקודת קצה (endpoint) שתקבל פרטי שגיאה במקרה שהתאמת קובץ ה-cookie נכשלה באמצעות הפניה אוטומטית מסוג HTTP 302. כברירת מחדל, תגובות יישלחו לכתובת ה-URL הזו רק אם הייתה שגיאה בפעולת ההתאמה של קובצי cookie, אבל מגיש הצעות המחיר עשוי לבקש שההפניה האוטומטית תישלח תמיד.
- Cookie Match Assist URL: זוהי כתובת ה-URL הבסיסית של נקודת הקצה שמיועדת להגיב לבקשות נכנסות, עבור ערוצי Exchange שמטמיעים את תהליך העבודה של Cookie Match Assist.
- מכסת קובצי cookie Match Assist: להמרות שמטמיעים את תהליך העבודה של Cookie Match Assist, זהו המספר המקסימלי של בקשות שכתובת ה-URL התואמת לקובץ ה-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 בסדר הבא: google_push, google_gid, google_cver ו-google_error. מגיש הצעות המחיר יכול להשיג זאת על ידי הגדרת כתובת האתר המתאימה של קובצי ה-cookie ל:
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: מציבים את תג ההתאמה
כדי להתחיל בתהליך הזה, מגיש הצעות המחיר צריך להציב את תג ההתאמה שלו כך שהוא יוצג בדפדפן של המשתמש. המבנה של תג התאמה פשוט שמחזיר למגיש הצעות המחיר רק את ה-User-ID של 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 ואת מספר הגרסה שלו בכתובת ה-URL, ומגיש הצעות המחיר יקבל גם את קובץ ה-cookie שלו שכלול בכותרות של הבקשות. בפועל, לגבי כתובת URL שתואמת לקובץ cookie שצוינה כ-https://ad.network.com/pixel, כתובת ה-URL להפניה אוטומטית של תג ההתאמה הפשוט, כפי שמתואר למעלה, עשויה להיראות כך:
https://ad.network.com/pixel?google_gid=dGhpcyBpcyBhbiBleGFtGxl&google_cver=1
ה-Google User ID שמועבר דרך הפרמטר google_gid הוא מחרוזת בקידוד base64 ללא תוספות. למגישי הצעות מחיר שבוחרים לארח טבלת התאמות, מומלץ
לאחסן את המחרוזת המדויקת שהוחזרה על ידי שירות ההתאמה של קובצי Cookie. בבקשות הבאות להצעות מחיר, הערך יהיה תואם לערכים שצוינו דרך BidRequest.google_user_id בפרוטוקול ה-RTB של Google או BidRequest.user.id בהטמעת OpenRTB של Google.
הגרסה שצוינה ב-google_cver מציינת את מספר הגרסה המספרי של ה-Google User ID. ה-Google User ID של משתמש מסוים ישתנה לעתים רחוקות, ולאחר מכן הערך הזה יוגדל.
אם Google נתקלת בשגיאה במהלך העיבוד של בקשת ההתאמה, במקום זאת יצויין הפרמטר google_error.
שלב 3: מגיש הצעות המחיר מבצע הפניה אוטומטית ומגיב בפיקסל
מגיש הצעות המחיר מקבל הפניה אוטומטית לכתובת ה-URL התואמת של קובצי ה-cookie, כולל פרמטרים שהוא ציין בשלב הראשון ופרמטרים ש-Google סיפקה בשלב השני. בנוסף, הם יקבלו גם את קובץ ה-cookie שלהם בכותרות HTTP. אם הפעולה בוצעה בהצלחה, מגיש הצעות מחיר שמארח טבלת התאמות משלו יכול להתאים את קובץ ה-cookie שלו למזהה המשתמש ב-Google שכלול בתגובה. מומלץ למגישי הצעות המחיר לשמור את המחרוזת המדויקת שהוחזרה על-ידי שירות ההתאמות של קובצי Cookie.
אם הפעולה נכשלה, מגיש הצעות המחיר יקבל את הפרמטר google_error בהפניה האוטומטית. זהו ערך מספרי שתואם למצבי שגיאה שונים שמזהים את השגיאה המסוימת שאירעה. כאן אפשר לקרוא מידע נוסף על ערכי השגיאות האפשריים.
אם תקבלו שגיאה, תוכלו לנסות להתאים את המשתמש הזה שוב על ידי הוספת תג התאמה חדש.
מגיש הצעות המחיר חייב תמיד להגיב באמצעות הצגת תמונת פיקסל בלתי נראית בגודל 1x1, או
להחזיר את התשובה HTTP 204 ללא תוכן.
תרשים של זרימת עבודה של התאמות קובצי Cookie
תהליך העבודה הזה מנוסח בתרשים הבא, שבו בקשות ותגובות מיוצגות על ידי חץ, ופריטי הנתונים שמתלווים אליהן מפורטים בסוגריים.
פרמטרים של כתובת אתר של תג התאמה
| פרמטר | התיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של החשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה דרך המשאב Bidders. |
google_cm |
מציין לשירות התאמת קובצי cookie של Google שעליו לבצע התאמה של קובצי cookie. המערכת תתעלם מהערך של הפרמטר וייתכן שהוא יושמט. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר את קובץ ה-cookie של Google עבור המשתמש, אם לא קיים קובץ כזה. המערכת תתעלם מהערך של הפרמטר וייתכן שהוא יושמט. השמטת הפרמטר תוביל לשגיאה אם לא קיים קובץ Cookie. |
google_no_sc |
הפרמטר הזה הוצא משימוש. אות זה מסמן לשירות התאמת קובצי cookie של Google שאין להגדיר קובץ cookie עבור המשתמש, אם לא קיים קובץ כזה. המערכת תתעלם מהערך של הפרמטר וייתכן שהוא יושמט. |
google_hm |
נתונים שמגיש הצעות המחיר רוצה לשמור בטבלת התאמות באירוח Google.
הערך הוא מחרוזת בקידוד base64 שבטוח לשימוש באינטרנט (אופציונלי). הגודל של הנתונים הגולמיים צריך להיות עד 40 בייטים. לדוגמה, |
google_redir |
מחרוזת מקודדת של כתובת URL שמגיש הצעות המחיר יכול לציין אם הוא רוצה
ש-Google תשלח את ההפניה האוטומטית HTTP 302 לכתובת ה-URL המקודדת של
תג ההתאמה הזה. כך Google יכולה להיות ממוקמת בחזית שיחה
בשרשור לשותפים. התוצאה תהיה שגיאה אם היא תצוין בלי
google_hm או עם google_cm. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של
הערך הוא userlistid[,timestamp]:
הפרמטר הזה של כתובת האתר עשוי לחזור על עצמו כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
מציין שהבקשה כפופה להגבלות GDPR על שימוש
בנתונים. לקבלת פרטים נוספים, אפשר לעיין בקטע
הדרישות להסכמת משתמשים באיחוד האירופי שבהמשך או במאמר ההשפעה על הזכאות להתאמה של קובצי cookie
במסמכי התיעוד של TCF גרסה 2.0 של Authorized Buyers של IAB.
לדוגמה: |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את הסכמת משתמש הקצה. לקבלת פרטים נוספים, אפשר לעיין בקטע הדרישות בנושא הסכמת משתמשים באיחוד האירופי בהמשך, או את המאמר איך נעביר את נתוני השקיפות וההסכמה? במסמכי התיעוד של Authorized Buyers של IAB TCF בגרסה 2.0. |
process_consent |
מציין שמגיש הצעות המחיר קיבל הסכמה ממשתמשי הקצה לשימוש בנתונים המפורטים
במדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש
פרמטרים נוספים של הסכמה לגבי הבקשה
( לדוגמה: |
בנוסף לפרמטרים שמפורטים למעלה, מגישי הצעות המחיר יכולים לציין הגדרות משלהם, והם יצורפו כפרמטרים לכתובת ה-URL להפניה אוטומטית. חשוב לדעת: המערכת של Google תתעלם מפרמטרים שהוגדרו על ידי מגיש הצעות המחיר ומשויכים לקידומת 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.
הנה תיאור של התהליך:
- חברת ExampleNews.com מעבדת מודעות ומתקשרת אליהן מ-Google (Ad Manager).
- מאחר שיחידת המודעות כשירה להקצאה דינמית, Google שולחת בקשות להצעות מחיר ל-FinestDSP ולמגישי הצעות מחיר אחרים דרך השירות 'בידינג בזמן אמת'.
- אפליקציית מגיש הצעות המחיר של FinestDSP מקבלת, מעבדת את הבקשה להצעת מחיר ושולחת אותה.
- Google מקבלת תגובות להצעות מחיר ממגישי הצעות המחיר, כולל התגובה של FinestDSP שמציינת מודעה עם תג התאמה (פיקסל).
- FinestDSP זוכה במכרז. Google מציגה את המודעה של FinestDSP ומתאימה את התג לג'יין.
- תג ההתאמה מפעיל את השירות Cookie Match של Google, ומציין את הפרמטרים
google_nidו-google_cm. - שירות ההתאמה של קובצי cookie קורא את קובץ ה-cookie של Google של דנה, ושולח לדפדפן של ג'יין הפניה אוטומטית לכתובת ה-URL של FinestDSP שתואמת לקובצי cookie, שבה הוגדרו הפרמטרים
google_user_idו-google_cver. - הדפדפן של ג'יין טוען את ההפניה האוטומטית לכתובת ה-URL של התאמת קובצי cookie של FinestDSP.
- נקודת הקצה (endpoint) של התאמה לקובצי Cookie של FinestDSP מעבדת את בקשת ההפניה האוטומטית,
שכוללת פרמטרים של כתובת אתר שהוגדרו על ידי Google ואת קובץ ה-cookie שלהם עבור ג'יין בכותרות ה-HTTP. עכשיו אפשר לשמור את המיפוי של קובץ ה-cookie בקובץ
google_user_idבטבלת ההתאמות של FinestDSP. - FinestDSP מגיב להפניה אוטומטית באמצעות פיקסל 1x1 בלתי נראה.
תרחיש 2: משתמש עם מיפוי קיים
שבוע אחרי תרחיש 1, דנה מבקרת שוב ב-ExampleNews.com. עכשיו, כשג'יין יצרה במחשב שלהם גם קובצי cookie של מגיש הצעות מחיר וגם של Ad Manager, כך פועלת ההתאמה.
- דף האינטרנט עובר עיבוד, וכתוצאה מכך Google (Ad Manager) מבקשת מודעות שיוצגו בדף.
- במהלך המכרז של המודעות, Google שולחת בקשה להצעת מחיר למגישי הצעות המחיר הרלוונטיים, כולל FinestDSP.
- FinestDSP מקבל את הבקשה להצעת מחיר, כולל אותות כמו
google_user_id. - מערכת FinestDSP מחפשת את
google_user_idבטבלת ההתאמות שלה, ומאתרת את קובץ ה-cookie המשויך לג'יין שנוצרה שבוע לפני כן (בתרחיש 1). - על סמך מידע שמשויך לקובץ ה-cookie, לוגיקת הבידינג של FinestDSP מגדירה הצעת מחיר על החשיפה וזוכה במכרז.
- ג'יין עשויה לראות מודעה מותאמת לתחומי העניין שלהם, על סמך מידע שנמצא ברשות FinestDSP.
ביוזמת מגיש הצעות המחיר: התאמה חד-כיוונית של קובצי 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: הפניה מחדש לשירות התאמת קובצי 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
שלב 3: הדפדפן של המשתמש מופנה מחדש לשירות התאמת קובצי ה-cookie של Google
Google תקבל הפניה אוטומטית שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP.
שלב 4: Google מציגה פיקסל בהפניה אוטומטית מוצלחת או שגיאה אם כתובת ה-URL של הדוח צוינה
אם פעולת ההתאמה של קובצי ה-cookie הסתיימה בהצלחה, או אם לא צוינה כתובת URL של דוח התאמות של קובצי Cookie לחשבון של מגיש הצעות המחיר, Google תציג פיקסל שקוף בגודל 1x1 כברירת מחדל ותהליך העבודה יסתיים כאן.
החשיפות של המשתמש הזה בבקשות הבאות להצעות מחיר יכללו את נתוני ההתאמה המתארחים של מגיש הצעות המחיר ב-BidRequest.hosted_match_data בפרוטוקול של Google או BidRequest.user.buyeruid בהטמעת OpenRTB של Google. מגישי הצעות המחיר יכולים גם לאכלס רשימות משתמשים באמצעות נתוני ההתאמה המתארחים שהם ציינו.
אחרת, אם אירעה שגיאה, Google תשלח הפניה אוטומטית לכתובת ה-URL של דוח ההתאמה לקובץ ה-cookie של מגיש הצעות המחיר, עם סיבת השגיאה בפרמטר google_error. אם כתובת ה-URL של דוח ההתאמה לקובצי cookie של מגיש הצעות המחיר הייתה https://ad.network.com/report, כתובת ה-URL להפניה אוטומטית תיראה כך:
<img src="https://ad.network.com/report?google_error=ERROR_ID" />
שלב 5: הדפדפן של המשתמש מפנה אוטומטית לכתובת ה-URL של דוח ההתאמה לקובץ ה-cookie של מגיש הצעות המחיר
הדפדפן של המשתמש יפנה את מגיש הצעות המחיר לכתובת ה-URL של דוח ההתאמה לקובץ ה-cookie, כולל סיבת השגיאה (אם קיימת) ש-Google ציינה בפרמטר google_error. למידע נוסף על פירוש קוד השגיאה, עיינו בתיאור הפרמטר.
שלב 6: מגיש הצעות המחיר מציג פיקסל שקוף בגודל 1x1
מגיש הצעות המחיר חייב להגיב לדפדפן של המשתמש על ידי הצגת פיקסל שקוף בגודל 1x1.
תרשים של תהליך העבודה להתאמת קובצי cookie למשתמשים ממדינות בארה"ב עם הגבלות על פרטיות
תהליך ברירת המחדל של משתמשים במדינות בארה"ב עם הגבלות על פרטיות מתואר בתרשים שבהמשך, שבו חץ מיוצג על ידי בקשות ותשובות, ופריטי הנתונים שמתלווים אליהם מפורטים בסוגריים.
פרמטרים של כתובת אתר להפניה מחדש של מגיש הצעות המחיר לשירות התאמת קובצי cookie של Google
| פרמטר | התיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של החשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה דרך המשאב Bidders. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר את קובץ ה-cookie של Google עבור המשתמש, אם לא קיים קובץ כזה. המערכת תתעלם מהערך של הפרמטר וייתכן שהוא יושמט. השמטת הפרמטר תוביל לשגיאה אם לא קיים קובץ Cookie. |
google_no_sc |
הפרמטר הזה הוצא משימוש. אות זה מסמן לשירות התאמת קובצי cookie של Google שאין להגדיר קובץ cookie עבור המשתמש, אם לא קיים קובץ כזה. המערכת תתעלם מהערך של הפרמטר וייתכן שהוא יושמט. |
google_hm |
מכילה נתונים שמגיש הצעות המחיר רוצה לשמור בטבלת התאמות שמתארחת ב-Google. |
google_redir |
כתובת URL מקודדת שאתם רוצים ש-Google תשלח לכתובת אחרת מסוג HTTP 302. כתובת ה-URL
שצוינה תקבל הפניות אוטומטיות עם הפרמטר google_error
גם לשגיאות וגם לפעולות מוצלחות. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של
הערך הוא userlistid[,timestamp]:
הפרמטר הזה של כתובת האתר עשוי לחזור על עצמו כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
מציין שהבקשה כפופה להגבלות GDPR על שימוש
בנתונים. לקבלת פרטים נוספים, אפשר לעיין בקטע
הדרישות להסכמת משתמשים באיחוד האירופי שבהמשך או במאמר ההשפעה על הזכאות להתאמה של קובצי cookie
במסמכי התיעוד של TCF גרסה 2.0 של Authorized Buyers של IAB.
לדוגמה: |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את הסכמת משתמש הקצה. לקבלת פרטים נוספים, אפשר לעיין בקטע הדרישות בנושא הסכמת משתמשים באיחוד האירופי בהמשך, או את המאמר איך נעביר את נתוני השקיפות וההסכמה? במסמכי התיעוד של Authorized Buyers של IAB TCF בגרסה 2.0. |
process_consent |
מציין שמגיש הצעות המחיר קיבל הסכמה ממשתמשי הקצה לשימוש בנתונים המפורטים
במדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש
פרמטרים נוספים של הסכמה לגבי הבקשה
( לדוגמה: |
פרמטרים של כתובת אתר ש-Google מפנה אותם לכתובת ה-URL של דוח ההתאמה לקובץ ה-cookie של מגיש הצעות המחיר
| פרמטר | התיאור |
|---|---|
google_error |
ערך של מספר שלם המציין את שגיאת הבקשה הכוללת. כשהוא
מתקבל, המשמעות היא שלא בוצעו
פעולות, ולא יוגדרו
פרמטרים אחרים של תגובות מסוג
|
ביוזמת Google: התאמה דו-כיוונית של פיקסלים
התאמה דו-כיוונית של פיקסלים היא תהליך עבודה לשירות התאמת קובצי cookie של Google, שבו Google מנסה להתאים מזהה משתמש של Google למגיש הצעות מחיר שנבחר באמצעות אלגוריתם, שאינו זוכה במכרז הבידינג בזמן אמת. כשמציבים מודעה, Google תציב תג התאמה שיפנה את הדפדפן של המשתמש לטעון פיקסל שקוף מכתובת ה-URL התואמת לקובץ ה-cookie של מגיש הצעות המחיר שנבחר. כך גם Google וגם מגיש הצעות המחיר יוכלו לאכלס טבלת התאמות במשתמש נתון. לפניכם דוגמה פשוטה לתהליך העבודה הזה.
שלב 1: Google ממקמת תג התאמה
כשדף של בעל התוכן הדיגיטלי המשתתף בתוכנית נטען בדפדפן של המשתמש, ומשבצת מודעה בדף הזה ממולאת על ידי Google, ניתן להציב תג התאמה
שתבקש פיקסל ממגיש הצעות מחיר שנבחר באופן אלגוריתם. תג ההתאמה של Pixel שהוצב על ידי Google משלב את כתובת ה-URL של כתובת ה-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'
מגישי הצעות מחיר שמקבלים בקשות להתאמת פיקסלים נדרשים להשיב עם הפניה אוטומטית לשירות ההתאמה של קובצי Cookie של Google, במבנה הבא:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
שימו לב שכתובת ה-URL להפניה אוטומטית שלמעלה דומה לכתובת ה-URL שמופיעה בתג ההתאמה בתהליך העבודה של Bidder-Initiated cookie matching Workflow.
ב'התאמה ל-Pixel', הפרמטר google_cm מוחלף בפרמטר google_push, והערך שלו חייב להיות שווה לערך ש-Google סיפקה בבקשה. כמו כן, בדומה לתהליך העבודה ביוזמת מגיש הצעות המחיר, אפשר לציין פרמטרים נוספים כדי למלא תרחישים נוספים לדוגמה.
שלב 3: Google מעבדת את ההפניה האוטומטית ומגיבה באמצעות פיקסל
Google מתעדת עבור המשתמש שנוצרה התאמה, ומטפלת בכל הפעולות הנוספות שהתבקשו באמצעות פרמטרים של שאילתה. לבסוף, Google מגיבה באמצעות פיקסל שקוף בגודל 1x1.
תרשים של תהליך העבודה בהתאמת Pixel
תהליך העבודה הזה מנוסח בתרשים הבא, שבו בקשות ותגובות מיוצגות על ידי חץ, ופריטי הנתונים שמתלווים אליהן מפורטים בסוגריים.
פרמטרים של בקשה לתג התאמה של Google
| פרמטר | התיאור |
|---|---|
google_gid |
מזהה משתמש ב-Google. לגבי משתמשים שאינם נמצאים במדינה בארה"ב עם הגבלות פרטיות, הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_cver |
גרסת קובצי ה-cookie. הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_push |
מציין שהבקשה הזו מתחילה את תהליך העבודה של התאמת Pixel. הערך צריך להיות מוחזר דרך הפרמטר המתאים בתגובת ההפניה האוטומטית של מגיש הצעות המחיר. |
פרמטרים של כתובת אתר להפניה אוטומטית בהתאמה של מגיש הצעות מחיר
| פרמטר | התיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של החשבון של מגיש הצעות המחיר. אפשר לאחזר את המזהה הזה דרך המשאב Bidders. |
google_push |
ההערה הזו מציינת שההפניה הזו משלימה את תהליך העבודה של התאמת Pixel. יש לציין כאן את הערך מתג Google Match התואם. |
google_hm |
מכילה נתונים שמגיש הצעות המחיר רוצה לשמור בטבלת התאמות שמתארחת ב-Google. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של
הערך הוא userlistid[,timestamp]:
הפרמטר הזה של כתובת האתר עשוי לחזור על עצמו כדי להוסיף את המשתמש לכמה רשימות. |
ביוזמת 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 מאפשרת לבורסות פרסום להשתמש בתהליכי עבודה של התאמה של קובצי cookie ביוזמת Google וביוזמת Google, כדי להתאים מזהה משתמש ב-Google לקובץ ה-cookie שלהן. קובץ Cookie 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' של רשת ה-cookie מקבלת את הבקשה, ושירות ההתאמה של קובצי ה-cookie שלה אחראי להתאים את מזהה המשתמש לאחד ממגישי הצעות המחיר שלה. בתרשים הבא, שירות ההתאמה של קובצי cookie של רשת ה-Exchange מגיב לדפדפן של המשתמש עם הפניה אוטומטית לאחת מנקודות הקצה של מגיש הצעות המחיר.
- מגיש הצעות המחיר מקבל את הבקשה יחד עם פרמטרים נוספים שצוינו על ידי מערכת ה-Exchange כדי להתאים את מזהה המשתמש לקובץ ה-cookie שלו.
הגבלות
מכסת תדירות של בקשות להתאמות חדשות
מגישי הצעות המחיר אחראים להגביל את מספר הקריאות לשירות ההתאמה של קובצי cookie עבור משתמשים שיש להם רשומה חדשה בטבלת ההתאמות שמתארחת ב-Google. רשומה בטבלת ההתאמות המתארחת עשויה להיחשב שפג תוקפה תוך 14 יום. לאחר מכן, תוכלו לרענן אותה.
תגובה לכל הבקשות להתאמת פיקסלים
מגישי הצעות מחיר שמשתמשים בתהליך העבודה של התאמת Pixel צפויים להגיב לכל הבקשות הנכנסות ל-Pixel Match עם תשובה, שכוללת את הפרמטר google_push. זה מאפשר ל-Google לאכוף את המדיניות על ידי מעקב אחר השימוש. אם שיעור התגובה של מגיש הצעות המחיר יורד מתחת ל-90%, Google תצמצם את מספר הבקשות ל-Pixel Match שנשלחות לחשבון שלו.
שימוש בנקודות קצה (endpoint) מסוג HTTPS
נקודות הקצה שבהן נעשה שימוש בכל תהליכי העבודה של התאמות קובצי cookie צריכות להשתמש ב-HTTPS.
כשאתם מגיבים לבקשת Pixel Match שנשלחה אליכם באמצעות HTTPS, אתם נדרשים להפנות את המשתמשים לשירות התאמת קובצי ה-cookie באמצעות HTTPS. באופן דומה, נקודת קצה של Cookie Match Assist שמפנה מחדש אל מגישי הצעות המחיר חייבת גם היא להשתמש ב-HTTPS. אם תשלחו ל-Google בקשות באמצעות HTTP בתדירות גבוהה יותר מפעם ב-2 דקות, מספר בקשות ההתאמה שיישלחו לחשבון שלכם יווסת.
הדרישות להסכמת משתמשים באיחוד האירופי
בבקשות להתאמות של קובצי cookie שכפופות למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, צריך לציין הסכמה של משתמשי הקצה. בקשות כאלה נדרשות כדי לציין שההסכמה התקבלה באחת מהדרכים הבאות:
- TCFv2: כולל את הפרמטרים
gdprו-gdpr_consent. לקבלת מידע נוסף, אפשר לעיין במסמכי התיעוד של Authorized Buyers של IAB TCF בגרסה 2.0. process_consent: הצהרה שמגיש הצעות המחיר קיבל את הסכמת המשתמש הנדרשת.
דוגמאות
הדוגמאות הבאות ממחישות איך להשתמש בשירות 'התאמת קובצי 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, קראו את המאמר פרמטרים של כתובות URL להפניה אוטומטית.
הוספה לרשימת משתמשים יחידה
אפשר לציין את הפרמטר 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. אם מגיש הצעות המחיר רוצה לשמור בטבלת ההתאמה שלו את הפרמטר google_hm, הערך שלו חייב להיות מחרוזת בקידוד base64 שבטוח לשימוש באינטרנט. במקרה של משתמש שבו נתוני קובצי ה-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.