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

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

स्पैम से निपटने के हमारे बड़े कोशिशों के तहत, हमने एक ऐप्लिकेशन उपयोगकर्ता की ओर से, आंकड़ों/विज्ञापन प्रॉडक्ट से भेजे गए उपयोगकर्ता-एजेंट हेडर के लिए, स्टैंडर्ड के आधार पर जानकारी तैयार की है. ऐप्लिकेशन उपयोगकर्ता-एजेंट को नीचे दिए गए विवरण का पालन करने के लिए नेटिव कोड से हासिल किया जा सकता है:

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

दो अक्षरों वाले भाषा और देश कोड को अंडरस्कोर से अलग करते हुए, डिवाइस के लिए एक आईईटीएफ़ स्थान टैग. (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/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 इवेंट के बारे में 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 फ़ील्ड में स्वीकार नहीं किया जाता. इस फ़ील्ड में 1 से 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

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

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

ज़रूरी


जगह: क्वेरी


ऐप्लिकेशन के होस्ट OS का मौजूदा वर्शन. यह मानक के रूप में मानक होना चाहिए.


Android

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

ज़रूरी


जगह: क्वेरी


इवेंट को मेज़र करने वाले SDK टूल का वर्शन. हालांकि, इसे खास तौर पर डीबग करने के लिए इस्तेमाल किया जाता है, इसलिए इसे रिलीज़ वाले वर्शन को ठीक वैसा ही दिखाना चाहिए जैसा वह आपके SDK रिलीज़ के साथ प्रकाशित किया जाता है. अगर ऐप्लिकेशन में SDK टूल का इस्तेमाल नहीं किया जाता, तो कृपया 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 के मान से कैप्चर की गई.

BX3QojHp4mY5MrJtFM_d1u
gclid_only_request

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


जगह: क्वेरी


gclid पर आधारित एट्रिब्यूशन के लिए आइडेंटिफ़ायर, जहां rdid (विज्ञापन आईडी) 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
       &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"]}}

गैर-कस्टम इवेंट और आय की जानकारीविज्ञापन आईडी (विज्ञापन आईडी) के साथ उपलब्ध मान्य कन्वर्ज़न ट्रैकिंग अनुरोध का उदाहरण:

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
  • Integer

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

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

    • समय का फ़ॉर्मैट: यूटीसी समय क्षेत्र में परिभाषित यूनिक्स/एपॉच टाइमस्टैंप, जिसमें माइक्रोसेकंड तक सटीक वैल्यू होती है
    • मान्य उदाहरण:
      • बुधवार के लिए 1478713087, 09 नवंबर 2016 17:38:07 जीएमटी
      • बुधवार, 07 जनवरी 2004 22:19:42.123 जीएमटी के लिए 1073513982.123000
  • रेंज

    • प्रिमिटिव वैल्यू की स्ट्रिंग (स्ट्रिंग, नंबर, और बूलियन) ही भेजें
    • मान्य उदाहरण:
      • [123, 456, 789]
      • ["abc"]

कन्वर्ज़न ट्रैकिंग रिस्पॉन्स

कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:

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

ad_events और गड़बड़ियों की कैटगरी खाली हो सकती है.

हमें उम्मीद है कि गड़बड़ियों की जानकारी, मशीन से पढ़े जा सकने वाले गड़बड़ी कोड के तौर पर दिखेगी, जैसे कि invalid_timestamp.

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

कन्वर्ज़न ट्रैकिंग रिस्पॉन्स
ad_event_id

हमेशा प्रज़ेंट करें


स्ट्रिंग


ad_event_id, विज्ञापन इवेंट के लिए यूनीक आइडेंटिफ़ायर के तौर पर काम करता है. क्रॉस-नेटवर्क एट्रिब्यूशन अनुरोध में इसका फिर से इस्तेमाल किया जाता है. डीबग करने के लिए इसे लॉग/बनाया जाना चाहिए.

Q2owS0VRancwZHk0QlJDdXVMX2U1TQ
conversion_metric

हमेशा प्रज़ेंट करें


स्ट्रिंग


एट्रिब्यूशन के लिए इस्तेमाल की गई कन्वर्ज़न मेट्रिक. शुरुआत में हम एक कन्वर्ज़न मेट्रिक का इस्तेमाल करेंगे.

conversion
timestamp

हमेशा प्रज़ेंट करें


संख्या


विज्ञापन इवेंट के लिए UNIX टाइमस्टैंप, सेकंड में माइक्रोसेकंड के बाद सटीक होता है. इस वैल्यू का इस्तेमाल, लास्ट क्लिक एट्रिब्यूशन के लिए किया जाना चाहिए.

1432681913.123456
campaign_type

हमेशा प्रज़ेंट करें


स्ट्रिंग


यह फ़ील्ड, विज्ञापन इवेंट बनाने वाले कैंपेन के टाइप की पहचान करेगा. संभावित वैल्यू इस तरह होती हैं.

ACI
ACE
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

हमेशा प्रज़ेंट करें


संख्या


विज्ञापन देने वाले का पहचानकर्ता, जो उस कैंपेन का मालिक होता है जिसने विज्ञापन इवेंट बनाया है. इस वैल्यू का इस्तेमाल, Google Ads खातों में अंतर करने के लिए किया जा सकता है.

123456789
location

हमेशा प्रज़ेंट करें


संख्या


विज्ञापन इवेंट की भौगोलिक जगह के लिए लोकेशन आईडी कोड. लोकेशन कोड को समझने के लिए, Google Ads API का रेफ़रंस देखें.

network_type

हमेशा प्रज़ेंट करें


स्ट्रिंग


यह फ़ील्ड, Google Ads विज्ञापन नेटवर्क की पहचान करेगा, जिसमें विज्ञापन इवेंट हुआ है. इस तरह की वैल्यू हो सकती हैं.

Search
Display
YouTube
network_subtype

जब campaign_type ACI या ACE हो और network_type Display हो, तो null होगा.


स्ट्रिंग


यह फ़ील्ड Google Ads विज्ञापन नेटवर्क के "उप-प्रकार" की पहचान करेगा. संभावित नेटवर्क के टाइप के आधार पर, संभावित वैल्यू अलग-अलग हो सकती हैं.


सामान्य Google Search
GoogleSearch
Google सर्च पार्टनर
SearchPartners

डिसप्ले

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

YouTube

YouTube वीडियो नेटवर्क
YouTubeVideos
YouTube सर्च नेटवर्क
YouTubeSearch
वीडियो पार्टनर
VideoPartners
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

हमेशा प्रज़ेंट करें


संख्या


विज्ञापन इवेंट के साथ बनाए गए विज्ञापन ग्रुप का न्यूमेरिक आईडी. यह वैल्यू यूनीक है.

123456789
ad_group_name

यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब campaign_type, ACI,ACE या ACPRE हो.


स्ट्रिंग


विज्ञापन इवेंट बनाने वाले विज्ञापन ग्रुप का नाम, जिसे विज्ञापन देने वाले ने तय किया है. इस वैल्यू के यूनीक होने की गारंटी नहीं है.

My App AdGroup
creative_id

यह सुविधा सिर्फ़ तब दी जाती है, जब campaign_type ACI और ACE न हो.


संख्या


क्रिएटिव विज्ञापन यूनिट का वह न्यूमेरिक आईडी जिसने विज्ञापन इवेंट बनाया. यह वैल्यू यूनीक है.

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
}

सर्च कैंपेन के लिए, बेहतर कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:

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

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

/pagead/conversion/app/1.0/cross_network

और ज़रूरी दो पैरामीटर जोड़ना:

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

ज़रूरी


जगह: क्वेरी


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

attributed

ज़रूरी


जगह: क्वेरी


एपीआई इस्तेमाल करने वाले लोगों को, 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 जवाब देगा.