أمثلة على تحديد المصدر على جميع الشبكات

يعمل معظم المعلِنين مع عدة شبكات إعلانية مختلفة لعرض الإعلانات على تطبيقات الناشرين. إذا سجّلت شبكات الإعلانات مصادر تحديد المصدر و المشغِّلات الخاصة بها في واجهة برمجة التطبيقات، ستتلقّى تقارير عن الأحداث والملخّصات التي تم تحديد مصدرها ذاتيًا.

ومع ذلك، يمكن للمعلِنين الذين يريدون استخدام جهة خارجية لإجراء عملية تحديد مصدر على مستوى الشبكات المتعددة (XNA) لتحديد إعلان واحد فائِز لإحالة ناجحة معيّنة مواصلة إجراء ذلك باستخدام الأساليب التالية:

  • إعداد خادم داخلي لتسجيل أحداث المشغِّلات وتلقّي تقارير تحديد المصدر من واجهة برمجة التطبيقات
  • مواصلة استخدام شريك قياس أداء حالي على الأجهزة الجوّالة

بغض النظر عن التقنية التي يختارها المعلِن لاستخدامها، تتيح واجهة برمجة التطبيقات Attribution reporting API عددًا من الميزات المختلفة التي تتيح لجهة خارجية تخصيص منطق XNA نيابةً عن المعلِن:

  • يمكن لجهة خارجية إجراء عملية تحديد المصدر باستخدام واجهة برمجة التطبيقات مع أو بدون عمليات إعادة التوجيه من شبكات الإعلانات.
  • يمكن أن توفّر الأولوية والفلاتر ومفاتيح إزالة التكرار تخصيصًا إضافيًا لتحديد المصدر استنادًا إلى سمات المصدر والعامل المشغّل.
  • تسمح فترات تحديد المصدر بعد التثبيت للمصادر التي أدّت إلى إجراء عملية تثبيت بمواصلة الحصول على نسبة المساهمة في أحداث الإحالات الناجحة المستقبلية داخل التطبيق.

يمكن أن يكون لنموذج تحديد المصدر الذي تستخدمه تكنولوجيات الإعلان لإزالة تكرار الإحالات الناجحة على جميع الشبكات واختيار المصادر الفائزة مستويات مختلفة من التعقيد، وذلك استنادًا إلى كيفية الاستفادة من ميزات واجهة برمجة التطبيقات هذه.

توضّح الأمثلة التالية سيناريوهات حول كيفية استخدام هذه الميزات، وكيفية تأثير الإعدادات المختلفة في مصدر تحديد المصدر الذي يحصل في النهاية على نسبة المساهمة في حدث تشغيل معيّن.

العملية

توضِّح القائمة التالية خطوات عملية XNA. للتبسيط، تفترض الخطوات المدرَجة هنا نموذجًا يستخدم فيه المعلِن تقنية عرض الإعلانات لعرض الإعلانات ونظام إدارة الأداء للتسويق (MMP) لقياس الإحالات الناجحة. ومع ذلك، يتسم تصميم واجهة برمجة التطبيقات بالمرونة، إذ لا تختلف الوظائف بين الأنواع المختلفة من تكنولوجيات الإعلان، ولا تتطلّب استخدام تكنولوجيا إعلانية.

  1. تسجيل المصدر: يطّلع المستخدم على إعلان أو ينقر عليه، وتسجّل تكنولوجيا عرض الإعلانات هذه المصادر في واجهة برمجة التطبيقات. يمكن أن تعيد تكنولوجيا عرض الإعلانات التوجيه أيضًا إلى تكنولوجيات إعلانية أخرى يمكنها تسجيل المصادر مباشرةً باستخدام واجهة برمجة التطبيقات أيضًا، أو تفعيل تحديد المصدر على مستوى الشبكات بدون عمليات إعادة التوجيه.
  2. تسجيل المشغِّل: ينفّذ المستخدِم إجراءً مرتبطًا بالإحالة الناجحة، مثل فتح التطبيق لأول مرة أو الشراء أو إضافة سلعة إلى سلة التسوّق، وعندئذٍ يسجِّل منصّة إدارة الأداء (MMP) مشغِّلاً باستخدام واجهة برمجة التطبيقات. يمكن أن تُعيد منصّة إدارة الأداء أيضًا التوجيه إلى تقنيات إعلانية أخرى يمكنها تسجيل عوامل التفعيل مباشرةً من خلال واجهة برمجة التطبيقات. إذا كانت منصّة إدارة الأداء التسويقي (MMP) بحاجة إلى تفعيل تحديد المصدر على مستوى الشبكات بدون عمليات إعادة التوجيه، يجب تحديد إعدادات تحديد المصدر أثناء تسجيل العامل المشغِّل.
  3. تحديد المصدر: في حال تحديد إعدادات تحديد المصدر أثناء تسجيل العامل المشغِّل، يتم إنشاء مصادر مشتقة بالنيابة عن منصّة إدارة الأداء التسويقي. تتم محاولة مطابقة كلّ عامل تشغيل مع مصدر مؤهّل مسجّل مباشرةً من خلال منصّة إدارة الأداء التسويقي (MMP) أو مصدر مشتق مؤهّل تم إنشاؤه نيابةً عن منصّة إدارة الأداء التسويقي باستخدام مصادر تكنولوجيا عرض الإعلانات. ويتمّ إسقاط المصادر المتبقية التي لم تحصل على مصدر الإحالة، ولن تكون مؤهّلة بعد ذلك للحصول على مصدر الإحالة للإحالات الناجحة المستقبلية. قد تتم الإشارة إلى ذلك أيضًا باسم "فقدان المحتوى مرة واحدة يعني فقدانه إلى الأبد" في أجزاء أخرى من المستندات.
    1. عندما يفقد مصدر مشتقّ عملية تحديد المصدر، لن تنشئ واجهة برمجة التطبيقات مصادر مشتقّة مستقبلية استنادًا إلى المصدر الأصلي عند تسجيل أحداث الإحالات الناجحة المستقبلية من خلال منصّة إدارة الأداء التسويقي. قد يستمرّ استخدام تقنية عرض الإعلانات وخدمات إدارة الأداء التسويقي الأخرى للمصدر الأصلي في تحديد المصدر في المستقبل. وقد تم وصف ذلك بالتفصيل في السيناريو 6.
  4. إنشاء التقارير: يؤدّي تحديد المصدر إلى إنشاء تقارير عن الأحداث أو التقارير المجمّعة. يُرجى العِلم أنّه يتم إنشاء تقارير مجمّعة فقط للمصادر المستمدة.
  5. تسليم التقارير: يتم جدولة تسليم التقارير التي تم إنشاؤها.

السيناريو 1: تحديد المصدر على جميع الشبكات باستخدام عمليات إعادة التوجيه

يعمل المعلِن مع تقنيتي عرض إعلانات ونظام إدارة أداء واحد. عند النقر على الإعلانات التي تعرِضها تكنولوجيات عرض الإعلانات، تعيد تكنولوجيات عرض الإعلانات التوجيه إلى منصّة إدارة الأداء التسويقي عند تسجيل المصدر. عندما يُجري أحد المستخدِمين إحالة ناجحة في التطبيق، تعيد منصّة إدارة الأداء (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-tech1‏ (Trigger2) وad-tech2‏ (Trigger3):

غير محدّدة

النتيجة

يتنافس المصدران Source2 وSource4 المسجَّلان في mmp-ad-tech في عملية تحديد المصدر لشدَّة مفعول عامل التفعيل Trigger1 المسجَّل في mmp-ad-tech. يفوز المصدر2 على المصدر4 بسبب حصوله على أولوية أعلى. يتمّ تحديد مصدر 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
المشغّلات المسجّلة
نتيجة تحديد المصدر

سمات Trigger1 إلى المصدر2، وسمات Trigger2 إلى المصدر1، وسمات Trigger3 إلى المصدر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: تحديد المصدر على جميع الشبكات بدون عمليات إعادة التوجيه

يعمل المعلِن مع تقنيتي عرض إعلانات ونظام إدارة أداء واحد. ينقر المستخدِم على إعلان من تقنية عرض الإعلانات الأولى، ما يؤدي إلى إعادة التوجيه إلى منصّة إدارة الأداء التسويقي عند تسجيل المصدر. عندما ينقر المستخدِم على إعلان من تكنولوجيا عرض الإعلانات الثانية، لا تُعيد تكنولوجيا عرض الإعلانات التوجيه، بل تختار بدلاً من ذلك مشاركة مجموعة فرعية من مفاتيح التجميع مع منصّة إدارة الأداء التسويقي مسبقًا.

يُجري المستخدِم بعد ذلك إحالة ناجحة في التطبيق الذي يسجِّل فيه منصّة إدارة الأداء التسويقي عامل التفعيل، ولكنّه لا يُعيد التوجيه إلى أيّ من تكنولوجيات الإعلان. تحصل تكنولوجيا الإعلان التي لا تُعيد التوجيه على عملية تحديد المصدر بالاستناد إلى نقطة الاتصال الأخيرة. سيتلقّى منصّة إدارة الأداء (MMP) فقط تقريرًا تلخيصيًا مُعاد تكراره على جميع الشبكات يتضمّن هذه الإحالة الناجحة.

المخطط الزمني للتسجيلات

في t0، ينقر المستخدِم على إعلان، ما يؤدّي إلى تسجيل المصدر1 من قِبل ad-tech1 وتسجيل المصدر2 من قِبل mmp-ad-tech باستخدام إعادة التوجيه من ad-tech1:

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

في t1، ينقر المستخدِم على إعلان آخر، ما يؤدي إلى 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"
    }
  }

النتيجة

يتطابق المصدر2 مع التسجيل والوجهة مع المشغّل، ما يجعله مصدرًا متنافسًا لتحديد المصدر. بالإضافة إلى ذلك، أثناء تسجيل المشغّل، تم تحديد إعداد تحديد مصدر لكلّ من ad-tech2 وSource3 باستخدام مفاتيح تجميع المشاركة في ad-tech2. يتيح ذلك إنشاء مصدر مشتق، وهو "المصدر3"، كمصدر منافس لتحديد المصدر.

المصادر المنافسة

الحقول

Source2

Source3'

المصدر الأصلي يسجّل تكنولوجيا الإعلان

mmp-ad-tech

ad-tech2

source_event_id

45453

978

الأولوية

100

200
المشغّلات المسجّلة

Trigger1 من mmp-ad-tech

نتيجة تحديد المصدر

يتمّ إسناد العامل المشغّل 1 إلى المصدر 3 لأنّ المصدر 3 لديه أولوية أعلى من المصدر 2.

نشر الإحالة إلى المصادر التي تم تجاهلها

Source2

تقارير الأحداث

لا شيء: لا يتم إنشاء تقارير الأحداث للمصادر المستمدة.

التقارير المجمّعة

لا يشارك المصدر الرئيسي لمصدر3، أي مصدر3، سوى campaignCounts، ويتم احتساب المقطع الرئيسي للعامل المشغِّل على النحو التالي:

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

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

أخيرًا، يتم إنشاء المفتاح الناتج عن طريق دمج مفتاح التفعيل (0x1400) مع مفتاح المصدر (0x159)، ما يؤدي إلى إنشاء 0x1559.

عنوان URL للتقرير: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

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

السيناريو 3: مصدر مسجَّل في MMP ومصدر مشتق مرشح للعنصر الرئيسي في سلسلة التسجيل نفسها

يعمل المعلِن مع تقنيتي عرض إعلانات ونظام إدارة أداء واحد. ينقر المستخدِم على إعلان من تقنية عرض الإعلانات الأولى التي لا تُعيد التوجيه عند تسجيل المصدر، ولكنّها تشارك مفاتيح التجميع مع منصّة إدارة الأداء التسويقي. ينقر المستخدِم على إعلان من تقنية عرض الإعلانات الثانية، التي تعيد التوجيه إلى منصّة إدارة الأداء التسويقي عند تسجيل المصدر وتشارك مفاتيح التجميع مع منصّة إدارة الأداء التسويقي.

المخطط الزمني للتسجيلات

في 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، تقنية الإعلان 2، المصدر 2 ووجّهت المستخدمين إلى تسجيل مصدر إدارة الأداء التسويقي، المصدر 3:

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

في t2، تم ضبط عملية تسجيل المشغّل لإنشاء مصادر مشتقة من ad-tech1 وad-tech2:

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

والنتيجة هي أنّ المصدر المسجّل في منصّة إدارة الأداء (MMP) في سلسلة التسجيل الثانية هو الذي يحصل على عملية الإحالة الناجحة. يشبه التقرير المجمّع الناتج ما يلي:

النتيجة

لا يشارك المصدر المشتق من المصدر2 (الذي يحمل القيمة "source_event_id": "234456") في عملية تحديد المصدر لأنّ سلسلة التسجيل نفسها تحتوي أيضًا على مصدر مسجّل من النوع mmp-ad-tech.

المصادر المنافسة

الحقول

Source1'

Source3

المصدر الأصلي يسجّل تكنولوجيا الإعلان

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

الأولوية

20

100
المشغّلات المسجّلة

Trigger1 من mmp-ad-tech

نتيجة تحديد المصدر

يتمّ تحديد المصدر3 كسبب لحدوث الإجراء Trigger1 لأنّ المصدر3 لديه أولوية أعلى من المصدر1.

نشر الإحالة إلى المصادر التي تم تجاهلها

‫Source1: لن يتم اعتبار Source1 لإنشاء مصدر مشتق من mmp-ad-tech بعد الآن.

تقارير الأحداث

عنوان URL للتقرير: https://www.ad-tech1.com/.well-known/attribution-reporting/report-event-attribution

  {
    "attribution_destination": "https://destination.example.com",
    "scheduled_report_time": "800176400",
    "source_event_id": "4234",
    "trigger_data": "2",
    "source_type": "navigation",
    "randomized_trigger_rate": 0.0024263
  }
التقارير المجمّعة

عنوان URL للتقرير: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

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

السيناريو 4: تحديد المصدر على مستوى الشبكات بدون عمليات إعادة توجيه مع معايير لاختيار المصدر

يعمل المعلِن مع 4 تقنيات عرض إعلانات ونظام إدارة أداء واحد. ينقر أحد المستخدِمين على إعلان من تقنية عرض إعلان واحدة ويشاهد إعلانات من التقنيات الثلاث الأخرى. عندما يُجري المستخدِم إحالة ناجحة في تطبيق المعلِن، يسجِّل منصّة إدارة الأداء التسويقي عامل تشغيل ويحدِّد مصادر تقنية عرض الإعلانات المسجَّلة لإنشاء مصادر مشتقة منها، استنادًا إلى الفلاتر التالية:

  1. النطاق_حسب_الأولوية: اختيار المصادر ذات الأولوية ضمن النطاق المحدّد
  2. انتهاء الصلاحية: اختيار مصادر تنتهي صلاحيتها بعد مدة أطول من المدة المحدّدة
  3. source_filters: اختيار المصادر التي تتطابق فيها filter_data مع source_filters المحدّدة
  4. source_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 عامل تشغيل مع إعداد تحديد المصدر لجميع مصادر تقنية الإعلان الأخرى المذكورة سابقًا والمسجّلة:

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

النتيجة

لا تُعدّ المصادر التالية مؤهّلة لإنشاء مصادر مشتقة منها بسبب عدم تطابق المعايير:

  1. لا يستوفي المصدر1 فلتر source_type:event في إعدادات تحديد المصدر في تقنية الإعلان1.
  2. تم ضبط الأولوية على المصدر2 على 2000، وهي خارج نطاق فلتر الأولوية في ad-tech2‏ (1,1000).
  3. لا تتطابق Source3 مع قيمة filter2
المصادر المنافسة

الحقول

Source4'

تسجيل تكنولوجيا الإعلان في المصدر الأصلي

ad-tech4

source_event_id

7567

الوجهة

https://destination.example.com

الأولوية

30

expiry

وقت التسجيل + يومان
المشغّلات المسجّلة

Trigger1 من mmp-ad-tech

نتيجة تحديد المصدر

يتمّ تحديد مصدر Trigger1 على أنّه Source4 لأنّه المصدر الوحيد المؤهّل لتحديد المصدر.

نشر الإحالة إلى المصادر التي تم تجاهلها

بدون

تقارير الأحداث

لا شيء، لا يتم إنشاء تقارير الأحداث للإعلان الفائز من مصدر مشتق

التقارير المجمّعة

عنوان URL للتقرير: http://www.mmp-ad-tech.com

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

السيناريو 5: تحديد المصدر بعد التثبيت

يعمل المعلِن مع تقنيتي عرض إعلانات ونظام إدارة أداء واحد. ينقر أحد المستخدِمين على إعلان من تقنية عرض الإعلانات الأولى ويثبّت تطبيق المعلِن. أثناء تحديد مصدر الإحالة الناجحة بعد التثبيت، يفوز المصدر المشتق الذي تم تحديد مصدر التثبيت منه على المصادر الأخرى، حتى إذا كانت المصادر الأخرى لها أولويات أعلى.

المخطط الزمني للتسجيل

في t0، يؤدي تفاعل المستخدِم إلى تسجيل تكنولوجيا الإعلان1 لمصدر1:

  "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، يؤدّي تفاعل المستخدِم إلى تسجيل تكنولوجيا الإعلان2 لمصدر2:

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

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

النتيجة

مصادر مشتقة تم إنشاؤها من المصدر1 والمصدر2 (المصدر1 والمصدر2 على التوالي)، والتي تتنافس على تحديد المصدر.

المصادر المنافسة

الحقول

Source1'

Source2'

المصدر الأصلي يسجّل تكنولوجيا الإعلان

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 لأنّه أدّى إلى تثبيت التطبيق المقصود. يُرجى العلم أنّ المصدر2 كان لديه أولوية أعلى.

نشر الإحالة إلى المصادر التي تم تجاهلها

Source2: لن يتمّ اعتبار المصادر المشتقة من Source2 في عملية تحديد المصدر لأيّ عوامل تشغيل مسجّلة من خلال mmp-ad-tech.

تقارير الأحداث

لا شيء، لا يتم إنشاء تقارير الأحداث للإعلان الفائز من مصدر مشتق

التقارير المجمّعة

عنوان URL للتقرير: http://www.mmp-ad-tech.com/.well-known/attribution-reporting/report-aggregate-attribution

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

السيناريو 6: خسارة مرة واحدة تعني خسارة دائمًا

إذا كان لخدمة ad-tech1 مصدرًا شارك مصدره المشتق في تحديد مصدر عامل تشغيل mmp-ad-tech وفقَد تحديد المصدر، لا يتم استخدام مصدر ad-tech1 لإنشاء مصدر مشتق لعوامل تشغيل mmp-ad-tech بعد ذلك. في ما يلي مثال على مخطط زمني:

  • في t0، يتم تسجيل المصدر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، لذا لم يتم استخدام المصدر1 لإنشاء مصدر مشتق لتحديد مصدر Trigger2. إذا لم يكن قد خسر في وقت سابق في t3، كان سيفوز على مصدر ad-tech3 بسبب أنّه يتمتع بأولوية أعلى.