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

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

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

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

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

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

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

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

العملية

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

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

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

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

غير محدّدة

النتيجة

يتنافس المصدران Source2 وSource4 المسجّلان لدى شريك تكنولوجيا الإعلان في منصة قياس التسويق معًا على تحديد المصدر لمشغّل Trigger1 المسجّل لدى شريك تكنولوجيا الإعلان في منصة قياس التسويق. تكون الأولوية للمصدر 2 على المصدر 4 لأنّ المصدر 2 لديه أولوية أعلى. يتم تحديد مصدر Trigger2 على أنّه Source1 من خلال ad-tech1، ويتم تحديد مصدر Trigger3 على أنّه 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 إلى Source2، وسمات Trigger2 إلى Source1، وسمات Trigger3 إلى Source3.

سمات المشاركات من المصادر التي تم تجاهلها

Source4 - won't compete for attribution in future.

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

عنوان 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، ينقر المستخدم على إعلان، ما يؤدي إلى تسجيل 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 مع التسجيل والوجهة مع المشغّل، وبالتالي يصبح مصدرًا منافسًا لتحديد المصدر. بالإضافة إلى ذلك، أثناء تسجيل المشغّل، تم تحديد إعداد تحديد المصدر لـ ad-tech2 وSource3 باستخدام مفاتيح تجميع المشاركة في ad-tech2. يتيح ذلك إنشاء مصدر مشتق، Source3، كمصدر منافس لتحديد المصدر.

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

الحقول

Source2

المصدر3'

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

mmp-ad-tech

ad-tech2

source_event_id

45453

978

الأولوية

100

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

‫Trigger1 من mmp-ad-tech

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

يتم تحديد المصدر "Source3" كالمصدر المسؤول عن Trigger1 لأنّ لديه أولوية أعلى من Source2.

سمات المشاركات من المصادر التي تم تجاهلها

Source2

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

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

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

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

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

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

أخيرًا، يتم إنشاء المفتاح الناتج من خلال دمج مفتاح التشغيل (0x1400) مع مفتاح المصدر (0x159) باستخدام عامل OR، ما يؤدي إلى الحصول على 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: مصدر مسجَّل لدى شريك قياس الأداء على الأجهزة الجوّالة ومصدر مشتقّ مرشّح رئيسي في سلسلة التسجيل نفسها

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

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

في الوقت 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"
    }
  }

والنتيجة هي أنّ المصدر المسجَّل لدى شريك قياس الأداء التسويقي في سلسلة التسجيل الثانية يحصل على تحديد المصدر. سيبدو التقرير المجمّع الناتج على النحو التالي:

النتيجة

لا يشارك المصدر المشتق من Source2 (الذي يتضمّن "source_event_id": "234456") في تحديد المصدر لأنّ سلسلة التسجيل نفسها تتضمّن أيضًا مصدرًا مسجّلاً من قِبل شريك تقني في مجال الإعلان على الأجهزة الجوّالة.

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

الحقول

Source1'

Source3

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

ad-tech1

mmp-ad-tech

source_event_id

52343

4234

الأولوية

20

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

‫Trigger1 من mmp-ad-tech

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

يتم تحديد المصدر Source3 كالمصدر المسؤول عن Trigger1 لأنّ لديه أولوية أعلى من Source1.

سمات المشاركات من المصادر التي تم تجاهلها

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

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

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

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

في الوقت t0، يؤدي النقر من قِبل المستخدم إلى تسجيل مصدر Source1 في ad-tech1، ما يؤدي إلى ربط 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. لا يستوفي Source1 فلتر source_type:event في إعداد تحديد المصدر الخاص بـ ad-tech1
  2. تم ضبط أولوية Source2 على 2000، وهو خارج نطاق فلتر الأولوية (1,1000) في ad-tech2
  3. لا يتطابق Source3 مع قيمة filter2
المصادر المتنافسة

الحقول

المصدر 4'

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

ad-tech4

source_event_id

7567

الوجهة

https://destination.example.com

الأولوية

30

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

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

‫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، يؤدي تفاعل المستخدم إلى تسجيل 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"
    }
  }

النتيجة

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

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

الحقول

Source1'

المصدر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.

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

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

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

عنوان 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، يتم تسجيل Source1 الخاص بـ 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-tech1 وad-tech3.
  • في t6، يتم تحديد مصدر Trigger2، حيث يفوز المصدر المشتقّ من Source3 (Source3') بعملية تحديد المصدر.

شرح النتيجة

فقد المصدر المشتقّ من مصدر ad-tech1 تحديد المصدر الخاص بـ Trigger1، لذا لم يتم استخدام Source1 لإنشاء مصدر مشتقّ لتحديد المصدر الخاص بـ Trigger2. لو لم يخسر إعلان الحملة (أ) في t3، كان سيفوز على مصدر ad-tech3 بسبب تمتّعه بأولوية أعلى.