מדידה של מקרים שבהם קליק על מודעה או צפייה בה מובילים להמרה, למשל רכישה באתר של המפרסם.
למי ההדרכה הזו מיועדת?
כאן נסביר את העקרונות הבסיסיים של דוחות השיוך וחלק מהמושגים הבסיסיים, אבל לא נרחיב על פרטים טכניים.
- אם אתם עובדים בתחום הפרסום או טכנולוגיות הפרסום, תוכלו ללמוד איך ה-API הזה מספק יכולות שפועלות באמצעות קובצי cookie של צד שלישי. מומלץ לעיין בתרחישי השימוש של ה-API, שבהם מוסבר בפירוט איך הדוחות נוצרים.
- מפתחים או מהנדסי תוכנה יכולים לעבור לסקירה הכללית המלאה של המערכת או לנסות את ה-API ולהשתתף בו.
מפרסמים ובעלי תוכן דיגיטלי שמסתמכים על פלטפורמות טכנולוגיות לפרסום למדידת המרות לא צריכים להשתמש ב-API ישירות. אם אתם מתכננים לשלב את פלטפורמת טכנולוגיית הפרסום שלכם עם ה-API הזה, כדאי לכם להבין איך פועל דיווח השיוך (Attribution).
מה זה Attribution Reporting API?
כיום, מדידת ההמרות ממודעות מתבססת לעיתים קרובות על קובצי Cookie של צד שלישי. הדפדפנים מגבילים את הגישה לקובצי cookie של צד שלישי כי אפשר להשתמש בהם כדי לעקוב אחרי משתמשים באתרים שונים ולפגוע בפרטיות שלהם.
Attribution Reporting API מאפשר לבצע את המדידות האלה בצורה שמכבדת את הפרטיות, בלי קובצי cookie של צד שלישי.
ה-API הזה מאפשר למפרסמים ולספקי טכנולוגיות פרסום למדוד המרות במקרים הבאים:
- קליקים וצפיות במודעות.
- מודעות ב-iframe של צד שלישי, כמו מודעות באתר של בעל תוכן דיגיטלי שמשתמש בספק צד שלישי של טכנולוגיית פרסום.
- מודעות בהקשר של צד ראשון, כמו מודעות ברשת חברתית או בדף תוצאות של מנוע חיפוש, או מודעות של בעלי תוכן דיגיטלי שמוצגות באתר שלהם.
אם חלק מהמונחים או מהמושגים האלה לא מוכרים לכם, תוכלו לעיין במילון של ארגז החול לפרטיות.
התנסות ב-API
- בדיקה מקומית בדפדפן. להגדיר דגל, שמורה לדפדפן Chrome להפעיל תכונות ניסיוניות ספציפיות.
אם אתם רוצים להתנסות ב-API, תוכלו לעבור למאמר דיווח שיוך: ניסוי והשתתפות.
שינויים ב-API
- לעקוב אחרי שינויי ה-API.
- למה השקנו את Attribution Reporting API במחצית הראשונה של שנת 2023?
זמינות
הצעה | סטטוס |
---|---|
תהליך ההמרה: מהאפליקציה לאינטרנט הסבר על האתר והסבר על Android הודעה ברשימה לקבלת אימייל |
זמינה ב-Chrome וב-Android לניסיון מקור |
תהליך ההמרה: חוצה-מכשירים הסבר |
ההצעה הזו הועברה לארכיון. אין כרגע תוכניות להטמעה. |
מניעת דוחות לא תקינים שאפשר לצבור באמצעות אימות דוחות הסבר |
ההצעה הזו הועברה לארכיון. במקום זאת, הטמענו את trigger_context_id לתרחיש לדוגמה הזה. |
רשימת ההיתרים שמוגדרת כברירת מחדל למדיניות ההרשאות של Attribution Reporting API תישאר * הודעה ברשימה לעדכונים |
התכונה תהיה זמינה ב-Chrome ברבעון הראשון של 2023 |
epsilon של דיווח ברמת האירוע שאפשר להגדיר בעיה ב-GitHub |
התכונה תהיה זמינה ב-Chrome ברבעון הרביעי של שנת 2023 |
מילוי (padding) של עומס העבודה (payload) של דוחות שניתנים לצבירה הסבר מעודכן |
התכונה תהיה זמינה ב-Chrome ברבעון הרביעי של שנת 2023 |
גמישות ברמת האירוע הסבר על הגדרות גמישות ברמת האירוע |
זמין ב-Chrome ברבעון 4 של 2023
היכולת להתאים אישית את מספר דוחות השיוך ואת מספר החלונות או את אורך החלונות לדיווח. התכונה תהיה זמינה ב-Chrome ברבעון הראשון של 2024 היכולת להתאים אישית את מספר הביטים של נתוני הטריגר. |
תמיכה בדוחות מפורטים של ניפוי באגים בדוחות השיוך (Attribution) שלא תלויים בקובצי Cookie של צד שלישי הסבר |
התכונה תהיה זמינה ב-Chrome ברבעון השלישי של 2024 |
תמיכה ב-Attribution Reporting API וב-Aggregation Service ב-Google Cloud הסבר על Attribution Reporting API הסבר על Aggregation Service |
התכונה תהיה זמינה ב-Chrome במחצית השנייה של שנת 2023 |
סינון גמיש של תרומות הסבר |
התכונה תהיה זמינה ב-Chrome ברבעון השלישי של 2024 |
סינון לפני השיוך: היקפי שיוך הסבר |
התכונה תהיה זמינה ב-Chrome ברבעון הרביעי של 2024 |
תרחישים לדוגמה ותכונות
Attribution Reporting API מספק גישה לסוגים שונים של תובנות באמצעות שני סוגים של דוחות שאפשר לשלוח למפרסם או לספק צד שלישי של טכנולוגיית פרסום. אפשר להשתמש בשני סוגי הדוחות האלה בו-זמנית, והם משלימים זה את זה.
- בדוחות ברמת האירוע משויך קליק או צפייה מסוימים במודעה (בצד המודעה) לנתונים בצד ההמרה. הנתונים בצד ההמרות מוגבלים מאוד, והם מכילים רעש (כלומר, בחלק קטן מהמקרים נשלחים נתונים אקראיים במקום דוחות אמיתיים). כך אפשר לשמור על פרטיות המשתמשים על ידי מניעת איחוד של זהות המשתמש בין אתרים. כדי להגן על הפרטיות, הדוחות נשלחים לאחר השהיה.
- דוחות סיכום לא קשורים לאירוע ספציפי בצד המודעה. הדוחות האלה מספקים נתוני המרה עשירים יותר באיכות גבוהה יותר מאשר דוחות ברמת האירוע. שילוב של שיטות פרטיות עוזר לצמצם את הסיכון ליצירת זהות משותפת בין אתרים.
דוחות ברמת האירוע
בדוחות ברמת האירוע, קליק על מודעה או צפייה במודעה משויכים לנתוני המרה כלליים.
![דוח ברמת האירוע](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=5&hl=he)
news.example
(המצורף למזהה המשתמש Bob_Doe ב-news.example
) הוביל לרכישה ב-shop.example
.דוחות ברמת האירוע מתאימים ל:
- אופטימיזציה. עונים על שאלות כמו "איך אפשר לשפר את ההחזר על ההשקעה?". באופן ספציפי, אפשר להשתמש בדוחות האלה כדי לבצע אופטימיזציה של מיקומי המודעות, כי אפשר להציג בהם מזהים ייחודיים בצד המודעה. דוחות ברמת האירוע יכולים לספק נתוני אימון למודלים של למידת מכונה.
- דיווח גס, שבו נדרש מעט מאוד מידע על ההמרה. המגבלה הנוכחית היא 3 ביט של נתוני המרות עבור קליקים (כלומר, אפשר להקצות להמרה אחת מתוך שמונה קטגוריות) וביט אחד עבור צפיות. אין תמיכה בקידוד של נתונים מפורטים בצד ההמרה, כמו מחיר ספציפי או שעה של המרה, בדוחות ברמת האירוע.
- זיהוי הונאות. הנתונים בדוחות מסוימים יכולים להיות שימושיים לזיהוי ולניתוח של הונאות בפרסום, כי הם מאפשרים לכם להבין דפוסים שאפשר להשתמש בהם כדי לזהות פעילות ספאמית או פעילות לא חוקית.
דוחות סיכום
דוחות סיכום (לשעבר דוחות מצטברים) מספקים נתוני המרות מפורטים יותר וגמישות רבה יותר למיזוג של נתוני קליקים או צפיות ונתוני המרות.
![דוגמה לתובנות מדוחות סיכום.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=5&hl=he)
news.example
הוביל ל-518 המרות ב-shoes.example
, ולהוצאה כוללת של 38,174$. מחצית מההמרות הגיעו ממשתמשים בניו יורק, ארה"ב.דוחות סיכום מתאימים במיוחד לדיווח על תרחישים לדוגמה. בעזרת הדוחות האלה תוכלו לענות על שאלות כמו "מהו ההחזר על ההשקעה שלי?"
אנחנו חוקרים את הנושא של שימוש בדוחות סיכום לצורך אופטימיזציה – לדוגמה, כדי לבצע אופטימיזציה לפי ערך הרכישה, שלא נתמך בדוחות ברמת האירוע (כי נתוני ההמרות כלליים מדי).
תכונות אחרות
תכונות נוספות של ה-API הזה כוללות:
- שיוך מאפליקציה לאתר: הצגת מודעה באפליקציה או לחיצה עליה והשלמת המרה באתר.
תמיכה בדפדפנים
- לא שותפו אותות ב-Firefox וב-Edge.
- עמדת Safari ו-WebKit היא שלילית, והן הציעו API אחר למדידת המרות ממודעות שנקרא מדידת קליקים פרטית.
שני ממשקי ה-API שונים, אבל צוותי Chrome ו-WebKit עובדים יחד באופן גלוי כדי לפשט את חוויית הפיתוח. לדוגמה, הם עובדים יחד על שמות המאפיינים ועל מבנה ה-JSON של הדוחות.
קבוצת התכונות של Attribution Reporting API שונה מזו של Private Click Measurement API שהוצעה על ידי Safari ו-WebKit. יתרון משמעותי אחד של Attribution Reporting API הוא:
- יש תמיכה במדידה של צפיות.
- אפשר לספק דוחות ברמת האירוע.
- דוחות סיכום מכילים מידע עשיר גם לגבי קליקים/צפיות וגם לגבי המרות.
- צדדים שלישיים, כמו פלטפורמות של טכנולוגיות פרסום, יכולים לקבל דוחות בשם בעלי תוכן דיגיטלי ומפרסמים.
הגדרות הדפדפן
- המשתמשים יכולים לבטל את ההסכמה לשימוש ב-API באמצעות הגדרות המשתמש בכתובת
chrome://settings/adPrivacy
. - ממשק ה-API לא פעיל במצב פרטי.
איך אתרים יכולים לשלוט בגישה?
אם ה-API זמין בדפדפן מסוים, הוא זמין כברירת מחדל בכל אתר, גם במסמכים ובסקריפטים ברמה העליונה וגם ברכיבי iframe מאותו מקור.
צדדים שלישיים שרירותיים – לדוגמה, iframes של מודעות ממקורות שונים שלא נוספו לדף באמצעות סקריפט שיש לו גישה ברמה העליונה – לא יכולים להשתמש ב-API בלי ידיעת בעל התוכן הדיגיטלי או המפרסם: ב-iframes האלה, צריך להפעיל את Attribution Reporting API באופן מפורש באמצעות מדיניות ההרשאות.
<iframe src="..." allow="attribution-reporting"></iframe>
צדדים שלישיים עם גישה ברמה העליונה שמוסיפים לדף רכיבי iframe ממקורות שונים יכולים גם להפעיל את Attribution Reporting API באמצעות מדיניות ההרשאות.
אפשר להשבית את Attribution Reporting API לכל הגורמים, כולל סקריפטים עם הרשאת גישה ברמה העליונה, על ידי שליחת כותרת התגובה של HTTP:
Permissions-Policy: attribution-reporting=()
איך פועל Attribution Reporting API?
Attribution Reporting API מאפשר למדוד שני אירועים שמקושרים זה לזה: אירוע באתר של בעל התוכן הדיגיטלי, כמו צפייה של משתמש במודעה או לחיצה על מודעה, עם המרה שהתרחשה לאחר מכן באתר של המפרסם.
דוחות ברמת האירוע
![דוח ברמת האירוע](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=5&hl=he)
הדפדפן מתאים בין קליקים או צפיות לבין נתוני המרות שהוגדרו על ידי טכנולוגיית פרסום.
בהמשך, הדפדפן שולח את הדוחות שנוצרו לנקודת קצה מוגדרת מראש, עם עיכוב מסוים ורעש.
דוחות סיכום
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=5&hl=he)
הדוחות הסיכומיים נוצרים באופן הבא:
- משתמש לוחץ על מודעה או צופה בה, והמודעה מוגדרת באופן מיוחד. הדפדפן – במכשיר המקומי של המשתמש – מתעד את האירוע הזה, לצד נתוני הגדרת שיוך שצוינו מראש.
- מאוחר יותר, כשהמשתמש משלים המרה, הדפדפן מתאים את אירוע הצפייה או הקליק המפורט הזה (שנקרא אירוע מקור השיוך) לנתוני ההמרה המפורטים (שנקראים נתוני הטריגר של השיוך). המאפיינים של הפרטים שנאספים מוגדרים מראש על ידי חברת טכנולוגיית הפרסום, והדפדפן פועל לפי לוגיקה ספציפית שמוגדרת על ידי חברת טכנולוגיית הפרסום. הדפדפן מנפיק את הנתונים האלה כדוח שניתן לצבור.
- דוחות שאפשר לצבור נשלחים מהדפדפן מוצפנים לשרת של חברת טכנולוגיית הפרסום. מהשרת של טכנולוגיית הפרסום, הדוחות שאפשר לצבור נשלחים לשירות הצבירה כדי ליצור דוח סיכום.
- לאחר מכן, דוחות הסיכום יהיו זמינים לטכנולוגיית הפרסום. שימו לב שדוחות הסיכום לא מושהים באותה מידה כמו דוחות ברמת האירוע.
פרטיות
בניגוד לקובצי cookie של צד שלישי, Attribution Reporting API מאפשר לחברות פרסום לקבל תובנות לגבי המרות בלי לעקוב אחרי הפעילות של אנשים באתרים שונים.
ניקח לדוגמה אדם בשם בועז. בועז רואה מודעה בזמן שהוא קורא את החדשות ב-news.example
. שבוע לאחר מכן, בועז קונה נעליים ב-shoes.example
.
כיום, ההמרה הזו תהיה במעקב באמצעות קובץ cookie של צד שלישי שמשמש כמזהה בכמה אתרים.
בעזרת קובצי cookie של צד שלישי, חברת פרסום דיגיטלי יכולה לגשת למידע מפורט על הפעילות של בועז ב-news.example
וב-shoes.example
. טכנולוגיית הפרסום יכולה למזג את קטעי המידע האלה כדי ליצור פרופיל מפורט של בועז, כולל המיקום שלו, הרגלי הגלישה שלו והמאמרים שהוא מעדיף לקרוא ב-news.example
. הפרופיל הזה יכול לכלול גם רכישות, פעילות ופרטי כרטיס אשראי ב-shoes.example
. השילוב הזה בין אתרים שימושי למדידת המרות מפרסום. אבל הוא פוגע בפרטיות המשתמשים: מתבצע מעקב אחרי הפעילות של בועז באתרים שונים ברמת פירוט גבוהה.
![תצוגה של האינטרנט של היום (זהות משולבת) לצד האינטרנט של מחר (זהות מחולקת)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=5&hl=he)
כמות קטנה של מידע משולבת בין אתרים – מספיק כדי למדוד המרות, אבל לא מספיק כדי לעקוב אחרי הפעילות של בועז באתרים השונים בפירוט. הפעילות של רון ב-news.example
וב-shoes.example
תישאר נפרדת.
אמצעי הגנה בכל סוג של דוח
דוחות ברמת האירוע מקשרים מזהה בצד המודעה לכמות קטנה של נתונים בצד ההמרה. הם מספקים מידע על המרה באתרים שונים, אבל המידע בצד ההמרה גולמי מדי כדי לאפשר איחוד של זהות המשתמש בין אתרים.
דוחות סיכום מספקים תובנות מפורטות, אבל רק ברמת צבירת (aggration). התוכן של הדוחות האלה שאפשר לצבור אותם מוצפן כשהם נשלחים לטכנולוגיית הפרסום, ולכן טכנולוגיית הפרסום לא יכולה לקבל מידע מהדוחות בלי להשתמש בשירות צבירת. שירות האגרגציה מספק גישה רק למצטברים עם רעש.
אמצעי הגנה נוספים על הפרטיות, כמו הגבלות על קצב שליחת הבקשות, חלים גם על דוחות ברמת האירוע וגם על דוחות מצטברים.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=5&hl=he)
פירוט: דוחות ברמת האירוע ופרטיות
דוחות ברמת האירוע מספקים תובנות לגבי המרות בלי לעקוב אחרי משתמשים באתרים שונים, באמצעות מנגנוני הפרטיות הבאים:
- לא נעשה שימוש במזהה שמשתמש באתרים שונים, ופעילות גלישה מפורטת באתרים שונים לא יוצאת מהמכשיר.
- בדוחות ברמת האירוע, 64 ביט של מידע בצד המודעה (
news.example
) משויכים ל-1 ביט או ל-3 ביט בלבד בצד ההמרה (shop.example
). 64 ביט מספיקים למיפוי למזהה משתמש ספציפי, אבל אפשר לקשר את 64 הביט האלה רק למעט מאוד מידע באתרים שונים: 1 ביט או 3 ביט, שלא מספיקים כדי להכיל מזהה.- 64 הביט בצד המודעה הם לא מידע חדש. כבר היום אפשר להציג מזהה משתמש בצד המודעה.
news.example
אוadtech.example
כבר יודעים על הפעילות של משתמש מסוים ב-news.example
.
- 64 הביט בצד המודעה הם לא מידע חדש. כבר היום אפשר להציג מזהה משתמש בצד המודעה.
- אנחנו מחילים הגנות נוספות כדי למנוע ניצול לרעה ומעקב חוצה-אתרים:
- הדוחות נשלחים עם עיכוב.
- נתוני ההמרות מוטשטשים: באחוז מסוים מהמקרים נוצרים דוחות מזויפים.
- מספר דוחות ההמרות המשויכים מוגבל לכל קליק או צפייה.
פירוט: דוחות סיכום ופרטיות
בדוחות סיכום, אירוע של צפייה או קליק משויך לנתוני המרה מפורטים. התובנות על ההמרות מוצגות בלי לעקוב אחרי המשתמשים באתרים שונים, באמצעות מנגנוני הפרטיות הבאים:
- לא נעשה שימוש במזהה חוצה-אתרים.
- כל שיוך יכול לתרום כמה נתונים לדוח הסיכום שנוצר. כל משתמש יכול להפעיל מספר שיוך (Attribution) לקליק (או לצפייה) ולהמרה מסוימים.
- הנתונים נצברים עד לרמת אירועים רבים (משתמשים רבים), ולא ניתן לצפות באירועים ספציפיים בצורה מדויקת. כשבודקים את הנתונים המצטברים, ככל שרמת הפירוט עולה, כך עולה גם רמת הרעש היחסי בנתונים האלה. קטעי נתונים שמצטברים מהרבה אירועים ומשתמשים הם מדויקים יותר, כדי לשמור על התועלת שלהם.
- הדוחות הגולמיים שמקשרים אירוע צפייה או קליק מפורט לנתוני המרה מפורטים מוצפנים ואי אפשר לקרוא אותם בחברת טכנולוגיית הפרסום. רק שירות האגרגציה יכול לקרוא את הנתונים האלה.
- אנחנו מחילים הגנות נוספות כדי למנוע ניצול לרעה ומעקב חוצה-אתרים:
- הדוחות נשלחים עם עיכובים אקראיים.
- שאילתות על פלחים שונים של הנתונים מוגבלות בקצב.
יצירת מעורבות ושיתוף משוב
- אם יש לכם שאלות לגבי ה-API: יוצרים דיווח על בעיה במאגר ה-API.
- אתם יכולים לעקוב אחרי עדכונים והודעות בנושא API ברשימת התפוצה של Attribution Reporting.
- אם יש לכם שאלות טכניות, תוכלו לדווח על באג ב-Chromium.
- לשאלות כלליות על שיטות מומלצות, הטמעה ושילוב: יוצרים פנייה במאגר התמיכה למפתחים של ארגז החול לפרטיות.