تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج "إدارة بيانات DoubleClick" لتتبُّع التطبيقات التابعة لجهات خارجية

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

للحصول على مزيد من المعلومات حول DoubleClick Digital Marketing بشكل عام، بالإضافة إلى نظرة عامة على ميزات تحديد المصدر داخل التطبيق، يُرجى الاطّلاع على صفحة معلومات DoubleClick Digital Marketing.

يُعدِّ المعلِن حدث الإحالة الناجحة في "إعلانات شبكة العرض المزدوجة" لتمثيل عملية التثبيت أو الإحالة الناجحة (في "مدير عروض الأسعار" فقط - بكسل الإحالة الناجحة) (في "مدير الحملة" - نشاط Floodlight).
يربط المعلِن حدث الإحالة الناجحة في "إدارة حملة DoubleClick" بواجهة الطرف الثالث، ويقدّم المتغيّرات الرئيسية التي تحدّد المعلِن ومجموعة أنشطة الإحالات الناجحة.
- ‫src هو الرقم التعريفي للمعلِن الذي يمثّل مصدر نشاط Floodlight.
- ‫cat هي سلسلة علامة النشاط التي تستخدمها خوادم Floodlight لتحديد مجموعة الأنشطة التي ينتمي إليها النشاط.
- ‫type هي سلسلة علامة المجموعة التي تحدِّد مجموعة الأنشطة التي يرتبط بها نشاط Floodlight.
- u1, u2, ... (إذا كانت متاحة) هي قيم مفاتيح متغيّرات Floodlight المخصّصة.
يضيف المعلِن متغيرات للإشارة إلى جمع الموافقة من أجل الامتثال لقانون الأسواق الرقمية.
- يُستخدَم eea لتحديد المستخدمين في المنطقة الاقتصادية الأوروبية.
  - يشير الرمز eea=0 إلى أنّ المستخدم ليس من المنطقة الاقتصادية الأوروبية.
  - يشير الرمز eea=1 إلى أنّ المستخدم من المنطقة الاقتصادية الأوروبية.
- ‫ad_user_data هو علامة الموافقة على استخدام بيانات المستخدمين لأغراض إعلانية.
  - يجب ضبطها فقط إذا كان eea=1
  - يشير الرمز ad_user_data=0 إلى أنّ المستخدم رفض الموافقة على نقل البيانات على مستوى المستخدم إلى Google لأغراض إعلانية.
  - يشير الرمز ad_user_data=1 إلى أنّ المستخدم قد منح موافقته على نقل البيانات على مستوى المستخدم إلى Google لأغراض إعلانية.
- يتم استخدام npa لتخصيص محتوى الإعلانات.
  - تشير npa=0 إلى أنّ المستخدِم يوافق على التخصيص.
  - يشير الرمز npa=1 إلى أنّ المستخدم لم يوافق على التخصيص.
- يمكن استخدام test_request_reason=dma لاختبار مَعلمات قانون الأسواق الرقمية
  - تتحقّق هذه الدالة من صحة جميع مَعلمات قانون الأسواق الرقمية وتعرض تحذيرات.
  - تعرض هذه السمة ردودًا متعدّدة مع نقرات وهمية.
  - تسجّل الإحالات الناجحة كإحالات ناجحة اختبارية.
بالإضافة إلى ذلك، على المعلِن تزويد الجهات الخارجية برمز الإذن المحدّد الخاص به:

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

مثال على عنوان URL لمستخدم خارج المنطقة الاقتصادية الأوروبية
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
مثال على عنوان URL للمستخدم في المنطقة الاقتصادية الأوروبية
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
where:
- ‫src هو الرقم التعريفي للمعلِن الذي يمثّل مصدر نشاط Floodlight.
- ‫cat هي سلسلة علامة النشاط التي تستخدمها خوادم Floodlight لتحديد مجموعة الأنشطة التي ينتمي إليها النشاط.
- ‫type هي سلسلة علامة المجموعة التي تحدِّد مجموعة الأنشطة التي يرتبط بها نشاط Floodlight.
- ‫ord هو رقم عشوائي يُستخدَم لجعل علامة Floodlight فريدة.
- u1, u2, ... (إذا كانت متاحة) هي قيم مفاتيح متغيّرات Floodlight المخصّصة.
- تحدّد eea ما إذا كان المستخدم في المنطقة الاقتصادية الأوروبية.
- تحدّد ad_user_data ما إذا كان المستخدم يوافق على ملفات تعريف الارتباط وخدمة "إحصاءات Google".
- تحدّد npa ما إذا كان المستخدم يوافق على التخصيص.
مع مَعلمات إضافية يتم إرسالها من خلال حمولة JSON في طلب HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (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]"
```
where:
- app (مطلوبة) هي عنصر JSON يمثّل التطبيق الذي حدث فيه نشاط الإحالة الناجحة. استخدِم app: {} إذا لم يكن التطبيق الذي حدث فيه نشاط الإحالة الناجحة متاحًا.
- ‫bundle (إذا كان متاحًا) هو حقل عنصر التطبيق الذي يحتوي على قيمة سلسلة تمثّل اسم حزمة "متجر Play" أو معرّف App Store.
- ‫device هو عنصر JSON يمثّل الجهاز الذي تمّ عليه نشاط الإحالة الناجحة.
- ‫ua هو حقل عنصر الجهاز الذي يمثّل سلسلة وكيل المستخدم للتطبيق الذي تم تسجيل نشاط فيه. هذه المَعلمة مطلوبة.
- ip (إذا كان متاحًا) هو عنوان IPv4 للجهاز. هذه المَعلمة مطلوبة.
- ‫didmd5 هي سلسلة تجزئة MD5 لمعرّف المعلِنين (IDFA) أو معرّف Google Play الإعلاني بالأحرف اللاتينية الكبيرة.
- ‫lmt هو عدد صحيح، وتكون قيمته 1 إذا فعّل المستخدم خيار "تقييد تتبُّع الإعلانات" في معرّف المعلِنين (IDFA) أو المعرّف الإعلاني (AdID)، أو 0 إذا لم يتم ضبطه.
ستردّ "إدارة حملة DoubleClick" باستجابة JSON تحدّد ما إذا كان حدث الإحالة الناجحة منسوبًا إلى مشاهدة أو نقرة تم عرضها من خلال "حملة DoubleClick"، وإذا كانت الإجابة "نعم"، سيتم تقديم معلومات إضافية عن الحدث (آخر مشاهدة أو نقرة):
- معرّف الإعلان
- رقم تعريف الموقع
- رقم تعريف موضع الإعلان
- الرقم التعريفي لتصميم الإعلان
- الطابع الزمني
قد تبدو استجابة 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",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
where:
- القيمة attributed هي 1 (إذا كان يمكن إسناد الإحالة الناجحة إلى مرّة ظهور أو نقرة) أو 0 (إذا لم يكن بالإمكان إسنادها).
- last_impression_ad_id (إذا كانت قيمة attributed = 1) هو رقم تعريف الإعلان لآخر مرّة ظهور.
- ‫last_impression_site_id (إذا كانت قيمة attributed = 1) هو معرّف الموقع الإلكتروني لآخر مرّة ظهور.
- ‫last_impression_placement_id (إذا كانت قيمة السمة attributed = 1) هو رقم تعريف موضع الإعلان لآخر مرّة ظهور.
- ‫last_impression_creative_id (إذا كانت قيمة attributed = 1) هو رقم تعريف تصميم الإعلان لآخر مرّة ظهور.
- ‫last_click_ad_id (إذا كانت القيمة attributed = 1 وتمّ تحديد مصدر النقرة) هو معرّف الإعلان للنقرة الأخيرة.
- ‫last_click_site_id (إذا كانت القيمة attributed = 1 وتم تحديد مصدر النقرة) هو معرّف الموقع الإلكتروني للنقرة الأخيرة.
- ‫last_click_placement_id (إذا كانت قيمة attributed = 1 وتم تحديد مصدر النقرة) هو معرّف موضع الإعلان للنقرة الأخيرة.
- last_click_creative_id (إذا كانت قيمة attributed تساوي 1 وتم تحديد مصدر النقرة) هو رقم تعريف تصميم الإعلان للنقرة الأخيرة.
- يمثّل last_click_exclid معرّف نقرة فريدًا يتم ملؤه باستخدام الماكرو %eiid!.
اعتبارًا من بدء تطبيق قانون الأسواق الرقمية في مارس 2024، ستتوفّر الحقول التالية أيضًا:
- يشير cps إلى خدمة المنصة الأساسية التي ينتمي إليها الحدث
  - ‫a : الإعلانات
  - ‫m : الخرائط
  - ‫p : متجر Play
  - s : بحث
  - ‫h : Shopping
  - ‫y : YouTube
- ad_events هي مصفوفة من عناصر ad_event تحتوي على جميع أحداث الإحالات الناجحة.
  - يحتوي العنصر ad_event على الحقول التالية:
  - ‫product_type هي سلسلة تعرض المنتج المسؤول عن الإحالة الناجحة. سيكون هذا الإعداد إما DCM أو DBM.
  - ‫interaction_type هو نوع التفاعل الذي أدّى إلى الحدث. إما impression أو click
  - conversion_metric هو مقياس الإحالة الناجحة المستخدَم لتحديد المصدر. إما conversion أو view_through_conversion
  - ‫timestamp هو الطابع الزمني لنظام التشغيل UNIX الذي حدث فيه الحدث الإعلاني بدقة الميكروثانية. يجب استخدام هذه القيمة لتحديد المصدر بالاستناد إلى النقرة الأخيرة.
  - تحدّد السمة campaign_type نوع الحملة التي أدّت إلى ظهور حدث الإعلان.
  - ‫line_item_id (في "مدير حملة DoubleClick" فقط) هو رقم تعريف العنصر في "مدير حملة DoubleClick" الذي أدّى إلى إنشاء حدث الإعلان.
  - ‫line_item_name (DBM فقط) هو اسم العنصر في DBM الذي أدّى إلى إنشاء حدث الإعلان.
  - placement_id (في "إدارة حملة DoubleClick" فقط) هو رقم تعريف علامة موضع الإعلان في "إدارة حملة DoubleClick" الذي أدّى إلى إنشاء حدث الإعلان.
  - ‫placement_name (في "إدارة حملة DoubleClick" فقط) هو اسم علامة موضع الإعلان في "إدارة حملة DoubleClick" التي أدّت إلى إنشاء حدث الإعلان.
  - ‫external_customer_id هو معرّف المعلِن الذي يملك الحملة التي أدّت إلى الحدث الإعلاني.
    - إذا كانت قيمة product هي DBM، يمثّل هذا الحقل رقم تعريف المعلِن في DBM.
    - إذا كانت قيمة product هي DCM، يمثّل هذا الحقل رقم تعريف المعلِن في DCM.
  - ‫creative_id هو رقم تعريف الوحدة الإعلانية الخاصة بتصميم الإعلان التي أنتجت حدث الإعلان.
    - إذا كانت قيمة product هي DBM، يمثّل هذا الحقل رقم تعريف تصميم الإعلان في DBM.
    - إذا كانت قيمة product هي DCM، يمثّل هذا الحقل رقم تعريف تصميم الإعلان في DCM.
  - ‫exchange_id (DBM فقط) هو رقم تعريف التبادل الذي عرض إعلان DBM.
  - ‫insertion_order_id (DBM فقط) هو معرّف طلب الإدراج في DBM.
  - site_id (في "إدارة حملة DoubleClick" فقط) هو رقم تعريف الموقع الإلكتروني ضمن "إدارة حملة DoubleClick" لحدث الإعلان.
  - تشير cps إلى "خدمة المنصّة الأساسية" التي ينتمي إليها الحدث الإعلاني. يُرجى الرجوع إلى الشرح الكامل للحقل cps في وقت سابق من المستندات للحصول على مزيد من التفاصيل.
- ‫warnings هي مصفوفة من التحذيرات التي نتجت عن حدث الإحالة الناجحة.
- ‫errors هي مصفوفة من الأخطاء التي ينتجها حدث الإحالة الناجحة مع رموز خطأ HTTP، وذلك في السيناريوهات التالية:
  - HTTP 204 في حال تجاوز حصة الطلبات.
  - ‫HTTP 400 عندما يُعتبر الطلب غير صالح، مثلاً، في حال عدم توفّر المَعلمات المطلوبة، وعندما يعود الخادم إلى تتبُّع وحدات البكسل.
  - HTTP 401 إذا كان رمز التفويض غير صالح
  - HTTP 404 لأي طلبات غير صالحة.
سيتمكّن المعلِن من الاطّلاع على تقارير الحملات في نظامك، كما سيتمكّن من الاطّلاع على تقارير الإحالات الناجحة في "مدير الحملة المزدوج" باستخدام المَعلمات نفسها.

أمثلة إضافية على الردود بعد تطبيق قانون الأسواق الرقمية في مارس 2024

في ما يلي مثال على استجابة لتتبُّع الإحالات الناجحة مع تحديد المصدر، حيث يتم تحديد مصدر الإحالة الناجحة على أنّه تفاعلات مع إعلانات على "شبكة البحث" وYouTube، ولكن تم رفض الموافقة على الاستخدام المشترك بموجب البندين 5(2)(ب) و5(2)(ج) بين "شبكة البحث" و"منتجات Google" الأخرى:
```
{
  attributed: 1,
  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: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
مثال على ردّ إيجابي لتتبُّع الإحالات الناجحة في "حملة على DoubleClick Bid Manager":
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

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

دمج "إدارة بيانات DoubleClick" لتتبُّع التطبيقات التابعة لجهات خارجية