ऐप्लिकेशन का उपयोगकर्ता एजेंट
स्पैम से निपटने के हमारे बड़े कोशिशों के तहत, हमने एक ऐप्लिकेशन उपयोगकर्ता की ओर से, आंकड़ों/विज्ञापन प्रॉडक्ट से भेजे गए उपयोगकर्ता-एजेंट हेडर के लिए, स्टैंडर्ड के आधार पर जानकारी तैयार की है. ऐप्लिकेशन उपयोगकर्ता-एजेंट को नीचे दिए गए विवरण का पालन करने के लिए नेटिव कोड से हासिल किया जा सकता है:
name version (os_and_version; locale; device; build; Proxy)
इन फ़ील्ड की परिभाषा इस तरह है:
उपयोगकर्ता एजेंट कॉम्पोनेंट | |
---|---|
name | आंकड़े/विज्ञापन प्रॉडक्ट का नाम. ( ध्यान दें कि अगर उपयोगकर्ता एजेंट को क्लाइंट-साइड पर बनाया गया है, तो Android// Specified by API consumer. iOS// Specified by API consumer. |
version | आंकड़े/विज्ञापन प्रॉडक्ट का वर्शन.
( Android// Specified by API consumer. iOS// Specified by API consumer. |
os_and_version | ऑपरेटिंग सिस्टम और ऑपरेटिंग सिस्टम का वर्शन
जिस पर ऐप्लिकेशन चल रहा है. ( AndroidString osAndVersion = "Android " + Build.VERSION.RELEASE; iOSUIDevice *uid = [UIDevice currentDevice]; NSString *osAndVersion = [NSString stringWithFormat:@"%@ %@", [uid systemName], [uid systemVersion]]; |
locale | दो अक्षरों वाले भाषा और देश कोड को अंडरस्कोर से अलग करते हुए, डिवाइस के लिए एक आईईटीएफ़ स्थान टैग.
( AndroidString locale = Locale.getDefault(); iOSNSString *locale = [[NSLocale currentLocale] localeIdentifier] |
device | विश्लेषण/विज्ञापन प्रॉडक्ट चलाने वाले डिवाइस का नाम.
( AndroidString 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 | "बिल्ड/" उसके बाद ऑपरेटिंग सिस्टम का बिल्ड नंबर डालें.
( AndroidString build = "Build/" + Build.ID; iOS@import Darwin.sys.sysctl; NSString *build(void) { size_t bufferSize = 64; NSMutableData *buffer = [[NSMutableData alloc] initWithLength:bufferSize]; int status = sysctlbyname("kern.osversion", buffer.mutableBytes, &bufferSize, NULL, 0); if (status != 0) { return nil; } return [[NSString alloc] initWithCString:buffer.mutableBytes encoding:NSUTF8StringEncoding]; } |
ऐप्लिकेशन के उपयोगकर्ता एजेंट के सर्वर को बनाते समय, ऐप्लिकेशन के उपयोगकर्ता एजेंट के आखिर में ; Proxy
को ही शामिल करें. अगर ऐप्लिकेशन उपयोगकर्ता एजेंट को पूरी तरह से क्लाइंट-साइड
पर बनाया गया है, तो ; Proxy
को बाहर रखें. इस तरह कोई ऐप्लिकेशन उपयोगकर्ता-एजेंट हो सकता है:
- Android:
AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M; Proxy)
- iOS:
AdMob/7.10.1 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy)
कन्वर्ज़न ट्रैकिंग अनुरोध
कन्वर्ज़न ट्रैकिंग अनुरोधों का मकसद किसी ऐसे Google Ads इवेंट के बारे में Google Ads को बताना है जिसे कन्वर्ज़न के तौर पर ट्रैक किया जाना चाहिए और/या इसका इस्तेमाल रीमार्केटिंग सूची को भरने के लिए किया जा सकता है. इसमें, इवेंट से पहले हुए किसी भी क्लिक की जानकारी देने वाला मेटाडेटा भी शामिल किया जा सकता है.
सभी एपीआई कॉल www.googleadservices.com
डोमेन को किए जाते हैं. कन्वर्ज़न
अनुरोध, इस पाथ पर एचटीटीपीएस के ज़रिए POST
अनुरोध होते हैं:
/pagead/conversion/app/versionजहां version, कन्वर्ज़न ट्रैकिंग एपीआई का सही वर्शन है. फ़िलहाल,
1.0
ही मान्य वर्शन है.
एक स्टैंडर्ड ऐप्लिकेशन कन्वर्ज़न अनुरोध में ये पैरामीटर शामिल होंगे.
कन्वर्ज़न ट्रैकिंग अनुरोध | |
---|---|
dev_token |
ज़रूरी जगह: क्वेरी एपीआई उपभोक्ता को जारी किया गया यूनीक और स्टैटिक डेवलपर टोकन. Z_eErE4DkvcKjDM1OVE4c4 |
link_id |
ज़रूरी जगह: क्वेरी लिंक पहचानकर्ता, किसी खास ऐप्लिकेशन पर एपीआई उपभोक्ता के डेवलपर टोकन को बाइंड करता है. 31FF8D67E5BB5DD5029DCC2734C2F884 |
app_event_type |
ज़रूरी जगह: क्वेरी ऐप्लिकेशन इवेंट का नाम. यह फ़ील्ड एक इनूमरेशन है और सिर्फ़ नीचे दी गई वैल्यू को स्वीकार करेगा: • first_open • session_start • in_app_purchase • view_item_list • view_item • view_search_results • add_to_cart • ecommerce_purchase • custom
|
app_event_name |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी किसी भी कस्टम ऐप्लिकेशन इवेंट का नाम, जो level_achieved Level Achieved इस फ़ील्ड में, |
app_event_data |
ज़रूरी नहीं जगह: मुख्य भाग किसी भी अतिरिक्त रिच इवेंट डेटा को एक सामान्य JSON ऑब्जेक्ट मैपिंग स्ट्रिंग के तौर पर वैल्यू के साथ फ़ॉरवर्ड करें. स्वीकार की जाने वाली वैल्यू, स्ट्रिंग और स्ट्रिंग की कैटगरी होती हैं. {"level": 5, "attempts": 20} |
rdid |
ज़रूरी जगह: क्वेरी एक मान्य UUID स्ट्रिंग, जो रॉ डिवाइस आईडी को दिखाती है. f10e1de2-e237-4f50-b6aa-843c45cc63d6 अगर डिवाइस आईडी मौजूद नहीं है, जैसे कि बिना ATT वाले उपयोगकर्ता से मिला डिवाइस आईडी, तो इसे शून्य पर सेट करें. 00000000-0000-0000-0000-000000000000 |
id_type |
ज़रूरी जगह: क्वेरी
Androidadvertisingid iOSidfa |
lat |
ज़रूरी जगह: क्वेरी डिवाइस के लिए सीमित विज्ञापन की ट्रैकिंग की स्थिति.
|
app_version |
ज़रूरी जगह: क्वेरी ऐप्लिकेशन का मौजूदा वर्शन. इसे नीचे दिए गए तरीके से मानक बनाया जाना चाहिए. AndroidpackageManager.getPackageInfo(packageName(), PackageManager.GET_META_DATA).versionName iOS[[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"] 1.2.4 |
os_version |
ज़रूरी जगह: क्वेरी ऐप्लिकेशन के होस्ट OS का मौजूदा वर्शन. यह मानक के रूप में मानक होना चाहिए. Androidandroid.os.Build.VERSION.RELEASE iOS[[UIDevice currentDevice] systemVersion] |
sdk_version |
ज़रूरी जगह: क्वेरी इवेंट को मेज़र करने वाले SDK टूल का वर्शन. हालांकि, इसे खास तौर पर डीबग करने के लिए इस्तेमाल किया जाता है, इसलिए इसे रिलीज़ वाले वर्शन को ठीक वैसा ही दिखाना चाहिए जैसा वह आपके SDK रिलीज़ के साथ प्रकाशित किया जाता है. अगर ऐप्लिकेशन में SDK टूल का इस्तेमाल नहीं किया जाता, तो कृपया
1.9.5r6 |
timestamp |
ज़रूरी जगह: क्वेरी कन्वर्ज़न इवेंट का UNIX टाइमस्टैंप, कुछ ही सेकंड में माइक्रोसेकंड तक सटीक होता है. 1432681913.123456 |
value |
ज़रूरी नहीं जगह: क्वेरी अगर कोई हो, तो इवेंट की मॉनेटरी वैल्यू. इसे हमेशा मशीन से पढ़े जा सकने वाले फ़्लोटिंग पॉइंट वैल्यू के तौर पर फ़ॉर्मैट किया जाना चाहिए. इसमें वैल्यू के पूर्णांक और अंश को अलग करने के लिए दशमलव बिंदु का इस्तेमाल किया जाता है. 1.99 |
currency_code |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी
USD |
gclid |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी डीप लिंक यूआरएल से Cj0KEQjw0dy4BRCuuL_e5M |
market_referrer_gclid |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी डीप लिंक यूआरएल के BX3QojHp4mY5MrJtFM_d1u |
gclid_only_request |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी
1 |
gbraid |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी ऐप्लिकेशन को खोलने वाले डीप लिंक यूआरएल के ज़रिए आखिरी बार ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O |
app_open_source |
कुछ शर्तों के तहत ज़रूरी है जगह: क्वेरी विज्ञापन पर क्लिक करने के डीपलिंक या ऑर्गैनिक ऐप्लिकेशन सेशन को पहचानने के लिए वैल्यू. ad_click or organic |
User-Agent |
ज़रूरी जगह: हेडर ऐप्लिकेशन का उपयोगकर्ता एजेंट, जैसा कि पिछले सेक्शन में बताया गया है. AdMob/7.10.1 (Android 6.0; en_US; SM-G900F; Build/MMB29M) |
X-Forwarded-For |
ज़रूरी जगह: हेडर उस डिवाइस का सार्वजनिक IPv4 या IPv6 पता जहां इवेंट को मापा गया था. 216.58.194.174 |
सभी अनुरोध एचटीटीपीएस से भेजे जाने चाहिए. एचटीटीपी से मिले पिंग अस्वीकार कर दिए जाएंगे.
कृपया ध्यान रखें कि अगर अनुरोध का मुख्य हिस्सा खाली है (कुछ मामलों में, app_event_data
पेलोड में कोई रिच इवेंट डेटा नहीं भेजा जाता है), तो हमारे सर्वर के लिए ज़रूरी है कि आप अपने अनुरोध पर Content-Length: 0
हेडर को साफ़ तौर पर सेट करें.
सैंपल अनुरोध
कन्वर्ज़न के गैर-कस्टम इवेंट और आय की जानकारी वाले मान्य कन्वर्ज़न ट्रैकिंग अनुरोध का उदाहरण:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_code=USD Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}
गैर-कस्टम इवेंट और आय की जानकारीविज्ञापन आईडी (विज्ञापन आईडी) के साथ उपलब्ध मान्य कन्वर्ज़न ट्रैकिंग अनुरोध का उदाहरण:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=advertisingid &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_code=USD &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u &gclid=Cj0KEQjw0dy4BRCuuL_e5M &gclid_only_request=1 Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; Android,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
{"app_event_data":{"item_id":["Crayons","Markers"]}}
सेशन शुरू होने के मान्य अनुरोध का उदाहरण:
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
सेशन के लिए, सेशन स्टार्ट रीएट्रिब्यूशन अनुरोध का उदाहरण
जो डीप लिंक से शुरू हुआ:
example://product/123?gclid=Cj0KEQjw0dy4BRCuuL_e5M
POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &gclid=Cj0KEQjw0dy4BRCuuL_e5M Host: www.googleadservices.com User-Agent: MyAnalyticsCompany/1.0.0 (iOS 10.0.2; en_US; iPhone9,1; Build/13D15; Proxy) X-Forwarded-For: 216.58.194.174 Content-Type: application/json; charset=utf-8
इवेंट डेटा को कोड में बदलने का तरीका
app_event_data
बॉडी पैरामीटर के लिए, कृपया बुनियादी डेटा टाइप के लिए यहां दिए गए कन्वेंशन का इस्तेमाल करें:
फ़्लोट
- ऐप्लिकेशन लोकलाइज़ेशन के अलावा, दशमलव विभाजक के रूप में बिंदु का उपयोग करें
- मुद्रा के मान दिखाने के लिए दशमलव के बाद दो अंकों का इस्तेमाल करें, जैसे कि 2.99
- घातांकीय नोटेशन का इस्तेमाल न करें, जैसे कि 2E+9
- अंकों के ग्रुप को अलग-अलग करने के लिए, कॉमा का इस्तेमाल न करें, जैसे कि 1,000,000
- मान्य उदाहरण:
-0.5
2.99
1000000.123
Integer
- सिर्फ़ पूरे पूर्णांक मान भेजें, जिनमें दशमलव अंक न हों
- अंकों के ग्रुप को अलग-अलग करने के लिए, कॉमा का इस्तेमाल न करें, जैसे कि 10,00,000
- मान्य उदाहरण:
1000
-11
0
तारीख
- तारीख का फ़ॉर्मैट: yyyy-mm-dd
yyyy
= चार अंकों वाला साल, उदाहरण के लिए, 2016mm
= दो अंकों का महीना, उदाहरण के लिए सितंबर के लिए 09dd
= दो अंकों वाला दिन, उदाहरण के लिए, महीने के 23वें दिन के लिए 23
- हमेशा ऊपर दिए गए अंकों की संख्या भेजें. उदाहरण के लिए, अगर महीने की पांचवीं तारीख के लिए dd का मान भेजा जा रहा है, तो
05
भेजें. - मान्य उदाहरण:
"2016-09-23"
"1990-12-31"
- तारीख का फ़ॉर्मैट: yyyy-mm-dd
टाइमस्टैंप
- समय का फ़ॉर्मैट: यूटीसी समय क्षेत्र में परिभाषित यूनिक्स/एपॉच टाइमस्टैंप, जिसमें माइक्रोसेकंड तक सटीक वैल्यू होती है
- मान्य उदाहरण:
- बुधवार के लिए
1478713087
, 09 नवंबर 2016 17:38:07 जीएमटी - बुधवार, 07 जनवरी 2004 22:19:42.123 जीएमटी के लिए
1073513982.123000
- बुधवार के लिए
रेंज
- प्रिमिटिव वैल्यू की स्ट्रिंग (स्ट्रिंग, नंबर, और बूलियन) ही भेजें
- मान्य उदाहरण:
[123, 456, 789]
["abc"]
कन्वर्ज़न ट्रैकिंग रिस्पॉन्स
कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का फ़ॉर्मैट नीचे दिया गया है:
{ "ad_events": [<ad event objects>], "errors": [<error strings>], "attributed": true|false }
ad_events और गड़बड़ियों की कैटगरी खाली हो सकती है.
हमें उम्मीद है कि गड़बड़ियों की जानकारी, मशीन से पढ़े जा सकने वाले गड़बड़ी कोड के तौर पर दिखेगी, जैसे कि invalid_timestamp
.
विज्ञापन इवेंट, ऐप्लिकेशन एट्रिब्यूशन की मुख्य चीज़ें हैं. इनमें ये प्रॉपर्टी शामिल होंगी.
कन्वर्ज़न ट्रैकिंग रिस्पॉन्स | |
---|---|
ad_event_id |
हमेशा प्रज़ेंट करें स्ट्रिंग
Q2owS0VRancwZHk0QlJDdXVMX2U1TQ |
conversion_metric |
हमेशा प्रज़ेंट करें स्ट्रिंग एट्रिब्यूशन के लिए इस्तेमाल की गई कन्वर्ज़न मेट्रिक. शुरुआत में हम एक कन्वर्ज़न मेट्रिक का इस्तेमाल करेंगे. conversion |
timestamp |
हमेशा प्रज़ेंट करें संख्या विज्ञापन इवेंट के लिए UNIX टाइमस्टैंप, सेकंड में माइक्रोसेकंड के बाद सटीक होता है. इस वैल्यू का इस्तेमाल, लास्ट क्लिक एट्रिब्यूशन के लिए किया जाना चाहिए. 1432681913.123456 |
campaign_type |
हमेशा प्रज़ेंट करें स्ट्रिंग यह फ़ील्ड, विज्ञापन इवेंट बनाने वाले कैंपेन के टाइप की पहचान करेगा. संभावित वैल्यू इस तरह होती हैं. ACI ACE Search Display Video Shopping Hotel Performance_Max Other ACI, ऐप्लिकेशन इंस्टॉल करने का बढ़ावा देने वाले कैंपेन का छोटा नाम है. ACE, ऐप्लिकेशन में तरह-तरह के काम करने के लिए बढ़ावा देने वाले कैंपेन का छोटा नाम है. |
campaign_id |
हमेशा प्रज़ेंट करें संख्या उस कैंपेन का अंकों वाला कैंपेन आईडी जिसने विज्ञापन इवेंट बनाया था. यह वैल्यू यूनीक होनी चाहिए. 123456789 |
campaign_name |
हमेशा प्रज़ेंट करें स्ट्रिंग विज्ञापन देने वाले के लिए तय किए गए उस कैंपेन का नाम जो विज्ञापन इवेंट बनाता है. इस वैल्यू के यूनीक होने की गारंटी नहीं है. Occasional Gamers (Video) |
ad_type |
हमेशा प्रज़ेंट करें स्ट्रिंग विज्ञापन इवेंट दिखाने वाले विज्ञापन का टाइप. इस वैल्यू का इस्तेमाल, नीचे दी गई अलग-अलग तरह की इन्वेंट्री में अंतर करने के लिए किया जा सकता है. ऐप्लिकेशन प्रमोशनClickToDownloadऐप्लिकेशन यूज़र ऐक्टिविटी AppDeepLinkऐप्लिकेशन यूज़र ऐक्टिविटी — इंस्टॉल करें और जारी रखें AppDeepLinkContinueअन्य सभी वैल्यू के लिए कैच-ऑल Unknown |
external_customer_id |
हमेशा प्रज़ेंट करें संख्या विज्ञापन देने वाले का पहचानकर्ता, जो उस कैंपेन का मालिक होता है जिसने विज्ञापन इवेंट बनाया है. इस वैल्यू का इस्तेमाल, Google Ads खातों में अंतर करने के लिए किया जा सकता है. 123456789 |
location |
हमेशा प्रज़ेंट करें संख्या विज्ञापन इवेंट की भौगोलिक जगह के लिए लोकेशन आईडी कोड. लोकेशन कोड को समझने के लिए, Google Ads API का रेफ़रंस देखें. |
network_type |
हमेशा प्रज़ेंट करें स्ट्रिंग यह फ़ील्ड, Google Ads विज्ञापन नेटवर्क की पहचान करेगा, जिसमें विज्ञापन इवेंट हुआ है. इस तरह की वैल्यू हो सकती हैं. Search Display YouTube |
network_subtype |
जब स्ट्रिंग यह फ़ील्ड Google Ads विज्ञापन नेटवर्क के "उप-प्रकार" की पहचान करेगा. संभावित नेटवर्क के टाइप के आधार पर, संभावित वैल्यू अलग-अलग हो सकती हैं. खोजेंसामान्य Google SearchGoogleSearchGoogle सर्च पार्टनर SearchPartners डिसप्लेमोबाइल वेब पब्लिशरmGDNऐप्लिकेशन पब्लिशर Google AdMob YouTubeYouTube वीडियो नेटवर्कYouTubeVideosYouTube सर्च नेटवर्क YouTubeSearchवीडियो पार्टनर VideoPartners |
video_id |
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब स्ट्रिंग विज्ञापन इवेंट से जुड़ा YouTube वीडियो आईडी. dQw4w9WgXcQ |
keyword |
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब स्ट्रिंग विज्ञापन इवेंट से जुड़ा खोज कीवर्ड. +food +delivery |
match_type |
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब स्ट्रिंग सर्च कीवर्ड के लिए मैच टाइप. सटीकeवाक्यांश pबड़ा b |
placement |
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब स्ट्रिंग विज्ञापन इवेंट से जुड़ा प्लेसमेंट. mobileapp::1-343200656 |
ad_group_id |
हमेशा प्रज़ेंट करें संख्या विज्ञापन इवेंट के साथ बनाए गए विज्ञापन ग्रुप का न्यूमेरिक आईडी. यह वैल्यू यूनीक है. 123456789 |
ad_group_name |
यह सुविधा सिर्फ़ तब उपलब्ध होती है, जब स्ट्रिंग विज्ञापन इवेंट बनाने वाले विज्ञापन ग्रुप का नाम, जिसे विज्ञापन देने वाले ने तय किया है. इस वैल्यू के यूनीक होने की गारंटी नहीं है. My App AdGroup |
creative_id |
यह सुविधा सिर्फ़ तब दी जाती है, जब संख्या क्रिएटिव विज्ञापन यूनिट का वह न्यूमेरिक आईडी जिसने विज्ञापन इवेंट बनाया. यह वैल्यू यूनीक है. 123456789 |
interaction_type |
यह फ़ील्ड हमेशा जुड़ाव वाला रहेगा. स्ट्रिंग |
जवाब के उदाहरण
अनुरोध में गड़बड़ियों के होने पर, कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:
{ "ad_events": [], "errors": ["INVALID_CURRENCY_CODE"], "attributed": false }
नेगेटिव कन्वर्ज़न ट्रैकिंग का उदाहरण:
{ "ad_events": [], "errors": [], "attributed": false }
सभी कन्वर्ज़न ट्रैकिंग अनुरोधों के लिए, कन्वर्ज़न ट्रैकिंग रिस्पॉन्स दिखेगा.
यूनिवर्सल ऐप्लिकेशन कैंपेन के लिए, पॉज़िटिव कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "ACI", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Search", "network_subtype": "GoogleSearch", "video_id": null, "keyword": null, "match_type": null, "placement": null, "ad_group_id": null, "ad_group_name": "", "creative_id": null, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
सर्च कैंपेन के लिए, बेहतर कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Search", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Search", "network_subtype": "GoogleSearch", "video_id": null, "keyword": "+space +birds", "match_type": "b", "placement": null, "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
डिसप्ले कैंपेन के लिए, स्वीकार किए जाने वाले कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Display", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "Display", "network_subtype": "mGDN", "video_id": null, "keyword": null, "match_type": null, "placement": "mobile-app::2-343200656", "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
किसी YouTube कैंपेन के लिए, स्वीकार किए जाने वाले कन्वर्ज़न ट्रैकिंग रिस्पॉन्स का एक उदाहरण है:
{ "ad_events": [{ "ad_event_id": "Q2owS0VRancwZHk0QlJDdXVMX2U1TQ", "conversion_metric": "conversion", "interaction_type": "engagement", "campaign_type": "Video", "campaign_id": 123456789, "campaign_name": "My App Campaign", "ad_type": "ClickToDownload", "external_customer_id": 123456789, "location": 21144, "network_type": "YouTube", "network_subtype": "YouTubeVideos", "video_id": "dQw4w9WgXcQ", "keyword": null, "match_type": null, "placement": null, "ad_group_id": 123456789, "ad_group_name": "My App AdGroup", "creative_id": 123456789, "timestamp": 1432681913.123456 }], "errors": [], "attributed": true }
क्रॉस-नेटवर्क एट्रिब्यूशन अनुरोध
जब Google Ads कन्वर्ज़न ट्रैकिंग के अनुरोध का सकारात्मक जवाब देता है, तो लास्ट क्लिक की पहचान करने के बाद, एपीआई उपभोक्ता को अपने क्रॉस-नेटवर्क एट्रिब्यूशन फ़ैसले की Google Ads को सूचना देनी होती है.
क्रॉस-नेटवर्क एट्रिब्यूशन का अनुरोध मूल कन्वर्ज़न ट्रैकिंग अनुरोध से मिलता-जुलता है, लेकिन अनुरोध का पाथ ऐसा ही होता है:
/pagead/conversion/app/1.0/cross_network
और ज़रूरी दो पैरामीटर जोड़ना:
क्रॉस-नेटवर्क एट्रिब्यूशन अनुरोध | |
---|---|
ad_event_id |
ज़रूरी जगह: क्वेरी पिछले अनुरोध में एट्रिब्यूशन से जुड़े विज्ञापन इवेंट का
|
attributed |
ज़रूरी जगह: क्वेरी एपीआई इस्तेमाल करने वाले लोगों को, Google Ads को कन्वर्ज़न के लिए क्रेडिट मिला है या नहीं. |
मान्य क्रॉस-नेटवर्क एट्रिब्यूशन अनुरोध का उदाहरण:
POST /pagead/conversion/app/1.0/cross_network ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=custom &app_event_name=level_achieved &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D &id_type=idfa &lat=0 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 ×tamp=1432681913.123456 &value=1.99 ¤cy_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 जवाब देगा.