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

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

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

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

اسم الجهاز الفعلي الذي يعرض منتج "إحصاءات Google"/إعلانات Google. (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 في نهاية وكيل مستخدم التطبيق عند إنشاء خادم خادم وكيل المستخدم. إذا تم إنشاء وكيل المستخدم في التطبيق بالكامل من جهة العميل، يمكنك استبعاد ; 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.0.

سيحتوي طلب الإحالة الناجحة العادي للتطبيق على المَعلمات التالية.

طلب تتبع الإحالة الناجحة
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 حرفًا (باستخدام ترميز 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}
rdid

مطلوب

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

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

f10e1de2-e237-4f50-b6aa-843c45cc63d6

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

00000000-0000-0000-0000-000000000000
id_type

مطلوب

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

نوع المعرّف المُخزّن في الحقل rdid. قد نقبل المزيد من القيم هنا في المستقبل، ولكن في البداية، سندعم ما يلي.

Android

advertisingid

iOS

idfa
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

مطلوب

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

الطابع الزمني لحدث حدث الإحالة الناجحة في يونكس، بالثواني، بدقة تصل إلى ميكرو ثانية

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 في السيناريوهات التي يكون فيها (idid) (not) المعرّف متوفّرًاnot أو جميع 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. سيتم رفض الإشعارات التي يتم تلقيها عبر HTTP.

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

نموذج طلب

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

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &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
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 (الإعلانات) غير متوفّرة:

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
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.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &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
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
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، يُرجى استخدام العبارات التالية لأنواع البيانات الأولية:

  • العائم

    • استخدِم حرف النقطة كفاصل عشري بشكل مستقل عن أقلمة التطبيقات.
    • استخدِم القيمة العشرية المكوّنة من رقمين لتمثيل القيم النقدية، مثلاً 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 ليوم 23 من الشهر
    • أرسِل دائمًا عدد الأرقام المحدّد أعلاه، على سبيل المثال، إذا أرسلت القيمة "يوم" لليوم الخامس من الشهر، أرسِل 05.
    • أمثلة صالحة:
      • "2016-09-23"
      • "1990-12-31"

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

    • تنسيق الوقت: طابع زمني لنظام التشغيل Unix/Epoch تم تحديده وفقًا للمنطقة الزمنية للتوقيت العالمي المتفق عليه بدقة تصل إلى ميكرو ثانية.
    • أمثلة صالحة:
      • 1478713087 ليوم الأربعاء، 09 تشرين الثاني (نوفمبر) 2016 الساعة 17:38:07 بتوقيت غرينيتش
      • 1073513982.123000 ليوم الأربعاء، 7 كانون الثاني (يناير) 2004 الساعة 22:19:42.123 بتوقيت غرينيتش

  • المصفوفات

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

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

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

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

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

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

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

الاستجابة لتتبُّع الإحالات الناجحة
ad_event_id

مشاركة العرض دائمًا

string

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

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

مشاركة العرض دائمًا

string

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

conversion
timestamp

مشاركة العرض دائمًا

رقم

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

1432681913.123456
campaign_type

مشاركة العرض دائمًا

string

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

ACI
ACE
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI هو اختصار لحملة التطبيقات لجذب عمليات التثبيت. تشكّل تجارب حملات AdWords (ACE) اختصارًا لحملات التطبيقات لجذب المستخدمين الحاليين.
campaign_id

مشاركة العرض دائمًا

رقم

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

123456789
campaign_name

مشاركة العرض دائمًا

string

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

Occasional Gamers (Video)
ad_type

مشاركة العرض دائمًا

string

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

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

مشاركة العرض دائمًا

رقم

رقم تعريف المعلِن الذي يملك الحملة التي أنتجت الحدث الإعلاني يمكن استخدام هذه القيمة للتمييز بين حسابات "إعلانات Google".

123456789
location

مشاركة العرض دائمًا

رقم

رمز معرّف الموقع للموقع الجغرافي لحدث الإعلان. ارجع إلى مرجع واجهة برمجة التطبيقات مع "إعلانات Google" لتفسير رموز المواقع الجغرافية.
network_type

مشاركة العرض دائمًا

string

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

Search
Display
YouTube
network_subtype

سيكون null عند campaign_type في ACI أو ACE وnetwork_type في Display.

string

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

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

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

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

YouTube

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

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

string

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

dQw4w9WgXcQ
keyword

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

string

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

+food +delivery
match_type

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

string

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

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

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

string

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

mobileapp::1-343200656
ad_group_id

مشاركة العرض دائمًا

رقم

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

123456789
ad_group_name

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

string

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

My App AdGroup
creative_id

يتم توفيره فقط عند عدم campaign_type وACI وACE.

رقم

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

123456789
interaction_type

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

string

نماذج الردود

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

{
  "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": null,
    "ad_group_name": "",
    "creative_id": null,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

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

{
  "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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

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

{
  "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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

في ما يلي مثال على الاستجابة لتأكيد تتبُّع الإحالات الناجحة لأي حملة على 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": "My App AdGroup",
    "creative_id": 123456789,
    "timestamp": 1432681913.123456
  }],
  "errors": [],
  "attributed": true
}

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

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

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

/pagead/conversion/app/1.0/cross_network

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

طلب إحالة على جميع الشبكات
ad_event_id

مطلوب

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

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

مطلوب

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

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

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

POST /pagead/conversion/app/1.0/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 رد عام بدون نص ردّ.