ردیابی تبدیل برنامه و بازاریابی مجدد - مشخصات درخواست/پاسخ

عامل کاربر برنامه

به‌عنوان بخشی از تلاش‌های گسترده‌ترمان برای مبارزه با هرزنامه، یک مشخصات استاندارد برای سربرگ User-Agent ایجاد کرده‌ایم که توسط یک محصول تجزیه و تحلیل/تبلیغات به نمایندگی از یک کاربر برنامه ارسال می‌شود. برنامه User-Agent را می توان از کد بومی برای رعایت مشخصات زیر مشتق کرد:

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

تعریف این فیلدها به شرح زیر است:

اجزای عامل کاربر
name

نام محصول تجزیه و تحلیل/تبلیغات. ( Google AdMob )

توجه داشته باشید که اگر عامل کاربر در سمت کلاینت ساخته شده باشد، به جای آن name باید شناسه بسته برنامه مشتری باشد.

اندروید 
// Specified by API consumer.
iOS 
// Specified by API consumer.
version

نسخه محصول تجزیه و تحلیل/تبلیغات. ( 7.10.1 )

اندروید 
// Specified by API consumer.
iOS 
// Specified by API consumer.
os_and_version

سیستم عامل و نسخه سیستم عامل برنامه در حال اجرا است. ( Android 6.0 )

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

یک برچسب محلی IETF برای دستگاه، با استفاده از زبان دو حرفی و کد کشور که با زیرخط از هم جدا شده‌اند. ( en_US )

اندروید 
String locale = Locale.getDefault();
iOS 
NSString *locale =
  [[NSLocale currentLocale]
    localeIdentifier]
device

نام دستگاه فیزیکی که محصول تجزیه و تحلیل/تبلیغات را اجرا می کند. ( iPhone9,1 )

اندروید 
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 )

اندروید 
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 Ads از رویداد برنامه‌ای است که باید به‌عنوان تبدیل ردیابی شود و/یا برای تکمیل فهرست بازاریابی مجدد استفاده شود، و بازیابی فراداده‌ای که هر کلیکی را که قبل از رویداد توصیف می‌کند توصیف می‌کند.

همه تماس‌های API با دامنه www.googleadservices.com انجام می‌شود. درخواست‌های تبدیل، درخواست‌های POST از طریق HTTPS در مسیر زیر هستند:

/pagead/conversion/app/version
که در آن version نسخه مورد نظر API ردیابی تبدیل است. در حال حاضر تنها نسخه معتبر 1.0 است.

درخواست تبدیل برنامه استاندارد شامل پارامترهای زیر خواهد بود.

درخواست ردیابی تبدیل
dev_token

مورد نیاز

مکان: پرس و جو

توکن توسعه‌دهنده منحصربه‌فرد و ایستا که برای مصرف‌کننده API صادر می‌شود. 

Z_eErE4DkvcKjDM1OVE4c4
link_id

مورد نیاز

مکان: پرس و جو

شناسه پیوند، توکن توسعه دهنده مصرف کننده API را به یک برنامه خاص متصل می کند. 

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 پذیرفته نمی‌شود. این فیلد باید شامل 1 تا 64 کاراکتر یونیکد (با استفاده از رمزگذاری UTF-8) باشد. اگر app_event_type سفارشی باشد، این فیلد ضروری است . 

level_achieved
Level Achieved

این فیلد نباید حاوی هیچ یک از مقادیر رزرو شده برای app_event_type باشد. اگر از نام رویداد رزرو شده استفاده شود، API یک خطای APP_EVENT_NAME_RESERVED_VALUE را برمی‌گرداند.

app_event_data

اختیاری

مکان: بدن

هرگونه داده رویداد غنی اضافی را به عنوان کلیدهای رشته ای نگاشت شیء JSON ساده به مقادیر ارسال کنید. مقادیر قابل قبول رشته ها و آرایه های رشته ها هستند. 

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

مورد نیاز

مکان: پرس و جو

یک رشته UUID معتبر که شناسه دستگاه خام را نشان می دهد. 

f10e1de2-e237-4f50-b6aa-843c45cc63d6

در صورتی که شناسه دستگاه گم شده باشد، مانند شناسه دستگاه از یک کاربر بدون رضایت ATT، آن را صفر تنظیم کنید. 

00000000-0000-0000-0000-000000000000
id_type

مورد نیاز

مکان: پرس و جو

نوع شناسه ذخیره شده در فیلد rdid . ممکن است در آینده ارزش های بیشتری را در اینجا بپذیریم، اما برای شروع، موارد زیر را پشتیبانی خواهیم کرد.

اندروید 

advertisingid

iOS 

idfa
eea

تحت شرایط خاصی مورد نیاز است

مکان: پرس و جو

محدوده 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

مورد نیاز

مکان: پرس و جو

نسخه فعلی برنامه این باید به صورت زیر استاندارد شود.

اندروید 

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

iOS 

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

مورد نیاز

مکان: پرس و جو

نسخه فعلی سیستم عامل میزبان برنامه. این باید به صورت زیر استاندارد شود.

اندروید 

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

تحت شرایط خاصی مورد نیاز است

مکان: پرس و جو

مقدار پارامتر query gclid از یک URL پیوند عمیق که برنامه را باز کرده است.

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

تحت شرایط خاصی مورد نیاز است

مکان: پرس و جو

مقدار پارامتر query gclid از یک URL پیوند عمیق که از مقدار install_referrer از طریق Play Install Referrer API گرفته شده است.

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

تحت شرایط خاصی مورد نیاز است

مکان: پرس و جو

شناسه انتساب مبتنی بر gclid در سناریوهایی که rdid (advertisingid) در دسترس 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
       &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.0
       ?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.0
       ?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.0
       ?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.0
       ?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

رمزگذاری داده های رویداد

برای پارامتر بدنه 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 ماه
    • همیشه تعداد ارقام مشخص شده در بالا را ارسال کنید، به عنوان مثال اگر مقدار dd را برای روز پنجم ماه ارسال می کنید، 05 ارسال کنید.
    • نمونه های معتبر:
      • "2016-09-23"
      • "1990-12-31"

  • مهر زمان

    • قالب زمان: مهر زمانی Unix/Epoch در منطقه زمانی UTC با دقت حداکثر میکروثانیه تعریف شده است
    • نمونه های معتبر:
      • 1478713087 برای چهارشنبه، 09 نوامبر 2016، 17:38:07 GMT
      • 1073513982.123000 برای چهارشنبه، 07 ژانویه 2004، 22:19:42.123 GMT

  • آرایه ها

    • فقط آرایه هایی از مقادیر اولیه (رشته ها، اعداد و بولی ها) را ارسال کنید.
    • مثال های معتبر:
      • [123, 456, 789]
      • ["abc"]

پاسخ ردیابی تبدیل

پاسخ ردیابی تبدیل فرمت زیر را دارد: 

{
  "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» برای همه درخواست‌های DMA در محدوده مورد نیاز است.

  • ad_user_data_invalid - مقدار درخواست "ad_user_data" نامعتبر بود. فیلد «ad_user_data» برای همه درخواست‌های DMA در محدوده مورد نیاز است.

  • ad_personalization_missing_or_invalid - هر یک از این درخواست ها فیلد "ad_personalization" را تنظیم نکرده بود یا نامعتبر بود. فیلد "ad_personalization" برای همه درخواست‌های DMA در محدوده مورد نیاز است.

رویدادهای تبلیغاتی اشیاء اصلی تخصیص برنامه هستند و دارای ویژگی‌های زیر هستند.

نکات مهم در مورد رفتار پاسخ به رضایت کاربر:
اگر این تبدیل رضایت داده کاربر تبلیغات را داشته باشد و کاربر رضایت استفاده متقابل را در تنظیمات کاربر Google خود داشته باشد، Google Ads با آخرین کلیک در تمام CPSهای خود پاسخ خواهد داد. اگر کاربر به رضایت استفاده متقابل در تنظیمات کاربر Google خود رضایت نداده باشد، Google Ads با چندین آخرین کلیک بر اساس هر CPS پاسخ خواهد داد.

اگر این تبدیل شامل CPSهای خاصی در رضایت استفاده متقابل انتخاب شده توسط کاربر باشد اما موارد دیگر را نه، Google Ads با یک آخرین کلیک در سراسر CPSهایی که رضایت استفاده متقابل اعطا شده است، پاسخ می دهد، اما با چندین آخرین کلیک، بر اساس هر CPS، برای آن CPSهایی که رضایت استفاده متقابل دریافت نکرده اند.

پاسخ ردیابی تبدیل
ad_event_id

همیشه حاضر

رشته

ad_event_id به عنوان یک شناسه منحصر به فرد برای رویدادهای تبلیغاتی عمل می کند. در درخواست انتساب بین شبکه‌ای مجدداً استفاده می‌شود و باید برای اهداف اشکال‌زدایی وارد/حفظ شود. 

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

همیشه حاضر

رشته

متریک تبدیل مورد استفاده برای انتساب. ما در ابتدا از یک معیار تبدیل پشتیبانی خواهیم کرد. 

conversion
timestamp

همیشه حاضر

شماره

مُهر زمانی یونیکس رویداد آگهی، در چند ثانیه با دقت حداکثر میکروثانیه رخ داد. این مقدار باید برای انتساب آخرین کلیک استفاده شود. 

1432681913.123456
campaign_type

همیشه حاضر

رشته

این فیلد نوع کمپینی را که رویداد تبلیغاتی را تولید کرده است مشخص می کند. مقادیر ممکن به شرح زیر است. 

ACI
ACE
ACPre
Search
Display
Video
Shopping
Hotel
Performance_Max
Other

ACI مخفف App Campaign for Install است. ACE مخفف App Campaigns for Engagement است.

campaign_id

همیشه حاضر

شماره

شناسه عددی کمپین کمپینی که رویداد تبلیغاتی را تولید کرده است. این ارزش منحصر به فرد تضمین شده است. 

123456789
campaign_name

همیشه حاضر

رشته

نام کمپین تعریف‌شده توسط تبلیغ‌کننده برای کمپینی که رویداد تبلیغاتی را تولید کرده است. این ارزش منحصر به فرد تضمین نمی شود. 

Occasional Gamers (Video)
ad_type

همیشه حاضر

رشته

نوع تبلیغی که منجر به رویداد تبلیغاتی شد. از این مقدار می توان برای تمایز بین انواع مختلف موجودی به شرح زیر استفاده کرد.

تبلیغ برنامه
ClickToDownload
 تعامل با برنامه
AppDeepLink
 تعامل با برنامه - نصب و ادامه جریان
AppDeepLinkContinue
 برای مقادیر دیگر همه چیز را بگیرید 
Unknown
external_customer_id

همیشه حاضر

شماره

شناسه تبلیغ‌کننده برای تبلیغ‌کننده‌ای که مالک کمپینی است که رویداد تبلیغاتی را تولید کرده است. از این مقدار می‌توان برای متمایز کردن حساب‌های Google Ads استفاده کرد. 

123456789
location

همیشه حاضر

شماره

کد شناسه مکان برای موقعیت جغرافیایی رویداد تبلیغاتی. برای تفسیر کدهای مکان به مرجع Google Ads API مراجعه کنید.

network_type

همیشه حاضر

رشته

این فیلد شبکه تبلیغاتی Google Ads را که رویداد تبلیغاتی در آن رخ داده است شناسایی می کند. مقادیر ممکن به شرح زیر است. 

Search
Display
YouTube
GoogleTv
cross-network
network_subtype

زمانی که campaign_type ACI یا ACE باشد و network_type Display باشد، null خواهد بود.

رشته

این فیلد «فرعی» شبکه تبلیغاتی Google Ads را که رویداد تبلیغاتی در آن رخ داده است، مشخص می کند. مقادیر ممکن بسته به نوع شبکه اولیه متفاوت است.

جستجوی معمولی گوگل
GoogleSearch
 شرکای جستجوی گوگل 
SearchPartners

نمایش

ناشران وب موبایل
mGDN
 ناشران برنامه 
Google AdMob

یوتیوب

شبکه ویدیوهای یوتیوب
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 نباشد.

شماره

شناسه عددی گروه تبلیغاتی که با رویداد تبلیغاتی تولید شده است. این ارزش منحصر به فرد تضمین شده است. 

123456789
ad_group_name

فقط زمانی ارائه می شود که campaign_type ACI ، ACE یا ACPRE باشد.

رشته

نام گروه تبلیغاتی تعریف شده توسط تبلیغ کننده برای گروه تبلیغاتی که رویداد تبلیغاتی را تولید کرده است. این ارزش منحصر به فرد تضمین نمی شود. 

My App AdGroup
creative_id

فقط زمانی ارائه می شود که campaign_type ACI ، ACE ، ACPRE یا Performance_Max نباشد .

شماره

شناسه عددی واحد تبلیغات خلاق که رویداد تبلیغاتی را تولید کرده است. این ارزش منحصر به فرد تضمین شده است. 

123456789
interaction_type

این زمینه همیشه تعامل خواهد بود.

رشته

نمونه پاسخ ها

نمونه ای از پاسخ ردیابی تبدیل زمانی که درخواست حاوی خطا باشد: 

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


درخواست انتساب بین شبکه ای

وقتی Google Ads به درخواست ردیابی تبدیل پاسخ مثبت می‌دهد، مصرف‌کننده API باید پس از شناسایی آخرین کلیک، تصمیم خود را درباره انتساب بین شبکه‌ای به Google Ads اطلاع دهد.

درخواست انتساب بین شبکه ای مشابه درخواست اصلی ردیابی تبدیل است، اما با یک مسیر درخواست: 

/pagead/conversion/app/1.0/cross_network

و اضافه کردن دو پارامتر مورد نیاز:

درخواست انتساب بین شبکه ای
ad_event_id

مورد نیاز

مکان: پرس و جو

شناسه ad_event_id از رویداد آگهی مرتبط با انتساب در درخواست قبلی.

attributed

مورد نیاز

مکان: پرس و جو

اینکه آیا Google Ads اعتباری را برای تبدیل توسط مصرف کننده API دریافت کرده است یا خیر. یا 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 بدون بدنه پاسخ دریافت می کند.