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

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

स्पैम से निपटने के लिए, हमने एक स्टैंडर्ड स्पेसिफ़िकेशन तैयार किया है. यह स्पेसिफ़िकेशन, ऐप्लिकेशन इस्तेमाल करने वाले व्यक्ति की ओर से भेजे गए User-Agent हेडर के लिए है. यह हेडर, आंकड़ों/विज्ञापन से जुड़ा कोई प्रॉडक्ट भेजता है. ऐप्लिकेशन के 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];
}

ऐप्लिकेशन के User-Agent को सर्वर साइड पर बनाते समय, ऐप्लिकेशन के User-Agent के आखिर में सिर्फ़ ; Proxy शामिल करें. अगर ऐप्लिकेशन का 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 को किसी ऐसे ऐप्लिकेशन इवेंट के बारे में सूचना देना है जिसे कन्वर्ज़न के तौर पर ट्रैक किया जाना चाहिए और/या जिसका इस्तेमाल रीमार्केटिंग सूची को भरने के लिए किया जाना चाहिए. साथ ही, इसका मकसद ऐसे मेटाडेटा को वापस पाना है जो इवेंट से पहले हुए किसी क्लिक के बारे में बताता है.

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

/pagead/conversion/app/version
जहां version, कन्वर्ज़न ट्रैकिंग एपीआई का ज़रूरी वर्शन है.

ऐप्लिकेशन कन्वर्ज़न के स्टैंडर्ड अनुरोध में, App Conversion API v1.1 के लिए ये पैरामीटर शामिल होंगे.

कन्वर्ज़न ट्रैकिंग का अनुरोध
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}
odm_info

iOS पर इंटिग्रेटेड कन्वर्ज़न मेज़रमेंट का इस्तेमाल करते समय ज़रूरी है

जगह की जानकारी: क्वेरी

info क्वेरी पैरामीटर की वैल्यू, जिसे iOS ऐप्लिकेशन इंस्टॉल करने या Google On Device Measurement (ODM): Event Data SDK से फिर से इंस्टॉल करने पर कैप्चर किया जाता है. इस फ़ील्ड की मदद से, iOS ऐप्लिकेशन कैंपेन के लिए इंटिग्रेटेड कन्वर्ज़न मेज़रमेंट की सुविधा चालू की जा सकती है.

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

ज़रूरी है

rdid फ़ील्ड में पास किया गया आइडेंटिफ़ायर किस तरह का है.

Android

advertisingid
 
appsetid

iOS

idfa
 
idfv
rdid

ज़रूरी है

जगह की जानकारी: क्वेरी

यह एक मान्य यूयूआईडी स्ट्रिंग है, जो रॉ डिवाइस आईडी को दिखाती है.

f10e1de2-e237-4f50-b6aa-843c45cc63d6

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

00000000-0000-0000-0000-000000000000
ctry_c

ज़रूरी है

जगह की जानकारी: क्वेरी

आईएसओ के दो अक्षरों वाला देश कोड. इससे उस देश के बारे में पता चलता है जहां से कन्वर्ज़न हुआ है.

iOS और Android पर, गैर-उपयोगकर्ता लेवल के ऐप्लिकेशन कन्वर्ज़न मेज़रमेंट को चालू करने के लिए, इस फ़ील्ड की ज़रूरत होती है.

US, IN
eea

कुछ मामलों में ज़रूरी है

जगह की जानकारी: क्वेरी

ईईए का दायरा.

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

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

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

कुछ मामलों में ज़रूरी है

जगह की जानकारी: क्वेरी

दिलचस्पी के मुताबिक दिखाए जाने वाले विज्ञापनों के लिए फ़्लैग

0: असली उपयोगकर्ता ने दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए सहमति नहीं दी है

1: असली उपयोगकर्ता ने दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए सहमति दी है 

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

कुछ मामलों में ज़रूरी है

जगह की जानकारी: क्वेरी

विज्ञापन दिखाने के मकसद से, उपयोगकर्ता के डेटा का इस्तेमाल करने के लिए सहमति का फ़्लैग

0: उपयोगकर्ता ने विज्ञापन दिखाने के मकसद से, उपयोगकर्ता लेवल का डेटा Google को भेजने की सहमति नहीं दी है

1: उपयोगकर्ता ने विज्ञापन दिखाने के मकसद से, उपयोगकर्ता लेवल का डेटा Google को भेजने की सहमति दी है 

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

ज़रूरी है

जगह की जानकारी: क्वेरी

डिवाइस के लिए, विज्ञापन ट्रैकिंग को सीमित करने की सेटिंग का स्टेटस.

  • 0: उपयोगकर्ता ने विज्ञापन की ट्रैकिंग को सीमित करने का विकल्प नहीं चुना है.
  • 1: उपयोगकर्ता ने विज्ञापन की ट्रैकिंग को सीमित करने का विकल्प चुना है.
app_version

ज़रूरी है

जगह की जानकारी: क्वेरी

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

Android

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

iOS

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

ज़रूरी है

जगह की जानकारी: क्वेरी

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

Android

android.os.Build.VERSION.RELEASE

iOS

[[UIDevice currentDevice] systemVersion]
sdk_version

ज़रूरी है

जगह की जानकारी: क्वेरी

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

1.9.5r6
timestamp

ज़रूरी है

जगह की जानकारी: क्वेरी

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

1432681913.123456
fot

ज़रूरी है

जगह की जानकारी: क्वेरी

यह first_open का 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 हेडर को साफ़ तौर पर सेट करें.

इवेंट डेटा को कोड में बदलना

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"]

नमूना अनुरोध

इंटिग्रेटेड कन्वर्ज़न मेज़रमेंट के लिए, ऑन-डिवाइस मेज़रमेंट: इवेंट डेटा एसडीके का इस्तेमाल करके, पहली बार ऐप्लिकेशन खोलने के अनुरोध का उदाहरण यहां दिया गया है:

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

इंटिग्रेटेड कन्वर्ज़न मेज़रमेंट के लिए, ऑन डिवाइस मेज़रमेंट: इवेंट डेटा एसडीके के बिना, पहली बार ऐप्लिकेशन खोलने के अनुरोध का उदाहरण यहां दिया गया है:

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

इंटिग्रेटेड कन्वर्ज़न मेज़रमेंट के लिए, ऑन डिवाइस मेज़रमेंट: इवेंट डेटा एसडीके का इस्तेमाल करके, पोस्ट इंस्टॉल अनुरोध का उदाहरण यहां दिया गया है:

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

On Device Measurement: Event Data SDK के बिना, पहली बार ऐप्लिकेशन खोलने के अनुरोध का उदाहरण यहां दिया गया है:

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

ACAPI v1.1 के लिए, Android के नॉन-डिटरमिनिस्टिक कन्वर्ज़न के लिए, पहली बार ऐप्लिकेशन खोलने के अनुरोध का उदाहरण यहां दिया गया है:

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

नॉन-कस्टम इवेंट टाइप और रेवेन्यू की जानकारी के साथ, कन्वर्ज़न ट्रैकिंग के मान्य अनुरोध का उदाहरण यहां दिया गया है:

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

कस्टम इवेंट टाइप नहीं है और रेवेन्यू की जानकारी मौजूद है. साथ ही, rdid (advertisingid) उपलब्ध नहीं है. ऐसे में, कन्वर्ज़न ट्रैकिंग का मान्य अनुरोध इस तरह किया जा सकता है:

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

सेशन शुरू होने के मान्य अनुरोध का उदाहरण यहां दिया गया है:

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

यहां एक ऐसे सेशन के लिए, सेशन शुरू होने के रीएट्रिब्यूशन के मान्य अनुरोध का उदाहरण दिया गया है जो डीप लिंक example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M से शुरू हुआ था:

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

ईईए के किसी ऐसे उपयोगकर्ता के लिए मान्य कन्वर्ज़न ट्रैकिंग अनुरोध का उदाहरण यहां दिया गया है जिसने विज्ञापन के लिए उपयोगकर्ता के डेटा की सहमति दी है, लेकिन दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा के लिए सहमति नहीं दी है:

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

कन्वर्ज़न ट्रैकिंग की प्रतिक्रिया से जुड़ी गाइड

कन्वर्ज़न ट्रैकिंग के जवाब का फ़ॉर्मैट यह होता है:

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

ad_events और errors, दोनों ऐरे खाली हो सकती हैं.

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

गड़बड़ी के कोड

  • invalid_timestamp - अनुरोध में मान्य टाइमस्टैंप मौजूद नहीं था.

  • eea_missing_or_invalid - अनुरोध में "eea" फ़ील्ड सेट नहीं किया गया था या यह अमान्य था.

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

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

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

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

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

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

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

स्ट्रिंग

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

Google Search की सामान्य सुविधा 
GoogleSearch
 Google की सर्च पार्टनर वेबसाइटें 
SearchPartners

डिसप्ले

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

YouTube

YouTube वीडियो नेटवर्क 
YouTubeVideos
 YouTube Search Network 
YouTubeSearch
 वीडियो पार्टनर 
VideoPartners

GoogleTv

GoogleTV Videos नेटवर्क 
GoogleTvVideos

क्रॉस-नेटवर्क

परफ़ॉर्मेंस मैक्स कैंपेन को अलग-अलग नेटवर्क पर चलाना 
cross-network
video_id

यह वैल्यू सिर्फ़ तब दी जाती है, जब network_type की वैल्यू YouTube पर सेट हो और campaign_type की वैल्यू नहीं ACI और ACE पर सेट हो.

स्ट्रिंग

विज्ञापन के इवेंट से जुड़ा YouTube वीडियो का आईडी.

dQw4w9WgXcQ
keyword

यह वैल्यू सिर्फ़ तब दी जाती है, जब network_type की वैल्यू Search पर सेट हो और campaign_type की वैल्यू नहीं ACI और ACE पर सेट हो.

स्ट्रिंग

विज्ञापन इवेंट से जुड़ा सर्च कीवर्ड.

+food +delivery
match_type

यह वैल्यू सिर्फ़ तब दी जाती है, जब network_type की वैल्यू Search पर सेट हो और campaign_type की वैल्यू नहीं ACI और ACE पर सेट हो.

स्ट्रिंग

सर्च कीवर्ड के लिए मैच टाइप.

निश्चित 
e
 वाक्यांश 
p
 ब्रॉड 
b
placement

यह वैल्यू सिर्फ़ तब दी जाती है, जब network_type की वैल्यू Display पर सेट हो और campaign_type की वैल्यू नहीं ACI और ACE पर सेट हो.

स्ट्रिंग

विज्ञापन के इवेंट से जुड़ा प्लेसमेंट.

mobileapp::1-343200656
ad_group_id

यह वैल्यू सिर्फ़ तब दी जाती है, जब campaign_type Performance_Max न हो.

संख्या

उस विज्ञापन ग्रुप का अंकों वाला आईडी जिससे विज्ञापन का इवेंट जनरेट हुआ. इस वैल्यू के यूनीक होने की गारंटी है.

यह फ़ील्ड, gbraid-एट्रिब्यूट किए गए उन विज्ञापन इवेंट के लिए उपलब्ध नहीं है जिन्हें डिटरमिनिस्टिक तरीके से एट्रिब्यूट किया जाता है (is_deterministic true है). जैसे, डीप लिंक एट्रिब्यूशन.

123456789
ad_group_name

यह वैल्यू सिर्फ़ तब दी जाती है, जब campaign_type की वैल्यू ACI, ACE या ACPRE हो.

स्ट्रिंग

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

यह फ़ील्ड, gbraid-एट्रिब्यूट किए गए उन विज्ञापन इवेंट के लिए उपलब्ध नहीं है जिन्हें डिटरमिनिस्टिक तरीके से एट्रिब्यूट किया जाता है (is_deterministic true है). जैसे, डीप लिंक एट्रिब्यूशन.

My App AdGroup
asset_group_id

यह वैल्यू सिर्फ़ तब दी जाती है, जब campaign_type Performance_Max हो.

संख्या

उस ऐसेट ग्रुप का अंकों वाला आईडी जिसने विज्ञापन का इवेंट जनरेट किया. यह वैल्यू यूनीक है.

123456789
creative_id

यह वैल्यू सिर्फ़ तब दी जाती है, जब campaign_type की वैल्यू नहीं ACI, ACE, ACPRE या Performance_Max हो.

संख्या

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

123456789
interaction_type

इस फ़ील्ड में हमेशा जुड़ाव की जानकारी दिखेगी.

स्ट्रिंग
is_deterministic

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

बूलियन

true, false
device_model

वह डिवाइस मॉडल जिसने विज्ञापन का इवेंट जनरेट किया.

स्ट्रिंग

sm-s936w, sm-3936w
os_version

ओएस का वह मेजर वर्शन जिसकी वजह से विज्ञापन का इवेंट हुआ.

स्ट्रिंग

14, 12
country

दो अक्षरों वाला वह देश कोड जहां विज्ञापन का इवेंट हुआ.

स्ट्रिंग

CA, US
city

वह शहर जहां विज्ञापन का इवेंट हुआ.

स्ट्रिंग

san jose, london
region

वह राज्य या प्रांत जहां विज्ञापन का इवेंट हुआ.

स्ट्रिंग

california, british columbia

जवाब के उदाहरण

डिटरमिनिस्टिक कन्वर्ज़न के लिए, जवाब का एक उदाहरण यहां दिया गया है:

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

iOS पर नॉन-डिटरमिनिस्टिक कन्वर्ज़न के लिए, जवाब का एक उदाहरण यहां दिया गया है:

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

Android पर नॉन-डिटरमिनिस्टिक कन्वर्ज़न के जवाब का एक उदाहरण यहां दिया गया है:

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

gbraid की मदद से एट्रिब्यूट किए गए iOS/Android कन्वर्ज़न के जवाब का उदाहरण यहां दिया गया है:

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

अनुरोध में गड़बड़ियां होने पर, कन्वर्ज़न ट्रैकिंग के जवाब का उदाहरण यहां दिया गया है:

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

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

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

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

ईईए से बाहर के किसी उपयोगकर्ता के लिए, Universal ऐप्लिकेशन कैंपेन के लिए कन्वर्ज़न ट्रैकिंग की पुष्टि करने वाले जवाब का उदाहरण यहां दिया गया है:

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

सर्च कैंपेन के लिए, ईईए से बाहर के किसी उपयोगकर्ता के लिए, कन्वर्ज़न ट्रैकिंग की पुष्टि करने वाले जवाब का उदाहरण यहां दिया गया है:

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

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

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

ईईए से बाहर के किसी उपयोगकर्ता के लिए, YouTube पर विज्ञापन कैंपेन के लिए कन्वर्ज़न ट्रैकिंग की पुष्टि करने वाले रिस्पॉन्स का उदाहरण यहां दिया गया है:

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


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

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

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

/pagead/conversion/app/1.1/cross_network

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

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

ज़रूरी है

जगह की जानकारी: क्वेरी

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

ज़रूरी है

जगह की जानकारी: क्वेरी

एपीआई का इस्तेमाल करने वाले व्यक्ति या कंपनी ने कन्वर्ज़न के लिए Google Ads को क्रेडिट दिया है या नहीं. 0 या 1 में से कोई एक वैल्यू दी जानी चाहिए.

क्रॉस-नेटवर्क एट्रिब्यूशन के मान्य अनुरोध का एक उदाहरण यह है:

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

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