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

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

स्पैम से निपटने के लिए, हमने एक स्टैंडर्ड स्पेसिफ़िकेशन तैयार किया है. यह स्पेसिफ़िकेशन, ऐप्लिकेशन इस्तेमाल करने वाले व्यक्ति की ओर से भेजे गए 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` के लिए रिज़र्व की गई कोई भी वैल्यू नहीं होनी चाहिए. अगर रिज़र्व किए गए इवेंट के नाम का इस्तेमाल किया जाता है, तो एपीआई `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 ध्यान दें: अगर कन्वर्ज़न इवेंट के समय `advertisingid` उपलब्ध नहीं है, तो कृपया `appsetid` शामिल करें. iOS idfa idfv ध्यान दें: अगर कन्वर्ज़न इवेंट के समय `idfa` उपलब्ध नहीं है, तो कृपया `idfv` शामिल करें.
`rdid`	ज़रूरी है जगह: क्वेरी यह रॉ डिवाइस आईडी को दिखाने वाली मान्य UUID स्ट्रिंग है. f10e1de2-e237-4f50-b6aa-843c45cc63d6 अगर डिवाइस आईडी मौजूद नहीं है, जैसे कि ATT के लिए सहमति न देने वाले उपयोगकर्ता का डिवाइस आईडी, तो इसे शून्य के तौर पर सेट करें. 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` क्वेरी पैरामीटर की वैल्यू. यह फ़ील्ड तब ज़रूरी होता है, जब `app_event_type` `session_start` हो और सेशन को `gclid` क्वेरी पैरामीटर वाले डीप लिंक से शुरू किया गया हो. ऐसा न होने पर, इसे हटा देना चाहिए. ध्यान दें: जब rdid (advertisingid) उपलब्ध नहीं होता है, तो gclid को ऐप्लिकेशन या सर्वर साइड पर कैश मेमोरी में सेव करना ज़रूरी होता है. ऐसा इसलिए, ताकि इसे ऐप्लिकेशन पर होने वाले आने वाले कन्वर्ज़न के साथ भेजा जा सके. इसके अलावा, इसे session_start के साथ भी भेजा जा सकता है. `gclid` केस-सेंसिटिव होता है. इसलिए, अनुरोध में इसे अपर/लोअर केस में नहीं बदला जाना चाहिए. Cj0KEQjw0dy4BRCuuL_e5M
`market_referrer_gclid`	कुछ शर्तों के मुताबिक ज़रूरी है जगह: क्वेरी डीप लिंक यूआरएल से `gclid` क्वेरी पैरामीटर की वैल्यू. इसे Play Install Referrer API के ज़रिए install_referrer वैल्यू से कैप्चर किया जाता है. ध्यान दें कि इसे ऐप्लिकेशन या सर्वर साइड पर कैश मेमोरी में सेव करना ज़रूरी है, ताकि इसे ऐप्लिकेशन पर होने वाले आने वाले कन्वर्ज़न के साथ भेजा जा सके. ऐसा न होने पर, इसे शामिल नहीं किया जाना चाहिए. `gclid` केस-सेंसिटिव होता है. इसलिए, अनुरोध में इसे अपर/लोअर केस में नहीं बदला जाना चाहिए. BX3QojHp4mY5MrJtFM_d1u
`gclid_only_request`	कुछ शर्तों के मुताबिक ज़रूरी है जगह: क्वेरी उन स्थितियों में `gclid` पर आधारित एट्रिब्यूशन के लिए आइडेंटिफ़ायर जहां rdid (advertisingid) `not` उपलब्ध है या सभी `zeroes` और `gclid` या `market_referrer_gclid` मौजूद है. rdid(advertisingid) उपलब्ध न होने पर, इसे `1` (true) पर सेट करना ज़रूरी है. डिवाइस आईडी पर आधारित अन्य फ़ील्ड, जैसे कि id_type और lat को उसी तरह पास किया जाना चाहिए. साथ ही, `gclid_only_request` के लिए इन्हें स्किप नहीं किया जाना चाहिए. 1
`gbraid`	कुछ शर्तों के मुताबिक ज़रूरी है जगह: क्वेरी पिछली बार देखा गया `gbraid` वैल्यू, डीप लिंक यूआरएल के ज़रिए भेजी जाती है. इस यूआरएल से ऐप्लिकेशन खुलता है. ध्यान दें कि इसे ऐप्लिकेशन पर कैश मेमोरी में सेव करना ज़रूरी है, ताकि इसे ऐप्लिकेशन पर होने वाले आने वाले कन्वर्ज़न के साथ भेजा जा सके. iOS और Android पर, गैर-उपयोगकर्ता लेवल के ऐप्लिकेशन कन्वर्ज़न मेज़रमेंट को चालू करने के लिए, यह फ़ील्ड भरना ज़रूरी है. `gbraid` केस-सेंसिटिव होता है. इसलिए, अनुरोध में इसे अपर/लोअर केस में नहीं बदला जाना चाहिए. ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
`app_open_source`	कुछ शर्तों के मुताबिक ज़रूरी है जगह: क्वेरी विज्ञापन पर क्लिक करके ऐप्लिकेशन के डीपलिंक या ऑर्गैनिक ऐप्लिकेशन सेशन की पहचान करने के लिए वैल्यू. इसे सिर्फ़ सेशन शुरू होने वाले इवेंट के साथ भेजना ज़रूरी है. साथ ही, इसे `"ad_click"` पर सेट करना ज़रूरी है. ऐसा तब करना होता है, जब session_start इवेंट को gbraid वाला डीपलिंक ट्रिगर करता है. इसके अलावा, इसे `"organic"` पर सेट करना ज़रूरी है. ऐसा तब करना होता है, जब session_start इवेंट को ऑर्गैनिक तौर पर ट्रिगर किया जाता है. ऐसा न होने पर, इस फ़ील्ड को खाली छोड़ दें. 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"]}}

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

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" फ़ील्ड में जानकारी देना ज़रूरी है.

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

attributed सिर्फ़ तब true दिखा सकता है, जब इवेंट को उस Google Ads खाते के कन्वर्ज़न ट्रैकिंग खाते में इंपोर्ट किया गया हो जिससे इंटरैक्शन हुआ है.

उपयोगकर्ता की सहमति के आधार पर, जवाब देने के तरीके के बारे में अहम जानकारी:
अगर कन्वर्ज़न के लिए, विज्ञापन में उपयोगकर्ता के डेटा के इस्तेमाल की सहमति मिली है और उपयोगकर्ता ने 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` की वैल्यू `null` होगी. स्ट्रिंग इस फ़ील्ड से, Google Ads के उस विज्ञापन नेटवर्क के "सबटाइप" की पहचान की जाएगी जिस पर विज्ञापन इवेंट हुआ था. प्राइमरी नेटवर्क टाइप के हिसाब से, संभावित वैल्यू अलग-अलग होती हैं. खोजें Google Search का सामान्य वर्शन GoogleSearch Google Search Partners SearchPartners डिसप्ले मोबाइल वेब पब्लिशर mGDN ऐप्लिकेशन पब्लिशर Google AdMob YouTube YouTube वीडियो नेटवर्क YouTubeVideos YouTube Search Network YouTubeSearch वीडियो पार्टनर VideoPartners GoogleTv GoogleTV वीडियो नेटवर्क GoogleTvVideos क्रॉस-नेटवर्क अलग-अलग नेटवर्क पर परफ़ॉर्मेंस मैक्स कैंपेन cross-network
`video_id`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `network_type` की वैल्यू `YouTube` पर सेट हो और `campaign_type` की वैल्यू नहीं `ACI` और `ACE` पर सेट हो. स्ट्रिंग विज्ञापन इवेंट से जुड़ा YouTube वीडियो आईडी. dQw4w9WgXcQ
`keyword`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `network_type` की वैल्यू `Search` पर सेट हो और `campaign_type` की वैल्यू नहीं `ACI` और `ACE` पर सेट हो. स्ट्रिंग विज्ञापन इवेंट से जुड़ा सर्च कीवर्ड. +food +delivery
`match_type`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `network_type` की वैल्यू `Search` पर सेट हो और `campaign_type` की वैल्यू नहीं `ACI` और `ACE` पर सेट हो. स्ट्रिंग सर्च कीवर्ड के लिए मैच टाइप. निश्चित e फ़्रेज़ p ब्रॉड b
`placement`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `network_type` की वैल्यू `Display` पर सेट हो और `campaign_type` की वैल्यू नहीं `ACI` और `ACE` पर सेट हो. स्ट्रिंग विज्ञापन इवेंट से जुड़ा प्लेसमेंट. mobileapp::1-343200656
`ad_group_id`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `campaign_type` `Performance_Max` नहीं होता है. संख्या उस विज्ञापन ग्रुप का अंकों वाला आईडी जिसने विज्ञापन इवेंट जनरेट किया. इस वैल्यू के यूनीक होने की गारंटी है. 123456789
`ad_group_name`	यह वैल्यू सिर्फ़ तब दी जाती है, जब `campaign_type` की वैल्यू `ACI`, `ACE` या `ACPRE` हो. स्ट्रिंग विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से तय किए गए विज्ञापन ग्रुप का नाम. यह उस विज्ञापन ग्रुप का नाम होता है जिसने विज्ञापन इवेंट जनरेट किया है. इस वैल्यू के यूनीक होने की गारंटी नहीं है. My App AdGroup
`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": null,
    "ad_group_name": null,
    "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": null,
    "ad_group_name": null,
    "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": null,
      "ad_group_name": null,
      "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",
    "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
}

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

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

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

एट्रिब्यूट किए गए कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण यहां दिया गया है. इसमें कन्वर्ज़न को Play + Search विज्ञापन इंटरैक्शन, दोनों के लिए एट्रिब्यूट किया गया है. हालांकि, Play + Search सीपीएस के बीच 5(2)(b) + 5(2)(c) क्रॉस-यूज़ की सहमति नहीं दी गई है:

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

एट्रिब्यूट किए गए कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण यहां दिया गया है. इसमें कन्वर्ज़न को Play + Search विज्ञापन इंटरैक्शन, दोनों के लिए एट्रिब्यूट किया गया है. साथ ही, Play + Search CPS के बीच, 5(2)(b) + 5(2)(c) के तहत क्रॉस-यूज़ की सहमति स्वीकार की गई है. यह आज के कन्वर्ज़न के व्यवहार जैसा ही है:

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

एट्रिब्यूट किए गए कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण यहां दिया गया है. इसमें कन्वर्ज़न को Play, Search, और YouTube विज्ञापन इंटरैक्शन, दोनों के लिए एट्रिब्यूट किया गया है. साथ ही, Play और Search CPS के बीच 5(2)(b) + 5(2)(c) के तहत, डेटा को क्रॉस-यूज़ करने की सहमति स्वीकार की गई है. हालांकि, YouTube CPS के लिए इसे अस्वीकार कर दिया गया है:

{
  "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": "",
    "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": null,
    "ad_group_name": "",
    "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` आइडेंटिफ़ायर. `ad_event_id` केस सेंसेटिव है. इसलिए, अनुरोध में इसे बड़े या छोटे अक्षरों में बदला नहीं जाना चाहिए.
`attributed`	ज़रूरी है जगह: क्वेरी एपीआई का इस्तेमाल करने वाले व्यक्ति या कंपनी ने Google Ads को कन्वर्ज़न का क्रेडिट दिया है या नहीं. `0` या `1` में से कोई एक वैल्यू दी जानी चाहिए.

ad_event_id

ज़रूरी है

जगह: क्वेरी

पिछले अनुरोध में एट्रिब्यूशन से जुड़े विज्ञापन इवेंट का 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 जवाब मिलेगा. इसमें कोई रिस्पॉन्स बॉडी नहीं होगी.

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

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

Android

iOS

कन्वर्ज़न ट्रैकिंग के अनुरोध से जुड़ी गाइड

Android

iOS

Android

iOS

Android

iOS

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

नमूना अनुरोध

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

खोजें

डिसप्ले

YouTube

GoogleTv

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

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

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

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

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

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

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

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

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