ऐप्लिकेशन कन्वर्ज़न ट्रैकिंग और रीमार्केटिंग - अनुरोध/जवाब की खास जानकारी

ऐप्लिकेशन का उपयोगकर्ता-एजेंट

स्पैम से निपटने के लिए, हमने एक स्टैंडर्ड स्पेसिफ़िकेशन तैयार किया है. यह स्पेसिफ़िकेशन, ऐप्लिकेशन इस्तेमाल करने वाले व्यक्ति की ओर से भेजे गए User-Agent हेडर के लिए है. यह हेडर, Analytics/Ads प्रॉडक्ट भेजता है. ऐप्लिकेशन के User-Agent को नेटिव कोड से हासिल किया जा सकता है, ताकि वह इन शर्तों का पालन कर सके:

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

इन फ़ील्ड की परिभाषाएं यहां दी गई हैं:

User-Agent कॉम्पोनेंट
name

Analytics/Ads प्रॉडक्ट का नाम. (Google AdMob)

ध्यान दें कि अगर उपयोगकर्ता एजेंट को क्लाइंट साइड पर बनाया जाता है, तो name क्लाइंट ऐप्लिकेशन का बंडल आईडी होना चाहिए.

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

Analytics/Ads प्रॉडक्ट का वर्शन. (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

उस फ़िज़िकल डिवाइस का नाम जिस पर Analytics/Ads प्रॉडक्ट चल रहा है. (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 Ads को किसी ऐसे ऐप्लिकेशन इवेंट के बारे में सूचना देना है जिसे कन्वर्ज़न के तौर पर ट्रैक किया जाना चाहिए और/या जिसका इस्तेमाल रीमार्केटिंग सूची को भरने के लिए किया जाना चाहिए. साथ ही, इसका मकसद ऐसे मेटाडेटा को वापस पाना है जिसमें इवेंट से पहले हुए किसी क्लिक के बारे में जानकारी दी गई हो.

सभी एपीआई कॉल, www.googleadservices.com डोमेन पर किए जाते हैं. कन्वर्ज़न के अनुरोध, POST अनुरोध होते हैं. ये अनुरोध, एचटीटीपीएस के ज़रिए इस पाथ पर किए जाते हैं: 

/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 फ़ील्ड में स्वीकार नहीं किया गया है. इस फ़ील्ड में, UTF-8 एन्कोडिंग का इस्तेमाल करके, 1 से 64 यूनिकोड वर्ण होने चाहिए. अगर 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

अगर डिवाइस आईडी मौजूद नहीं है, तो उसे सभी शून्य के तौर पर सेट करें. जैसे, एटीटी के लिए सहमति न देने वाले उपयोगकर्ता का डिवाइस आईडी.

00000000-0000-0000-0000-000000000000
id_type

ज़रूरी है

जगह: क्वेरी

rdid फ़ील्ड में सेव किए गए आइडेंटिफ़ायर का टाइप. आने वाले समय में, हम यहां और वैल्यू स्वीकार कर सकते हैं. हालांकि, शुरुआत में हम इन वैल्यू का इस्तेमाल करेंगे.

Android

advertisingid

iOS

idfa
eea

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

EEA का दायरा.

0: इस उपयोगकर्ता और कन्वर्ज़न पर यूरोप के कानून लागू नहीं होते

1: इस उपयोगकर्ता और कन्वर्ज़न पर यूरोप के कानून लागू होते हैं. उदाहरण के लिए, अगर कोई उपयोगकर्ता EEA में है, तो उस पर यूरोप के लागू होने वाले कानून लागू होंगे. 

*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

ज़रूरी है

जगह: क्वेरी

एसडीके टूल का वह वर्शन जिसने इवेंट को मेज़र किया. इसका इस्तेमाल मुख्य रूप से डीबग करने के लिए किया जाता है. इसलिए, इसमें रिलीज़ किए गए वर्शन की जानकारी ठीक उसी तरह दिखनी चाहिए जिस तरह वह आपके एसडीके टूल के रिलीज़ किए गए वर्शन में दिखती है. अगर ऐप्लिकेशन में एसडीके टूल का इस्तेमाल नहीं किया जाता है, तो कृपया app_version के तौर पर वही वैल्यू पास करें.

1.9.5r6
timestamp

ज़रूरी है

जगह: क्वेरी

यह कन्वर्ज़न इवेंट के होने का UNIX टाइमस्टैंप है. यह सेकंड में होता है और इसमें माइक्रोसेकंड तक की सटीक जानकारी होती है.

1432681913.123456
value

वैकल्पिक

जगह: क्वेरी

इवेंट की मॉनेटरी वैल्यू, अगर कोई हो. इसे हमेशा मशीन के पढ़ने लायक फ़्लोटिंग पॉइंट वैल्यू के तौर पर फ़ॉर्मैट किया जाना चाहिए. इसके लिए, दशमलव बिंदु का इस्तेमाल करके वैल्यू के पूर्णांक और भिन्न भाग को अलग किया जाता है.

1.99
currency_code

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

value पैरामीटर के लिए, ISO 4217 मुद्रा कोड. अगर value पैरामीटर की वैल्यू दी गई है और वह खाली नहीं है, तो यह फ़ील्ड भरना ज़रूरी है.

USD
gclid

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

ऐप्लिकेशन खोलने वाले डीप लिंक यूआरएल से gclid क्वेरी पैरामीटर की वैल्यू.

Cj0KEQjw0dy4BRCuuL_e5M
market_referrer_gclid

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

डीप लिंक यूआरएल से gclid क्वेरी पैरामीटर की वैल्यू. इसे Play Install Referrer API के ज़रिए install_referrer वैल्यू से कैप्चर किया जाता है.

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

उन स्थितियों में gclid के आधार पर एट्रिब्यूशन के लिए आइडेंटिफ़ायर जहां rdid (advertisingid) not उपलब्ध है या सभी zeroes और gclid या market_referrer_gclid मौजूद है.

1
gbraid

कुछ शर्तों के मुताबिक ज़रूरी है

जगह: क्वेरी

पिछली बार देखा गया gbraid, डीप लिंक यूआरएल के ज़रिए भेजी गई वैल्यू है. इस यूआरएल से ऐप्लिकेशन खुलता है. ध्यान दें कि इसे ऐप्लिकेशन पर कैश मेमोरी में सेव करना ज़रूरी है, ताकि इसे ऐप्लिकेशन पर होने वाले आने वाले कन्वर्ज़न के साथ भेजा जा सके.

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

सभी अनुरोध, एचटीटीपीएस के ज़रिए भेजे जाने चाहिए. एचटीटीपी के ज़रिए मिले पिंग अस्वीकार कर दिए जाएंगे.

कृपया ध्यान दें कि अगर अनुरोध का मुख्य हिस्सा खाली है (ऐसे मामलों में जहां 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

  • Integer

    • सिर्फ़ पूर्णांक वैल्यू भेजें, जिनमें दशमलव के बाद कोई अंक न हो
    • अंकों के ग्रुप को अलग करने के लिए, कॉमा वर्ण का इस्तेमाल न करें. उदाहरण के लिए, 1,000,000
    • मान्य उदाहरण:
      • 1000
      • -11
      • 0

  • Date

    • तारीख का फ़ॉर्मैट: yyyy-mm-dd
      • yyyy = साल, चार अंकों में. उदाहरण के लिए, 2016
      • mm = दो अंकों वाला महीना, जैसे कि सितंबर के लिए 09
      • dd = तारीख, दो अंकों में, जैसे कि महीने की 23वीं तारीख के लिए 23
    • ऊपर बताई गई संख्या के हिसाब से ही अंक भेजें. उदाहरण के लिए, अगर महीने के पांचवें दिन के लिए dd की वैल्यू भेजनी है, तो 05 भेजें.
    • मान्य उदाहरण:
      • "2016-09-23"
      • "1990-12-31"

  • टाइमस्टैंप

    • समय का फ़ॉर्मैट: यूटीसी टाइमज़ोन में तय किया गया Unix/Epoch टाइमस्टैंप, जिसमें माइक्रोसेकंड तक की सटीक जानकारी होती है
    • मान्य उदाहरण:
      • 1478713087 for Wed, 09 Nov 2016 17:38:07 GMT
      • 1073513982.123000 for Wed, 07 Jan 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" फ़ील्ड ज़रूरी है.

  • ad_user_data_invalid - "ad_user_data" अनुरोध की वैल्यू अमान्य थी. डीएमए के दायरे में आने वाले सभी अनुरोधों के लिए, "ad_user_data" फ़ील्ड ज़रूरी है.

  • ad_personalization_missing_or_invalid - अनुरोध में "ad_personalization" फ़ील्ड सेट नहीं किया गया था या यह अमान्य था. डीएमए के दायरे में आने वाले सभी अनुरोधों के लिए, "ad_personalization" फ़ील्ड में जानकारी डालना ज़रूरी है.

विज्ञापन इवेंट, ऐप्लिकेशन एट्रिब्यूशन के मुख्य ऑब्जेक्ट होते हैं. इनमें ये प्रॉपर्टी शामिल होंगी.

उपयोगकर्ता की सहमति के आधार पर, जवाब देने के तरीके के बारे में अहम जानकारी:
अगर कन्वर्ज़न में, विज्ञापन के लिए उपयोगकर्ता के डेटा की सहमति ली गई है और उपयोगकर्ता ने Google की उपयोगकर्ता सेटिंग में, क्रॉस-यूज़ की सहमति दी है, तो Google Ads अपने सभी सीपीएस के लिए, आखिरी क्लिक के तौर पर एक ही जवाब देगा. अगर उपयोगकर्ता ने Google खाते की सेटिंग में, क्रॉस-यूज़ सहमति देने की अनुमति नहीं दी है, तो Google Ads, हर सीपीएस के आधार पर कई लास्ट क्लिक के साथ जवाब देगा.

अगर कन्वर्ज़न में, उपयोगकर्ता की चुनी गई क्रॉस-यूज़ सहमति में शामिल कुछ सीपीएस शामिल हैं, लेकिन अन्य नहीं, तो Google Ads, क्रॉस-यूज़ सहमति वाले सीपीएस के लिए एक लास्ट क्लिक और क्रॉस-यूज़ सहमति में शामिल न किए गए सीपीएस के लिए, हर सीपीएस के हिसाब से कई लास्ट क्लिक दिखाएगा.

कन्वर्ज़न ट्रैकिंग रिस्पॉन्स
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, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले कैंपेन का संक्षिप्त नाम है. एसीई, ऐप्लिकेशन में दिलचस्पी बढ़ाने वाले विज्ञापनों का संक्षिप्त नाम है.
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 के उस विज्ञापन नेटवर्क के “सबटाइप” की पहचान की जाएगी जिस पर विज्ञापन इवेंट हुआ था. प्राइमरी नेटवर्क टाइप के हिसाब से, संभावित वैल्यू अलग-अलग होती हैं.

Google Search 
GoogleSearch
 Google Search Partners 
SearchPartners

डिसप्ले

मोबाइल वेब पब्लिशर 
mGDN
 ऐप्लिकेशन पब्लिशर 
Google AdMob

YouTube

YouTube वीडियो नेटवर्क 
YouTubeVideos
 YouTube Search Network 
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, कन्वर्ज़न ट्रैकिंग के अनुरोध का जवाब 'हां' में देता है, तो एपीआई का इस्तेमाल करने वाले व्यक्ति या कंपनी को आखिरी क्लिक की पहचान करने के बाद, Google Ads को क्रॉस-नेटवर्क एट्रिब्यूशन के फ़ैसले के बारे में सूचना देनी होगी.

क्रॉस-नेटवर्क एट्रिब्यूशन का अनुरोध, कन्वर्ज़न ट्रैकिंग के मूल अनुरोध जैसा ही होता है. हालांकि, इसमें अनुरोध का पाथ यह होता है:

/pagead/conversion/app/1.0/cross_network

और दो ज़रूरी पैरामीटर जोड़े गए हैं:

क्रॉस-नेटवर्क एट्रिब्यूशन का अनुरोध
ad_event_id

ज़रूरी है

जगह: क्वेरी

पिछले अनुरोध में एट्रिब्यूशन से जुड़े विज्ञापन इवेंट का ad_event_id आइडेंटिफ़ायर.

नहीं जाना चाहिए.
attributed

ज़रूरी है

जगह: क्वेरी

API का इस्तेमाल करने वाले व्यक्ति या कंपनी ने Google Ads को कन्वर्ज़न का क्रेडिट दिया है या नहीं. 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 जवाब मिलेगा. इसमें कोई जवाब नहीं होगा.