דף זה תורגם על ידי Cloud Translation API.

דוגמאות לשיוך (Attribution) חוצה-פלטפורמות

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

עם זאת, מפרסמים שרוצים להשתמש בצד שלישי כדי לבצע שיוך (Attribution) ברשתות שונות (XNA) כדי לקבוע מודעה מנצחת אחת להמרה נתונה, יכולים להמשיך לעשות זאת באמצעות השיטות הבאות:

הגדרת שרת פנימי כדי לרשום אירועי טריגר ולקבל דוחות שיוך מה-API
המשך השימוש בשותף קיים למדידת ביצועים בנייד

ללא קשר לשיטה שבה המפרסם בוחר להשתמש, Attribution Reporting API תומך במספר תכונות שונות שמאפשרות לצד שלישי להתאים אישית את הלוגיקה של XNA בשם המפרסם:

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

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

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

עיבוד

הרשימה הבאה מתארת את השלבים בתהליך XNA. כדי לפשט את הדברים, השלבים שמפורטים כאן מבוססים על מודל שבו המפרסם משתמש בטכנולוגיית פרסום להצגת מודעות כדי להציג מודעות וב-MMP למעקב המרות. עם זאת, העיצוב של ה-API גמיש – הפונקציונליות לא משתנה בין סוגים שונים של טכנולוגיות פרסום, והיא לא דורשת שימוש בטכנולוגיית פרסום.

רישום מקורות: משתמש צופה במודעה או לוחץ עליה, וטכנולוגיית הפרסום שמציגה את המודעה רושמת את המקורות האלה ב-API. טכנולוגיית הפרסום שמייצגת את המקור עשויה גם להפנות לכלים אחרים של טכנולוגיית פרסום שיכולים לרשום מקורות גם דרך ה-API, או להפעיל שיוך ברשתות שונות ללא הפניות אוטומטיות.
רישום טריגר: המשתמש מבצע פעולה שמשויכת להמרה, כמו פתיחת האפליקציה בפעם הראשונה, רכישה או הוספה לעגלת הקניות. לאחר מכן, מערכת ה-MMP רושמת טריגר ב-API. מערכת ה-MMP עשויה גם להפנות אוטומטית לספקי טכנולוגיות פרסום אחרים שיכולים לרשום טריגרים ישירות ב-API. אם מערכת ניהול ביצועים (MMP) צריכה להפעיל שיוך ברשתות שונות ללא הפניות אוטומטיות, צריך לציין את הגדרות השיוך במהלך רישום הטריגר.
שיוך (Attribution): אם תגדירו את הגדרות השיוך במהלך רישום הטריגר, המקורות המשניים יופקו בשם ה-MMP. המערכת מנסה להתאים כל טריגר למקור מתאים שרשום ישירות על ידי ה-MMP, או למקור נגזר מתאים שנוצר בשם ה-MMP באמצעות מקורות של טכנולוגיית הפרסום שמיועדת להצגת מודעות. המקורות הנותרים שלא זכו בשיוך יוצאו משימוש ולא יוכלו לזכות בשיוך להמרות עתידיות. יכול להיות שתראו את המונח הזה גם בחלקים אחרים של המסמכים, כ 'אבד פעם, אבד תמיד'.
1. כשמקור נגזר מאבד את השיוך, ה-API לא ייצור מקורות נגזרים עתידיים על סמך המקור המקורי כשאירועי המרה עתידיים יתועדו על ידי מערכת ה-MMP. טכנולוגיית המודעות להצגה ו-MMP אחרים עדיין עשויים להשתמש במקור המקורי לצורך שיוך עתידי. הנושא הזה מוסבר בפירוט בתרחיש 6.
יצירת דוחות: השיוך מוביל ליצירת דוחות אירועים או דוחות מצטברים. שימו לב: רק דוחות מצטברים נוצרים למקורות נגזרים.
שליחת דוחות: הדוחות שנוצרו מתוזמנים לשליחה.

תרחיש 1: שיוך (Attribution) חוצה-פלטפורמות עם הפניות אוטומטיות

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

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

ציר הזמן של ההרשמות

בשעה t0, המשתמש לוחץ על מודעה שמוצגת על ידי ad-tech1, שמרישה מקור Source1 יחד עם ההפניה האוטומטית שלו Source2 על ידי mmp-ad-tech:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "34532",
    "web_destination": "https://destination.example.com",
    "priority": "10",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x1"
    }
  },
  "Attribution-Reporting-Redirect": [
    "https://www.mmp-ad-tech.com/source2"
  ]
// Registered by mmp-ad-tech using redirects
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "788324",
    "web_destination": "https://destination.example.com",
    "priority": "30",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x2",
      "geoValue": "0x102"
    }
  }

בשעה t1, המשתמש לוחץ על מודעה שמוצגת על ידי ad-tech2 כדי לרשום את Source3 יחד עם ההפניה האוטומטית שלו אל mmp-ad-tech (Source4):

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "6574435",
    "web_destination": "https://destination.example.com",
    "priority": "10",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x3"
    }

  },
  "Attribution-Reporting-Redirect": [
    "https://www.mmp-ad-tech.com/source"
  ]
// Registered by mmp-ad-tech using redirects
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "4532343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x4"
    }
  }

בשעה t2, הפעולה או ההמרה של המשתמש באפליקציה של המפרסם גורמות לרישום של טריגר על ידי mmp-ad-tech‏ (טריגר 1), שמפנה גם את ad-tech1‏ (טריגר 2) ואת ad-tech2‏ (טריגר 3):

לא מוגדר

תוצאה

המקורות Source2 ו-Source4 שרשומים ב-mmp-ad-tech מתחרים בשיוך לטריגר Trigger1 שרשום ב-mmp-ad-tech. המקור Source2 מנצח את המקור Source4 כי יש לו עדיפות גבוהה יותר. הטריגר Trigger2 של ad-tech1 משויך למקור 1 על ידי ad-tech1, והטריגר Trigger3 של ad-tech2 משויך למקור 3 על ידי ad-tech2.

מקורות מתחרים של

שדות	Source1	Source2	Source3	Source4
המקור שמירשם את פתרון טכנולוגיית הפרסום	ad-tech1	mmp-ad-tech	ad-tech2	mmp-ad-tech
source_event_id	34532	788324	6574435	4532343
יעד	https://destination.example.com	https://destination.example.com	https://destination.example.com	https://destination.example.com
priority	10	30	10	20

טריגרים רשומים

תוצאת השיוך

המאפיינים של Trigger1 מועברים ל-Source2, המאפיינים של Trigger2 מועברים ל-Source1 והמאפיינים של Trigger3 מועברים ל-Source3.

הוספת שיוך לפוסטים ממקורות שנדחו

Source4 – לא יתמודד על שיוך בעתיד.

דוחות אירועים

כתובת ה-URL של הדוח: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "788324",
    "trigger_data": "1",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

כתובת ה-URL של הדוח: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "34532",
    "trigger_data": "2",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

כתובת ה-URL של הדוח: https://www.ad-tech2.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "6574435",
    "trigger_data": "3",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

דוחות צבירה

כתובת ה-URL של הדוח: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x104",
        "value": 11
      }
    ]
  }

כתובת ה-URL של הדוח: https://www.ad-tech1.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x201",
        "value": 21
      }
    ]
  }

כתובת ה-URL של הדוח: https://www.ad-tech2.com/.well-known/attribution-reporting/report-aggregate-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x303",
        "value": 31
      }
    ]
  }

תרחיש 2: שיוך (Attribution) חוצה-פלטפורמות ללא הפניות לכתובת אחרת

מפרסם עובד עם 2 ספקי טכנולוגיות פרסום להצגת מודעות ועם פלטפורמה אחת לניהול ביצועי מודעות (MMP). משתמש לוחץ על מודעה ממערכת טכנולוגיית הפרסום הראשונה שמוצגת לו, והיא מפנה אותו ל-MMP במהלך רישום המקור. כשהמשתמש לוחץ על מודעה מטכנולוגיית הפרסום השנייה להצגת מודעות, טכנולוגיית הפרסום לא מפנה לכתובת אחרת, אלא בוחרת לשתף מראש עם ה-MMP קבוצת משנה של מפתחות הצבירה שלה.

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

ציר הזמן של ההרשמות

בשעה t0, משתמש לוחץ על מודעה, וכתוצאה מכך מתבצע רישום של מקור 1 על ידי ad-tech1 ורישום של מקור 2 על ידי mmp-ad-tech באמצעות הפניה אוטומטית מ-ad-tech1:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "234543",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    }
  },
  "Attribution-Reporting-Redirect": [
    "http://www.mmp-ad-tech.com"
  ]
 // Registered by mmp-ad-tech using redirect
 "Attribution-Reporting-Register-Source": {
    "source_event_id": "45453",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5",
    }
  }

בשעה t1, המשתמש לוחץ על מודעה אחרת, וכתוצאה מכך נוצר מקור 3 על ידי ad-tech2 שמשתף מפתחות צבירת נתונים:

 // Registered by ad-tech2
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "978",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts"
    ]
  }

בשעה t2, הפעולה או ההמרה של המשתמש גורמות להרשמה על ידי mmp-ad-tech, שמכיל הגדרות שיוך ל-ad-tech2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "101"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ],
        "x_network_data": {
          "key_offset": 10
        }
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "200",
        "expiry": "172800"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-2": "0x4"
    }
  }

תוצאה

המקור Source2 מתאים את ההרשמה ואת היעד לטריגר, כך שהוא הופך למקור מתחרה לצורך שיוך. בנוסף, במהלך הרישום של הטריגר, הוגדרה הגדרת שיוך ל-ad-tech2 ול-Source3 באמצעות מפתחות צבירת נתונים לשיתוף של ad-tech2. כך אפשר ליצור מקור נגזר, Source3', כמקור מתחרה לצורך שיוך.

מקורות מתחרים

שדות	Source2	Source3'
המקור המקורי שמירשם את חברת טכנולוגיית הפרסום	mmp-ad-tech	ad-tech2
source_event_id	45453	978
priority	100	200

טריגרים רשומים

Trigger1 על ידי mmp-ad-tech.

תוצאת השיוך

הטריגר Trigger1 משויך למקור Source3 כי למקור Source3 יש עדיפות גבוהה יותר מאשר למקור Source2.

הוספת שיוך לפוסטים ממקורות שנדחו

Source2

דוחות אירועים

אף אחד – דוחות אירועים לא נוצרים למקורות נגזרים.

דוחות צבירה

מקור ההורה של Source3, כלומר Source3, משתף רק את campaignCounts. החלק העיקרי של הטריגר מחושב לפי:

(key_piece value) | ((x_network_key_mapping entry) << offset)

0x400 | (0x4 << 10) = 0x1400

לבסוף, המפתח שנוצר הוא 0x1559, שנוצר על ידי ביצוע OR למפתח הטריגר (0x1400) עם מפתח המקור (0x159).

כתובת ה-URL של הדוח: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "attribution_destination": "https://destination.example.com",
  "histograms": [
    {
     "key": "0x1559",
      "value": 32768
    }
  ]
}

תרחיש 3: מקור רשום של MMP ומועמד לחשבון הורה של מקור נגזר באותה שרשרת רישום

מפרסם עובד עם 2 ספקי טכנולוגיות פרסום להצגת מודעות ועם פלטפורמה אחת לניהול ביצועי מודעות (MMP). משתמש לוחץ על מודעה ממערכת טכנולוגיית הפרסום הראשונה שמציגה מודעות, שלא מפנה אוטומטית לאחר רישום המקור, אבל משתפת מפתחות צבירת נתונים עם מערכת ה-MMP. המשתמש לוחץ על מודעה מטכנולוגיית הפרסום השנייה להצגת מודעות, שמפנה את המשתמש ל-MMP במהלך רישום המקור ומשתפת מפתחות צביר עם ה-MMP.

ציר הזמן של ההרשמות

בשעה t0, המשתמש לוחץ על מודעה שמוצגת על ידי חברת ad-tech1, וכתוצאה מכך מתחילה ההרשמה של מקור 1:

 "Attribution-Reporting-Register-Source": {
    "source_event_id": "52343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
     "campaignCounts": "0x159",
     "geoValue": "0x5"
   },
   "shared_aggregation_keys": [
     "campaignCounts",
     "geoValue"
   ]
 }

בשעה t1, בשרשרת הרישום 2, מערכת ad-tech2 רושמת את Source2 ומפנה לרישום של מקור MMP, Source3:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "234456",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    },
    "shared_aggregation_keys": [
      "campaignCounts"
    ]
  },
  "Attribution-Reporting-Redirect": [
    "http://www.mmp-ad-tech.com"
  ]
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "4234",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x159"
    }
  }

בשלב t2, בזמן רישום הטריגר, ההקצאה מוגדרת כך שתיווצרו מקורות נגזרים מ-ad-tech1 ומ-ad-tech2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "101"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ],
        "x_network_data" : {
          "key_offset" : 10
        }
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "20",
        "expiry": "172800"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "priority": "20",
        "expiry": "172800"
      }
    ],
    "x_network_key_mapping" : {
      "enrollment-id-ad-tech-1" : "0x2",
      "enrollment-id-ad-tech-2" : "0x4"
    }
  }

כתוצאה מכך, המקור הרשום ב-MMP בשרשרת הרישום השנייה זוכה בשיוך. הדוח המצטבר שנוצר נראה כך:

תוצאה

המקור המשויך שמקורו במקור 2 (עם 'source_event_id": "234456') לא משתתף בשיוך כי באותו שרשרת רישום יש גם מקור רשום מסוג mmp-ad-tech.

מקורות מתחרים

שדות	Source1'	Source3
המקור המקורי שמירשם את טכנולוגיית הפרסום	ad-tech1	mmp-ad-tech
source_event_id	52343	4234
priority	20	100

טריגרים רשומים

Trigger1 על ידי mmp-ad-tech.

תוצאת השיוך

הטריגר Trigger1 ישויך למקור 3 כי למקור 3 יש עדיפות גבוהה יותר מאשר למקור 1.

הוספת שיוך לפוסטים ממקורות שנדחו

Source1' – לא נתייחס יותר ל-Source1 כמקור נגזר של mmp-ad-tech.

דוחות אירועים

כתובת ה-URL של הדוח: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "4234",
    "trigger_data": "2",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }

דוחות צבירה

כתובת ה-URL של הדוח: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "report_url": "http://www.mmp-example.com",
  "payload": {
    "attribution_destination": "https://destination.example.com",
    "histograms": [
      {
        "key": "0x559"
        "value": 32768
      }
    ]
  }
}

תרחיש 4: שיוך ברשתות שונות ללא הפניות אוטומטיות עם קריטריונים לבחירת מקור

מפרסם עובד עם 4 ספקי טכנולוגיות פרסום להצגת מודעות ועם פלטפורמה אחת לניהול רשתות (MMP). משתמש לוחץ על מודעה מ-1 מתוך 4 טכנולוגיות הפרסום שמוצגות לו, וצופים במודעות מ-3 הטכנולוגיות האחרות. כשמשתמש ממיר באפליקציה של המפרסם, מערכת ה-MMP רושמת טריגר ומציינת מבין אילו מקורות רשומים של טכנולוגיית פרסום להצגת מודעות צריך ליצור מקורות נגזרים, על סמך המסננים הבאים:

priority_range: בחירת מקורות שיש להם עדיפות בטווח הנתון
expiry: בחירת מקורות עם תאריך תפוגה מאוחר יותר מהמשך הזמן שצוין
source_filters: בחירת מקורות שה-filter_data שלהם תואם ל-source_filters שצוין
source_not_filters: בחירת מקורות שה-not_filters שלהם תואם ל-source_not_filters שצוין

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

ציר הזמן של הרישום

בשעה t0, קליק של משתמש גורם למערכת ad-tech1 לרשום מקור Source1, שמשויך ל-source_type כניווט למקור המרשם הזה:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "87456",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172801",
    "filter_data": {
      "filter1": [
        "does_not_matter"
      ],
      "filter2": [
        "non-match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x119",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשעה t1, משתמש צופה במודעה שגורמת ל-ad-tech2 לרשום מקור Source2, שמשויך לאירוע source_type במקור המורשם הזה:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "9078",
    "web_destination": "https://destination.example.com",
    "priority": "2000",
    "expiry": "172801",
    "filter_data": {
      "filter1": [
        "does_not_matter"
      ],
      "filter2": [
        "match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x129",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשעה t2, צפייה של משתמש גורמת ל-ad-tech3 לרשום מקור Source3, שמשויך את source_type כאירוע למקור המורשם הזה:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "2413",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "filter_data": {
      "filter1": [
        "non-match"
      ],
      "filter2": [
        "non-match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשעה t3, צפייה של משתמש גורמת ל-ad-tech4 לרשום מקור Source4, שמשויך את source_type כאירוע למקור המורשם הזה:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "7567",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "filter_data": {
      "filter1": [
        "match"
      ],
      "filter2": [
        "match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x169",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשלב t4, המרה של משתמש מובילה לכך ש-mmp-ad-tech רושם טריגר עם הגדרות שיוך לכל המקורות הרשומים של פלטפורמות ה-AdTech האחרות שצוינו למעלה:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "100"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ]
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "source_priority_range": {
          "start": 1,
          "end": 100
        },
        "source_filters": {
          "source_type": [
            "event"
          ]
        },
        "priority": "100",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ]
        },
        "priority": "100",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-3",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ],
          "filter1": [
            "match"
          ],
          "filter2": [
            "match"
          ]
        },
        "priority": "50",
        "expiry": "172801"
      },
      {
        "source_network": "enrollment-id-ad-tech-4",
        "source_priority_range": {
          "start": 1,
          "end": 1000
        },
        "source_filters": {
          "source_type": [
            "navigation"
          ],
          "filter1": [
            "match"
          ],
          "filter2": [
            "match"
          ]
        },
        "priority": "30",
        "expiry": "172801"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-1": "0x1",
      "enrollment-id-ad-tech-2": "0x2",
      "enrollment-id-ad-tech-3": "0x3",
      "enrollment-id-ad-tech-4": "0x4"
    }
  }

תוצאה

המקורות הבאים לא נחשבים מתאימים ליצירת מקורות נגזרים מהם בגלל חוסר התאמה לקריטריונים:

המקור Source1 לא עומד בדרישות של המסנן source_type:event בהגדרת השיוך של ad-tech1
העדיפות של Source2 מוגדרת כ-2000, מחוץ למסנן טווח העדיפות של ad-tech2‏ (1,1000)
הערך של Source3 לא תואם לערך של filter2

מקורות מתחרים

שדות	Source4'
המקור המקורי שמירשם את פתרון טכנולוגיית הפרסום	ad-tech4
source_event_id	7567
יעד	https://destination.example.com
priority	30
expiry	מועד ההרשמה + 2 ימים

טריגרים רשומים

Trigger1 על ידי mmp-ad-tech.

תוצאת השיוך

הטריגר Trigger1 ישויך ל-Source4 כי זהו המקור היחיד שעומד בדרישות לצורך שיוך

הוספת שיוך לפוסטים ממקורות שנדחו

ללא

דוחות אירועים

אף אחד – דוחות אירועים לא נוצרים למקור שזכה בבחירה

דוחות צבירה

כתובת ה-URL של הדוח: http://www.mmp-ad-tech.com

{
  "attribution_destination": "https://example.com",
  "histograms": [
    {
      "key": "0x56d",
      "value": 32768
    },
    {
      "key": "0x5",
      "value": 1664
    }
  ]
}

תרחיש 5: שיוך אחרי ההתקנה

מפרסם עובד עם 2 ספקי טכנולוגיות פרסום להצגת מודעות ועם פלטפורמה אחת לניהול ביצועי מודעות (MMP). משתמש לוחץ על מודעה מ-AdTech הראשון ומתקין את אפליקציית המפרסם. במהלך השיוך להמרות לאחר ההתקנה, המקור המשויך עם שיוך להתקנה מנצח על פני מקורות אחרים, גם אם למקורות אחרים יש עדיפות גבוהה יותר.

ציר הזמן של הרישום

בשעה t0, האינטראקציה של המשתמש גורמת לכלי הפרסום הדיגיטלי ad-tech1 לרשום את המקור Source1:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "3645",
    "destination": "android-app://com.example.app",
    "priority": "20",
    "expiry": "172801",
    "install_attribution_window": "86400",
    "post_install_exclusivity_window": "864000",
    "aggregation_keys": {
      "campaignCounts": "0x119",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשעה t1, המשתמש מתקין את האפליקציה com.example.app במכשיר שלו

בשעה t2, האינטראקציה של המשתמש גורמת לכלי הפרסום הדיגיטלי ad-tech2 לרשום את המקור Source2:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "345789",
    "destination": "android-app://com.example.app",
    "priority": "100",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

בשעה t3, הטריגר רשום על ידי mmp-ad-tech עם הגדרות שיוך ל-ad-tech1 ול-ad-tech2:

  "Attribution-Reporting-Register-Trigger": {
    "event_trigger_data": [
      {
        "trigger_data": "2",
        "priority": "100"
      }
    ],
    "aggregatable_trigger_data": [
      {
        "key_piece": "0x400",
        "source_keys": [
          "campaignCounts"
        ]
      }
    ],
    "aggregatable_values": {
      "campaignCounts": 32768,
      "geoValue": 1664
    },
    "attribution_config": [
      {
        "source_network": "enrollment-id-ad-tech-1",
        "priority": "10",
        "expiry": "172801",
        "post_install_exclusivity_window": "172800"
      },
      {
        "source_network": "enrollment-id-ad-tech-2",
        "priority": "20",
        "expiry": "172801"
      }
    ],
    "x_network_key_mapping": {
      "enrollment-id-ad-tech-1": "0x1",
      "enrollment-id-ad-tech-2": "0x3"
    }
  }

תוצאה

מקורות נגזרים שנוצרו מ-Source1 ומ-Source2 (Source1' ו-Source2', בהתאמה), שמתחרים על השיוך.

מקורות מתחרים

שדות	Source1'	Source2'
המקור המקורי שמירשם את פתרון טכנולוגיית הפרסום	ad-tech1	ad-tech2
source_event_id	3645	345789
יעד	android-app://com.example.app	android-app://com.example.app
priority	10	20
הגדלת מספר ההתקנות של האפליקציה	כן	לא

טריגרים רשומים

Trigger1 על ידי mmp-ad-tech.

תוצאת השיוך

הטריגר Trigger1 משויך למקור Source1 כי הוא הוביל להתקנת אפליקציית היעד. שימו לב של-Source2' הייתה עדיפות גבוהה יותר.

הוספת שיוך לפוסטים ממקורות שנדחו

'Source2' – מקורות נגזרים מ-Source2 לא יילקחו בחשבון בשיוך של טריגרים שנרשמו על ידי mmp-ad-tech.

דוחות אירועים

אף אחד – דוחות אירועים לא נוצרים למקור שזכה בבחירה

דוחות צבירה

כתובת ה-URL של הדוח: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

{
  "attribution_destination": "android-app://com.example.app",
  "histograms": [
    {
      "key": "0x519",
      "value": 32768
    },
    {
      "key": "0x5",
      "value": 1664
    }
  ]
}

תרחיש 6: מפסידים פעם אחת, מפסידים תמיד

אם למקור ad-tech1 יש מקור נגזר שהשתתף בייחוס לטריגר של mmp-ad-tech ואבד את השיוך, המקור של ad-tech1 לא ישמש לאחר מכן ליצירת מקור נגזר לטריגרים של mmp-ad-tech. הנה לוח זמנים לדוגמה:

בשעה t0, המקור Source1 של ad-tech1 רשום ב-"priority": "10".
בשעה t1, המקור Source2 של ad-tech2 רשום אצל "priority": "20".
בשעה t2, הטריגר Trigger1 של mmp-ad-tech רשום בתצורות השיוך של ad-tech1 ושל ad-tech2.
בשעה t3, מתבצעת שיוך (Attribution) לטריגר 1, שבו המקור המשויך מ-ad-tech2 זוכה בשיוך והמקור של ad-tech1 מתעלם
בשעה t4, המקור Source3 של ad-tech3 רשום ב-"priority": "5".
בשעה t5, הטריגר Trigger2 של mmp-ad-tech רשום בתצורות של ad-tech1 ושל ad-tech3.
בשעה t6 מתבצעת השיוך ל-Trigger2, שבו המקור המשויך מ-Source3‏ (Source3') זוכה בשיוך

הסבר על התוצאה

המקור המשויך מהמקור של ad-tech1 איבד את השיוך לטריגר 1, ולכן לא נעשה שימוש במקור 1 כדי ליצור מקור משויך לשיוך של טריגר 2. אם הוא לא היה מפסיד לפני כן ב-t3, הוא היה מנצח על פני המקור של ad-tech3 כי יש לו עדיפות גבוהה יותר.

דוגמאות לשיוך (Attribution) חוצה-פלטפורמות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

עיבוד

תרחיש 1: שיוך (Attribution) חוצה-פלטפורמות עם הפניות אוטומטיות

ציר הזמן של ההרשמות

תוצאה

מקורות מתחרים של

טריגרים רשומים

תוצאת השיוך

הוספת שיוך לפוסטים ממקורות שנדחו

דוחות אירועים

דוחות צבירה

תרחיש 2: שיוך (Attribution) חוצה-פלטפורמות ללא הפניות לכתובת אחרת

ציר הזמן של ההרשמות

תוצאה

מקורות מתחרים

טריגרים רשומים

תוצאת השיוך

הוספת שיוך לפוסטים ממקורות שנדחו

דוחות אירועים

דוחות צבירה

תרחיש 3: מקור רשום של MMP ומועמד לחשבון הורה של מקור נגזר באותה שרשרת רישום

ציר הזמן של ההרשמות

תוצאה

מקורות מתחרים

טריגרים רשומים

תוצאת השיוך

הוספת שיוך לפוסטים ממקורות שנדחו

דוחות אירועים

דוחות צבירה

תרחיש 4: שיוך ברשתות שונות ללא הפניות אוטומטיות עם קריטריונים לבחירת מקור

ציר הזמן של הרישום

תוצאה

מקורות מתחרים

טריגרים רשומים

תוצאת השיוך

הוספת שיוך לפוסטים ממקורות שנדחו

דוחות אירועים

דוחות צבירה

תרחיש 5: שיוך אחרי ההתקנה

ציר הזמן של הרישום

תוצאה

מקורות מתחרים

טריגרים רשומים

תוצאת השיוך

הוספת שיוך לפוסטים ממקורות שנדחו

דוחות אירועים

דוחות צבירה

תרחיש 6: מפסידים פעם אחת, מפסידים תמיד

הסבר על התוצאה

דוגמאות לשיוך (Attribution) חוצה-פלטפורמות