התאמות של קובצי Cookie

התאמת קובצי cookie היא תכונה שמאפשרת להתאים את קובץ ה-cookie שלכם – לדוגמה, מזהה של משתמש שגלש באתר שלכם – למזהה משתמש ב-Google שתואם למגיש הצעות המחיר, וליצור רשימות של משתמשים שיעזרו לכם לקבל החלטות יעילות יותר לגבי בידינג. במדריך הזה מתוארים מושגים שנעשה בהם שימוש בהתאמת קובצי 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. בהטמעת OpenRTB של Google, יציין BidRequest.user.buyeruid כמחרוזת בקידוד base64 שמתאימה לאינטרנט. אם נקודת הקצה של הבידינג מוגדרת לשימוש בפרוטוקול Google RTB שהוצא משימוש, הנתונים האלה יתקבלו כבייטים מפוענחים דרך השדה BidRequest.hosted_match_data.

  • רשימות משתמשים: אפשר לאכלס רשימות משתמשים במזהי משתמשים של Google או בנתוני התאמה שמתארחים.

  • טירגוט מראש: אפשר להגדיר את הטירגוט מראש כך שתקבלו רק בקשות להצעות מחיר שמכילות נתוני התאמה שמתארחים. אפשר להשתמש בנתונים האלה כדי למנוע חשיפות פחות רלוונטיות למשתמשים מחוץ למרחב של קובצי ה-cookie.

רשימות משתמשים

אפשר ליצור ולנהל רשימות משתמשים באמצעות Real-Time Bidding API. אחרי שיוצרים את הרשימות האלה, אפשר לאכלס את הרשימות האלה בתהליכי העבודה של התאמות של קובצי cookie שמתוארים בהמשך, או דרך שירות ההעלאה בכמות גדולה.

תחילת העבודה

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

  • מזהה רשת להתאמת קובצי cookie (NID): מזהה מחרוזת שמזהה באופן ייחודי חשבון של מציע מחיר לצורך התאמת קובצי cookie ופעולות קשורות אחרות.
  • Cookie matching URL: כתובת ה-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, בדרך כלל מצורפים פרמטרים לכתובת ה-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, וההטמעה שלו דורשת פרמטרים מוגדרים מראש שהוגדרו על ידי מגיש הצעות המחיר, בנוסף לפרמטר של התאמת פיקסלים, לפי הסדר הבא: 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 של Google תומך כרגע בשלושה תהליכי עבודה לתרחישי שימוש שונים, שמפורטים בהמשך.

התאמת קובצי 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 ב-OpenRTB או באמצעות BidRequest.google_user_id בפרוטוקול RTB של Google שהוצא משימוש.

הגרסה שצוינה ב-google_cver מציינת את מספר הגרסה המספרי של מזהה המשתמש ב-Google. מזהה המשתמש ב-Google של משתמש נתון ישתנה לעיתים רחוקות, ולאחר מכן המזהה יגדל.

אם Google נתקלה בשגיאה במהלך העיבוד של בקשת ההתאמה, במקום זאת יופיע פרמטר google_error.

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

מגיש הצעות המחיר מקבל הפניה אוטומטית לכתובת ה-URL שתואמת לקובצי cookie, כולל הפרמטרים שהוא ציין בשלב הראשון ופרמטרים ש-Google סיפקה בשלב השני. בנוסף, הם יקבלו את קובץ ה-cookie שלהם בכותרות ה-HTTP. אם הפעולה תתבצע בהצלחה, מגיש הצעות מחיר שמארח טבלת התאמה משלו יוכל להתאים את קובץ ה-cookie שלו למזהה המשתמש ב-Google שכלול בתגובה. מומלץ למשתתפים במכרזים לשמור את המחרוזת המדויקת שמוחזרת על ידי שירות התאמת קובצי ה-cookie.

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

המגיש הצעת המחיר חייב תמיד להגיב על ידי הצגת תמונה של פיקסל בלתי נראה בגודל 1x1, או לחלופין להחזיר תגובה מסוג HTTP 204 No Content.

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

התאמת פרמטרים של כתובת אתר של תג

פרמטר תיאור
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 בייטים או פחות. לדוגמה, Q29va2llIHRoYXQgaXMgdW5kZXIgNDAgdG90YWwgYnl0ZXMuLi4u.

google_redir מחרוזת בקידוד של כתובת URL שהמגיש יכול לציין אם הוא רוצה להורות ל-Google לשלוח את ההפניה האוטומטית HTTP 302 לכתובת ה-URL הקודדת של תג ההתאמה הזה. כך Google תמוקם בחזית בשיחה משורשרת לשותפים. אם תציינו את השדה בלי google_hm או עם google_cm, תופיע שגיאה.
google_ula מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
  • userlistid: מזהה של רשימת משתמשים מספרית אחת.
  • timestamp: חותמת זמן אופציונלית בפורמט POSIX, שמציינת מתי המשתמש נוסף לרשימת המשתמשים.

יכול להיות שחוזרים על הפרמטר הזה של כתובת URL כדי להוסיף את המשתמש לכמה רשימות.
gdpr מציין שהבקשה כפופה להגבלות של GDPR על השימוש בנתונים. לקבלת פרטים נוספים, אפשר לעיין בקטע הדרישות לקבלת הסכמת משתמשים באיחוד האירופי בהמשך, או במאמר ההשפעה על הכשירות של התאמת קובצי cookie ב מסמכי התיעוד בנושא TCF גרסה 2.0 של Authorized Buyers של IAB.

לדוגמה: gdpr=1
gdpr_consent מחרוזת TC שמייצגת את הסכמת משתמש הקצה. למידע נוסף, ראו דרישות לקבלת הסכמת משתמשים באיחוד האירופי בהמשך, או איך המחרוזת של נתוני השקיפות וההסכמה תועבר? במסמכים של Authorized Buyers בנושא IAB TCF v2.0.
process_consent מציין שמגיש הצעות המחיר קיבל הסכמה ממשתמשי הקצה לשימוש בנתונים שצוינו במדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.

אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש פרמטרים אחרים של הסכמה זמינים בבקשה (gdpr_consent), המערכת תתעלם מהפרמטר הזה.

לדוגמה: process_consent=T

בנוסף לפרמטרים שלמעלה, בידי המגישים של הצעות המחיר יש אפשרות לציין פרמטרים משלהם, שיצורפו כפרמטרים לכתובת ה-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_. הערכים הנתמכים של השגיאות הם:

  • 1: למשתמש יש קובץ Cookie של Google, אבל הוא ביטל את ההסכמה למעקב באמצעות קובץ ה-cookie הזה.
  • 2: לא צוינו פעולות חוקיות. לדוגמה, התקבלה בקשה ללא פעולה.
  • 3: למשתמש אין קובץ cookie של Google. Google לא תגדיר את קובץ ה-cookie דרך שירות התאמת קובצי ה-cookie.
  • 4: צוינו פעולות סותרות. אי אפשר לציין את הדגל google_push וגם את הדגל google_cm באותה בקשה כי יש להם מטרות מתנגשות.
  • 5: פרמטר google_push לא חוקי הועבר בהפניה אוטומטית לשרת של Google כחלק מבקשה דו-כיוונית של התאמת פיקסלים. בהפניה האוטומטית צריך להגדיר את google_push לאותו ערך שהוענק לכם בבקשה הראשונית של ה-pixel.
  • 6: סופק NID לא תקין בתג ההתאמה.
  • 7: זוהה קובץ cookie לא חוקי.
  • 8: הוצא משימוש. לא נמצא קובץ cookie.
  • 9: לא נמצא קובץ cookie, מתבצעת ניסיון להגדיר קובץ cookie לבדיקה.
  • 10: נעשה שימוש בפרמטר google_redir בלי לציין את google_hm, או נעשה בו שימוש בנוסף ל-google_cm.
  • 15: הבקשה מגיעה מאזור שבו Google דורשת ש-Google תארח את טבלת ההתאמות. לכן התגובה הזו לא מכילה מזהה משתמש ב-Google. בשלב הזה התכונה הזו מופעלת רק לאחוז קטן מהתנועה, אבל היא אמורה לפעול במלואה ביוני 2020.
google_hm

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

  • 1 – אסור: הלקוח עדיין לא נכלל ברשימת ההיתרים לכתיבה של רשומות בטבלת ההתאמות המארחת.
  • 2 – שגיאת פענוח: לא ניתן היה לפענח את ערך הפרמטר.
  • 3 – המטען הייעודי (Payload) ארוך מדי: ערך הפרמטר מפוענח ליותר מ-24 בייטים של נתונים.
  • 4 – שגיאה פנימית: אירעה שגיאה פנימית בשמירת הנתונים.
  • 5 – ויסות נתונים: הכתיבה הזו לא טופלה בגלל ויסות נתונים.
google_ula

סטטוס הפעולה להוספת רשימת משתמשים, חוזר על עצמו אם צוינו בבקשה כמה google_ula. הפורמט הוא:
userlistid,status code

דוגמה: google_ula=1234567890,0

הפעולה google_ula יכולה להחזיר כל אחד מקודי הסטטוס הבאים:

  • 0 – אין שגיאה. המשתמש נוסף לרשימת המשתמשים.
  • 2 – ההרשאה נדחתה. אין לכם הרשאה להוסיף משתמשים לרשימת המשתמשים הנתונה.
  • 5 – מזהה רשימת משתמשים שגוי. מזהה רשימת המשתמשים שצוין לא תקין.
  • 6 – מזהה המאפיין הסגור. מזהה רשימת המשתמשים שצוין סגור.
  • 10 – שגיאה פנימית. שירות התאמת קובצי ה-cookie נתקל בשגיאה פנימית. אפשר לנסות להתאים שוב את המשתמש.

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

תרחיש 1: משתמש מנקה את קובצי ה-cookie שלו וגולש באתר

דנה מנקה את המטמון של כל קובצי ה-Cookie. לאחר מכן הם נכנסים לדף הבית של ExampleNews.com.

הנה תיאור של התהליך:

  1. הדומיין ExampleNews.com מציג מודעות מ-Google (Ad Manager) ומפעיל אותן.
  2. מאחר שיחידת המודעות כשירה להקצאה דינמית, Google שולחת בקשות להצעות מחיר אל FinestDSP ומגישי הצעות מחיר אחרים דרך השירות 'בידינג בזמן אמת'.
  3. אפליקציית הבידינג של FinestDSP מקבלת את בקשת הצעת המחיר ומעבדת אותה, ואז שולחת את תגובת הצעת המחיר.
  4. Google מקבלת תגובות להצעות מחיר ממגישי הצעות המחיר, כולל התגובה של FinestDSP שמציינת מודעה עם תג התאמה (פיקסל).
  5. FinestDSP זוכה במכרז. Google מציגה את המודעה ואת תג ההתאמה של FinestDSP ל-Jane.
  6. תג ההתאמה קורא לשירות התאמת קובצי ה-cookie של Google, ומציין את הפרמטרים google_nid ו-google_cm.
  7. שירות התאמת קובצי ה-Cookie קורא את קובץ ה-Cookie של Google של גלית, ושולח לדפדפן של דנה הפניה אוטומטית לכתובת האתר של התאמת קובצי ה-Cookie של FinestDSP עם הפרמטרים google_gid ו-google_cver שהוגדרו.
  8. הדפדפן של דנה טוען את ההפניה האוטומטית לכתובת ה-URL של התאמת קובצי Cookie של FinestDSP.
  9. נקודת הקצה של FinestDSP להתאמת קובצי cookie מעבדת את בקשת ההפניה האוטומטית, שכוללת פרמטרים של כתובת URL שהוגדרו על ידי Google ואת קובץ ה-cookie של עינת בכותרות ה-HTTP. עכשיו מערכת FinestDSP יכולה לאחסן את המיפוי של ה-cookie שלה למזהה google_gid בטבלת ההתאמה שלה.
  10. מערכת FinestDSP מגיבה להפניה האוטומטית באמצעות פיקסל 1x1 בלתי נראה.
תרחיש 2: משתמש עם מיפוי קיים

שבוע אחרי התרחיש הראשון, ג'יין נכנסת שוב לאתר ExampleNews.com. עכשיו, אחרי שגם קובצי ה-cookie של המגיש הצעות המחיר וגם קובצי ה-cookie של Ad Manager נמצאים במחשב של ג'יין, זה האופן שבו מתבצע ההתאמה.

  1. דף האינטרנט מוצג, וכתוצאה מכך Google‏ (Ad Manager) שולחת בקשה להצגת מודעות שיוצגו בדף.
  2. במהלך מכרז המודעות, Google שולחת בקשה להצעת מחיר למגישי הצעות המחיר הרלוונטיים, כולל FinestDSP.
  3. FinestDSP מקבל את הבקשה להצעת מחיר, כולל אותות כמו google_gid.
  4. שירות FinestDSP מחפש את השדה google_gid בטבלת ההתאמות, ומוצא את קובץ ה-cookie שמשויך לג'יין שנוצר שבוע קודם לכן (בתרחיש 1).
  5. על סמך המידע שמשויך לקובץ ה-cookie, לוגיק הבידינג של FinestDSP שולח הצעת מחיר על החשיפות וזוכה במכרז.
  6. יכול להיות שג'יין תראה מודעה שמותאמת לתחומי העניין שלה, על סמך מידע שנמצא בידי FinestDSP.

התאמת קובצי cookie בכיוון אחד דומה לתהליך העבודה הדו-כיווני, אלא שהיא משתנה כך שרק Google מארחת ומאכלסת את טבלת ההתאמות. אפשר להשתמש באפשרות הזו במקרים שבהם מגיש הצעות המחיר לא מורשה לארח מזהי משתמשים של Google בטבלת התאמות משלו. כדי להשתמש בתהליך הזה, מגישי הצעות המחיר חייבים לאפשר ל-Google לארח את טבלת ההתאמות, לא יכולים יותר לציין את הערך google_cm בבקשות ל-Cookie Adjust Service של Google, וכתוצאה מכך לא יקבלו את הפרמטר google_gid כדי לאכלס את טבלת ההתאמות שלהם. אחרי ש-Google תזהה התאמה למשתמש, בעלי הצעות המחיר יוכלו להוסיף אותו לרשימות של משתמשים באמצעות נתוני קובצי ה-cookie שלהם. באופן דומה, בקשות להצעת מחיר של המשתמשים האלה לא יכללו את מזהה המשתמש ב-Google, אבל יכללו נתוני התאמה מתארחים. דוגמה פשוטה לתהליך העבודה המעודכן מפורטת בשלבים הבאים.

כדי להתחיל את התהליך הזה, המשתתף במכרז צריך להציב תג התאמה כך שיוצג בדפדפן של המשתמש. בניגוד לתהליך העבודה למשתמשים שלא נמצאים במדינות ארה"ב עם הגבלות פרטיות, תג ההתאמה צריך להפנות את הדפדפן של המשתמש לכתובת ה-URL להתאמה לפי קובצי cookie. לדוגמה, עם כתובת URL שתואמת לקובצי Cookie שהוגדרה כ-https://ad.network.com/pixel, היא תיראה כך:

<img src="https://ad.network.com/pixel" />

כשהמודעה נטענת בדפדפן של המשתמש, היא מבקשת פיקסל מכתובת ה-URL של התאמת קובצי ה-Cookie של המגיש. הבקשה הזו תכלול את קובץ ה-cookie שלהם בכותרת ה-HTTP, שצריך לחלץ בשלב הבא.

נקודת הקצה של התאמת קובצי ה-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 תקבל הפניה אוטומטית שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP.

שלב 4: Google מציגה פיקסל בהפניה אוטומטית לאחר השלמת הבדיקה או לאחר שגיאה, אם צוינה כתובת ה-URL של הדוח

אם פעולת ההתאמה של קובצי ה-cookie תצליח – או אם לא צוינה כתובת URL של דוח התאמה של קובצי cookie בחשבון של המגיש – Google תציג פיקסל שקוף בגודל 1x1 כברירת מחדל, ותהליך העבודה יסתיים כאן. החשיפות למשתמש הזה בבקשות הבאות להצעת מחיר יכללו את נתוני ההתאמה של מגיש הצעות המחיר שמתארחים ב-BidRequest.user.buyeruid בשביל OpenRTB או ב-BidRequest.hosted_match_data בשביל פרוטוקול RTB של 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" />

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

שלב 6: המשתתף במכרז מציג פיקסל שקוף בגודל 1x1

המגיש הצעת המחיר צריך להגיב על כך על ידי הצגת פיקסל שקוף בגודל 1x1 בדפדפן של המשתמש.

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

פרמטר תיאור
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]:
  • userlistid: מזהה של רשימת משתמשים מספרית אחת.
  • timestamp: חותמת זמן אופציונלית בפורמט POSIX, שמציינת מתי המשתמש נוסף לרשימת המשתמשים.

יכול להיות שחוזרים על הפרמטר הזה של כתובת URL כדי להוסיף את המשתמש לכמה רשימות.
gdpr מעיד על כך שהבקשה כפופה להגבלות של GDPR על שימוש בנתונים. פרטים נוספים זמינים בקטע דרישות לקבלת הסכמת משתמשים באיחוד האירופי בהמשך, או בקטע השפעה על הזכאות להתאמה לפי קובצי cookie במסמכים של Authorized Buyers בנושא IAB TCF v2.0.

לדוגמה: gdpr=1
gdpr_consent מחרוזת TC שמייצגת את הסכמת משתמש הקצה. לקבלת פרטים נוספים, אפשר לעיין בקטע הדרישות לקבלת הסכמת משתמשים באיחוד האירופי למטה, או במאמר איך יועברו נתוני השקיפות וההסכמה? במסמכי התיעוד של IAB TCF בגרסה 2.0 של Authorized Buyers.
process_consent הנתון הזה מציין שהמגיש של הצעת המחיר קיבל הסכמה ממשתמשי הקצה לשימושים בנתונים שצוינו ב מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי.

אם הבקשה לא כפופה למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, או אם יש פרמטרים אחרים של הסכמה שזמינים בבקשה (gdpr_consent), הפרמטר הזה לא מטופל.

לדוגמה: process_consent=T
פרמטר תיאור
google_error

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

  • 1: למשתמש יש קובץ Cookie של Google, אבל הוא ביטל את ההסכמה למעקב באמצעות קובץ ה-cookie הזה.
  • 2: לא צוינו פעולות חוקיות. לדוגמה, התקבלה בקשה ללא פעולה.
  • 3: למשתמש אין קובץ cookie של Google. Google לא תגדיר את קובץ ה-cookie דרך שירות התאמת קובצי ה-cookie.
  • 4: צוינו פעולות סותרות. אי אפשר לציין את הדגל google_push וגם את הדגל google_cm באותה בקשה כי יש להם מטרות מתנגשות.
  • 5: פרמטר google_push לא חוקי הועבר בהפניה אוטומטית לשרת של Google כחלק מבקשה דו-כיוונית של התאמת פיקסלים. בהפניה האוטומטית צריך להגדיר את google_push לאותו ערך שהוענק לכם בבקשה הראשונית של ה-pixel.
  • 6: סופק NID לא תקין בתג ההתאמה.
  • 7: זוהה קובץ cookie לא חוקי.
  • 8: הוצא משימוש. לא נמצא קובץ cookie.
  • 9: לא נמצא קובץ cookie, מתבצעת ניסיון להגדיר קובץ cookie לבדיקה.
  • 10: נעשה שימוש בפרמטר google_redir בלי לציין את google_hm, או נעשה בו שימוש בנוסף ל-google_cm.
  • 15: הבקשה מגיעה מאזור שבו Google דורשת ש-Google תארח את טבלת ההתאמות. לכן התגובה הזו לא מכילה מזהה משתמש ב-Google. האפשרות הזו מופעלת כרגע רק לחלק קטן מתנועת הגולשים, אבל אנחנו מתכננים להפעיל אותה באופן מלא ביוני 2020.

ביוזמת 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" />

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

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

פרמטרים של בקשות של תג התאמה של Google

פרמטר תיאור
google_gid מזהה משתמש ב-Google. למשתמשים שלא נמצאים במדינות בארה"ב עם הגבלות על פרטיות, הערך הזה תמיד יצוין בתג ההתאמה של Google.
google_cver גרסת קובץ ה-cookie. הערך הזה תמיד יצוין בתג ההתאמה של Google.
google_push הבקשה הזו מפעילה את תהליך העבודה של התאמת הפיקסלים. צריך להחזיר את הערך דרך הפרמטר המתאים בתגובה להפניה אוטומטית של המגיש.
gdpr_consent מחרוזת TC שמייצגת את הסכמת משתמש הקצה. פרטים נוספים זמינים בקטע [דרישות הסכמה של משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements) שבהמשך, או בקטע **איך המחרוזת של נתוני השקיפות וההסכמה תועבר?** במסמכי התיעוד של IAB TCF v2.0 ל-Authorized Buyers‏ (//support.google.com/authorizedbuyers/answer/9789378).

פרמטרים להפניה אוטומטית של Bidder Pixel Matching

פרמטר תיאור
google_nid מזהה הרשת (NID) של חשבון המגיש הצעות המחיר. אפשר לאחזר את המזהה הזה דרך המשאב Bidders.
google_push מציין שההפניה האוטומטית משלימה את תהליך העבודה של התאמת Pixel. צריך לציין כאן את הערך מתג ההתאמה המתאים של Google.
google_hm

מכיל נתונים שהמגיש/ת הצעות המחיר רוצה לאחסן בטבלת התאמות שמתארחת ב-Google.
google_ula מחרוזת שמשמשת להוספת המשתמש לרשימת משתמשים קיימת. הפורמט הצפוי של הערך הוא userlistid[,timestamp]:
  • userlistid: מזהה של רשימת משתמשים מספרית אחת.
  • timestamp: חותמת זמן אופציונלית בפורמט POSIX, שמציינת מתי המשתמש נוסף לרשימת המשתמשים.

אפשר לחזור על פרמטר כתובת ה-URL הזה כדי להוסיף את המשתמש לכמה רשימות.
gdpr_consent מחרוזת נתוני שקיפות והסכמה שמייצגת את ההסכמה ממשתמשי הקצה. פרטים נוספים מופיעים בהמשך בקטע [דרישות הסכמה של משתמשים באיחוד האירופי](/authorized-buyers/rtb/cookie-guide#eu-user-consent-requirements), או בקטע **איך המחרוזת של נתוני השקיפות וההסכמה תועבר?** במסמכי התיעוד של [Authorized Buyers IAB TCF v2.0](//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.

נקודת הקצה של התאמת קובצי ה-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

Google תקבל הפניה אוטומטית שמכילה את הפרמטרים שציינתם, בנוסף לקובץ ה-cookie של Google בכותרות ה-HTTP. אם הפעולה תתבצע בהצלחה, החשיפות של המשתמש הזה בבקשות הצעות המחיר הבאות יכללו את נתוני ההתאמה המאוחסנים של המגיש ב-BidRequest.user.buyeruid ב-OpenRTB, או ב-BidRequest.hosted_match_data בפרוטוקול Google RTB שהוצא משימוש. בנוסף, בידי המגישים של הצעות המחיר יש אפשרות לאכלס רשימות של משתמשים באמצעות נתוני ההתאמה המארחים שציינו.

לבסוף, Google מחזירה פיקסל שקוף בגודל 1x1 לדפדפן של המשתמש.

פלטפורמות ה-Exchange יכולות להשתמש בתהליכי עבודה של התאמת קובצי cookie ביוזמתו של המגיש וביוזמתו של Google כדי להתאים מזהה משתמש ב-Google לקובץ ה-cookie שלו. cookie Match Assist (CMA) הוא תכונה נוספת לבורסות פרסום שמאפשרת להן ליצור טבלאות של התאמות עם מגישי הצעות המחיר שלהם.

  1. כשמציבים מודעה, Google בוחרת באופן אלגוריתמי בורסה משתתפת ומציבה תג Cookie Match Assist במבנה הבא:

    <img src="https://ob.exchange.com/pixel?google_gid=GOOGLE_GID&google_cver=1"/>

  2. תג ההתאמה של CMA של Google גורם לכך שכתובת ה-URL של התאמת קובצי ה-cookie בזירת המסחר תקבל בקשה ל-pixel.

  3. נקודת הקצה של התאמת קובצי ה-cookie של פלטפורמת ה-Exchange מקבלת את הבקשה, שם שירות התאמת קובצי ה-cookie שלה אחראי להתאמת מזהה המשתמש לאחד מהמגישים. בתרשים הבא, שירות התאמת קובצי ה-Cookie של הבורסה מגיב לדפדפן של המשתמש עם הפניה אוטומטית לאחת מנקודות הקצה של מגיש הצעות המחיר.
  4. מגיש הצעות המחיר מקבל את הבקשה, ביחד עם הפרמטרים שצוינו על ידי פלטפורמת ה-Exchange, כדי להתאים בין מזהה המשתמש לקובץ ה-cookie שלו.

הגבלות

מכסת התדירות של הבקשות להתאמות חדשות

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

תגובה לכל הבקשות להתאמה לפי פיקסל

בידינגרים שמשתמשים בתהליך העבודה של התאמת פיקסלים צפויים להשיב לכל הבקשות הנכנסות של התאמת פיקסלים בתשובה שכוללת את הפרמטר google_push. כך Google יכולה לאכוף את כללי המדיניות על ידי מעקב אחרי השימוש. אם שיעור התגובה של מגיש הצעות המחיר יורד מתחת ל-90%, Google תנטרל את מספר בקשות ההתאמה ל-Pixel שנשלחו לחשבון שלו.

שימוש בנקודות קצה מסוג HTTPS

נקודות הקצה שמשמשות בכל תהליכי העבודה של התאמת קובצי Cookie חייבות להשתמש ב-HTTPS.

כשמשיבים לבקשה של התאמת פיקסלים שנשלחת אליכם ב-HTTPS, צריך להפנות אוטומטית לשירות התאמת קובצי ה-cookie ב-HTTPS. באופן דומה, גם בנקודת קצה של Cookie Match Assist שמפנה למגישי הצעות המחיר צריך להשתמש ב-HTTPS. אם תשלחו בקשות ל-Google באמצעות HTTP בתדירות גבוהה יותר מפעם ב-2 דקות, מספר בקשות ההתאמה שיישלחו לחשבון שלכם יצומצם.

בקשות להתאמת קובצי cookie כפופות למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, וצריך לציין בהן את הסכמת משתמשי הקצה. בבקשות כאלה צריך לציין שההסכמה התקבלה באחת מהדרכים הבאות:

דוגמאות

הדוגמאות הבאות ממחישות איך להשתמש בשירות התאמת קובצי 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 ולהוסיף את המשתמש לרשימת משתמשים בבקשה אחת, תג ההתאמה של המגיש הצעת המחיר צריך לכלול את 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 ב-OpenRTB, או ב-BidRequest.hosted_match_data בפרוטוקול Google RTB שהוצא משימוש.

אם במקום זאת המגיש הצעת המחיר השתמש בתג התאמה שבו הערך של google_hm לא היה בקידוד base64 – למשל chocolate_chunk! – כתובת ה-URL להפניה אוטומטית עשויה להיראות כך:

https://cookie-monster.com/pixel?google_hm=2

כתובת ה-URL להפניה אוטומטית שלמעלה כוללת ערך google_hm של 2, מה שמצביע על כך שהפעולה נכשלה כי לא ניתן היה לפענח את הערך.

טבלאות של התאמות של מגישי הצעות מחיר ושל Google שמתארחות ב-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 ב-OpenRTB, או ב-BidRequest.hosted_match_data בפרוטוקול Google RTB שהוצא משימוש.