התאמה לקובצי 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. Google תציין את
BidRequest.user.buyeruidכמחרוזת בקידוד base64 שמתאים לשימוש באינטרנט.רשימות משתמשים: אפשר לאכלס רשימות משתמשים במזהי משתמשים ב-Google או בנתוני התאמה שמתארחים ב-Google.
- מיקוד מראש: אפשר להגדיר את המיקוד מראש כך שתקבלו רק בקשות להצעות מחיר שכוללות נתוני התאמה שמתארחים בשרתים של Google. אפשר להשתמש בזה כדי להסיר חשיפות פחות רלוונטיות למשתמשים מחוץ למרחב קובצי ה-Cookie שלכם.
רשימות משתמשים
אפשר ליצור ולנהל רשימות משתמשים באמצעות Real-Time Bidding API. אחרי שיוצרים את הרשימות האלה, אפשר לאכלס אותן באמצעות תהליכי העבודה הבאים של התאמת קובצי Cookie, או באמצעות שירות ההעלאה בכמות גדולה.
תחילת העבודה
כדי להתחיל להשתמש בהתאמת קובצי Cookie, צריך לפנות למנהל הטכני של החשבון, שיכול להפעיל תהליכי עבודה ספציפיים ולעזור לכם להגדיר את הפריטים הבאים:
- Cookie Matching Network ID (NID): מזהה מחרוזת שמזהה באופן ייחודי חשבון של משתתף במכרז לצורך התאמה של קובצי Cookie ופעולות קשורות אחרות.
- כתובת ה-URL של Cookie Matching: כתובת ה-URL הבסיסית של נקודת קצה שתקבל ותטפל בבקשות נכנסות כחלק מתהליכי העבודה של Cookie Matching. משתתפים במכרז יכולים להטמיע פקודות מאקרו בכתובת ה-URL הזו כדי לשלוט בסדר הפרמטרים שמועברים אליה בתהליכי עבודה של התאמת קובצי Cookie.
- תג התאמה: התג שצריך להציב בדפדפן של משתמש כדי להשתמש בתהליך העבודה של התאמת קובצי Cookie שמתחיל בבידינג. המודעות האלה יכולות להופיע לצד מודעות אחרות או בנכסי אינטרנט שלא קשורים למודעות.
- כתובת ה-URL של דוח ההתאמה של קובצי Cookie (אופציונלי): בתהליך העבודה של התאמת קובצי Cookie חד-כיוונית, זוהי כתובת URL אופציונלית שאפשר לספק כדי לציין נקודת קצה שתקבל פרטי שגיאה במקרה שהתאמת קובצי ה-Cookie נכשלת באמצעות הפניה אוטומטית מסוג HTTP 302. כברירת מחדל, התשובות יישלחו לכתובת ה-URL הזו רק אם הייתה שגיאה בפעולת ההתאמה לקובצי Cookie, אבל יכול להיות שהמגישי הצעות מחיר יבקשו שההפניה תמיד תישלח.
- כתובת ה-URL של Cookie Match Assist: בבורסות שמטמיעות את תהליך העבודה של Cookie Match Assist, זו כתובת ה-URL הבסיסית של נקודת הקצה שמיועדת להגיב לבקשות נכנסות.
- מכסת בקשות ל-Cookie Match Assist: בבורסות שמטמיעות את תהליך העבודה של Cookie Match Assist, זהו המספר המקסימלי של בקשות שכתובת ה-URL שלהן לזיהוי קובצי Cookie יכולה לקבל בכל שנייה. המטרה היא למנוע מבקשות CMA ליצור עומס יתר על השרתים של הבורסה.
פקודות מאקרו להתאמת קובצי 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 Matching, בסדר הבא: google_push, google_gid, google_cver ו-google_error. כדי לעשות את זה, המגיש יכול להגדיר את כתובת ה-URL של התאמת הקובץ שלו ל:
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 לקבל בקשה מהדפדפן של המשתמש, והשירות ינפיק הפניה אוטומטית אל כתובת ה-URL להתאמת קובצי Cookie של המגיש.HTTP 302 ההפניה האוטומטית תכלול פרמטרים של שאילתה שמציינים את מזהה המשתמש ב-Google ואת מספר הגרסה שלו בכתובת ה-URL, והמגיש הצעת המחיר יקבל גם את קובץ ה-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.user.id.
הגרסה שצוינה ב-google_cver מציינת את מספר הגרסה המספרי של מזהה המשתמש ב-Google. מזהה המשתמש ב-Google של משתמש מסוים ישתנה לעיתים רחוקות, ואז הוא יוגדל.
אם Google תיתקל בשגיאה במהלך עיבוד בקשת ההתאמה, יצוין במקומה הפרמטר google_error.
שלב 3: המשתתף במכרז מעבד את ההפניה האוטומטית ומגיב עם פיקסל
המשתתף במכרז מופנה אוטומטית לכתובת ה-URL של התאמת קובצי ה-Cookie שלו, כולל הפרמטרים שהוא ציין בשלב הראשון והפרמטרים ש-Google סיפקה בשלב השני. בנוסף, הם יקבלו את קובץ ה-Cookie בכותרות ה-HTTP. אם הפעולה בוצעה בהצלחה, משתתף במכרז שמארח טבלת התאמות משלו יכול להתאים את קובץ ה-Cookie שלו למזהה המשתמש של Google שכלול בתגובה. מומלץ למגישי הצעות מחיר לאחסן את המחרוזת המדויקת שמוחזרת על ידי שירות התאמת הקבצים.
אם הפעולה לא הצליחה, המשתתף במכרז יקבל את הפרמטר google_error בהפניה האוטומטית. זהו ערך מספרי שמתאים למצבי שגיאה שונים, ומזהה את השגיאה הספציפית שהתרחשה. מידע נוסף על ערכי השגיאות האפשריים מופיע בתיאור של פרמטר כתובת ה-URL google_error. אם מופיעה שגיאה, אפשר לנסות שוב להתאים את המשתמש על ידי הצבת תג התאמה חדש.
המשתתף במכרז חייב להגיב תמיד על ידי הצגת תמונה של פיקסל 1x1 בלתי נראה, או לחלופין להחזיר תגובה מסוג HTTP 204 No Content.
תרשים זרימה של תהליך העבודה של התאמת קובצי Cookie
בתרשים הבא מוצג תהליך העבודה הזה, שבו בקשות ותגובות מיוצגות על ידי חץ, ופריטי הנתונים שמצורפים אליהן מופיעים בסוגריים.
התאמה של פרמטרים של כתובת אתר בתג
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של חשבון המשתתף במכרז. אפשר לאחזר את המזהה הזה באמצעות המשאב Bidders. |
google_cm |
הערך הזה מציין לשירות התאמת קובצי Cookie של Google שעליו לבצע התאמה של קובצי Cookie. המערכת מתעלמת מהערך של הפרמטר, ואפשר להשמיט אותו. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר קובץ Cookie של Google למשתמש אם אין כזה. המערכת מתעלמת מהערך של הפרמטר, ואפשר להשמיט אותו. אם לא קיים קובץ Cookie, השמטת הפרמטר תגרום לשגיאה. |
google_no_sc |
הפרמטר הזה הוצא משימוש. הערך הזה מציין לשירות להתאמת קובצי Cookie של Google שלא להגדיר קובץ Cookie למשתמש אם אין קובץ Cookie כזה. המערכת מתעלמת מהערך של הפרמטר, ואפשר להשמיט אותו. |
google_hm |
נתונים שהמשתתף במכרז רוצה לאחסן בטבלת התאמות שמתארחת ב-Google. הערך הוא מחרוזת בקידוד base64 שמתאימה לשימוש באינטרנט (הוספת ריפוד היא אופציונלית). הנתונים הגולמיים צריכים להיות באורך של 40 בייט או פחות. לדוגמה,
|
google_redir |
מחרוזת בקידוד URL שהמגיש יכול לציין אם הוא רוצה להפנות את Google לשלוח את ההפניה HTTP 302 לכתובת ה-URL המקודדת לתג ההתאמה הזה. כך Google יכולה להיות הראשונה בשרשרת של קריאות לשותפים. הפעולה הזו תגרום לשגיאה אם היא תצוין בלי google_hm או עם google_cm. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
מציין שהבקשה כפופה להגבלות של GDPR על השימוש בנתונים. לפרטים נוספים, אפשר לעיין במאמר
דרישות בנושא הסכמת משתמשים באיחוד האירופי או במאמר השפעה על הזכאות להתאמת קובצי Cookie במסמכי
העזרה בנושא גרסה 2.0 של IAB TCF ב-Authorized Buyers.
לדוגמה: |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את ההסכמה של משתמש הקצה. לפרטים נוספים, אפשר לעיין במאמר דרישות ההסכמה של משתמשים באיחוד האירופי או במאמר איך מחרוזת נתוני השקיפות וההסכמה תועבר? במסמכי Authorized Buyers בנושא TCF גרסה 2.0 של IAB. |
process_consent |
הפרמטר הזה מציין שהמשתתף במכרז קיבל את הסכמת משתמשי הקצה לשימושים בנתונים שצוינו ב
מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש פרמטרים אחרים של הסכמה שזמינים בבקשה ( לדוגמה: |
בנוסף לפרמטרים שצוינו קודם, המשתתפים במכרז יכולים לציין פרמטרים משלהם, שיתווספו כפרמטרים לכתובת ה-URL להפניה. שימו לב: המערכת תתעלם מפרמטרים שהוגדרו על ידי מגישי הצעות המחיר ושמם מתחיל בקידומת google_, כי Google שומרת אותם לפיתוח עתידי, ואין ערובה לכך שהסדר של הפרמטרים יישמר. תג התאמה שכולל פרמטרים שהוגדרו על ידי המגיש עשוי להיראות כך:
<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />
פרמטרים של כתובת URL להפניה אוטומטית
כתובת ה-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 של Google, ומציין את הפרמטרים
google_nidו-google_cm. - השירות Cookie Match קורא את קובץ ה-Cookie של ג'יין ב-Google ושולח לדפדפן של ג'יין הפניה אוטומטית לכתובת ה-URL של Cookie Matching של FinestDSP עם הפרמטרים
google_gidו-google_cver. - הדפדפן של ג'יין טוען את ההפניה לכתובת ה-URL של FinestDSP להתאמת קובצי Cookie.
- נקודת הקצה של FinestDSP להתאמת קובצי Cookie מעבדת את בקשת ההפניה האוטומטית,
שכוללת פרמטרים של כתובת URL שהוגדרו על ידי Google, ואת קובץ ה-Cookie שלה עבור Jane בכותרות ה-HTTP. מעכשיו FinestDSP יכולה לאחסן את המיפוי של הקובץ שלה ל-
google_gidבטבלת ההתאמה שלה. - מערכת FinestDSP מגיבה להפניה האוטומטית עם פיקסל 1x1 בלתי נראה.
תרחיש 2: משתמש עם מיפוי קיים
שבוע אחרי תרחיש 1, דנה נכנסת שוב לאתר ExampleNews.com. עכשיו, כשיש למשתמשת ג'יין קובצי Cookie של הצעת מחיר ושל Ad Manager במחשב שלה, כך מתבצעת ההתאמה.
- דף האינטרנט מוצג, ובעקבות זאת Google (Ad Manager) שולחת בקשות למודעות שיוצגו בדף.
- במהלך המכרז על שטחי הפרסום, Google שולחת בקשה להצעת מחיר למגישי הצעות מחיר רלוונטיים, כולל FinestDSP.
- מערכת FinestDSP מקבלת את הבקשה להצעת מחיר, כולל אותות כמו
google_gid. - מערכת FinestDSP מחפשת את
google_gidבטבלת ההתאמות שלה, ומוצאת את קובץ ה-Cookie שמשויך ל-Jane ושנוצר שבוע קודם (בתרחיש 1). - על סמך מידע שמשויך לקובץ ה-Cookie, לוגיקת הבידינג של FinestDSP מגישה הצעת מחיר על החשיפה וזוכה במכרז.
- יכול להיות שיוצגו לג'יין מודעות שמותאמות לתחומי העניין שלה, על סמך מידע שיש ל-FinestDSP.
התאמה של קובצי Cookie שמתבצעת על ידי הבידאר: חד-כיוונית
התאמה חד-כיוונית של קובצי Cookie דומה לתהליך העבודה הדו-כיווני, אבל היא שונה בכך שרק Google מארחת ומאכלסת טבלת התאמה. אפשר להשתמש בזה במקרים שבהם אסור למגיש ההצעה לארח מזהי משתמשים של Google בטבלת ההתאמה שלו. כדי להשתמש בתהליך הזה, המשתתפים במכרז צריכים לאפשר ל-Google לארח את טבלת ההתאמות. הם כבר לא יכולים לציין את google_cm בבקשות לשירות התאמת קובצי Cookie של Google, ולכן הם לא יקבלו את google_gid כדי לאכלס את טבלת ההתאמות שלהם. אחרי ש-Google מזהה התאמה למשתמש, המשתתפים במכרז יכולים להוסיף אותו לרשימות משתמשים באמצעות נתוני קובצי ה-Cookie שלהם. באופן דומה, בקשות להצעות מחיר עבור המשתמשים האלה לא יכללו את מזהה המשתמש ב-Google, אבל יכללו נתוני התאמה שמתארחים ב-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 Matching של 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 Matching של Google
Google תקבל הפניה אוטומטית שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP.
שלב 4: אם צוינה כתובת URL של דוח, Google מציגה פיקסל בהפניה או בשגיאה אם הפעולה הצליחה
אם פעולת ההתאמה של קובצי ה-Cookie מצליחה – או אם לא צוינה כתובת URL של דוח התאמה של קובצי Cookie בחשבון של הצעת המחיר – Google תציג כברירת מחדל פיקסל שקוף בגודל 1x1, ותהליך העבודה יסתיים כאן.
חשיפות של המשתמש הזה בבקשות להצעות מחיר הבאות יכללו את נתוני ההתאמה המתארחים של הצעת המחיר ב-BidRequest.user.buyeruid. המשתתפים במכרז יכולים גם לאכלס רשימות משתמשים באמצעות נתוני ההתאמה המתארחים שהם ציינו.
אחרת, אם התרחשה שגיאה, Google תשלח הפניה אוטומטית לכתובת ה-URL של דוח התאמת הקובצים של המשתתף במכרז, עם ציון הגורם לשגיאה בפרמטר 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 Matching של Google
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של חשבון המשתתף במכרז. אפשר לאחזר את המזהה הזה באמצעות המשאב Bidders. |
google_sc |
הפרמטר הזה הוצא משימוש. מגדיר קובץ Cookie של Google למשתמש אם אין כזה. המערכת מתעלמת מהערך של הפרמטר, ואפשר להשמיט אותו. אם לא קיים קובץ Cookie, השמטת הפרמטר תגרום לשגיאה. |
google_no_sc |
הפרמטר הזה הוצא משימוש. הערך הזה מציין לשירות להתאמת קובצי Cookie של Google שלא להגדיר קובץ Cookie למשתמש אם אין קובץ Cookie כזה. המערכת מתעלמת מהערך של הפרמטר, ואפשר להשמיט אותו. |
google_hm |
מכיל נתונים שהמשתתף במכרז רוצה לאחסן בטבלת התאמות שמתארחת ב-Google. |
google_redir |
כתובת URL מקודדת שרוצים ש-Google תשלח אליה הפניה אוטומטית מסוג HTTP 302. כתובת ה-URL שצוינה תקבל הפניות אוטומטיות עם הפרמטר google_error גם לשגיאות וגם לפעולות שבוצעו בהצלחה. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
מציין שהבקשה כפופה להגבלות של GDPR על השימוש בנתונים. לפרטים נוספים, אפשר לעיין במאמר
דרישות בנושא הסכמת משתמשים באיחוד האירופי או במאמר השפעה על הזכאות להתאמת קובצי Cookie במסמכי
העזרה בנושא גרסה 2.0 של IAB TCF ב-Authorized Buyers.
לדוגמה: |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את ההסכמה של משתמש הקצה. לפרטים נוספים, אפשר לעיין במאמר דרישות ההסכמה של משתמשים באיחוד האירופי או במאמר איך מחרוזת נתוני השקיפות וההסכמה תועבר? במסמכי Authorized Buyers בנושא TCF גרסה 2.0 של IAB. |
process_consent |
הפרמטר הזה מציין שהמשתתף במכרז קיבל את הסכמת משתמשי הקצה לשימושים בנתונים שצוינו ב
מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש פרמטרים אחרים של הסכמה שזמינים בבקשה ( לדוגמה: |
פרמטרים של כתובות URL להפניה אוטומטית של Google לכתובת ה-URL של דוח התאמת קובצי Cookie של הצעת המחיר
| פרמטר | תיאור |
|---|---|
google_error |
ערך של מספר שלם שמציין את השגיאה הכוללת בבקשה. אם התקבלה התשובה, המשמעות היא שלא בוצעו פעולות, ולא יוגדרו פרמטרים אחרים של התשובה
|
התאמה דו-כיוונית של פיקסלים שמופעלת על ידי Google
התאמת פיקסלים דו-כיוונית היא תהליך עבודה בשירות התאמת קובצי Cookie של Google, שבו Google מנסה להתאים מזהה משתמש ב-Google למגיש הצעת מחיר שנבחר על ידי אלגוריתם, ולא למגיש הצעת המחיר שזכה במכרז עם בידינג בזמן אמת. כשמודעה מוצגת, Google מטמיעה תג התאמה שמפנה את הדפדפן של המשתמש לטעינה של פיקסל שקוף מכתובת ה-URL להתאמת קובצי Cookie של המגיש שנבחר. הפעולה הזו תאפשר גם ל-Google וגם למגיש ההצעה לאכלס טבלת התאמה עם משתמש נתון. הדוגמה הבאה ממחישה את תהליך העבודה הזה.
שלב 1: Google מציבה תג התאמה
כשדף של בעל תוכן דיגיטלי משתתף נטען בדפדפן של המשתמש, ומשבצת פרסום בדף הזה מתמלאת על ידי Google, יכול להיות שיוצב תג התאמה שמבקש פיקסל ממוגש הצעות מחיר שנבחר על ידי אלגוריתם. תג Pixel Matching שהוצב על ידי 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 של שירות התאמת העוגיות של Google
משתתפים במכרז שמקבלים בקשות להתאמת פיקסלים נדרשים להשיב בהפניה אוטומטית לשירות התאמת קובצי ה-Cookie של Google, שמוגדרת באופן הבא:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
שימו לב שכתובת ה-URL להפניה האוטומטית שמופיעה למעלה דומה לכתובת ה-URL שמשמשת בתג ההתאמה בתהליך העבודה של התאמת קובצי Cookie שמתבצעת על ידי הצעת המחיר.
ב-Pixel Matching, הפרמטר google_cm מוחלף בפרמטר google_push, והערך שלו צריך להיות שווה לערך שסופק על ידי Google בבקשה. בדומה לתהליך העבודה שמתחיל בהצעת מחיר, אפשר לציין פרמטרים נוספים כדי לתת מענה לתרחישי שימוש נוספים.
שלב 3: Google מעבדת את ההפניה האוטומטית ומגיבה עם פיקסל
Google מתעדת שנוצרת התאמה למשתמש ומטפלת בכל פעולה נוספת שמתבקשת באמצעות פרמטרים של שאילתה. לבסוף, Google מגיבה עם פיקסל 1x1 שקוף.
תרשים זרימה של תהליך העבודה של התאמת פיקסלים
בתרשים הבא מוצג תהליך העבודה הזה, שבו בקשות ותגובות מיוצגות על ידי חץ, ופריטי הנתונים שמצורפים אליהן מופיעים בסוגריים.
פרמטרים של בקשות לתג התאמה של Google
| פרמטר | תיאור |
|---|---|
google_gid |
מזהה משתמש Google. למשתמשים שלא נמצאים במדינה בארה"ב שבה יש הגבלות על פרטיות, הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_cver |
גרסת קובץ ה-Cookie. הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_push |
הערך הזה מציין שהבקשה הזו מתחילה את תהליך העבודה של התאמת פיקסלים. הערך צריך להיות מוחזר דרך הפרמטר המתאים בתגובת ההפניה האוטומטית של מגיש ההצעות. |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את ההסכמה של משתמש הקצה. לפרטים נוספים, אפשר לעיין במאמר בנושא [דרישות ההסכמה של משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) או בקטע **איך מחרוזת נתוני השקיפות וההסכמה תועבר?** במאמר בנושא [תיעוד של גרסה 2.0 של TCF של IAB בתוכנית Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
פרמטרים של הפניה אוטומטית להתאמת פיקסלים של מגישי הצעות מחיר
| פרמטר | תיאור |
|---|---|
google_nid |
מזהה הרשת (NID) של חשבון המשתתף במכרז. אפשר לאחזר את המזהה הזה באמצעות המשאב Bidders. |
google_push |
הערך הזה מציין שההפניה הזו משלימה את תהליך העבודה של התאמת פיקסלים. כאן צריך לציין את הערך מתג ההתאמה של Google שמתאים. |
google_hm |
מכיל נתונים שהמשתתף במכרז רוצה לאחסן בטבלת התאמות שמתארחת ב-Google. |
google_ula |
מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות. |
gdpr_consent |
מחרוזת נתוני שקיפות והסכמה שמייצגת את ההסכמה של משתמש הקצה. לפרטים נוספים, אפשר לעיין במאמר [דרישות ההסכמה של משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) או בקטע **איך מחרוזת נתוני השקיפות וההסכמה תועבר?** [במסמכי IAB TCF בגרסה 2.0 של Authorized Buyers](//support.google.com/authorizedbuyers/answer/9789378). |
התאמה חד-כיוונית של פיקסלים שמתבצעת על ידי Google
ההתאמה החד-כיוונית של פיקסלים שונה מתהליך העבודה הדו-כיווני בכך שתג ההתאמה של Google לא כולל פרמטר שמציין את מזהה המשתמש ב-Google, אבל הוא ימשיך לאכלס טבלת התאמה שמתארחת ב-Google. אפשר להשתמש בזה במקרים שבהם אסור למגיש ההצעה לארח מזהי משתמשים של Google בטבלת ההתאמה שלו. דוגמה לתהליך העבודה המעודכן מפורטת בשלבים הבאים.
שלב 1: Google מציבה תג התאמה
Google מציבה תג התאמה למועמד להגשת הצעת מחיר שנבחר באופן אלגוריתמי. תג ההתאמה כולל את הפרמטר google_push. לדוגמה:
<img src="https://ad.network.com/pixel?google_push=PUSH_DATA" />
שלב 2: הדפדפן של המשתמש שולח בקשה לפיקסל מכתובת ה-URL של התאמת קובצי ה-Cookie של המגיש
הדפדפן של המשתמש שולח בקשה לפיקסל מכתובת ה-URL של התאמת קובצי Cookie של המגיש, כולל קובץ ה-Cookie של המגיש בכותרות ה-HTTP.
שלב 3: הפניה לשירות Cookie Matching של 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 Matching של Google
Google תקבל הפניה אוטומטית שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP. אם הפעולה הצליחה, נתוני החשיפות של המשתמש הזה בבקשות הבאות להצעות מחיר יכללו את נתוני ההתאמה שמתארחים אצל מגיש הצעת המחיר ב-BidRequest.user.buyeruid.
המשתתפים במכרז יכולים גם לאכלס רשימות משתמשים באמצעות נתוני ההתאמה המתארחים שהם ציינו.
לבסוף, Google מחזירה פיקסל 1x1 שקוף לדפדפן של המשתמש.
עזרה בהתאמת קובצי Cookie
ב-Open Bidding, פלטפורמות Exchange יכולות להשתמש בתהליכי עבודה של התאמת קובצי Cookie מסוג bidder initiated ו-Google initiated, כדי להתאים User-ID של Google לקובץ Cookie שלהן. התכונה Cookie 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 של הבורסה מקבלת בקשת פיקסל.
- נקודת הקצה של התאמת קובצי Cookie בבורסה מקבלת את הבקשה, ושירות התאמת קובצי Cookie שלה אחראי להתאמת מזהה המשתמש לאחד מהמשתתפים במכרז. בתרשים הבא, שירות התאמת קובצי ה-Cookie של הבורסה מגיב לדפדפן של המשתמש בהפניה אוטומטית לאחת מנקודות הקצה של המגיש שלה.
- המשתתף במכרז מקבל את הבקשה, יחד עם כל הפרמטרים שצוינו על ידי הבורסה כדי להתאים את מזהה המשתמש לקובץ ה-Cookie שלו.
הגבלות
הגבלת התדירות של בקשות להתאמות חדשות
האחריות של המגישים הצעות מחיר היא להגביל את מספר הקריאות לשירות Cookie Matching עבור משתמשים שיש להם רשומה חדשה בטבלת ההתאמה שמתארחת ב-Google. יכול להיות שערך בטבלת ההתאמות המתארחת ייחשב כלא תקף אחרי 14 ימים, ואז אפשר לרענן אותו.
תגובה לכל הבקשות להתאמת פיקסלים
משתתפים במכרז שמשתמשים בתהליך העבודה של התאמת פיקסלים צריכים להגיב לכל הבקשות הנכנסות של התאמת פיקסלים עם תגובה שכוללת את הפרמטר google_push. כך Google יכולה לאכוף את כללי המדיניות על ידי מעקב אחרי השימוש. אם שיעור התגובה של משתתף במכרז נמוך מ-90%, Google תגביל את מספר הבקשות להתאמת פיקסלים שנשלחות לחשבון שלו.
שימוש בנקודות קצה (endpoint) מסוג HTTPS
נקודות הקצה שמשמשות בכל תהליכי העבודה של התאמת קובצי Cookie חייבות להשתמש ב-HTTPS.
כשמגיבים לבקשה להתאמת פיקסלים שנשלחה אליכם באמצעות HTTPS, אתם נדרשים להפנות אוטומטית לשירות להתאמת קובצי Cookie באמצעות HTTPS. באופן דומה, נקודת קצה של Cookie Match Assist שמפנה בידים למוציאים לאור צריכה גם היא להשתמש ב-HTTPS. אם תשלחו בקשות ל-Google דרך HTTP בתדירות גבוהה יותר מפעם אחת בכל 2 דקות, מספר בקשות ההתאמה שנשלחות לחשבון שלכם יוגבל.
הדרישות לקבלת הסכמה ממשתמשים באיחוד האירופי
בבקשות להשוואת קובצי Cookie שחלות עליהן הדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, צריך לציין את הסכמת משתמשי הקצה. בקשות כאלה צריכות לציין שההסכמה נאספה באחת מהדרכים הבאות:
- TCFv2: כולל את הפרמטרים
gdprו-gdpr_consent. פרטים נוספים זמינים ב מסמכי העזרה בנושא TCF גרסה 2.0 של IAB ב-Authorized Buyers. -
process_consent: הצהרה של מגיש הצעת המחיר שלפיה הוא קיבל את ההסכמה הנדרשת מהמשתמשים.
דוגמאות
בדוגמאות הבאות מוסבר איך להשתמש בשירות Cookie Matching כדי להשיג מטרות ספציפיות. שימו לב: אלא אם צוין אחרת, ההנחה היא שהמשתמש שעליו מבוצעת הפעולה לא נמצא במדינה בארה"ב שבה יש הגבלות על פרטיות.
איכלוס טבלת התאמה בשרת של המגיש
מגיש הצעת מחיר יכול להשתמש בתהליך העבודה של התאמת קובצי 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 של התאמת הקבצים של הקונה היא 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, והוא לא מתכוון לאחסן התאמה עם מזהה המשתמש ב-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 של התאמת הקבצים של הבידינג היא https://cookie-monster.com/pixel, כתובת ה-URL להפניה האוטומטית של Google תהיה:
https://cookie-monster.com/pixel
הפרמטר google_gid לא מופיע בהפניה האוטומטית כי התגית match לא כללה את google_cm, והפרמטר google_hm לא נכלל בתגובות מוצלחות. בבקשות עתידיות להצעות מחיר על חשיפות של המשתמש הזה, המגיש יקבל את נתוני ההתאמה שמתארחים ב-BidRequest.user.buyeruid.
אם במקום זאת, מערכת הבידינג השתמשה בתג התאמה שבו הערך של 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.user.buyeruid.