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

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

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

ऐप्लिकेशन कन्वर्ज़न के स्टैंडर्ड अनुरोध में, 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 फ़ील्ड में स्वीकार नहीं किया गया है. इस फ़ील्ड में, 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}
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

ज़रूरी है

जगह: क्वेरी

यह रॉ डिवाइस आईडी को दिखाने वाली मान्य UUID स्ट्रिंग है.

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

ज़रूरी है

जगह: क्वेरी

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

नमूना अनुरोध

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

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

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

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

हमेशा मौजूद

संख्या

विज्ञापन इवेंट होने का 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 सर्च पार्टनर 
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

इस फ़ील्ड में हमेशा 'उपयोगकर्ता जुड़ाव' दिखेगा.

स्ट्रिंग
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": null,
    "ad_group_name": 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": null,
    "ad_group_name": 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": null,
      "ad_group_name": 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",
    "is_deterministic": true
    "timestamp": 0.000000,
  }],
  "errors": [],
  "attributed": true
  "warnings" [],
}

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

{
  "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.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 जवाब मिलेगा. इसमें कोई रिस्पॉन्स बॉडी नहीं होगी.