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

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

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

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

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

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

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

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

معالجة

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

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

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

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

سيتلقّى "منصّة MMP" تقريرًا مُزالاً من جميع الشبكات، وستتلقّى كل تقنية من تقنيات إعلانات العرض تقارير مُنسوبة ذاتيًا.

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

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

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

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

غير محدّدة

النتيجة

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

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

الحقول

Source1

Source2

Source3

Source4

تقنية تسجيل الإعلانات

تقنية الإعلان 1

mmp-ad-tech

تقنية الإعلان 2

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-ميزة-attribution

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

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

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

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

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

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

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

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

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

في t0، ينقر المستخدم على إعلان، ما يؤدي إلى تسجيل Source1 بواسطة تقنية الإعلان (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 via redirect
 "Attribution-Reporting-Register-Source": {
    "source_event_id": "45453",
    "web_destination": "https://destination.example.com",
    "priority": "100",
    "expiry": "172801",
    "aggregation_keys": {
      "campaignCounts": "0x159",
      "geoValue": "0x5",
    }
  }

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

في 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. يؤدي هذا إلى تفعيل مصدر مشتق، Source3' كمصدر منافس لتحديد المصدر

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

الحقول

Source2

المصدر 3

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

mmp-ad-tech

تقنية الإعلان 2

source_event_id

45453

978

الأولوية

100

200
تم تسجيل المشغلات

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

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

يتم نسب Trigger1 إلى المصدر 3' لأن Source3' له أولوية أعلى من المصدر 2.

المصادر التي تم تجاهلها بعد تحديد المصدر

Source2

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

غير متوفِّرة: لا يتم إنشاء تقارير الأحداث للمصادر المشتقّة.

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

المصدر الرئيسي للمصدر 3، أي المصدر 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.

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

في t0، ينقر المستخدم على إعلان معروض بواسطة ad-tech1، ما يؤدي إلى بدء تسجيل المصدر 1:

 "Attribution-Reporting-Register-Source": {
    "source_event_id": "52343",
    "web_destination": "https://destination.example.com",
    "priority": "20",
    "expiry": "172800",
    "aggregation_keys": {
     "campaignCounts": "0x159",
     "geoValue": "0x5"
   },
   "shared_aggregation_keys": [
     "campaignCounts",
     "geoValue"
   ]
 }

في t1، تسجّل سلسلة التسجيل 2، ad-tech2 المصدر 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"
    }
  }

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

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

تقنية الإعلان 1

mmp-ad-tech

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

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

الحقول

المصدر4'

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

تقنية الإعلان 4

source_event_id

7567

الوجهة

https://destination.example.com

الأولوية

30

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

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

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

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

يتم نسب Trigger1 إلى المصدر 4' لأنه المصدر المؤهَّل فقط لتحديد المصدر

المصادر التي تم تجاهلها بعد تحديد المصدر

لا ينطبق

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

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

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

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

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

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

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

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

في t0، يتسبب تفاعل المستخدم في تسجيل ad-tech1 المصدر 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"
    ]
  }

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

في t2، يتسبب تفاعل المستخدم في تسجيل 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 وSource2' على التوالي، تتنافس جميعها على الإحالة.

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

الحقول

Source1'

المصدر2'

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

تقنية الإعلان 1

تقنية الإعلان 2

source_event_id

3645

345789

الوجهة

android-app://com.example.app

android-app://com.example.app

الأولوية

10

20

قيادة عملية تثبيت التطبيق

نعم

لا
تم تسجيل المشغلات

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

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

يتم إسناد Trigger1 إلى المصدر 1' لأنه قد أدى إلى تثبيت التطبيق الوجهة. يُرجى ملاحظة أن Source2' كان له أولوية أعلى.

المصادر التي تم تجاهلها بعد تحديد المصدر

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

شرح النتيجة

فقد المصدر المشتق من مصدر ad-tech1 تحديد المصدر لـ Trigger1، لذلك لم يتم استخدام المصدر 1 لإنشاء مصدر مشتق من إحالة Trigger2. لو لم يحدث ذلك قبل وصولها إلى المستوى 3، كان من الممكن أن تتفوق على مصدر تكنولوجيا الإعلان 3 بسبب منحها أولوية أعلى.