מגדירים את ה-API כך שתינתן עדיפות למקורות או לטריגרים ספציפיים.
מתן עדיפות לקליקים או לצפיות ספציפיים בדוחות ברמת האירוע או בדוחות נצברים
באמצעות עדיפויות בצד המקור, אפשר לשנות את התנהגות ברירת המחדל של Attribution Reporting API. כברירת מחדל, מודל השיוך הוא מודל השיוך האחרון, כלומר המרה משויכת לאירוע המקור התואם האחרון. אפשר לשנות את ההתנהגות הזו גם בדוחות ברמת האירוע וגם בדוחות שאפשר לצבור.
כדי לשנות את עדיפות ברירת המחדל, מוסיפים את המפתח priority לכותרת של רישום המקור.
מגדירים עדיפות גבוהה יותר למקורות שרוצים לתת להם עדיפות. ערכים גדולים יותר מציינים עדיפות גבוהה יותר. לדוגמה, לאירוע מקור עם priority של 2 יש עדיפות על פני מקור עם priority של 1.
רק הדוח שתואם לאירוע המקור עם העדיפות הכי גבוהה נשלח.
קוד לדוגמה
שינוי השיוך כדי לבחור מקורות שהיו פחות לאחרונה (קליק ראשון):
const currentTimestamp = Date.now();
const priority = -currentTimestamp;
res.set(
"Attribution-Reporting-Register-Source",
JSON.stringify({
// … all usual fields for that header
priority: `${priority}`
})
);
הגדרת עדיפות להמרות ספציפיות בדוחות ברמת האירוע
בניגוד לעדיפויות בצד המקור, הגדרת עדיפויות בצד הטריגר זמינה רק לדוחות ברמת האירוע.
נניח שמשתמש לוחץ על מודעה ומשלים ארבע המרות: הוא נכנס לדף הבית של האתר של המפרסם, ואז נכנס לדף מוצר, נרשם לניוזלטר ובסוף מבצע רכישה.
אבל בגלל המגבלה של שלושה דוחות לקליקים, כברירת מחדל כל הדוחות הבאים אחרי ההרשמה (ההמרה השלישית) מושמטים, כולל דוח הרכישה.
במקום זאת, אפשר להגדיר את ה-API כך שתקבלו דוחות על המרות שחשובות לכם יותר, למשל דוח הרכישות.
כדי לעשות זאת, מוסיפים את המפתח priority לכותרת של רישום טריגר ומגדירים עדיפות גבוהה יותר להמרות שרוצים לתת להן עדיפות.
כשמופעל שיוך לאירוע מקור נתון, אם הושג המספר המקסימלי של שיוכים (שלושה לקליקים, אחד לצפיות) למקור הזה, הדפדפן:
משווים את העדיפות של הדוח החדש לעדיפויות של דוחות מתוזמנים קיימים מאותו מקור.
כדי לתזמן את הדוח החדש, צריך למחוק את הדוח עם העדיפות הכי נמוכה. אם הדוח החדש הוא זה עם העדיפות הכי נמוכה, הוא יתעלם ממנו ולא תקבלו אותו.
אם לא מוגדרות עדיפויות, הדפדפן חוזר להתנהגות ברירת המחדל שלו: כל המרה שמתרחשת אחרי ההמרה השלישית לקליקים או אחרי ההמרה הראשונה לצפיות מושמטת.
עיון בדוגמת הקוד: מתן עדיפות להמרות מסוג תשלום
השלבים הבאים
מידע על הגדרת מקורות וטריגרים זמין במאמרים הבאים: