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

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

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

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

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

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

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

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

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

התהליך

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

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

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

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

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

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

בשלב 0, המשתמש לוחץ על מודעה שהוצגה על ידי ad-tech1 אשר רושמת מקור מקור1 עם ההפניה האוטומטית 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, כלומר מקור4:

  "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) ו-ad-tech2 (Trigger3):

לא מוגדר

תוצאה

מקורות הרשומים ב-mmp-ad-tech Source2 ו-Source4 מתחרים בשיוך עבור הטריגר רשום mmp-ad-tech Trigger1. Source2 מנצח את 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 [טריגרים] ל: Source1 [מקור1] ואת Trigger3 [טריגרים] ל-Source3 [מקור 3].

מקורות שהמערכת מתעלמת מהם בשיוך פוסט

מקור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: שיוך (Attribution) חוצה-רשתות ללא הפניות אוטומטיות

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

בשלב 1, המשתמש לוחץ על מודעה אחרת וכתוצאה מכך מועבר ל-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' [מקור3] כי ל-Source3 יש עדיפות גבוהה יותר מאשר "Source2" (מקור 2).

מקורות שהמערכת מתעלמת מהם בשיוך פוסט

Source2

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

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

דוחות צבירה

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

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

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

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

כתובת אתר של דוח: 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.

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

ב-00, המשתמש לוחץ על מודעה שהוצגה על ידי 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, בהגדרה של הטריגר מוגדר שיוך (Attribution) כדי ליצור מקורות נגזרים מ-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 מיוחס למקור 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
  }

דוחות צבירה

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

עדיפות_range: בחירת מקורות עם עדיפות בטווח הנתון
תפוגה: בחירת מקורות עם תפוגה מאוחרת ממשך הזמן שצוין
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"
    ]
  }

בשלב 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, המרה של משתמשים מובילה לרישום טריגר עם הגדרת שיוך (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"
    }
  }

תוצאה

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

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

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

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

מפעילים נרשמו

Trigger1 של mmp-ad-tech.

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

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

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

בשלב 0, אינטראקציה עם משתמש גורמת ל-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 לרשום את 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 עם תצורות שיוך (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, כלומר מקור1 ו-Source2' בהתאמה, ומתחרים על שיוך.

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

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

מפעילים נרשמו

Trigger1 של mmp-ad-tech.

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

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

מקורות שהמערכת מתעלמת מהם בשיוך פוסט

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

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

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

דוחות צבירה

כתובת אתר של דוח: 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, המקור1 של ad-tech1 רשום אצל "priority": "10".
בשלב 1, המקור2 של ad-tech2 רשום אצל "priority": "20".
בשלב 2, הפרמטר Trigger1 של mmp-ad-tech רשום עם הגדרות השיוך (Attribution) של ad-tech1 ו-ad-tech2.
בשלב 3, השיוך (Attribution) של Trigger1 מתבצע כאשר המקור שנגזר מה-ad-tech2 זוכה לייחוס, והמקור של ad-tech1 לא נלקח בחשבון
בשלב 4, המקור3 של ad-tech3 רשום אצל "priority": "5".
בשלב t5, הפרמטר Trigger2 של mmp-ad-tech רשום בהגדרות של ad-tech1 ו-ad-tech3.
בשלב 6, מתבצע שיוך (Attribution) עבור Trigger2, שבו המקור הנגזר מהמקור3 (Source3) זוכה בשיוך

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

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