أمثلة على الإحالة على جميع الشبكات

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

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

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

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

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

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

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

العملية

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

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

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

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

سيتلقّى "شريك الإعلانات الموجَّه (MMP)" تقريرًا عن إزالة التكرار على جميع الشبكات، وستتلقّى كل تكنولوجيا إعلانات تعرض تقاريرًا ذاتية الإحالة.

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

في المستوى 0، ينقر المستخدِم على أحد الإعلانات المعروضة بواسطة ad-tech1 التي تسجِّل المصدر 1 مع مصدر إعادة التوجيه 2 بواسطة 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"
    }
  }

في المستوى الأول، ينقر المستخدِم على أحد الإعلانات المعروضة من خلال تقنية ad-tech2 لتسجيل المصدر 3 مع إعادة التوجيه إلى mmp-ad-tech، أي المصدر 4:

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

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

عند المستوى 2، يؤدّي إجراء المستخدِم أو الإحالة الناجحة في تطبيق المعلِن إلى تسجيل عامل تشغيل من خلال mmp-ad-tech (Trigger1) الذي يُعيد أيضًا التوجيه إلى ad-tech1 (Trigger2) وad-tech2 (Trigger3):

غير محدّدة

النتيجة

تتنافس المصادر المسجّلة في mmp-ad-tech على المصدر 2 وSource4 في تحديد المصدر المشغِّل Trigger1 الخاص بـ mmp-ad-tech. يفوز المصدر 2 على المصدر 4 بسبب أولوية أعلى. يُنسَب عامل التشغيل 2 من تكنولوجيا الإعلان إلى المصدر 1 من خلال ad-tech1 ويُنسب عامل التشغيل 3 من تكنولوجيا الإعلان إلى المصدر 3 من خلال ad-tech2.

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

الحقول

Source1

Source2

Source3

Source4

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

تكنولوجيا الإعلان

تكنولوجيا إعلان mmp

تكنولوجيا الإعلان

تكنولوجيا إعلان mmp

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، وسمات المشغِّل 2 إلى سمتَي المصدر 1 وعامل المشغِّل 3 إلى المصدر 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. ينقر المستخدِم على إعلان من تقنية الإعلان الأولى التي تعرض إعلانات، ما يؤدي إلى إعادة التوجيه إلى MMP عند تسجيل المصدر. عندما ينقر المستخدِم على إعلان من تقنية الإعلانات الثانية التي تعرض الإعلانات، لا تُعيد تقنية الإعلان التوجيه، ويختار بدلاً من ذلك مشاركة مجموعة فرعية من مفاتيح التجميع الخاصة به مع نظام إدارة الوسائط (MMP) مقدمًا.

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

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

عند الوصول إلى المستوى 0، ينقر المستخدِم على أحد الإعلانات، ما يؤدي إلى تسجيل المصدر 1 عن طريق التسجيل في 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",
    }
  }

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

في المستوى الثاني، يؤدي إجراء المستخدم/محركات الإحالات الناجحة إلى تشغيل التسجيل من خلال 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. ويتيح هذا إنشاء مصدر مشتق، "Source3" كمصدر منافس للإحالة.

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

الحقول

Source2

المصدر 3

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

تكنولوجيا إعلان mmp

تكنولوجيا الإعلان

source_event_id

45453

978

الأولوية

100

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

Trigger1 بواسطة mmp-ad-tech.

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

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

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

Source2

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

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

التقارير الإجمالية

المصدر الرئيسي لـ Source3'، أي أنّ المصدر3 يشارك فقط campaignCounts، ويتم احتساب الجزء الرئيسي للعامل المشغِّل من خلال:

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

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

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

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

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

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

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

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

عند الساعة 0، ينقر المستخدِم على إعلان معروض من خلال 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"
   ]
 }

في المرحلة الأولى، تسجِّل سلسلة التسجيل 2 ad-tech2 المصدر 2 وتعيد التوجيه لتسجيل مصدر MMP، المصدر 3:

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

في المستوى الثاني، يتم ضبط مصدر تسجيل المشغِّل لإنشاء مصادر مشتقة من 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.

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

الحقول

المصدر 1

Source3

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

تكنولوجيا الإعلان

تكنولوجيا إعلان mmp

source_event_id

52343

4234

الأولوية

20

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

Trigger1 بواسطة mmp-ad-tech.

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

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

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

المصدر 1' - لن يتم النظر في المصدر 1 لإنشاء مصدر مشتق من أجل mmp-ad-tech بعد الآن.

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

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

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

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

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

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

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

  1. نطاق_الأولوية: اختيار المصادر التي لها الأولوية ضمن نطاق معين
  2. انتهاء الصلاحية: اختيار المصادر التي تنتهي صلاحيتها بعد المدة المحددة
  3. source_filters: اختيار المصادر التي تتطابق بيانات filter_data فيها مع فلاتر المصدر المحدّدة.
  4. source_not_filters: اختيار المصادر التي تتطابق فلاتر not_filters فيها مع source_not_filters.

بعد إنشاء المصادر المشتقة استنادًا إلى المعايير، تصبح مؤهَّلة للمشاركة في عملية تحديد المصدر.

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

في المستوى 0، تؤدي نقرة المستخدِم إلى تسجيل مصدر الإعلان 1 المصدر 1، ما يربط بين نوع المصدر "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"
    ]
  }

في المستوى الأول، يشاهد المستخدِم الإعلان الذي يتسبب في تسجيل ad-tech2 لمصدر المصدر 2، والذي يربط نوع المصدر كحدث بهذا المصدر المسجَّل:

  "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 لمصدر المصدر 3 الذي يربط نوع المصدر كحدث بهذا المصدر المسجَّل:

  "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 لمصدر المصدر 4، الذي يربط المصدر_type كحدث بهذا المصدر المسجَّل:

  "Attribution-Reporting-Register-Source": {
    "source_event_id": "7567",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "filter_data": {
      "filter1": [
        "match"
      ],
      "filter2": [
        "match"
      ]
    },
    "aggregation_keys": {
      "campaignCounts": "0x169",
      "geoValue": "0x5"
    },
    "shared_aggregation_keys": [
      "campaignCounts",
      "geoValue"
    ]
  }

في المستوى 4، يؤدّي الإحالة الناجحة للمستخدِم إلى تسجيل عامل تشغيل من خلال mmp-ad-tech بشأن إعداد تحديد المصدر لجميع المصادر الأخرى المسجَّلة لتكنولوجيا الإعلان المذكورة أعلاه:

  "Attribution-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" في إعدادات تحديد المصدر في ad-tech1.
  2. تم ضبط أولوية المصدر 2 على 2000، وهي قيمة خارج فلتر نطاق أولوية الإعلان 2 (1,100)
  3. لا يتطابق المصدر 3 مع قيمة "filter2".
المصادر المنافسة

الحقول

المصدر 4

المصدر الأصلي الذي يسجِّل تقنية الإعلان

تكنولوجيا الإعلان

source_event_id

7567

الوجهة

https://destination.example.com

الأولوية

30

انتهاء الصلاحية

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

Trigger1 بواسطة mmp-ad-tech.

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

يُنسَب عامل التشغيل 1 إلى المصدر 4 لأنّه مصدر مؤهَّل فقط لتحديد المصدر.

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

لا ينطبق

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

بدون - لا يتم إنشاء تقارير الأحداث لفائز مصدر مشتقّ

التقارير الإجمالية

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

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

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

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

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

عند المستوى 0، يؤدي تفاعل المستخدِم إلى تسجيل تقنية الإعلان 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"
    ]
  }

في المستوى الأول، يثبِّت المستخدم التطبيق com.example.app على جهازه.

في المستوى الثاني، يؤدي تفاعل المستخدِم إلى تسجيل تقنية ad-tech2 للمصدر 2:

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

في 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 على التوالي، واللذين يتنافسان من أجل الإحالة.

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

الحقول

المصدر 1

المصدر2

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

تكنولوجيا الإعلان

تكنولوجيا الإعلان

source_event_id

3645

345789

الوجهة

android-app://com.example.app

android-app://com.example.app

الأولوية

10

20

دفع تثبيت التطبيق

نعم

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

Trigger1 بواسطة mmp-ad-tech.

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

يُنسب عامل التشغيل 1 إلى المصدر 1 لأنّه أدى إلى تثبيت تطبيق الوجهة. تجدر الإشارة إلى أنّ المصدر 2' كان له أولوية أعلى.

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

المصدر 2 - لن يتم أخذ المصادر المستمدة من المصدر 2 في الاعتبار في الإحالة لأي عوامل تشغيل مسجَّلة بواسطة 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، تمّ تسجيل مصدر ad-tech2's في "priority": "20".
  • في t2، يتم تسجيل Trigger1 في mmp-ad-tech من خلال إعدادات تحديد المصدر لـ ad-tech1 وad-tech2.
  • في المستوى 3، تحدث إحالة المشغِّل 1 حيث يفوز المصدر المشتق من ad-tech2 بالإحالة ويتم تجاهل مصدر ad-tech1.
  • في t4، تمّ تسجيل مصدر 3 ad-tech3 في "priority": "5".
  • في t5، تمّ تسجيل Trigger2 في mmp-ad-tech من خلال إعدادات ad-tech1 وad-tech3.
  • في t6، يحدث تحديد مصدر المشغِّل 2، حيث يفوز المصدر المشتق من المصدر 3 (المصدر 3) بالإحالة.

شرح النتيجة

فَقدَ المصدر المشتق من مصدر ad-tech1 إحالة للعامل المشغِّل 1، لذلك لم يتم استخدام المصدر 1 لإنشاء مصدر مشتق لإحالة المشغِّل 2. وإذا لم يكُن الجهاز قد فُقد من قبل في المستوى الثالث، كان سيتجاوز مصدر تكنولوجيا ad-tech3 لأنّه يحظى بأولوية أعلى.