تتبُّع الإحالات الناجحة وتجديد النشاط التسويقي للتطبيقات - مواصفات الطلب/الاستجابة

وكيل المستخدم للتطبيق

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

name version (os_and_version; locale; device; build; Proxy)

في ما يلي تعريف لهذه الحقول:

مكوّنات وكيل المستخدم
name

اسم منتج الإحصاءات أو الإعلانات (Google AdMob)

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

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
version

تمثّل هذه السمة إصدار منتج الإحصاءات أو الإعلانات. (7.10.1)

Android
// Specified by API consumer.
iOS
// Specified by API consumer.
os_and_version

نظام التشغيل وإصدار نظام التشغيل اللذان يعمل عليهما التطبيق (Android 6.0 )

Android
String osAndVersion =
    "Android " + Build.VERSION.RELEASE;
iOS
UIDevice *uid =
  [UIDevice currentDevice];
NSString *osAndVersion =
  [NSString
    stringWithFormat:@"%@ %@",
    [uid systemName],
    [uid systemVersion]];
locale

تمثّل هذه السمة علامة لغة IETF للجهاز، باستخدام رمز اللغة ورمز البلد المكوّنَين من حرفَين والمفصولَين بشرطة سفلية. (en_US)

Android
String locale = Locale.getDefault();
iOS
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

تمثّل هذه السمة اسم الجهاز الفعلي الذي يتم تشغيل منتج الإحصاءات/الإعلانات عليه. (iPhone9,1)

Android
String device = Build.MODEL;
iOS
@import Darwin.sys.sysctl;

NSString *device(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("hw.machine",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}
build

‫"Build/" متبوعًا برقم إصدار نظام التشغيل (Build/13D15)

Android
String build = "Build/" + Build.ID;
iOS
@import Darwin.sys.sysctl;

NSString *build(void) {
  size_t bufferSize = 64;
  NSMutableData *buffer =
    [[NSMutableData alloc]
      initWithLength:bufferSize];
  int status =
    sysctlbyname("kern.osversion",
      buffer.mutableBytes,
      &bufferSize, NULL, 0);
  if (status != 0) {
    return nil;
  }
  return [[NSString alloc]
    initWithCString:buffer.mutableBytes
    encoding:NSUTF8StringEncoding];
}

يجب تضمين ; Proxy في نهاية سلسلة User-Agent الخاصة بالتطبيق عند إنشاء سلسلة User-Agent الخاصة بالتطبيق من جهة الخادم. إذا تم إنشاء سلسلة User-Agent الخاصة بالتطبيق بالكامل من جهة العميل، استبعِد ; Proxy. وبالتالي، قد تكون سلسلة وكيل المستخدم للتطبيق على النحو التالي:

  • نظام تشغيل Android:‏ AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
  • نظام تشغيل iOS:‏ AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)

دليل طلبات تتبُّع الإحالات الناجحة

الغرض من طلبات تتبُّع الإحالات الناجحة هو إعلام "إعلانات Google" بحدث في التطبيق يجب تتبُّعه كإحالة ناجحة و/أو استخدامه لملء قائمة تجديد النشاط التسويقي، واسترداد البيانات الوصفية التي تصف أي نقرة سبقت الحدث.

يتم إجراء جميع طلبات البيانات من واجهة برمجة التطبيقات إلى النطاق www.googleadservices.com. طلبات الإحالات الناجحة هي طلبات POST عبر HTTPS على المسار التالي: 

/pagead/conversion/app/version
حيث version هو الإصدار المطلوب من واجهة برمجة التطبيقات لتتبُّع الإحالات الناجحة.

سيتضمّن طلب الإحالة الناجحة للتطبيق العادي المَعلمات التالية للإصدار 1.1 من App Conversion API.

طلب تتبُّع الإحالات الناجحة
dev_token

مطلوب

الموقع الجغرافي: طلب البحث

الرمز المميّز الفريد والثابت للمطوّر الذي يتم إصداره لمستهلك واجهة برمجة التطبيقات

Z_eErE4DkvcKjDM1OVE4c4
link_id

مطلوب

الموقع الجغرافي: طلب البحث

معرّف الربط الذي يربط الرمز المميز للمطوّر الخاص بمستهلك واجهة برمجة التطبيقات بتطبيق معيّن.

31FF8D67E5BB5DD5029DCC2734C2F884
app_event_type

مطلوب

الموقع الجغرافي: طلب البحث

تمثّل هذه السمة اسم حدث التطبيق الذي وقع. هذا الحقل هو تعداد، ولن يقبل إلا القيم التالية:

 • first_open
 • session_start
 • in_app_purchase
 • view_item_list
 • view_item
 • view_search_results
 • add_to_cart
 • ecommerce_purchase
 • custom

يجب دائمًا إرسال حدث first_open لتحديد مصدر عمليات التثبيت، ويجب دائمًا إرسال حدث session_start لتحديد مصدر الجلسات مرة أخرى. استخدِم in_app_purchase لعمليات الشراء التي تتم من خلال متجر التطبيقات الأصلي، واستخدِم ecommerce_purchase لجميع عمليات الشراء الأخرى.
app_event_name

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

اسم أي حدث مخصّص للتطبيق غير مقبول في الحقل app_event_type. يجب أن يحتوي هذا الحقل على ما بين حرف واحد و64 حرفًا من أحرف Unicode (باستخدام ترميز UTF-8). هذا الحقل مطلوب إذا كانت قيمة app_event_type مخصّصة.

level_achieved
Level Achieved

يجب ألا يحتوي هذا الحقل على أي من القيم المحجوزة لـ app_event_type. في حال استخدام اسم حدث محجوز، ستعرض واجهة برمجة التطبيقات الخطأ APP_EVENT_NAME_RESERVED_VALUE.
app_event_data

اختياري

الموقع: نص الرسالة

أرسِل أي بيانات إضافية عن الأحداث الغنية بصريًا كعنصر JSON بسيط يربط المفاتيح بالقيم. وتكون القيم المقبولة هي سلاسل ومجموعات منها.

{"level": 5, "attempts": 20}
odm_info

مطلوب عند استخدام ميزة "قياس الإحالات الناجحة المتكامل" على أجهزة iOS

الموقع الجغرافي: طلب البحث

قيمة مَعلمة طلب البحث info التي يتم تسجيلها عند تثبيت تطبيق iOS أو إعادة تثبيته من خلال خدمة "القياس على الجهاز فقط" من Google: حزمة تطوير البرامج (SDK) لبيانات الأحداث يتيح هذا الحقل ميزة "قياس الإحالات الناجحة المتكامل" في "حملات التطبيقات" على أجهزة iOS.

XYZr_AB8C-_zGtKjUhqtzPLeQ8lbJB5dADVR0tpZ9f-28sN5qN9GTZ_FztjL0OL
FzgxUJDhZr8w6lwGxAwPcxSwR5orjWepZiVP7sRRoCiaHerR-1TP17eJKtazgeSg
_CVEs13LllDTfrhVM8uWISqlg8dXobsLzmj8C7WrOlktHA5P_E23
id_type

مطلوب

تمثّل هذه السمة نوع المعرّف الذي تم تمريره في الحقل rdid.

Android

advertisingid
 
appsetid

iOS

idfa
 
idfv
rdid

مطلوب

الموقع الجغرافي: طلب البحث

سلسلة معرّف فريد عالمي (UUID) صالحة تمثّل رقم تعريف الجهاز الأولي.

f10e1de2-e237-4f50-b6aa-843c45cc63d6

في حال عدم توفّر معرّف الجهاز، مثل معرّف الجهاز من مستخدم لم يوافق على إطار عمل ATT، اضبطه على القيمة صفر.

00000000-0000-0000-0000-000000000000
ctry_c

مطلوب

الموقع الجغرافي: طلب البحث

رمز البلد المكوّن من حرفَين وفقًا لمعايير ISO للإشارة إلى البلد الذي نشأ منه الإحالة الناجحة.

هذا الحقل مطلوب لتفعيل ميزة قياس الإحالات الناجحة للتطبيق على مستوى غير المستخدم على أجهزة iOS وAndroid.

US, IN
eea

مطلوبة في ظل شروط معيّنة

الموقع الجغرافي: طلب البحث

نطاق المنطقة الاقتصادية الأوروبية

0: لا تنطبق اللوائح التنظيمية الأوروبية على هذا المستخدم والإحالة الناجحة

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

*Required to be sent when the value is known.
ad_personalization

مطلوبة في ظل شروط معيّنة

الموقع الجغرافي: طلب البحث

علامات الإعلانات المخصّصة

0: رفض المستخدِم النهائي الموافقة على تخصيص الإعلانات

1: منح المستخدِم النهائي الموافقة على تخصيص الإعلانات 

*Required to be sent when the value is known.
ad_user_data

مطلوبة في ظل شروط معيّنة

الموقع الجغرافي: طلب البحث

علامة الموافقة على استخدام بيانات المستخدِم لأغراض إعلانية

0: رفض المستخدِم الموافقة على نقل البيانات على مستوى المستخدِم إلى Google لأغراض إعلانية

1: وافق المستخدِم على نقل البيانات على مستوى المستخدِم إلى Google لأغراض إعلانية 

*Required to be sent when the value is known.
lat

مطلوب

الموقع الجغرافي: طلب البحث

حالة "الحدّ من التتبُّع الإعلاني" للجهاز.

  • ‫0: لم يختار المستخدم تقييد تتبُّع الإعلانات.
  • ‫1: اختار المستخدم تقييد تتبُّع الإعلانات.
app_version

مطلوب

الموقع الجغرافي: طلب البحث

الإصدار الحالي من التطبيق، ويجب أن يكون موحّدًا على النحو التالي.

Android

packageManager.getPackageInfo(packageName(),
  PackageManager.GET_META_DATA).versionName

iOS

[[[NSBundle mainBundle] infoDictionary]
  objectForKey:@"CFBundleShortVersionString"]
 
1.2.4
os_version

مطلوب

الموقع الجغرافي: طلب البحث

الإصدار الحالي من نظام التشغيل المضيف للتطبيق يجب توحيد هذا التنسيق على النحو التالي.

Android

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

مطلوب

الموقع الجغرافي: طلب البحث

إصدار حزمة تطوير البرامج (SDK) الذي قاس الحدث. وبما أنّ هذا المعرّف يُستخدم بشكل أساسي لتصحيح الأخطاء، يجب أن يعكس نسخة الإصدار تمامًا كما هي منشورة مع إصدارات حزمة SDK. إذا كان التطبيق لا يستخدم حزمة تطوير برامج (SDK)، يُرجى إدخال القيمة نفسها التي تم إدخالها في app_version.

1.9.5r6
timestamp

مطلوب

الموقع الجغرافي: طلب البحث

الطابع الزمني لنظام التشغيل UNIX الذي حدث فيه حدث الإحالة الناجحة، بالثواني مع دقة الميكروثانية

1432681913.123456
fot

مطلوب

الموقع الجغرافي: طلب البحث

الطابع الزمني لحقبة UNIX من first_open المقابل بالثواني مع دقة الميكروثانية لجميع الجلسات اللاحقة والأحداث بعد التثبيت.

1432681913.123456
value

اختياري

الموقع الجغرافي: طلب البحث

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

1.99
currency_code

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

تمثّل هذه السمة رمز العملة بالتنسيق ISO 4217 الخاص بالمَعلمة value. هذا الحقل مطلوب في حال توفير المَعلمة value وعدم تركها فارغة.

USD
gclid

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

قيمة مَعلمة طلب البحث gclid من عنوان URL لربط صفحات معيّنة أدى إلى فتح التطبيق.

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

تمثّل هذه السمة قيمة مَعلمة طلب البحث gclid من عنوان URL لصفحة معيّنة تم الحصول عليها من قيمة install_referrer من خلال Play Install Referrer API.

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

معرّف تحديد المصدر المستند إلى gclid في السيناريوهات التي لا يتوفّر فيها not (advertisingid) أو جميع zeroes، ويكون فيها gclid أو market_referrer_gclid.

1
gbraid

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

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

ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
app_open_source

مطلوب في ظروف معيّنة

الموقع الجغرافي: طلب البحث

قيمة لتحديد الرابط لصفحة معيّنة في التطبيق من خلال نقرة على الإعلان أو جلسات التطبيق المجانية

ad_click or organic
User-Agent

مطلوب

الموقع الجغرافي: العنوان

وكيل مستخدم التطبيق كما هو موضّح في القسم السابق

AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M)
X-Forwarded-For

مطلوب

الموقع الجغرافي: العنوان

عنوان IPv4 أو IPv6 العام للجهاز الذي تم قياس الحدث عليه.

216.58.194.174

يجب إرسال جميع الطلبات عبر HTTPS. سيتم رفض طلبات Ping التي يتم تلقّيها عبر HTTP.

يُرجى العِلم أنّه إذا كان نص الطلب فارغًا (في الحالات التي لا يتم فيها تمرير بيانات أحداث منسّقة في حمولة app_event_data)، يتطلّب الخادم أن تضبط عنوان Content-Length: 0 بشكل صريح في طلبك.

ترميز بيانات الأحداث

بالنسبة إلى مَعلمة النص الأساسي app_event_data، يُرجى استخدام الاصطلاحات التالية لأنواع البيانات الأساسية:

  • Float

    • استخدام النقطة كفاصل عشري بغض النظر عن لغة التطبيق
    • استخدِم دقة عشرية من رقمين لتمثيل القيم النقدية، مثل 2.99.
    • لا تستخدِم الترميز الأسي، مثل 2E+9
    • لا تستخدِم الفاصلة لفصل مجموعات الأرقام، مثل 1,000,000
    • أمثلة صالحة:
      • -0.5
      • 2.99
      • 1000000.123

  • عدد صحيح

    • يجب إرسال قيم أعداد صحيحة فقط بدون أرقام عشرية
    • لا تستخدِم فاصلة لفصل مجموعات الأرقام، مثل 1,000,000
    • أمثلة صالحة:
      • 1000
      • -11
      • 0

  • التاريخ

    • تنسيق التاريخ: yyyy-mm-dd
      • ‫yyyy = السنة بتنسيق من أربعة أرقام، مثل 2016
      • ‫mm = شهر مكوّن من رقمين، مثل 09 لسبتمبر
      • ‫dd = يوم من رقمين، مثل 23 لليوم الثالث والعشرين من الشهر
    • يجب دائمًا إرسال عدد الأرقام المحدّد أعلاه، مثلاً، إذا أردت إرسال قيمة dd لليوم الخامس من الشهر، أرسِل 05.
    • أمثلة صالحة:
      • "2016-09-23"
      • "1990-12-31"

  • الطابع الزمني

    • تنسيق الوقت: طابع زمني بتنسيق Unix/Epoch بالثواني محدّد في المنطقة الزمنية UTC بدقة الميكروثانية
    • أمثلة صالحة:
      • 1478713087 للأربعاء 9 تشرين الثاني (نوفمبر) 2016 الساعة 17:38:07 بتوقيت غرينتش
      • ‫1073513982.123000 for Wed, 07 Jan 2004 22:19:42.123 GMT

  • المصفوفات

    • إرسال مصفوفات من القيم الأساسية فقط (سلاسل وأرقام وقيم منطقية)
    • أمثلة صالحة:
      • [123, 456, 789]
      • ["abc"]

طلبات نموذجية

في ما يلي مثال على طلب فتح التطبيق لأول مرة باستخدام حزمة تطوير البرامج (SDK) الخاصة بميزة "قياس الإحالات الناجحة على الجهاز فقط: بيانات الأحداث" لميزة "قياس الإحالات الناجحة المتكامل":

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب فتح التطبيق لأول مرة بدون حزمة تطوير البرامج (SDK) الخاصة بميزة "قياس الإحالات الناجحة على الجهاز فقط: بيانات الأحداث" من أجل ميزة "قياس الإحالات الناجحة المتكاملة":

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب ما بعد التثبيت باستخدام حزمة تطوير البرامج (SDK) الخاصة بميزة "القياس على الجهاز فقط: بيانات الأحداث" في ميزة "قياس الإحالات الناجحة المتكامل":

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &odm_info=abcdEfadGdaf
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &&fot=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب فتح التطبيق لأول مرة بدون حزمة تطوير البرامج (SDK) الخاصة بميزة "القياس على الجهاز فقط: بيانات الأحداث":

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfv
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب فتح التطبيق لأول مرة لإحالة ناجحة غير حتمية على Android في ACAPI الإصدار 1.1:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=appsetid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &ctry_c=IN
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (android 11; en-GB; RMX2040; Build/_; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب صالح لتتبُّع الإحالات الناجحة يتضمّن نوع حدث غير مخصّص ومعلومات الإيرادات:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=0
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

في ما يلي مثال على طلب صالح لتتبُّع الإحالات الناجحة يتضمّن نوع حدث غير مخصّص ومعلومات الإيرادات مع عدم توفّر rdid (advertisingid):

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8
 
{"app_event_data":{"item_id":["Crayons","Markers"]}}

في ما يلي مثال على طلب بدء جلسة صالح:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب إعادة تحديد مصدر لبدء جلسة صالح لجلسة بدأت من رابط لصفحة معيّنة example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=0
       &ad_personalization=1
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

في ما يلي مثال على طلب صالح لتتبُّع الإحالات الناجحة لمستخدم في المنطقة الاقتصادية الأوروبية تمّت الموافقة فيه على استخدام بيانات المستخدم في الإعلانات ورفض تخصيص الإعلانات:

POST /pagead/conversion/app/1.1
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &eea=1
       &ad_personalization=0
       &ad_user_data=1
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

دليل الردود المتعلّقة بميزة "تتبُّع الإحالات الناجحة"

تتّبع استجابة تتبُّع الإحالات الناجحة التنسيق التالي:

{
  "ad_events": [<ad event objects>],
  "errors": [<error strings>],
  "attributed": true|false
}

قد تكون كلّ من مصفوفتَي ad_events وerrors فارغة.

نتوقّع أن تكون الأخطاء عبارة عن رموز أخطاء قابلة للقراءة آليًا، مثل invalid_timestamp.

رموز الخطأ

  • invalid_timestamp: لم يتضمّن الطلب طابعًا زمنيًا صالحًا.

  • eea_missing_or_invalid: لم يتم ضبط الحقل "eea" في الطلب أو كان غير صالح.

  • ad_user_data_missing: لم يتم ضبط حقل الطلب "ad_user_data". حقل "ad_user_data" مطلوب لجميع طلبات قانون الأسواق الرقمية التي تسري عليها.

  • ad_user_data_invalid: كانت قيمة طلب "ad_user_data" غير صالحة. حقل "ad_user_data" مطلوب لجميع طلبات قانون الأسواق الرقمية التي تسري عليها.

  • ad_personalization_missing_or_invalid: لم يتضمّن الطلب الحقل "ad_personalization" أو كان غير صالح. حقل "ad_personalization" مطلوب لجميع طلبات مناطق السوق المحدّدة التي تسري عليها اللائحة.

أحداث الإعلانات هي العناصر الأساسية لتحديد مصدر الإحالة في التطبيقات، وستتضمّن السمات التالية.

ملاحظات مهمة بشأن سلوك الاستجابة الذي يعتمد على موافقة المستخدم:
إذا كانت الإحالة الناجحة تتضمّن موافقة على بيانات المستخدمين في الإعلانات وكان المستخدم قد منح موافقة على الاستخدام المتعدّد ضمن إعدادات المستخدم في Google، ستستجيب "إعلانات Google" بنقرة واحدة أخيرة على جميع منصّات CPS التابعة لها. إذا لم يوافق المستخدم على استخدام الموافقة على مستوى منتجات Google في إعدادات المستخدم على Google، ستستجيب &quot;إعلانات Google&quot; بعدّة نقرات أخيرة، وذلك على أساس كلّ نقرة لكلّ تكلفة.

إذا كانت الإحالة الناجحة تتضمّن خدمات CPS معيّنة في الموافقة على الاستخدام المشترك التي يختارها المستخدم ولكن لا تتضمّن خدمات أخرى، ستستجيب "إعلانات Google" بنقرة أخيرة واحدة على مستوى خدمات CPS التي تم منحها الموافقة على الاستخدام المشترك، ولكن مع نقرات أخيرة متعدّدة، على مستوى كل خدمة CPS على حدة، بالنسبة إلى خدمات CPS التي لم يتم منحها الموافقة على الاستخدام المشترك.

الردّ على طلب تتبُّع الإحالات الناجحة
ad_event_id

الظهور دائمًا

سلسلة

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

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

الظهور دائمًا

سلسلة

مقياس الإحالة الناجحة المستخدَم لتحديد المصدر سنوفّر في البداية مقياسًا واحدًا للإحالات الناجحة.

conversion
timestamp

الظهور دائمًا

الرقم

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

1432681913.123456
campaign_type

الظهور دائمًا

سلسلة

سيحدّد هذا الحقل نوع الحملة التي أدّت إلى حدث الإعلان. في ما يلي القيم المحتمَلة.

ACI
ACE
ACPRE
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI هو اختصار لـ "حملة التطبيقات لجذب عمليات التثبيت". ‫ACE هو اختصار لـ "حملات التطبيقات لجذب المستخدمين الحاليين".
campaign_id

الظهور دائمًا

الرقم

رقم تعريف الحملة الرقمي للحملة التي أدّت إلى ظهور حدث الإعلان. ويُضمن أن تكون هذه القيمة فريدة.

123456789
campaign_name

الظهور دائمًا

سلسلة

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

Occasional Gamers (Video)
ad_type

الظهور دائمًا

سلسلة

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

الترويج لتطبيق 
ClickToDownload
 التفاعل مع التطبيق 
AppDeepLink
 التفاعل مع التطبيق — عملية التثبيت والمتابعة 
AppDeepLinkContinue
 فئة شاملة للقيم الأخرى 
Unknown
external_customer_id

الظهور دائمًا

الرقم

تمثّل هذه السمة معرّف المعلِن الخاص بالمعلِن الذي يملك الحملة التي أدّت إلى ظهور الحدث الإعلاني. يمكن استخدام هذه القيمة للتمييز بين حسابات &quot;إعلانات Google&quot;.

123456789
location

الظهور دائمًا

الرقم

رمز معرّف الموقع الجغرافي لحدث الإعلان. راجِع مرجع Google Ads API لتفسير رموز المواقع الجغرافية.
network_type

الظهور دائمًا

سلسلة

سيحدّد هذا الحقل شبكة الإعلانات على &quot;إعلانات Google&quot; التي وقع عليها حدث الإعلان. في ما يلي القيم المحتمَلة.

Search
Display
YouTube
GoogleTv
cross-network
network_subtype

يجب أن تكون القيمة null عندما تكون قيمة campaign_type هي ACI أو ACE وقيمة network_type هي Display.

سلسلة

سيحدّد هذا الحقل "النوع الفرعي" لشبكة الإعلانات على "إعلانات Google" التي حدث عليها الحدث الإعلاني. تختلف القيم المحتملة حسب نوع الشبكة الأساسية.

"بحث Google" العادي 
GoogleSearch
 الشركاء في شبكة بحث Google 
SearchPartners

الشبكة الإعلانية

الناشرون على الويب للأجهزة الجوّالة 
mGDN
 ناشرو التطبيقات 
Google AdMob

YouTube

شبكة "فيديوهات YouTube" 
YouTubeVideos
 شبكة بحث YouTube 
YouTubeSearch
 شركاء إعلانات الفيديو 
VideoPartners

GoogleTv

شبكة فيديوهات GoogleTV 
GoogleTvVideos

الشبكة المتقاطعة

"حملات الأداء الأفضل" على شبكات متعددة 
cross-network
video_id

يتم توفيرها فقط عندما تكون قيمة network_type هي YouTube وcampaign_type ليست ACI وACE.

سلسلة

رقم تعريف فيديو YouTube المرتبط بحدث الإعلان.

dQw4w9WgXcQ
keyword

يتم توفيرها فقط عندما تكون قيمة network_type هي Search وcampaign_type ليست ACI وACE.

سلسلة

كلمة البحث الرئيسية المرتبطة بحدث الإعلان.

+food +delivery
match_type

يتم توفيرها فقط عندما تكون قيمة network_type هي Search وcampaign_type ليست ACI وACE.

سلسلة

نوع مطابقة كلمات البحث الرئيسية

تامة 
e
 العبارة 
p
 مطابقة تقريبية 
b
placement

يتم توفيرها فقط عندما تكون قيمة network_type هي Display وcampaign_type ليست ACI وACE.

سلسلة

موضع الإعلان المرتبط بحدث الإعلان.

mobileapp::1-343200656
ad_group_id

يتم توفيرها فقط عندما لا تكون قيمة campaign_type هي Performance_Max.

الرقم

رقم التعريف الرقمي للمجموعة الإعلانية التي أدّت إلى الحدث الإعلاني. هذه القيمة مضمون أن تكون فريدة.

لا يتم توفير هذا الحقل لأحداث الإعلانات التي تم تحديد مصدرها باستخدام gbraid بشكل قطعي (is_deterministic هو true)، مثل تحديد مصدر الروابط لصفحات معيّنة.

123456789
ad_group_name

يتم توفيرها فقط عندما تكون قيمة campaign_type هي ACI أو ACE أو ACPRE.

سلسلة

اسم المجموعة الإعلانية التي يحدّدها المعلِن والتي عرضت حدث الإعلان. لا يُضمن أن تكون هذه القيمة فريدة.

لا يتم توفير هذا الحقل لأحداث الإعلانات التي تم تحديد مصدرها باستخدام gbraid بشكل قطعي (is_deterministic هو true)، مثل تحديد مصدر الروابط لصفحات معيّنة.

My App AdGroup
asset_group_id

يتم توفيرها فقط عندما تكون قيمة campaign_type هي Performance_Max.

الرقم

رقم التعريف الرقمي لمجموعة مواد العرض التي أدّت إلى ظهور الحدث الإعلاني. هذه القيمة فريدة.

123456789
creative_id

يتم توفيرها فقط عندما تكون قيمة campaign_type غير ACI أو ACE أو ACPRE أو Performance_Max.

الرقم

رقم التعريف الرقمي لوحدة الإعلان الإبداعية التي أنتجت الحدث الإعلاني. هذه القيمة مضمون أن تكون فريدة.

123456789
interaction_type

سيكون هذا الحقل دائمًا هو معدّل الاهتمام بالتطبيق.

سلسلة
is_deterministic

توضّح هذه السمة ما إذا كانت طريقة تحديد المصدر قطعية أم لا.

منطقي

true, false
device_model

طراز الجهاز الذي أنشأ حدث الإعلان.

سلسلة

sm-s936w, sm-3936w
os_version

الإصدار الرئيسي من نظام التشغيل الذي أدّى إلى إنشاء حدث الإعلان.

سلسلة

14, 12
country

رمز البلد المكوّن من حرفَين والذي أدّى إلى إنشاء حدث الإعلان.

سلسلة

CA, US
city

المدينة التي تم فيها تسجيل حدث الإعلان

سلسلة

san jose, london
region

تمثّل هذه السمة الولاية أو المقاطعة التي تم فيها إنشاء حدث الإعلان.

سلسلة

california, british columbia

أمثلة على الردود

في ما يلي مثال على ردّ لإحالة ناجحة محدّدة:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 1234567.898765
  }],
  "errors": [],
  "attributed": true
}

في ما يلي مثال على استجابة لإحالة ناجحة غير حتمية على نظام التشغيل iOS:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "network_type": null,
    "network_subtype": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "is_deterministic": false,
    },
    "device_info": {
        "device_model": "iphone12,3",
        "os_version": "14"
    },
    "timestamp": 1432681918.123456
    }],
  "errors": [],
  "attributed": true
}

في ما يلي مثال على ردّ لإحالة ناجحة غير حتمية على Android:

{
  "ad_events": [
    {
      "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
      "conversion_metric": "conversion",
      "interaction_type": "click",
      "campaign_type": "ACI",
      "campaign_id": 123456789,
      "campaign_name": "My App Campaign",
      "network_type": null,
      "network_subtype": null,
      "ad_group_id": 123456789,
      "ad_group_name": "My App AdGroup",
      "asset_group_id": null,
      "is_deterministic": false,
      "geo_info": {
        "city": "san jose",
        "country": "US",
        "region": "california"
      },
      "device_info": {
          "device_model": "sm-s926u",
          "os_version": "14"
      },
      "timestamp": 1432681918.123456
    },
    ],
    "errors": [],
    "warnings": []
  }

في ما يلي مثال على ردّ لإحالة ناجحة على iOS أو Android تم تحديد مصدرها من خلال gbraid:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "interaction_type": "engagement",
    "network_type": null,
    "ad_group_id": null,
    "ad_group_name": null,
    "asset_group_id": null,
    "is_deterministic": true,
    "timestamp": 0.000000
  }],
  "errors": [],
  "attributed": true,
  "warnings": [],
}

في ما يلي مثال على ردّ ميزة تتبُّع الإحالات الناجحة عندما يتضمّن الطلب أخطاء:

{
  "ad_events": [],
  "errors": ["INVALID_CURRENCY_CODE"],
  "attributed": false
}

في ما يلي مثال على ردّ سلبي لتتبُّع الإحالات الناجحة:

{
  "ad_events": [],
  "errors": [],
  "attributed": false
}

سيتم عرض ردّ على عملية تتبُّع الإحالات الناجحة لجميع طلبات تتبُّع الإحالات الناجحة.

في ما يلي مثال على ردّ إيجابي لتتبُّع الإحالات الناجحة لمستخدم من خارج المنطقة الاقتصادية الأوروبية في "حملة التطبيق الشاملة":

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

في ما يلي مثال على ردّ إيجابي لتتبُّع الإحالات الناجحة لمستخدم من خارج المنطقة الاقتصادية الأوروبية في "حملة على شبكة البحث":

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Search",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "GoogleSearch",
    "video_id": null,
    "keyword": "+space +birds",
    "match_type": "b",
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

في ما يلي مثال على استجابة إيجابية لتتبُّع الإحالات الناجحة لمستخدم خارج المنطقة الاقتصادية الأوروبية في "حملة على الشبكة الإعلانية":

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Display",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "mGDN",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": "mobile-app::2-343200656",
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}

في ما يلي مثال على استجابة إيجابية لتتبُّع الإحالات الناجحة لمستخدم من خارج المنطقة الاقتصادية الأوروبية في حملة على YouTube:

{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "engagement",
    "campaign_type": "Video",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": "dQw4w9WgXcQ",
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": null,
    "asset_group_id": null,
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true,
  "warnings": []
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Search",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}
 
{
  "ad_events": [{
    "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "Display",
    "network_subtype": "",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  },
  {
    "ad_event_id": "I8YUwWqxvOyqcwOcqBAkYZBMaOONSd",
    "conversion_metric": "conversion",
    "interaction_type": "click",
    "campaign_type": "ACI",
    "campaign_id": 123456789,
    "campaign_name": "My App Campaign",
    "ad_type": "ClickToDownload",
    "external_customer_id": 123456789,
    "location": 21144,
    "network_type": "YouTube",
    "network_subtype": "YouTubeVideos",
    "video_id": null,
    "keyword": null,
    "match_type": null,
    "placement": null,
    "ad_group_id": 123456789,
    "ad_group_name": "My App AdGroup",
    "asset_group_id": null,
    "creative_id": null,
    "timestamp": 1432681913.123456
  }
  ],
  "errors": [],
  "warnings": [],
  "attributed": true
}


طلب تحديد المصدر على جميع الشبكات

عندما تردّ "إعلانات Google" بشكل إيجابي على طلب تتبُّع إحالة ناجحة، على مستهلك واجهة برمجة التطبيقات إبلاغ "إعلانات Google" بقرار تحديد المصدر على مستوى الشبكات بعد تحديد النقرة الأخيرة.

يكون طلب تحديد المصدر على مستوى شبكات متعدّدة مطابقًا لطلب تتبُّع الإحالة الناجحة الأصلي، ولكن مع مسار طلب على النحو التالي:

/pagead/conversion/app/1.1/cross_network

وإضافة مَعلمتَين مطلوبتَين:

طلب تحديد المصدر على جميع الشبكات
ad_event_id

مطلوب

الموقع الجغرافي: طلب البحث

المعرّف ad_event_id من الحدث الإعلاني المرتبط بتحديد المصدر في الطلب السابق.

إنّ
attributed

مطلوب

الموقع الجغرافي: طلب البحث

تُستخدَم لتحديد ما إذا كانت "إعلانات Google" قد تلقّت نسبة مساهمة في الإحالة الناجحة من خلال مستهلك واجهة برمجة التطبيقات. إما 0 أو 1

في ما يلي مثال على طلب صالح للإحالة على جميع الشبكات:

POST /pagead/conversion/app/1.1/cross_network
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=custom
       &app_event_name=level_achieved
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &value=1.99
       &currency_code=USD
       &ad_event_id=Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
       &attributed=1
Host: www.googleadservices.com
User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
X-Forwarded-For: 216.58.194.174
Content-Type: application/json; charset=utf-8

سيتلقّى طلب تحديد المصدر صالح على مستوى الشبكات دائمًا استجابة عامة برمز الحالة 200 بدون نص الاستجابة.