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

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

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

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

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

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

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

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

התהליך

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

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

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

המפרסם עובד עם 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 via 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"
    }
  }

בשעה 1, המשתמש לוחץ על מודעה שהוצגה על ידי 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 via redirects
  "Attribution-Reporting-Register-Source": {
    "source_event_id": "4532343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
      "campaignCounts": "0x4"
    }
  }

ברמה 2, הפעולה או ההמרה של המשתמש באפליקציה של המפרסם מובילות מפעיל רישום על ידי mmp-ad-tech (Trigger1) שגם מפנה מחדש אל ad-tech1 (Trigger2) an ad-tech2 (Trigger3):

לא מוגדר

תוצאה

המקורות הרשומים של mmp-ad-tech Source2 ו-Source4 מתחרים על שיוך (Attribution) טריגר Trigger1 הרשום כ-mmp-ad-tech. מקור 2 זכה על פני Source4 מפני בעדיפות גבוהה יותר. Trigger2 על ידי ad-tech1 מיוחס ל-Source1 על ידי ad-tech1 ו ההפעלה של Trigger3 על ידי ad-tech2 משויכת ל-Source3 על ידי 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

עדיפות

10

30

10

20
נרשמו טריגרים
תוצאת שיוך (Attribution)

Trigger1 מאפיינים ל-Source2, ל-Trigger2

מקורות שהמערכת התעלמה מהם אחרי השיוך (Attribution)

מקור 4 – לא יתחרה על שיוך בעתיד.

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

כתובת ה-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: שיוך חוצה-רשתות ללא הפניות לכתובת אחרת

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

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

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

בשעה t0, משתמש לוחץ על מודעה, וכתוצאה מכך רישום Source1 על ידי רישום ad-tech1 ו-Source2 על ידי 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 via 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, המשתמש לוחץ על מודעה אחרת, וכתוצאה מכך מופיעה התווית Source3 של 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"
    ]
  }

בשעה 2, הפעולה או ההמרה של המשתמש גורמות להרשמה באמצעות 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"
    }
  }

תוצאה

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

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

שדות

Source2

מקור 3'

רישום מקור מקורי של טכנולוגיית פרסום

mmp-ad-tech

ad-tech2

source_event_id

45453

978

עדיפות

100

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

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

תוצאת שיוך (Attribution)

Trigger1 משויך ל-'Source3' כי Source3 מקבל עדיפות גבוהה יותר מ-'מקור2'.

מקורות שהמערכת התעלמה מהם אחרי השיוך (Attribution)

Source2

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

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

דוחות מצטברים

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

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

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

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

כתובת ה-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, והתחלת הרישום של Source1:

 "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"
   ]
 }

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

    "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"
    }
  }

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

תוצאה

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

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

שדות

מקור1'

Source3

רישום מקור מקורי של טכנולוגיית פרסום

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

עדיפות

20

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

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

תוצאת שיוך (Attribution)

הערך Trigger1 מיוחס ל-Source3, כי ל-Source3 יש עדיפות גבוהה יותר מזו של Source1.

מקורות שהמערכת התעלמה מהם אחרי השיוך (Attribution)

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

  1. עדיפות_range: בחירת מקורות עם עדיפות בטווח הנתון
  2. תפוגה: יש לבחור מקורות עם תפוגה לאחר משך הזמן שצוין
  3. source_filters: בחירת מקורות שהמסנן_data שלהם תואם ל-source_filters שצוינו
  4. 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"
    ]
  }

בשעה 1, משתמש צופה במודעה וגורם ל-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"
    ]
  }

בשעה 2, תצוגת משתמש גורמת ל-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"
    ]
  }

בשעה 3, תצוגת משתמש גורמת ל-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"
    ]
  }

בשעה 4, פעולת המרה של המשתמש מובילה לרישום טריגר מסוג mmp-ad-tech עם שיוך (Attribution) לכל שאר טכנולוגיות הפרסום שהוזכרו למעלה מקורות רשומים:

  "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"
    }
  }

תוצאה

המקורות הבאים לא נחשבים כמקורות שכשירים ליצירה של מקורות נגזרים עקב אי-התאמה בין קריטריונים:

  1. מקור 1 לא תואם למחרוזת "source_type":"event" סינון לפי הגדרות השיוך (Attribution) של ad-tech1
  2. העדיפות של Source2 היא 2000, שהיא מחוץ למסנן טווח העדיפות של ad-tech2 (1,1000).
  3. מקור 3 לא תואם לערך של "filter2"
מקורות מתחרים

שדות

מקור 4

רישום מקור מקורי של טכנולוגיית פרסום

פרסום דיגיטלי

source_event_id

7567

יעד

https://destination.example.com

עדיפות

30

תפוגה

זמן הרישום + יומיים
נרשמו טריגרים

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

תוצאת שיוך (Attribution)

Trigger1 מיוחס ל-'Source4' כי הוא רק מקור שעומד בדרישות לשיוך.

מקורות שהמערכת התעלמה מהם אחרי השיוך (Attribution)

ללא

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

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

דוחות מצטברים

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

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

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

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

לוח הזמנים להרשמה

בשעה 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"
    ]
  }

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

ברמה 2, אינטראקציה של המשתמש גורמת ל-ad-tech2 לרשום את מקור 2:

  "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"
    ]
  }

בשעה 3, טריגר נרשם על ידי mmp-ad-tech עם הגדרות השיוך (Attribution) עבור 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' בהתאמה, שמתחרים על שיוך.

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

שדות

מקור1'

מקור 2'

רישום מקור מקורי של טכנולוגיית פרסום

ad-tech1

ad-tech2

source_event_id

3645

345789

יעד

android-app://com.example.app

android-app://com.example.app

עדיפות

10

20

התחלת ההתקנה של האפליקציה

כן

לא
נרשמו טריגרים

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

תוצאת שיוך (Attribution)

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

מקורות שהמערכת התעלמה מהם אחרי השיוך (Attribution)

מקור 2 - מקורות הנגזרים מ-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 ואיבד את השיוך (Attribution), המקור של ad-tech1 לא ישמש כדי ליצור מקור נגזר לטריגרים של mmp-ad-tech לאחר מכן. הנה דוגמה לציר זמן:

  • בשעה t0, מקור המודעות 1 של ad-tech1 רשום אצל "priority": "10".
  • בשעה 1, מקור 2 של ad-tech2 רשום אצל "priority": "20".
  • בשעה 2, ערך Trigger1 של mmp-ad-tech רשום עם הגדרות השיוך (Attribution) של ad-tech1 ו-ad-tech2.
  • בשעה 3, השיוך של Trigger1 מתבצע כאשר המקור שנגזר מ-ad-tech2 זוכה בשיוך (Attribution) ומתעלמת מהמקור של ad-tech1
  • בשלב t4, מקור הערך 3 של ad-tech3 רשום אצל "priority": "5".
  • בשעה t5, ערך ה-Trigger2 של mmp-ad-tech רשום בהגדרות של ad-tech1 ושל ad-tech3.
  • בשעה 6, השיוך של Trigger2 מתבצע, והמקור הנגזר מ'מקור3' (Source3) זוכה בשיוך

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

המקור שנגזר מהמקור של ad-tech1 איבד את השיוך של Trigger1, ולכן לא נעשה שימוש ב-Source1 כדי ליצור מקור נגזר לשיוך של Trigger2. אם הוא לא היה מפסיד לפני כן בשלב 3, הוא היה זוכה במקור של ad-tech3 מכיוון שהעדיפות שלו גבוהה יותר.