دمج DDM لتتبع التطبيقات التابعة لجهة خارجية

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

1. يتولى المعلن إعداد حدث الإحالة الناجحة في DDM لتمثيل التثبيت/الإحالة الناجحة (مدير عروض الأسعار فقط - وحدة بكسل الإحالة الناجحة) (مدير الحملة - نشاط Floodlight).

2. حدث إحالة ناجحة للمُعلِن &links"DDM في واجهة الجهة الخارجية، ويقدّم متغيرات رئيسية تحدد المُعلِن ومجموعة أنشطة الإحالات الناجحة.

   • src هو الرقم التعريفي للمعلِن الذي يمثّل مصدر نشاط Floodlight.
   • cat هي سلسلة علامة النشاط، التي تستخدمها خوادم Floodlight لتحديد مجموعة الأنشطة التي ينتمي إليها النشاط.
   • type هي سلسلة علامة المجموعة التي تحدّد مجموعة الأنشطة المرتبطة بنشاط Floodlight.
   • u1, u2, ... (في حال توفّرها) هي قيم مفتاح متغير Floodlight المخصّص.

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

4. يُشغِّل المعلن حملة إعلانية داخل التطبيق مع علامات الإعلان التي يعرضها DBM في مقابلات عروض الأسعار في الوقت الفعلي أو التي يعرضها DCM في الوسائط التي يتم شراؤها مباشرةً.

5. يرى المستخدم و/أو ينقر على الإعلانات، التي يتم تسجيلها من خلال DDM.

6. عندما يثبّت المستخدم التطبيق و/أو يُكمل حدث إحالة ناجحة (&"اللعب أثناء اللعب& وما إلى ذلك) وخوادم تابعة لجهة خارجية

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
   

   حيث:

   • src هو الرقم التعريفي للمعلِن الذي يمثّل مصدر نشاط Floodlight.
   • cat هي سلسلة علامة النشاط، التي تستخدمها خوادم Floodlight لتحديد مجموعة الأنشطة التي ينتمي إليها النشاط.
   • type هي سلسلة علامة المجموعة التي تحدّد مجموعة الأنشطة المرتبطة بنشاط Floodlight.
   • ord هو رقم عشوائي يُستخدم لجعل علامة Floodlight فريدة.
   • u1, u2, ... (في حال توفّرها) هي قيم مفتاح متغيّر Floodlight المخصّصة.

   بمعلمات إضافية يتم إرسالها عبر حمولة JSON في مشاركة HTTP:

   {
     "app": {
       "bundle": "com.rovio.angrybirds"
     },
     "device": {
       "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
       "ip": "108.176.57.230",
       "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
       "lmt": 1
     }
   }
   

   ويتم تمرير الرمز المميز لتفويض المُعلن في عنوان تفويض HTTP:

   Authorization: Token token="[advertiser authorization token string]"
   

   حيث:

   • app (مطلوب) هو كائن JSON الذي يمثل التطبيق الذي حدث فيه نشاط الإحالة الناجحة. استخدِم app: {} إذا لم يكن التطبيق الذي حدث فيه نشاط الإحالة الناجحة متاحًا.
   • bundle (إن كان متاحًا) هو حقل كائن التطبيق الذي يحتوي على قيمة سلسلة لاسم حِزمة متجر Play أو رقم تعريف متجر التطبيقات.
   • device هو الكائن JSON الذي يمثل الجهاز الذي حدث عليه نشاط الإحالة الناجحة.
   • ua هو حقل كائن الجهاز الذي يمثل سلسلة وكيل المستخدم للتطبيق الذي تم تسجيل النشاط فيه. هذه المعلّمة مطلوبة.
   • ip (إذا كان متاحًا) هو عنوان IPv4 للجهاز المُحدَّد للجهاز. هذه المعلّمة مطلوبة.
   • didmd5 هي سلسلة تجزئة MD5 من قيمة IDFA أو معرّف إعلانات Google Play الكبيرة.
   • lmt عبارة عن عدد صحيح بقيمة 1 إذا كان المستخدم قد فعّل الخيار "الحد من التتبّع الإعلاني&;&; مع IDFA/AdID أو 0، إذا لم يتم إعداده.

   ستستجيب أداة DDM باستجابة JSON عمّا إذا كان حدث الإحالة الناجحة يُنسب إلى ملف شخصي أو نقرة يتم عرضها من خلال DCM، بالإضافة إلى معلومات إضافية حول الحدث (العرض الأخير أو النقرة):

   - Ad ID
   - Site ID
   - Placement ID
   - Creative ID
   - Timestamp
   

   قد يظهر نموذج استجابة JSON كما يلي:

   {"attributed": 1,  // Whether the conversion can be attributed to a DCM event.
    "last_impression_ad_id":283641088,
    "last_impression_site_id":1408067,
    "last_impression_placement_id":107616368,
    "last_impression_creative_id":60162352,
    "last_impression_timestamp":1415647607,
    "last_click_ad_id":283641088,
    "last_click_site_id":1408067,
    "last_click_placement_id":107616368,
    "last_click_creative_id":60162352,
    "last_click_timestamp":1415647657,
    "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}
   

   حيث:

   • attributed هي القيمة 1 (إذا كان يمكن نسب الإحالة الناجحة إلى مرة ظهور أو نقرة) أو 0 (إذا لم يكن من الممكن نسبها).
   • last_impression_ad_id (إذا تمت إحالته = 1) هو معرّف الإعلان لمرات الظهور الأخيرة.
   • last_impression_site_id (إذا تمت إحالته = 1) هو رقم تعريف الموقع الإلكتروني لمرة الظهور الأخيرة.
   • last_impression_placement_id (إذا كانت منسوبة = 1) هي رقم تعريف موضع الإعلان لآخر مرة ظهور.
   • last_impression_creative_id (إذا تمت إحالته = 1) هو معرّف تصميم الإعلان لآخر مرة ظهور.
   • last_click_ad_id (إذا تمت إحالة = 1 وإحالة من نقرة) هي رقم تعريف الإعلان للنقرة الأخيرة.
   • last_click_site_id (إذا تمت إحالة = 1 وإحالة من نقرة) هو رقم تعريف الموقع للنقرة الأخيرة.
   • last_click_placement_id (إذا كانت منسوبةً إلى 1 ونسبت النقرة) هي معرّف موضع النقرة الأخيرة.
   • last_click_creative_id (إذا تمت إحالة = 1 وإحالة نقرة) ويكون رقم تعريف تصميم الإعلان للنقرة الأخيرة.
   • يتطابق last_click_exclid مع رقم تعريف نقرة فريد تتم تعبئته من خلال وحدة ماكرو %eiid!

   مع رموز أخطاء HTTP، في السيناريوهات التالية:

   • HTTP 204 في حال تجاوز حصة الطلب
   • HTTP 400 عندما يُعتبر الطلب غير صالح (مثل عدم توفّر معلّمات مطلوبة) وتراجع الخادم عن تتبُّع وحدات البكسل.
   • HTTP 401 إذا كان الرمز المميز للتفويض غير صالح.
   • HTTP 404 إذا كانت لديك أي طلبات غير صحيحة.

   سيتمكّن المُعلن من الاطّلاع على تقارير الحملات في نظامك، وسيتمكّن المُعلِن أيضًا من الاطّلاع على تقارير الإحالات الناجحة في DCM ضمن المَعلمات نفسها كما هو موضّح أعلاه.