למדוד מתי קליק על מודעה או צפייה בה מובילים להמרה, למשל רכישה באתר של המפרסם.
למי ההדרכה הזו מיועדת?
כאן מוסבר על העקרונות הבסיסיים של דוחות השיוך ועל כמה מושגים בסיסיים, אבל לא מופיע הרבה מידע טכני.
- אם אתם עובדים בתחום הפרסום או טכנולוגיות הפרסום, תוכלו ללמוד איך ה-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 מספק גישה לשני סוגים של דוחות עם תובנות מסוגים שונים, שאפשר לשלוח למפרסם או לספק טכנולוגיות פרסום (ATP) של צד שלישי. אפשר להשתמש בשני סוגי הדוחות האלה בו-זמנית, והם משלימים זה את זה.
- דוחות ברמת האירוע משייכים קליק או צפייה מסוימים במודעה (בצד המודעה) לנתונים בצד ההמרה. הנתונים בצד ההמרות מוגבלים מאוד, והם מכילים רעש (כלומר, בחלק קטן מהמקרים נשלחים נתונים אקראיים במקום דוחות אמיתיים). כך אפשר לשמור על פרטיות המשתמשים על ידי מניעת איחוד של זהות המשתמש בין אתרים. כדי להגן על הפרטיות, הדוחות נשלחים לאחר השהיה.
- דוחות סיכום לא קשורים לאירוע ספציפי בצד המודעה. הדוחות האלה מספקים נתוני המרה עשירים יותר באיכות גבוהה יותר מאשר דוחות ברמת האירוע. שילוב של שיטות פרטיות עוזר לצמצם את הסיכון ליצירת זהות משותפת בין אתרים.
דוחות ברמת האירוע
בדוחות ברמת האירוע, קליק על מודעה או צפייה במודעה משויכים לנתוני המרה כלליים.

news.example
(המצורף למזהה המשתמש Bob_Doe ב-news.example
) הוביל לרכישה ב-shop.example
.דוחות ברמת האירוע מתאימים ל:
- אופטימיזציה. עונים על שאלות כמו "איך אפשר לשפר את ההחזר על ההשקעה?". באופן ספציפי, אפשר להשתמש בדוחות האלה כדי לבצע אופטימיזציה של מיקומי המודעות, כי אפשר להציג בהם מזהים ייחודיים בצד המודעה. דוחות ברמת האירוע יכולים לספק נתוני אימון למודלים של למידת מכונה.
- דיווח גס, שבו נדרש מעט מאוד מידע על ההמרה. המגבלה הנוכחית היא 3 ביט של נתוני המרות לקליק (כלומר, אפשר להקצות להמרה אחת מתוך שמונה קטגוריות) וביט אחד לצפייה. אין תמיכה בקידוד של נתונים מפורטים בצד ההמרה, כמו מחיר ספציפי או מועד המרה, בדוחות ברמת האירוע.
- זיהוי הונאות. הנתונים בדוחות מסוימים יכולים להיות שימושיים לזיהוי ולניתוח של הונאות בפרסום, כי הם מאפשרים לכם להבין דפוסים שאפשר להשתמש בהם כדי לזהות פעילות ספאמית או פעילות לא חוקית.
דוחות סיכום
דוחות סיכום (לשעבר דוחות מצטברים) מספקים נתוני המרות מפורטים יותר וגמישות רבה יותר למיזוג של נתוני קליקים או צפיות ונתוני המרות.

news.example
הוביל ל-518 המרות ב-shoes.example
ולהוצאה כוללת של 38, 174$. מחצית מההמרות הגיעו ממשתמשים בניו יורק, ארה"ב.דוחות סיכום מתאימים במיוחד לדיווח על תרחישים לדוגמה. בעזרת הדוחות האלה תוכלו לענות על שאלות כמו "מהו ההחזר על ההשקעה שלי?"
אנחנו חוקרים את הנושא של שימוש בדוחות סיכום לאופטימיזציה – לדוגמה, כדי לבצע אופטימיזציה לפי ערך הרכישה, שלא נתמך בדוחות ברמת האירוע (כי נתוני ההמרות כלליים מדי).
תכונות אחרות
תכונות נוספות של ה-API הזה כוללות:
- שיוך מאפליקציה לאתר: הצגת מודעה באפליקציה או לחיצה על מודעה באפליקציה והשלמת המרה באתר.
תמיכה בדפדפנים
- לא שותפו אותות ב-Firefox וב-Edge.
- עמדת Safari ו-WebKit היא שלילית, והן הציעו API אחר למדידת המרות ממודעות שנקרא Private Click Measurement.
שני ממשקי ה-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 מאפשר למדוד שני אירועים שמקושרים זה לזה: אירוע באתר של בעל התוכן הדיגיטלי, כמו צפייה של משתמש במודעה או לחיצה על מודעה, עם המרה שהתרחשה לאחר מכן באתר של המפרסם.
דוחות ברמת האירוע

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

דוחות הסיכום נוצרים באופן הבא:
- משתמש לוחץ על מודעה או צופה בה, והמודעה מוגדרת באופן מיוחד. הדפדפן – במכשיר המקומי של המשתמש – מתעד את האירוע הזה, לצד נתוני תצורת שיוך שצוינו מראש.
- מאוחר יותר, כשהמשתמש משלים המרה, הדפדפן מתאים את אירוע הצפייה או הקליק המפורט הזה (שנקרא אירוע מקור השיוך) לנתוני ההמרה המפורטים (שנקראים נתוני הטריגר של השיוך). המאפיינים של הפרטים שנאספים מוגדרים מראש על ידי חברת טכנולוגיית הפרסום, והדפדפן פועל לפי לוגיקה ספציפית שמוגדרת על ידי חברת טכנולוגיית הפרסום. הדפדפן מנפיק את הנתונים האלה כדוח שניתן לצבור.
- הדוחות עם הנתונים שאפשר לצבור מוצפנים על ידי הדפדפן ונשלחים לשרת של טכנולוגיית הפרסום. מהשרת של טכנולוגיית הפרסום, הדוחות עם הנתונים שאפשר לצבור נשלחים לשירות הצבירה כדי ליצור דוח סיכום.
- לאחר מכן, דוחות הסיכום יהיו זמינים לטכנולוגיית הפרסום. חשוב לזכור שדוחות הסיכום לא מתעכבים באותה מידה כמו דוחות ברמת האירוע.
פרטיות
בניגוד לקובצי cookie של צד שלישי, Attribution Reporting API מאפשר לחברות פרסום לקבל תובנות לגבי המרות בלי לעקוב אחרי הפעילות של משתמש מסוים באתרים שונים.
ניקח לדוגמה אדם בשם בועז. בועז רואה מודעה בזמן שהוא קורא את החדשות ב-news.example
. שבוע לאחר מכן, בועז קונה נעליים ב-shoes.example
.
כיום, המעקב אחר ההמרה הזו יתבצע באמצעות קובץ cookie של צד שלישי שמשמש כמזהה באתרים שונים.
בעזרת קובצי cookie של צד שלישי, חברת טכנולוגיית פרסום יכולה לגשת למידע מפורט על הפעילות של בועז ב-news.example
וב-shoes.example
. טכנולוגיית הפרסום יכולה למזג את קטעי המידע האלה כדי ליצור פרופיל מפורט של בועז, כולל המיקום שלו, הרגלי הגלישה שלו והמאמרים שהוא מעדיף לקרוא ב-news.example
. הפרופיל הזה יכול לכלול גם רכישות, פעילות ופרטי כרטיס אשראי ב-shoes.example
. השילוב הזה בין אתרים שונים שימושי למדידת המרות מפרסום. אבל היא פוגעת בפרטיות המשתמשים: מתבצע מעקב אחרי הפעילות של בועז באתרים שונים ברמת פירוט גבוהה.

כמות קטנה של מידע משולבת בין אתרים – מספיק כדי למדוד המרות, אבל לא מספיק כדי לעקוב אחרי הפעילות של בועז באתרים השונים בפירוט. הפעילות של רון ב-news.example
וב-shoes.example
תישאר נפרדת.
אמצעי הגנה בכל סוג של דוח
דוחות ברמת האירוע מקשרים מזהה בצד המודעה לכמות קטנה של נתונים בצד ההמרה. הם מספקים מידע על המרה באתרים שונים, אבל המידע בצד ההמרה גולמי מדי כדי לאפשר איחוד של זהות המשתמש בין אתרים.
דוחות סיכום מספקים תובנות מפורטות, אבל רק ברמת צבירה. מכיוון שהתוכן של הדוחות האלה שאפשר לצבור אותם מוצפן כשהם נשלחים לטכנולוגיית הפרסום, טכנולוגיית הפרסום לא יכולה לקבל מידע מהדוחות בלי להשתמש בשירות צבירת נתונים. שירות האגרגציה מספק גישה רק למצטברים עם רעש.
אמצעי הגנה נוספים על הפרטיות, כמו הגבלות על קצב שליחת הבקשות, חלים גם על דוחות ברמת האירוע וגם על דוחות מצטברים.

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