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

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

• רשימות משתמשים: אפשר לאכלס רשימות משתמשים במזהי משתמשים של 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%%. אלה המאקרוים הנתמכים והערכים המורחבים שלהם:

דוגמה למאקרו

למגיש הצעות המחיר יש שילוב של התאמות של קובצי 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

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

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

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

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

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

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

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

תרשים של תהליך העבודה של התאמות של קובצי Cookie

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

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

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

<img src="https://cm.g.doubleclick.net/pixel?google_nid=BIDDER_ACCOUNT_NID&google_cm&extra1=xx&extra2=yy" />

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

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

תרחישים לדוגמה של תהליך העבודה של התאמות של קובצי 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, ושולח לדפדפן של ג'יין הפניה לכתובת ה-URL של FinestDSP להתאמת קובצי cookie, עם ההגדרה של הפרמטרים google_gid ו-google_cver.
8. הדפדפן של ג'יין טוען את ההפניה לכתובת ה-URL של FinestDSP להתאמה לקובצי cookie.
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 שמשויך ל-Jane ונוצר שבוע קודם (בתרחיש 1).
5. על סמך המידע שמשויך לקובץ ה-cookie, לוגיק הבידינג של FinestDSP שולח הצעת מחיר על החשיפות וזוכה במכרז.
6. יכול להיות שג'יין תראה מודעה שמותאמת לתחומי העניין שלה, על סמך מידע שנמצא בידי 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 עבור OpenRTB, או ב-BidRequest.hosted_match_data עבור פרוטוקול Google RTB שהוצא משימוש. בנוסף, בידי המגישים של הצעות המחיר יש אפשרות לאכלס רשימות של משתמשים באמצעות נתוני ההתאמה המארחים שציינו.

אחרת, אם תתרחש שגיאה, 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

פרמטרים של כתובות URL להפניה אוטומטית של Google לכתובת ה-URL של דוח ההתאמה של קובצי cookie של המציע

ביוזמת 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: התאמת פיקסלים חד-כיוונית

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

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

התאמת קובצי Cookie

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

איך פועלת התכונה Cookie Match Assist

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

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

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

3. נקודת הקצה של התאמת קובצי ה-cookie של פלטפורמת ה-Exchange מקבלת את הבקשה, שם שירות התאמת קובצי ה-cookie שלה אחראי להתאמת מזהה המשתמש לאחד מהמגישים. בתרשים הבא, שירות ההתאמה של קובצי ה-cookie של פלטפורמת ה-Exchange משיב לדפדפן של המשתמש בהפניה אוטומטית לאחד מנקודות הקצה של המגישים.
4. המגיש הצעת המחיר מקבל את הבקשה, יחד עם הפרמטרים שצוינו על ידי פלטפורמת ה-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 ב-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_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 שהוצא משימוש.