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

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

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

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

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

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

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

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

فرآیند

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

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

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

یک تبلیغ‌کننده با ۲ تکنسین تبلیغات و ۱ MMP کار می‌کند. وقتی روی تبلیغاتی که توسط تکنسین‌های تبلیغات ارائه می‌شوند کلیک می‌شود، تکنسین‌های تبلیغات در هنگام ثبت منبع به MMP هدایت می‌شوند. وقتی کاربری در برنامه تبدیل می‌شود، MMP در هنگام ثبت تریگر به تکنسین‌های تبلیغات هدایت می‌شود.

MMP یک گزارش تفکیک‌شده بین شبکه‌ای دریافت می‌کند و هر فناوری تبلیغاتی که در حال ارائه خدمات است، گزارش‌های خود-انتسابی دریافت خواهد کرد.

جدول زمانی ثبت نام

در زمان t0، کاربر روی تبلیغی که توسط ad-tech1 ارائه می‌شود کلیک می‌کند که منبع Source1 را به همراه تغییر مسیر آن Source2 توسط mmp-ad-tech ثبت می‌کند:

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

در زمان t1، کاربر روی تبلیغی که توسط ad-tech2 نمایش داده می‌شود کلیک می‌کند تا Source3 را به همراه ریدایرکت آن به mmp-ad-tech (Source4) ثبت کند:

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

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

در زمان t2، اقدام یا تبدیل کاربر در برنامه تبلیغ‌کننده منجر به ثبت یک تریگر توسط mmp-ad-tech (Trigger1) می‌شود که او نیز یک ad-tech2 (Trigger3) را به ad-tech1 (Trigger2) هدایت می‌کند:

تعریف نشده

نتیجه

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

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

فیلدها

منبع1

منبع۲

منبع۳

منبع۴

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

فناوری تبلیغات1

mmp-ad-tech

تبلیغات-فناوری۲

mmp-ad-tech

شناسه رویداد منبع

۳۴۵۳۲

۷۸۸۳۲۴

۶۵۷۴۴۳۵

۴۵۳۲۳۴۳

مقصد

https://destination.example.com

https://destination.example.com

https://destination.example.com

https://destination.example.com

اولویت

۱۰

۳۰

۱۰

۲۰

تریگرهای ثبت شده
نتیجه انتساب

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

سناریوی ۲: انتساب بین شبکه‌ای بدون تغییر مسیر

یک تبلیغ‌کننده با ۲ تکنسین تبلیغات و ۱ MMP کار می‌کند. کاربر روی تبلیغی از اولین تکنسین تبلیغات کلیک می‌کند که پس از ثبت منبع به MMP هدایت می‌شود. وقتی کاربر روی تبلیغی از دومین تکنسین تبلیغات کلیک می‌کند، تکنسین تبلیغات هدایت نمی‌شود و در عوض زیرمجموعه‌ای از کلیدهای تجمیع خود را از قبل با MMP به اشتراک می‌گذارد.

سپس کاربر در برنامه‌ای که MMP تریگر را ثبت می‌کند، تبدیل انجام می‌دهد، اما به هیچ‌کدام از فناوری‌های تبلیغاتی هدایت نمی‌شود. فناوری تبلیغاتی که هدایت نمی‌کند، آخرین ارجاع را برنده می‌شود. فقط MMP یک گزارش خلاصه‌ی deduped بین شبکه‌ای دریافت می‌کند که شامل این تبدیل است.

جدول زمانی ثبت نام

در زمان 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 using redirect
 "Attribution-Reporting-Register-Source": {
    "source_event_id": "45453",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5",
    }
  }

در زمان t1، کاربر روی تبلیغ دیگری کلیک می‌کند و در نتیجه به 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 ثبت‌نام و مقصد را با trigger مطابقت می‌دهد، بنابراین به یک منبع رقیب برای انتساب تبدیل می‌شود. علاوه بر این، در طول ثبت trigger، یک پیکربندی انتساب برای ad-tech2 و Source3 با استفاده از کلیدهای تجمیع اشتراک‌گذاری ad-tech2 مشخص شد. این امر باعث می‌شود یک منبع مشتق شده، Source3'، به عنوان یک منبع رقیب برای انتساب تولید شود.

منابع رقیب

فیلدها

منبع۲

منبع ۳'

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

mmp-ad-tech

تبلیغات-فناوری۲

شناسه رویداد منبع

۴۵۴۵۳

۹۷۸

اولویت

۱۰۰

۲۰۰

تریگرهای ثبت شده

Trigger1 توسط mmp-ad-tech.

نتیجه انتساب

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

منابع نادیده گرفته شده پس از انتساب

منبع۲

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

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

گزارش‌های کلی

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

(key_piece value) | ((x_network_key_mapping entry) << offset)
0x400 | (0x4 << 10) = 0x1400

در نهایت، کلید حاصل با OR کردن کلید ماشه (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
    }
  ]
}

سناریوی ۳: منبع ثبت‌شده‌ی MMP و کاندیدای والد منبع مشتق‌شده در یک زنجیره‌ی ثبت نام

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

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

در زمان t2، ثبت تریگر به گونه‌ای پیکربندی شده است که منابع مشتق شده از ad-tech1 و ad-tech2 را تولید کند:

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

نتیجه این است که منبع ثبت‌شده در MMP در زنجیره ثبت دوم، انتساب را برنده می‌شود. گزارش کلی حاصل شبیه به شکل زیر است:

نتیجه

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

منابع رقیب

فیلدها

منبع ۱'

منبع۳

منبع اصلی ثبت نام فناوری تبلیغات

فناوری تبلیغات1

mmp-ad-tech

شناسه رویداد منبع

۵۲۳۴۳

۴۲۳۴ عدد

اولویت

۲۰

۱۰۰

تریگرهای ثبت شده

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

سناریوی ۴: انتساب بین شبکه‌ای بدون تغییر مسیر با معیارهای انتخاب منبع

یک تبلیغ‌کننده با ۴ سرویس‌دهنده‌ی فناوری تبلیغات و ۱ MMP کار می‌کند. کاربر روی تبلیغی از ۱ سرویس‌دهنده‌ی فناوری تبلیغات کلیک می‌کند و تبلیغات ۳ سرویس‌دهنده‌ی دیگر را مشاهده می‌کند. وقتی کاربری در برنامه‌ی تبلیغ‌کننده تبدیل می‌شود، 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 روی ۲۰۰۰ تنظیم شده است که خارج از فیلتر محدوده اولویت ad-tech2 (۱۱۰۰۰) است.
  3. مقدار Source3 با filter2 مطابقت ندارد.
منابع رقیب

فیلدها

منبع ۴'

منبع اصلی ثبت نام فناوری تبلیغات

تبلیغات-فناوری۴

شناسه رویداد منبع

7567

مقصد

https://destination.example.com

اولویت

۳۰

انقضا

مهلت ثبت نام + ۲ روز

تریگرهای ثبت شده

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

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

یک تبلیغ‌کننده با ۲ تکنسین تبلیغات و ۱ MMP کار می‌کند. کاربر روی تبلیغی از اولین تکنسین تبلیغات کلیک می‌کند و برنامه تبلیغ‌کننده را نصب می‌کند. در طول تخصیص برای تبدیل‌های پس از نصب، منبع مشتق شده با تخصیص نصب بر سایر منابع پیروز می‌شود، حتی اگر منابع دیگر اولویت بالاتری داشته باشند.

جدول زمانی ثبت نام

در زمان t0، تعامل کاربر باعث می‌شود ad-tech1 منبع ۱ را ثبت کند:

  "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 منبع ۲ را ثبت کند:

  "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

تبلیغات-فناوری۲

شناسه رویداد منبع

۳۶۴۵ عدد

۳۴۵۷۸۹

مقصد

برنامه اندروید: //com.example.app

برنامه اندروید: //com.example.app

اولویت

۱۰

۲۰

نصب برنامه Drive

بله

خیر

تریگرهای ثبت شده

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، Source2 مربوط به ad-tech2 با "priority": "20" ثبت شده است.
  • در زمان t2، Trigger1 مربوط به mmp-ad-tech با پیکربندی‌های انتساب ad-tech1 و ad-tech2 ثبت شده است.
  • در زمان t3، انتساب Trigger1 رخ می‌دهد که در آن منبع مشتق شده از ad-tech2 انتساب را برنده می‌شود و منبع ad-tech1 نادیده گرفته می‌شود.
  • در زمان t4، Source3 مربوط به ad-tech3 با "priority": "5" ثبت شده است.
  • در زمان t5، Trigger2 مربوط به mmp-ad-tech با پیکربندی‌های ad-tech1 و ad-tech3 ثبت شده است.
  • در زمان t6، نسبت دادن به Trigger2 انجام می‌شود، که در آن منبع مشتق شده از Source3 (Source3') نسبت دادن را برنده می‌شود.

توضیح نتیجه

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