התאמת קובצי cookie היא תכונה שמאפשרת להתאים את קובץ ה-cookie שלכם – לדוגמה, מזהה של משתמש שגלש באתר שלכם – למזהה משתמש ב-Google שתואם למגיש הצעות המחיר, וליצור רשימות של משתמשים שיעזרו לכם לקבל החלטות יעילות יותר לגבי הבידינג. במדריך הזה מתוארים מושגים שנעשה בהם שימוש בהתאמת קובצי cookie, תהליכי עבודה שונים של התאמת קובצי cookie וכל וריאציה שעשויה להיות להם בתרחישי שימוש מסוימים.
מושגים
מהי התאמת קובצי Cookie?
בדרך כלל, בעלי הדומיינים מגדירים את התוכן של קובצי ה-cookie למשתמשים שגולשים באתר שלהם, והם משמשים לזיהוי משתמשים בדומיין הזה. גם אם שני בעלי דומיינים היו מסכימים להחליף את הנתונים האלה, מודל האבטחה של דפדפני האינטרנט מגביל את היכולת לקרוא קובץ cookie שהוגדר על ידי דומיין אחר.
בהקשר של פרסום דיגיטלי, Google מזהה משתמשים באמצעות קובצי cookie ששייכים לדומיין doubleclick.net. למגישי הצעות מחיר שמשתתפים בבידינג בזמן אמת יכול להיות דומיין משלהם שבו הם מזהים קבוצה מסוימת של משתמשים שהם רוצים להציג להם מודעות. התאמת קובצי cookie מאפשרת למגיש הצעת המחיר להתאים את קובצי ה-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 או בנתוני התאמה שמתארחים.
- טירגוט מראש: אפשר להגדיר את הטירגוט מראש כך שתקבלו רק בקשות להצעות מחיר שמכילות נתוני התאמה שמתארחים. אפשר להשתמש בנתונים האלה כדי למנוע חשיפות פחות רלוונטיות למשתמשים מחוץ למרחב של קובצי ה-cookie.
רשימות משתמשים
אפשר ליצור ולנהל רשימות של משתמשים באמצעות Real-Time Bidding API. אחרי שיוצרים את הרשימות האלה, אפשר לאכלס אותן באמצעות תהליכי העבודה הבאים של התאמת קובצי cookie, או באמצעות השירות להעלאה בכמות גדולה.
תחילת העבודה
כדי להתחיל להשתמש בהתאמת קובצי cookie, עליכם לפנות למנהל החשבון הטכני שלכם. הוא יוכל להפעיל תהליכי עבודה ספציפיים ולעזור לכם להגדיר את האפשרויות הבאות:
- מזהה רשת להתאמת קובצי cookie (NID): מזהה מחרוזת שמזהה באופן ייחודי חשבון של מציע מחיר לצורך התאמת קובצי cookie ופעולות קשורות אחרות.
- כתובת URL להתאמת קובצי cookie: כתובת ה-URL הבסיסית של נקודת קצה שתקבל ותטפל בבקשות נכנסות כחלק מתהליכי העבודה של התאמת קובצי cookie. בעלי תוכן דיגיטלי יכולים להטמיע מקורות בכתובת ה-URL הזו כדי לקבוע את הסדר של הפרמטרים המועברים אליה בתהליכי העבודה של התאמת קובצי cookie.
- תג התאמה: התג שצריך להוסיף לדפדפן של המשתמש בתהליך העבודה של התאמת קובצי cookie שמופעל על ידי המציע. אפשר להציג את הנכס הזה לצד מודעות או למקם אותו בנכסי אינטרנט מחוץ למודעות.
- כתובת ה-URL של דוח התאמת קובצי ה-cookie (אופציונלי): בתהליך העבודה של התאמת קובצי ה-cookie בכיוון אחד, זוהי כתובת URL אופציונלית שאפשר לספק כדי לציין נקודת קצה שתקבל את פרטי השגיאה במקרה שההתאמה של קובצי ה-cookie נכשלת באמצעות הפניה אוטומטית מסוג HTTP 302. כברירת מחדל, התשובות יישלחו לכתובת ה-URL הזו רק אם הייתה שגיאה בפעולה של התאמת קובצי ה-cookie, אבל בעלי בידינג יכולים לבקש שההפניה האוטומטית תישלח תמיד.
- כתובת ה-URL של Cookie Match Assist: בזירות מסחר שמטמיעות את תהליך העבודה של Cookie Match Assist, זוהי כתובת ה-URL הבסיסית של נקודת הקצה (endpoint) שאמורה להגיב לבקשות נכנסות.
- מכסה של 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, לפי הסדר הבא: google_push, google_gid, google_cver ו-google_error. המגיש יכול לעשות זאת על ידי הגדרת כתובת ה-URL להתאמה לפי קובצי 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: ממקמים את תג ההתאמה
כדי להתחיל את התהליך הזה, המשתתף במכרז צריך למקם את תג ההתאמה שלו כך שיוצג בדפדפן של המשתמש. תג התאמה שמחזיר למגיש הצעות המחיר רק את מזהה המשתמש ב-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 שמוענק דרך הפרמטר google_gid הוא מחרוזת בקידוד base64 ללא תוספת שטח, שמותאמת לשימוש באינטרנט. למגישי הצעות מחיר שבוחרים לארח טבלת התאמה, מומלץ לאחסן את המחרוזת המדויקת שמוחזרת על ידי שירות התאמת קובצי ה-cookie. בבקשות הבאות להצעת מחיר, הערך הזה יתאים לערכים שצוינו באמצעות BidRequest.user.id.
הגרסה שצוינה ב-google_cver מציינת את מספר הגרסה המספרי של מזהה המשתמש ב-Google. מזהה המשתמש ב-Google של משתמש נתון ישתנה לעיתים רחוקות, ולאחר מכן המספר שלו יגדל.
אם Google נתקלת בשגיאה במהלך עיבוד הבקשה להתאמה, במקום זאת יופיע הפרמטר google_error.
שלב 3: המגיש הצעות המחיר מעבד את ההפניה האוטומטית ומגיב באמצעות פיקסל
המגיש הצעת המחיר מקבל הפניה לכתובת ה-URL שתואמת לקובץ ה-cookie, כולל הפרמטרים שציין בשלב הראשון והפרמטרים ש-Google סיפקה בשלב השני. בנוסף, הם יקבלו את קובץ ה-cookie שלהם גם בכותרות ה-HTTP. אם הפעולה תתבצע בהצלחה, מגיש הצעות מחיר שמארח טבלת התאמה משלו יוכל להתאים את ה-cookie שלו למזהה המשתמש ב-Google שכלול בתגובה. מומלץ למשתתפים במכרזים לשמור את המחרוזת המדויקת שמוחזרת על ידי שירות התאמת קובצי ה-cookie.
אם הפעולה תיכשל, המגיש הצעת המחיר יקבל פרמטר google_error בהפניה האוטומטית. זהו ערך מספרי שתואם למצבי שגיאה שונים שמזהים את השגיאה הספציפית שהתרחשה. מידע נוסף על ערכי השגיאה האפשריים זמין בתיאור של הפרמטר google_error של כתובת ה-URL. אם מופיעה הודעת שגיאה, תוכלו לנסות שוב להתאים את המשתמש הזה על ידי הצבת תג התאמה חדש.
המגיש של הצעת המחיר חייב תמיד להגיב על ידי הצגת תמונה של פיקסל בלתי נראה בגודל 1x1, או לחלופין להחזיר תגובה מסוג HTTP 204 No Content.
תרשים של תהליך העבודה של התאמות של קובצי Cookie
תהליך העבודה הזה מוצג בתרשים הבא, שבו בקשות ותשובות מיוצגות בחץ, ופריטי הנתונים שמלווים אותן מפורטים בסוגריים.
פרמטרים של כתובת URL של תג התאמה
| פרמטר | תיאור |
|---|---|
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]:
אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
הבקשה כפופה להגבלות של GDPR על השימוש בנתונים. פרטים נוספים זמינים במאמר
דרישות לקבלת הסכמת משתמשים באיחוד האירופי או בקטע השפעה על הזכאות להתאמה לפי קובצי cookie במסמכים של
Authorized Buyers בנושא IAB TCF גרסה 2.0.
לדוגמה: |
gdpr_consent |
מחרוזת TC שמייצגת את הסכמת משתמש הקצה. למידע נוסף, ראו דרישות הסכמה של משתמשים באיחוד האירופי או איך מחרוזת נתוני השקיפות וההסכמה תועבר? במסמכים של Authorized Buyers בנושא TCF v2.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 ל-Jane.
- תג ההתאמה קורא לשירות התאמת קובצי ה-Cookie של Google, ומציין את הפרמטרים
google_nidו-google_cm. - שירות התאמת קובצי ה-cookie קורא את קובץ ה-cookie של ג'יין ב-Google, ושולח לדפדפן של ג'יין הפניה לכתובת ה-URL של FinestDSP להתאמת קובצי cookie עם ההגדרה של הפרמטרים
google_gidו-google_cver. - הדפדפן של ג'יין טוען את ההפניה לכתובת ה-URL של FinestDSP להתאמה לקובצי cookie.
- נקודת הקצה של FinestDSP להתאמת קובצי cookie מעבדת את בקשת ההפניה האוטומטית, שכוללת פרמטרים של כתובת URL שהוגדרו על ידי Google ואת קובץ ה-cookie של עינת בכותרות ה-HTTP. עכשיו מערכת FinestDSP יכולה לאחסן את המיפוי של ה-cookie שלה אל
google_gidבטבלת ההתאמה שלה. - מערכת FinestDSP מגיבה להפניה האוטומטית באמצעות פיקסל בלתי נראה בגודל 1x1.
תרחיש 2: משתמש עם מיפוי קיים
שבוע אחרי התרחיש הראשון, ג'יין נכנסת שוב לאתר ExampleNews.com. עכשיו, אחרי שגם קובצי ה-cookie של המגיש הצעות המחיר וגם קובצי ה-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, אבל יכללו נתוני התאמה שמתארחים. דוגמה לתהליך העבודה המתוקן מפורטת בשלבים הבאים.
שלב 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.user.buyeruid. בנוסף, בעלי תוכן דיגיטלי יכולים לאכלס רשימות של משתמשים באמצעות נתוני ההתאמה המארחים שציינו.
אחרת, אם תתרחש שגיאה, 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 למשתמשים ממדינות בארה"ב עם הגבלות פרטיות
תהליך העבודה שמוגדר כברירת מחדל למשתמשים במדינות בארה"ב עם הגבלות פרטיות מתואר בתרשים הבא. הבקשות והתשובות מיוצגות בחץ, ופריטי הנתונים שמלווים אותן מפורטים בסוגריים.
פרמטרים של כתובות URL להפניה אוטומטית של בידינג לשירות ההתאמה של קובצי 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]:
אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות. |
gdpr |
מציין שהבקשה כפופה להגבלות של GDPR על השימוש בנתונים. פרטים נוספים זמינים בקטע
דרישות לקבלת הסכמת משתמשים באיחוד האירופי או בקטע השפעה על הזכאות להתאמה לפי קובצי cookie במסמכים של
Authorized Buyers בנושא IAB TCF גרסה 2.0.
לדוגמה: |
gdpr_consent |
מחרוזת TC שמייצגת את הסכמת משתמש הקצה. למידע נוסף, ראו דרישות הסכמה של משתמשים באיחוד האירופי או איך מחרוזת נתוני השקיפות וההסכמה תועבר? במסמכים של Authorized Buyers בנושא TCF v2.0 של IAB. |
process_consent |
הנתון הזה מציין שהמגיש של הצעת המחיר קיבל הסכמה ממשתמשי הקצה לשימושים בנתונים שצוינו ב
מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.
אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש פרמטרים אחרים של הסכמה שזמינים בבקשה ( לדוגמה: |
פרמטרים של כתובות URL להפניה אוטומטית של Google לכתובת ה-URL של דוח ההתאמה של קובצי cookie של המציע
| פרמטר | תיאור |
|---|---|
google_error |
ערך שלם שמציין את השגיאה הכוללת בבקשה. כשהיא מתקבלת, היא מציינת שלא בוצעו פעולות ולא יוגדרו פרמטרים אחרים בתגובה
|
יוזמה של Google: התאמת פיקסלים דו-כיוונית
התאמה דו-כיוונית של פיקסלים היא תהליך עבודה של שירות ההתאמה של קובצי cookie של Google, שבו Google מנסה להתאים מזהה משתמש ב-Google למגיש הצעות מחיר שנבחר באופן אלגוריתמי, מלבד המנצח במכרז הבידינג בזמן אמת. כשמודעה תוצג, Google תציב תג התאמה שידריך את הדפדפן של המשתמש לטעון פיקסל שקוף מכתובת ה-URL של התאמת קובצי ה-Cookie של המציע שנבחר. כך גם Google וגם המגיש הצעת המחיר יוכלו לאכלס טבלת התאמה עם משתמש נתון. בהמשך מופיעה דוגמה לתהליך העבודה הזה.
שלב 1: Google ממוקמת תג התאמה
כשדף של בעל תוכן דיגיטלי שמשתתף בתוכנית נטען בדפדפן של המשתמש, ו-Google ממלאת מקום מודעה בדף הזה, יכול להיות שיוצב תג התאמה שמבקש פיקסל ממגיש הצעות מחיר שנבחר באופן אלגוריתמי. תג ההתאמה של הפיקסל שמוטמע על ידי 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
בעלי מודעות שמקבלים בקשות להתאמה לפי פיקסלים צריכים להשיב בהפניה אוטומטית לשירות ההתאמה לפי קובצי cookie של Google, לפי המבנה הבא:
https://cm.g.doubleclick.net/pixel?google_nid=GOOGLE_NID&google_push=PUSH_DATA
שימו לב שכתובת ה-URL של ההפניה האוטומטית הקודמת דומה לכתובת ה-URL ששימשה בתג ההתאמה של תהליך העבודה של התאמת קובצי cookie ביוזמת המציע.
בהתאמת פיקסלים, הפרמטר google_cm מוחלף בפרמטר google_push, והערך שלו חייב להיות שווה לערך ש-Google מספקת בבקשה. בדומה לתהליך העבודה שמתחיל במגיש הצעות המחיר, אפשר לציין פרמטרים נוספים כדי לעמוד בדרישות של תרחישים נוספים לדוגמה.
שלב 3: Google מעבדת את ההפניה האוטומטית ומשיבים לה באמצעות פיקסל
Google מתעדת יצירת התאמה למשתמש ומטפלת בכל פעולה נוספת שנדרשת באמצעות פרמטרים של שאילתות. לבסוף, Google משיבה בפיקסל שקוף בגודל 1x1.
תרשים של תהליך העבודה של Pixel Matching
תהליך העבודה הזה מוצג בתרשים הבא, שבו בקשות ותשובות מיוצגות בחץ, ופריטי הנתונים שמלווים אותן מפורטים בסוגריים.
פרמטרים של בקשות של תג התאמה של Google
| פרמטר | תיאור |
|---|---|
google_gid |
מזהה משתמש ב-Google. למשתמשים שלא נמצאים במדינה בארה"ב עם הגבלות על פרטיות, הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_cver |
גרסת קובץ ה-cookie. הערך הזה תמיד יצוין בתג ההתאמה של Google. |
google_push |
הבקשה הזו מפעילה את תהליך העבודה של התאמת הפיקסלים. צריך להחזיר את הערך דרך הפרמטר התואם בתגובה להפניה אוטומטית של המגיש. |
gdpr_consent |
מחרוזת TC שמייצגת את הסכמת משתמש הקצה. פרטים נוספים זמינים במאמר [דרישות הסכמת משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements), או בקטע **איך תישלח מחרוזת ה-TC?** במסמכי התיעוד של IAB TCF v2.0 ל-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 |
מחרוזת TC שמייצגת את הסכמת משתמש הקצה. למידע נוסף, אפשר לעיין במאמר [דרישות להסכמת משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) או בקטע **איך תישלח מחרוזת ה-TC?** במסמכי התיעוד של IAB TCF v2.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 התואמת של Cooking של המציע.
הדפדפן של המשתמש מבקש פיקסל מכתובת ה-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.user.buyeruid.
בנוסף, בידי המגישים של הצעות המחיר יש אפשרות לאכלס רשימות של משתמשים באמצעות נתוני ההתאמה המאוחסנים שציינו.
לבסוף, Google מחזירה פיקסל שקוף בגודל 1x1 לדפדפן של המשתמש.
התאמת קובצי Cookie
פלטפורמות ה-Exchange יכולות להשתמש בתהליכי עבודה של התאמת קובצי cookie ביוזמתו של המגיש וביוזמתו של Google כדי להתאים מזהה משתמש ב-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 בזירת המסחר לקבל בקשה ל-pixel.
- נקודת הקצה של התאמת קובצי ה-cookie של פלטפורמת ה-Exchange מקבלת את הבקשה, שם שירות התאמת קובצי ה-cookie שלה אחראי להתאמת מזהה המשתמש לאחד מהמגישים של הצעות המחיר. בתרשים הבא, שירות ההתאמה של קובצי ה-cookie של פלטפורמת ה-Exchange משיב לדפדפן של המשתמש בהפניה אוטומטית לאחד מנקודות הקצה של המגישים.
- המגיש הצעת המחיר מקבל את הבקשה, יחד עם הפרמטרים שצוינו על ידי פלטפורמת ה-Exchange כדי להתאים את מזהה המשתמש לקובץ ה-cookie שלו.
הגבלות
הגבלת התדירות של בקשות להתאמות חדשות
בידי המגישים של הצעות המחיר נמצאת האחריות להגביל את מספר הקריאות לשירות התאמת קובצי ה-cookie למשתמשים שיש להם רשומה עדכנית בטבלת ההתאמה שמתארחת ב-Google. רשומה בטבלת ההתאמות המארחת עשויה להיחשב כפגה אחרי 14 ימים, ואז אפשר יהיה לרענן אותה.
תגובה לכל הבקשות להתאמה לפי פיקסל
בידינגרים שמשתמשים בתהליך העבודה של התאמת פיקסלים צפויים להשיב לכל הבקשות הנכנסות של התאמת פיקסלים בתשובה שכוללת את הפרמטר google_push. כך Google יכולה לאכוף את כללי המדיניות על ידי מעקב אחרי השימוש. אם שיעור התשובות של מבצע בידינג נמוך מ-90%, Google תצמצם את מספר הבקשות של Pixel Match שנשלחות לחשבון שלו.
שימוש בנקודות קצה מסוג HTTPS
נקודות הקצה שמשמשות בכל תהליכי העבודה של התאמת קובצי Cookie חייבות להשתמש ב-HTTPS.
כשמשיבים לבקשה של Pixel Match שנשלחת אליכם ב-HTTPS, צריך להפנות אוטומטית לשירות התאמת קובצי ה-cookie ב-HTTPS. באופן דומה, גם נקודת קצה של Cookie Match Assist שמפנה למגישי הצעות מחיר חייבת להשתמש ב-HTTPS. אם תשלחו בקשות ל-Google באמצעות HTTP בתדירות גבוהה יותר מפעם ב-2 דקות, מספר הבקשות להתאמה שיישלחו לחשבון שלכם יצומצם.
הדרישות לקבלת הסכמה ממשתמשים באיחוד האירופי
בקשות להתאמת קובצי cookie כפופות למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, וצריך לציין בהן את הסכמת משתמשי הקצה. בבקשות כאלה צריך לציין שההסכמה התקבלה באחת מהדרכים הבאות:
- TCFv2: הנתונים האלה כוללים את הפרמטרים
gdprו-gdpr_consent. פרטים נוספים זמינים במסמכי העזרה של Authorizes Buyers בנושא TCF גרסה 2.0 של IAB. 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, ולא מתכוונים לשמור התאמה עם מזהה המשתמש ב-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.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.