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