نمونه های انتساب بین شبکه ای، نمونه های اسناد بین شبکه ای

بیشتر تبلیغ‌کنندگان با چندین شبکه تبلیغاتی مختلف کار می‌کنند تا تبلیغات را در سراسر برنامه‌های ناشر ارائه دهند. اگر شبکه‌های تبلیغاتی منابع اسناد و محرک‌های خود را با API ثبت کنند، گزارش‌های رویداد و خلاصه‌ای را دریافت خواهند کرد.

با این حال، تبلیغ‌کنندگانی که می‌خواهند از یک شخص ثالث برای انجام اسناد بین شبکه‌ای (XNA) برای تعیین یک آگهی برنده برای یک تبدیل معین استفاده کنند، می‌توانند با استفاده از تکنیک‌های زیر به این کار ادامه دهند:

  • یک سرور داخلی برای ثبت رویدادهای ماشه و دریافت گزارش های انتساب از API راه اندازی کنید
  • به استفاده از شریک اندازه گیری تلفن همراه موجود ادامه دهید

صرف نظر از تکنیکی که تبلیغ‌کننده برای استفاده انتخاب می‌کند، API Attribution Reporting از تعدادی ویژگی مختلف پشتیبانی می‌کند که شخص ثالث را قادر می‌سازد منطق XNA را از طرف یک تبلیغ‌کننده سفارشی کند:

  • شخص ثالث می‌تواند با API با یا بدون تغییر مسیر از شبکه‌های تبلیغاتی، انتساب را انجام دهد.
  • اولویت، فیلترها، و کلیدهای کپی کردن می توانند سفارشی سازی اسناد اضافی را بر اساس ابعاد منبع و ماشه ارائه دهند.
  • پنجره‌های انتساب پس از نصب به منابعی که نصب را هدایت کرده‌اند اجازه می‌دهند همچنان اعتبار رویدادهای تبدیل درون‌برنامه آینده را کسب کنند.

مدل اسنادی که فناوری‌های تبلیغاتی برای حذف مجدد بین شبکه‌ها و انتخاب منابع برنده استفاده می‌کنند، بسته به نحوه استفاده از این ویژگی‌های API، می‌تواند سطوح مختلفی از پیچیدگی داشته باشد.

مثال‌های زیر سناریوهای نمونه‌ای را نشان می‌دهند که چگونه می‌توان از این ویژگی‌ها استفاده کرد، و چگونه پیکربندی‌های مختلف تأثیر می‌گذارند که کدام منبع انتساب در نهایت برای یک رویداد محرک معین اعتبار کسب کند.

روند

لیست زیر مراحل فرآیند XNA را مشخص می کند. برای سادگی، مراحل فهرست‌شده در اینجا مدلی را فرض می‌کنند که در آن تبلیغ‌کننده از فناوری تبلیغات برای ارائه تبلیغات و یک MMP برای اندازه‌گیری تبدیل استفاده می‌کند. با این حال، طراحی API انعطاف‌پذیر است - عملکرد در انواع مختلف فناوری‌های تبلیغاتی متفاوت نیست، و همچنین نیازی به استفاده از فناوری تبلیغاتی ندارد.

  1. ثبت منبع : کاربر یک تبلیغ را مشاهده یا کلیک می‌کند و فناوری تبلیغاتی ارائه‌دهنده این منابع را در API ثبت می‌کند. فناوری تبلیغات ارائه‌شده همچنین ممکن است به سایر فناوری‌های تبلیغاتی هدایت شود که می‌توانند منابع را مستقیماً با API نیز ثبت کنند، یا انتساب بین شبکه‌ای را بدون تغییر مسیر فعال کنند.
  2. ثبت ماشه : کاربر یک اقدام مرتبط با تبدیل را انجام می دهد، مانند باز کردن اولین برنامه، خرید یا افزودن به سبد خرید، که پس از آن یک MMP یک ماشه را با API ثبت می کند. MMP همچنین ممکن است به سایر فناوری های تبلیغاتی که می توانند محرک ها را مستقیماً با API ثبت کنند هدایت شود. اگر یک MMP نیاز به فعال کردن انتساب بین شبکه‌ای بدون تغییرمسیر داشته باشد، پیکربندی انتساب باید در طول ثبت راه‌اندازی مشخص شود.
  3. Attribution : اگر پیکربندی انتساب در هنگام ثبت تریگر مشخص شده باشد، منابع مشتق شده از طرف MMP تولید می شوند. سعی می‌شود هر راه‌اندازی با یک منبع واجد شرایط که مستقیماً توسط MMP ثبت شده است یا یک منبع مشتق شده واجد شرایط که از طرف MMP با استفاده از منابع فناوری تبلیغات ارائه شده است، مطابقت داده شود. منابع باقی‌مانده، که انتساب کسب نکرده‌اند، حذف شده‌اند و دیگر واجد شرایط دریافت انتساب برای تبدیل‌های آینده نیستند. همچنین ممکن است در بخش‌های دیگر مستندات، این مورد را با عنوان «یک بار از دست بده، همیشه از دست بده» دیده شود.
    1. هنگامی که یک منبع مشتق شده اعتبار خود را از دست می دهد، وقتی رویدادهای تبدیل آینده توسط MMP ثبت می شود، API منابع مشتق شده آینده را بر اساس منبع اصلی ایجاد نمی کند. فناوری ارائه آگهی و سایر MMPها ممکن است همچنان از منبع اصلی برای انتساب در آینده استفاده کنند. این در سناریوی 6 به تفصیل توضیح داده شده است.
  4. تولید گزارش : انتساب منجر به تولید گزارش رویداد یا انبوه می شود. لطفاً توجه داشته باشید که فقط گزارش‌های انبوه برای منابع مشتق شده تولید می‌شوند.
  5. تحویل گزارش : گزارش های تولید شده برای تحویل برنامه ریزی شده است.

سناریو 1: انتساب شبکه با تغییر مسیر

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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"
    }
  }

در 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 via 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 (Trigger1) می‌شود که همچنین به ad-tech1 (Trigger2) یک ad-tech2 (Trigger3) را هدایت می‌کند:

تعریف نشده

نتیجه

منابع ثبت شده mmp-ad-tech Source2 و Source4 در انتساب برای Trigger1 ثبت شده mmp-ad-tech رقابت می کنند. Source2 به دلیل داشتن اولویت بالاتر بر Source4 پیروز می شود. Trigger2 توسط ad-tech1 توسط ad-tech1 به Source1 و توسط ad-tech2 Trigger3 توسط ad-tech2 به Source3 نسبت داده می شود.

منابع رقیب برای

زمینه های

منبع 1

منبع 2

منبع 3

منبع 4

منبع فناوری ثبت آگهی

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

محرک ها ثبت شد
نتیجه انتساب

ویژگی های Trigger1 به Source2، ویژگی های Trigger2 به Source1 و ویژگی های Trigger3 به Source3.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

Source4 - در آینده برای انتساب رقابت نخواهد کرد.

گزارش رویدادها

نشانی وب گزارش: 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
  }

آدرس گزارش: 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
  }

آدرس گزارش: 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
  }
گزارش های انبوه

نشانی وب گزارش: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

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

نشانی وب گزارش: https://www.ad-tech1.com/.well-known/attribution-reporting/report-aggregate-attribution

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

نشانی اینترنتی گزارش: https://www.ad-tech2.com/.well-known/attribution-reporting/report-aggregate-attribution

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

سناریو 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"
    ]
  }

در 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' را قادر می سازد تا به عنوان منبع رقیب برای انتساب تولید شود.

منابع رقیب

زمینه های

منبع 2

منبع3'

منبع اصلی ثبت آگهی فناوری

mmp-ad-tech

ad-tech2

source_event_id

45453

978

اولویت

100

200

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source3' نسبت داده می شود زیرا Source3' اولویت بیشتری نسبت به Source2 دارد.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

منبع 2

گزارش رویدادها

هیچ - گزارش رویداد برای منابع مشتق شده ایجاد نمی شود.

گزارش های انبوه

منبع والد Source3'، یعنی Source3، فقط campaignCounts به اشتراک می گذارد، قطعه کلیدی برای ماشه توسط:

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

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

در نهایت، کلید حاصل توسط کلید ماشه OR-ing (0x1400) با کلید منبع (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 و نامزد اصلی منبع مشتق شده در یک زنجیره ثبت نام

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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:

    "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 در زنجیره ثبت دوم برنده انتساب می شود. گزارش انبوه حاصل شبیه موارد زیر است:

نتیجه

منبع مشتق شده از Source2 (با " source_event_id": "234456 ") در انتساب شرکت نمی کند زیرا همان زنجیره ثبت یک منبع ثبت شده mmp-ad-tech نیز دارد.

منابع رقیب

زمینه های

منبع1'

منبع 3

منبع اصلی فناوری ثبت آگهی

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

اولویت

20

100

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source3 نسبت داده می شود زیرا Source3 اولویت بیشتری نسبت به Source1 دارد.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

Source1' - Source1 دیگر برای ایجاد منبع مشتق شده برای mmp-ad-tech در نظر گرفته نخواهد شد.

گزارش رویدادها

آدرس گزارش: 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 فناوری تبلیغاتی و 1 MMP است. کاربر روی تبلیغی از 1 فناوری تبلیغات کلیک می‌کند و آگهی‌های 3 مورد دیگر را مشاهده می‌کند. وقتی کاربر در برنامه تبلیغ‌کننده تبدیل می‌کند، MMP یک راه‌انداز را ثبت می‌کند و مشخص می‌کند که از کدام منابع ثبت‌شده در فناوری آگهی ارائه می‌شود تا منابع مشتق شده را بر اساس فیلترهای زیر:

  1. priority_range: منابعی را انتخاب کنید که دارای اولویت در محدوده داده شده باشند
  2. انقضا: منابعی را انتخاب کنید که انقضا دیرتر از مدت زمان مشخص شده دارند
  3. source_filters: منابعی را انتخاب کنید که filter_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"
    ]
  }

در 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 با پیکربندی انتساب برای سایر منابع ثبت‌شده فناوری‌های تبلیغاتی ذکر شده در بالا می‌شود:

  "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. Source1 فیلتر " source_type":"event " در پیکربندی ارجاع ad-tech1 را برآورده نمی کند
  2. Source2 دارای اولویت 2000 است که خارج از فیلتر محدوده اولویت ad-tech2 است (11000)
  3. منبع 3 با مقدار " filter2 " مطابقت ندارد
منابع رقیب

زمینه های

منبع4'

فناوری ثبت آگهی منبع اصلی

ad-tech4

source_event_id

7567

مقصد

https://destination.example.com

اولویت

30

انقضا

زمان ثبت نام + 2 روز

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source4 نسبت داده می شود زیرا تنها منبعی است که برای انتساب واجد شرایط است

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

هیچ یک

گزارش رویدادها

هیچ - گزارش رویداد برای برنده منبع مشتق شده ایجاد نمی شود

گزارش های انبوه

نشانی اینترنتی گزارش: http://www.mmp-ad-tech.com

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

سناریوی 5: انتساب پس از نصب

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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"
    ]
  }

در 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' به ترتیب تولید شده است که برای انتساب با هم رقابت می کنند.

منابع رقیب

زمینه های

منبع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.

نتیجه انتساب

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

سناریوی ششم: یک بار باخت، همیشه باخت

اگر ad-tech1 منبعی داشته باشد که منبع مشتق شده آن در انتساب برای راه‌انداز mmp-ad-tech شرکت کرده و انتساب را از دست داده است، منبع ad-tech1 برای ایجاد منبع مشتق شده برای محرک‌های mmp-ad-tech بعد از آن استفاده نمی‌شود. در اینجا یک نمونه جدول زمانی آمده است:

  • در t0، منبع 1 ad-tech1 با "priority": "10" .
  • در t1، منبع 2 ad-tech2 با "priority": "20" .
  • در t2، Trigger1 mmp-ad-tech با تنظیمات انتساب ad-tech1 و ad-tech2 ثبت شده است.
  • در t3، انتساب برای Trigger1 در جایی اتفاق می‌افتد که منبع مشتق شده از ad-tech2 برنده انتساب شود و منبع ad-tech1 نادیده گرفته شود.
  • در t4، منبع 3 ad-tech3 با "priority": "5" .
  • در t5، Trigger2 mmp-ad-tech با تنظیمات ad-tech1 و ad-tech3 ثبت شده است.
  • در t6، انتساب برای Trigger2 انجام می شود، جایی که منبع مشتق شده از Source3 (Source3') برنده انتساب می شود.

توضیح نتیجه

منبع مشتق شده از منبع ad-tech1 اعتبار Trigger1 را از دست داده بود، بنابراین از Source1 برای ایجاد منبع مشتق شده برای انتساب Trigger2 استفاده نشد. اگر قبلاً در t3 از دست نمی داد، به دلیل داشتن اولویت بالاتر، بر منبع ad-tech3 پیروز می شد.

،

بیشتر تبلیغ‌کنندگان با چندین شبکه تبلیغاتی مختلف کار می‌کنند تا تبلیغات را در سراسر برنامه‌های ناشر ارائه دهند. اگر شبکه‌های تبلیغاتی منابع اسناد و محرک‌های خود را با API ثبت کنند، گزارش‌های رویداد و خلاصه‌ای را دریافت خواهند کرد.

با این حال، تبلیغ‌کنندگانی که می‌خواهند از یک شخص ثالث برای انجام اسناد بین شبکه‌ای (XNA) برای تعیین یک آگهی برنده برای یک تبدیل معین استفاده کنند، می‌توانند با استفاده از تکنیک‌های زیر به این کار ادامه دهند:

  • یک سرور داخلی برای ثبت رویدادهای ماشه و دریافت گزارش های انتساب از API راه اندازی کنید
  • به استفاده از شریک اندازه گیری تلفن همراه موجود ادامه دهید

صرف نظر از تکنیکی که تبلیغ‌کننده برای استفاده انتخاب می‌کند، API Attribution Reporting از تعدادی ویژگی مختلف پشتیبانی می‌کند که شخص ثالث را قادر می‌سازد منطق XNA را از طرف یک تبلیغ‌کننده سفارشی کند:

  • شخص ثالث می‌تواند با API با یا بدون تغییر مسیر از شبکه‌های تبلیغاتی، انتساب را انجام دهد.
  • اولویت، فیلترها، و کلیدهای کپی کردن می توانند سفارشی سازی اسناد اضافی را بر اساس ابعاد منبع و ماشه ارائه دهند.
  • پنجره‌های انتساب پس از نصب به منابعی که نصب را هدایت کرده‌اند اجازه می‌دهند همچنان اعتبار رویدادهای تبدیل درون‌برنامه آینده را کسب کنند.

مدل اسنادی که فناوری‌های تبلیغاتی برای حذف مجدد بین شبکه‌ها و انتخاب منابع برنده استفاده می‌کنند، بسته به نحوه استفاده از این ویژگی‌های API، می‌تواند سطوح مختلفی از پیچیدگی داشته باشد.

مثال‌های زیر سناریوهای نمونه‌ای را نشان می‌دهند که چگونه می‌توان از این ویژگی‌ها استفاده کرد، و چگونه پیکربندی‌های مختلف تأثیر می‌گذارند که کدام منبع انتساب در نهایت برای یک رویداد محرک معین اعتبار کسب کند.

روند

لیست زیر مراحل فرآیند XNA را مشخص می کند. برای سادگی، مراحل فهرست‌شده در اینجا مدلی را فرض می‌کنند که در آن تبلیغ‌کننده از فناوری تبلیغات برای ارائه تبلیغات و یک MMP برای اندازه‌گیری تبدیل استفاده می‌کند. با این حال، طراحی API انعطاف‌پذیر است - عملکرد در انواع مختلف فناوری‌های تبلیغاتی متفاوت نیست، و همچنین نیازی به استفاده از فناوری تبلیغاتی ندارد.

  1. ثبت منبع : کاربر یک تبلیغ را مشاهده یا کلیک می‌کند و فناوری تبلیغاتی ارائه‌دهنده این منابع را در API ثبت می‌کند. فناوری تبلیغات ارائه‌شده همچنین ممکن است به سایر فناوری‌های تبلیغاتی هدایت شود که می‌توانند منابع را مستقیماً با API نیز ثبت کنند، یا انتساب بین شبکه‌ای را بدون تغییر مسیر فعال کنند.
  2. ثبت ماشه : کاربر یک اقدام مرتبط با تبدیل را انجام می دهد، مانند باز کردن اولین برنامه، خرید یا افزودن به سبد خرید، که پس از آن یک MMP یک ماشه را با API ثبت می کند. MMP همچنین ممکن است به سایر فناوری های تبلیغاتی که می توانند محرک ها را مستقیماً با API ثبت کنند هدایت شود. اگر یک MMP نیاز به فعال کردن انتساب بین شبکه‌ای بدون تغییرمسیر داشته باشد، پیکربندی انتساب باید در طول ثبت راه‌اندازی مشخص شود.
  3. Attribution : اگر پیکربندی انتساب در هنگام ثبت تریگر مشخص شده باشد، منابع مشتق شده از طرف MMP تولید می شوند. سعی می‌شود هر راه‌اندازی با یک منبع واجد شرایط که مستقیماً توسط MMP ثبت شده است یا یک منبع مشتق شده واجد شرایط که از طرف MMP با استفاده از منابع فناوری تبلیغات ارائه شده است، مطابقت داده شود. منابع باقی‌مانده، که انتساب کسب نکرده‌اند، حذف شده‌اند و دیگر واجد شرایط دریافت انتساب برای تبدیل‌های آینده نیستند. همچنین ممکن است در بخش‌های دیگر مستندات به این «یک بار از دست بده، همیشه از دست بده» اشاره می‌شود.
    1. هنگامی که یک منبع مشتق شده اعتبار خود را از دست می دهد، وقتی رویدادهای تبدیل آینده توسط MMP ثبت می شود، API منابع مشتق شده آینده را بر اساس منبع اصلی ایجاد نمی کند. فناوری ارائه آگهی و سایر MMPها ممکن است همچنان از منبع اصلی برای انتساب در آینده استفاده کنند. این در سناریو 6 به تفصیل توضیح داده شده است.
  4. تولید گزارش : انتساب منجر به تولید گزارش رویداد یا انبوه می شود. لطفاً توجه داشته باشید که فقط گزارش‌های انبوه برای منابع مشتق شده تولید می‌شوند.
  5. تحویل گزارش : گزارش های تولید شده برای تحویل برنامه ریزی شده است.

سناریو 1: انتساب شبکه با تغییر مسیر

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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"
    }
  }

در 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 via 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 (Trigger1) می‌شود که همچنین به ad-tech1 (Trigger2) یک ad-tech2 (Trigger3) را هدایت می‌کند:

تعریف نشده

نتیجه

منابع ثبت شده mmp-ad-tech Source2 و Source4 در انتساب برای Trigger1 ثبت شده mmp-ad-tech رقابت می کنند. Source2 به دلیل داشتن اولویت بالاتر بر Source4 پیروز می شود. Trigger2 توسط ad-tech1 توسط ad-tech1 به Source1 و توسط ad-tech2 Trigger3 توسط ad-tech2 به Source3 نسبت داده می شود.

منابع رقیب برای

زمینه های

منبع 1

منبع 2

منبع 3

منبع 4

منبع فناوری ثبت آگهی

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

محرک ها ثبت شد
نتیجه انتساب

ویژگی های Trigger1 به Source2، ویژگی های Trigger2 به Source1 و ویژگی های Trigger3 به Source3.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

Source4 - در آینده برای انتساب رقابت نخواهد کرد.

گزارش رویدادها

نشانی وب گزارش: 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
  }

آدرس گزارش: 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
  }

آدرس گزارش: 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
  }
گزارش های انبوه

نشانی وب گزارش: https://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

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

نشانی وب گزارش: https://www.ad-tech1.com/.well-known/attribution-reporting/report-aggregate-attribution

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

نشانی اینترنتی گزارش: https://www.ad-tech2.com/.well-known/attribution-reporting/report-aggregate-attribution

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

سناریوی 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"
    ]
  }

در 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' را قادر می سازد تا به عنوان منبع رقیب برای انتساب تولید شود.

منابع رقیب

زمینه های

منبع 2

منبع3'

منبع اصلی ثبت آگهی فناوری

mmp-ad-tech

ad-tech2

source_event_id

45453

978

اولویت

100

200

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source3' نسبت داده می شود زیرا Source3' اولویت بیشتری نسبت به Source2 دارد.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

منبع 2

گزارش رویدادها

هیچ - گزارش رویداد برای منابع مشتق شده ایجاد نمی شود.

گزارش های انبوه

منبع والد Source3'، یعنی Source3، فقط campaignCounts به اشتراک می گذارد، قطعه کلیدی برای ماشه توسط:

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

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

در نهایت، کلید حاصل توسط کلید ماشه OR-ing (0x1400) با کلید منبع (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 و نامزد اصلی منبع مشتق شده در یک زنجیره ثبت نام

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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"
   ]
 }

در t1، زنجیره ثبت 2، ad-tech2 Source2 را ثبت می کند و برای ثبت منبع MMP تغییر مسیر می دهد، Source3:

    "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 در زنجیره ثبت دوم برنده انتساب می شود. گزارش انبوه حاصل شبیه موارد زیر است:

نتیجه

منبع مشتق شده از Source2 (با " source_event_id": "234456 ") در انتساب شرکت نمی کند زیرا همان زنجیره ثبت یک منبع ثبت شده mmp-ad-tech نیز دارد.

منابع رقیب

زمینه های

منبع1'

منبع 3

منبع اصلی فناوری ثبت آگهی

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

اولویت

20

100

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source3 نسبت داده می شود زیرا Source3 اولویت بیشتری نسبت به Source1 دارد.

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

Source1' - Source1 دیگر برای ایجاد منبع مشتق شده برای mmp-ad-tech در نظر گرفته نخواهد شد.

گزارش رویدادها

آدرس گزارش: 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 فناوری تبلیغاتی و 1 MMP است. کاربر روی تبلیغی از 1 فناوری تبلیغات کلیک می‌کند و آگهی‌های 3 مورد دیگر را مشاهده می‌کند. وقتی کاربر در برنامه تبلیغ‌کننده تبدیل می‌کند، MMP یک راه‌انداز را ثبت می‌کند و مشخص می‌کند که از کدام منابع ثبت‌شده در فناوری آگهی ارائه می‌شود تا منابع مشتق شده را بر اساس فیلترهای زیر:

  1. priority_range: منابعی را انتخاب کنید که دارای اولویت در محدوده داده شده باشند
  2. انقضا: منابعی را انتخاب کنید که انقضا دیرتر از مدت زمان مشخص شده دارند
  3. source_filters: منابعی را انتخاب کنید که filter_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"
    ]
  }

در 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 با پیکربندی انتساب برای سایر منابع ثبت‌شده فناوری‌های تبلیغاتی ذکر شده در بالا می‌شود:

  "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. Source1 فیلتر " source_type":"event " در پیکربندی ارجاع ad-tech1 را برآورده نمی کند
  2. Source2 دارای اولویت 2000 است که خارج از فیلتر محدوده اولویت ad-tech2 است (11000)
  3. منبع 3 با مقدار " filter2 " مطابقت ندارد
منابع رقیب

زمینه های

منبع4'

فناوری ثبت آگهی منبع اصلی

ad-tech4

source_event_id

7567

مقصد

https://destination.example.com

اولویت

30

انقضا

زمان ثبت نام + 2 روز

محرک ها ثبت شد

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

Trigger1 به Source4 نسبت داده می شود زیرا تنها منبعی است که برای انتساب واجد شرایط است

منابع نادیده گرفته شده ذکر منبع را ارسال می کنند

هیچ یک

گزارش رویدادها

هیچ - گزارش رویداد برای برنده منبع مشتق شده ایجاد نمی شود

گزارش های انبوه

نشانی اینترنتی گزارش: http://www.mmp-ad-tech.com

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

سناریوی 5: انتساب پس از نصب

یک تبلیغ‌کننده در حال کار با ۲ فناوری تبلیغاتی و ۱ 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"
    ]
  }

در 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' به ترتیب تولید شده است که برای انتساب با هم رقابت می کنند.

منابع رقیب

زمینه های

منبع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.

نتیجه انتساب

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

سناریوی ششم: یک بار باخت، همیشه باخت

اگر ad-tech1 منبعی داشته باشد که منبع مشتق شده آن در انتساب برای راه‌انداز mmp-ad-tech شرکت کرده و انتساب را از دست داده است، منبع ad-tech1 برای ایجاد منبع مشتق‌شده برای محرک‌های mmp-ad-tech بعد از آن استفاده نمی‌شود. در اینجا یک نمونه جدول زمانی آمده است:

  • در t0، منبع 1 ad-tech1 با "priority": "10" .
  • در t1، منبع 2 ad-tech2 با "priority": "20" .
  • در t2، Trigger1 mmp-ad-tech با تنظیمات انتساب ad-tech1 و ad-tech2 ثبت شده است.
  • در t3، انتساب برای Trigger1 در جایی اتفاق می‌افتد که منبع مشتق شده از ad-tech2 برنده انتساب شود و منبع ad-tech1 نادیده گرفته شود.
  • در t4، منبع 3 ad-tech3 با "priority": "5" .
  • در t5، Trigger2 mmp-ad-tech با تنظیمات ad-tech1 و ad-tech3 ثبت شده است.
  • در t6، انتساب برای Trigger2 انجام می شود، جایی که منبع مشتق شده از Source3 (Source3') برنده انتساب می شود.

توضیح نتیجه

منبع مشتق شده از منبع ad-tech1 اعتبار Trigger1 را از دست داده بود، بنابراین از Source1 برای ایجاد منبع مشتق شده برای انتساب Trigger2 استفاده نشد. اگر قبلاً در t3 از دست نمی داد، به دلیل داشتن اولویت بالاتر، بر منبع ad-tech3 پیروز می شد.