- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- इसे आज़माएं!
दिए गए कन्वर्ज़न में बदलाव को प्रोसेस करता है.
थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. अपलोड करने वाले ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"conversionAdjustments": [
{
object ( |
फ़ील्ड | |
---|---|
conversionAdjustments[] |
ज़रूरी है. अपलोड किए जा रहे कन्वर्ज़न में बदलाव. |
partialFailure |
ज़रूरी है. सही होने पर, सही कार्रवाइयां की जाएंगी और अमान्य ऑपरेशन से गड़बड़ियां दिखेंगी. अगर गलत है, तो सभी कार्रवाइयां एक ही लेन-देन में तभी पूरी की जाएंगी, जब वे सभी मान्य हों. यह हमेशा सही पर सेट होना चाहिए. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं. |
validateOnly |
सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता है. सिर्फ़ गड़बड़ियां मिलती हैं, नतीजे नहीं. |
jobId |
ज़रूरी नहीं. जॉब आईडी सेट करने के लिए वैकल्पिक इनपुट. अगर दिया गया हो, तो यह 2^31 से कम की एक नेगेटिव संख्या होनी चाहिए. अगर यह फ़ील्ड नहीं दिया जाता है, तो एपीआई [2^31, (2^63)-1] की रेंज में जॉब आईडी जनरेट करेगा. एपीआई इस अनुरोध की वैल्यू, |
जवाब का मुख्य भाग
ConversionAdjustmentUploadService.UploadConversionAdjustments
के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "partialFailureError": { object ( |
फ़ील्ड | |
---|---|
partialFailureError |
कुछ ऐसी गड़बड़ियां जो कुछ हद तक गड़बड़ी वाले मोड में, कन्वर्ज़न में बदलाव न कर पाने से जुड़ी हैं. अडजस्टमेंट में सभी गड़बड़ियां होने पर, वैल्यू कैलकुलेट की जाती है. अगर अडजस्टमेंट के बाद कोई गड़बड़ी होती है (उदाहरण के लिए, पुष्टि करने से जुड़ी गड़बड़ियां), तो हम RPC लेवल की गड़बड़ी दिखाते हैं. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं. |
results[] |
प्रोसेस किए गए कन्वर्ज़न में बदलाव के लिए लौटाया गया. जिन पंक्तियों के लिए गड़बड़ी मिली है उनके लिए Proto खाली रहेगा. पुष्टि करने के बाद वाले नतीजों में सिर्फ़ सही होने पर नतीजे नहीं दिखाए जाते हैं. |
jobId |
अपलोड बैच के लिए जॉब आईडी. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
ConversionAdjustment
कन्वर्ज़न में बदलाव.
जेएसओएन के काेड में दिखाना |
---|
{ "gclidDateTimePair": { object ( |
फ़ील्ड | |
---|---|
gclidDateTimePair |
अडजस्टमेंट के लिए, ऐसे कन्वर्ज़न की पहचान खास तौर पर करें जिसे बिना ऑर्डर आईडी के रिपोर्ट किया गया था. अगर AdjustType ENHANCEMENT है, तो यह वैल्यू ज़रूरी नहीं है. हालांकि, इसे ऑर्डर आईडी के साथ सेट किया जा सकता है. |
adjustmentType |
अडजस्टमेंट का टाइप. |
restatementValue |
कन्वर्ज़न वैल्यू को फिर से बताने के लिए ज़रूरी जानकारी. रीस्टेटमेंट के लिए ज़रूरी है. दावा वापसी के लिए नहीं दिया जाना चाहिए. दावा वापस लेने के लिए, गड़बड़ी का मैसेज दिया जाएगा. ध्यान दें: अगर आपको बदले गए मान के साथ दूसरा रीस्टेटमेंट अपलोड करना है, तो इसमें नया और सबसे हाल का बदलाव होने का समय होना चाहिए. अगर ऐसा नहीं किया जाता है, तो इसे पिछले रीस्टेटमेंट का डुप्लीकेट माना जाएगा और इसे अनदेखा किया जाएगा. |
userIdentifiers[] |
ओरिजनल कन्वर्ज़न को बेहतर बनाने के लिए, यूज़र आइडेंटिफ़ायर. कन्वर्ज़न अडजस्टमेंट अपलोड करने वाली सेवा, बेहतर बनाए गए विज्ञापनों में सिर्फ़ उपयोगकर्ता आइडेंटिफ़ायर को स्वीकार करती है. हर बेहतर बनाने के लिए, उपयोगकर्ता आइडेंटिफ़ायर की ज़्यादा से ज़्यादा संख्या पांच है. |
orderId |
अडजस्ट किए जाने वाले कन्वर्ज़न का ऑर्डर आईडी. अगर कन्वर्ज़न को किसी ऑर्डर आईडी के साथ रिपोर्ट किया गया है, तो उस ऑर्डर आईडी को यहां आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाना चाहिए. बेहतर बनाने के लिए ऑर्डर आईडी डालना ज़रूरी है. |
conversionAction |
इस कन्वर्ज़न ऐक्शन से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. ध्यान दें: हालांकि, इस संसाधन के नाम में ग्राहक आईडी और कन्वर्ज़न ऐक्शन आईडी शामिल होता है, लेकिन पुष्टि करने की प्रोसेस में इस ग्राहक आईडी को नज़रअंदाज़ कर दिया जाएगा और कन्वर्ज़न ऐक्शन आईडी को कन्वर्ज़न ऐक्शन के एकमात्र आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाएगा. |
adjustmentDateTime |
वह तारीख और समय जब अडजस्टमेंट हुआ. conversionDateTime के बाद की होनी चाहिए. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |
userAgent |
ओरिजनल कन्वर्ज़न को बेहतर बनाने के लिए उपयोगकर्ता एजेंट. यह आपके उपयोगकर्ताओं के एचटीटीपी अनुरोध के हेडर में तब मिल सकता है, जब वे आपके वेब पेज पर ग्राहक में बदल जाएंगे. उदाहरण के लिए, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". उपयोगकर्ता एजेंट की जानकारी सिर्फ़ उपयोगकर्ता आइडेंटिफ़ायर की मदद से बेहतर बनाकर दी जा सकती है. यह मूल कन्वर्ज़न भेजने वाले अनुरोध के उपयोगकर्ता एजेंट से मेल खाना चाहिए, ताकि कन्वर्ज़न और बेहतर बनाने की प्रोसेस, दोनों को एक ही डिवाइस को एट्रिब्यूट किया जा सके या दोनों को क्रॉस-डिवाइस के तौर पर एट्रिब्यूट किया जा सके. |
GclidDateTimePair
उस कन्वर्ज़न की पहचान करता है जिसे बिना ऑर्डर आईडी के रिपोर्ट किया गया था.
जेएसओएन के काेड में दिखाना |
---|
{ "gclid": string, "conversionDateTime": string } |
फ़ील्ड | |
---|---|
gclid |
इस अडजस्टमेंट के लिए, ओरिजनल कन्वर्ज़न से जुड़ा Google क्लिक आईडी (gclid). |
conversionDateTime |
वह तारीख और समय जब इस अडजस्टमेंट के लिए मूल कन्वर्ज़न हुआ था. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |
ConversionAdjustmentType
विज्ञापन देने वाले, पहले से रिपोर्ट किए गए कन्वर्ज़न में बदलाव करने के लिए, अलग-अलग कार्रवाइयां कर सकते हैं. दावा वापस लेने पर, कन्वर्ज़न नेगेटिव हो जाएगा. रीस्टेटमेंट से कन्वर्ज़न की वैल्यू बदल जाती है.
Enums | |
---|---|
UNSPECIFIED |
जानकारी नहीं दी गई. |
UNKNOWN |
इस वर्शन में ऐसी वैल्यू दिखाता है जिसकी जानकारी नहीं है. |
RETRACTION |
किसी कन्वर्ज़न को घटाता है, ताकि उसकी कुल वैल्यू और संख्या दोनों शून्य हो जाएं. |
RESTATEMENT |
कन्वर्ज़न की वैल्यू बदलता है. |
ENHANCEMENT |
दिए गए उपयोगकर्ता आइडेंटिफ़ायर और उपयोगकर्ता एजेंट के साथ मौजूदा कन्वर्ज़न को जोड़ता है. Google इनका इस्तेमाल करके कन्वर्ज़न की संख्या को बेहतर बना सकता है. |
RestatementValue
कन्वर्ज़न वैल्यू को दोहराने के लिए ज़रूरी जानकारी शामिल होती है.
जेएसओएन के काेड में दिखाना |
---|
{ "adjustedValue": number, "currencyCode": string } |
फ़ील्ड | |
---|---|
adjustedValue |
फिर से जनरेट की गई कन्वर्ज़न वैल्यू. यह रीस्टेटमेंट के बाद होने वाले कन्वर्ज़न की वैल्यू है. उदाहरण के लिए, किसी कन्वर्ज़न की वैल्यू को 100 से 70 में बदलने के लिए, 70 की अडजस्ट की गई वैल्यू रिपोर्ट की जानी चाहिए. ध्यान दें: अगर आपको बदले गए मान के साथ दूसरा रीस्टेटमेंट अपलोड करना है, तो इसमें नया और सबसे हाल का बदलाव होने का समय होना चाहिए. अगर ऐसा नहीं किया जाता है, तो इसे पिछले रीस्टेटमेंट का डुप्लीकेट माना जाएगा और इसे अनदेखा किया जाएगा. |
currencyCode |
बदली गई वैल्यू की मुद्रा. अगर वैल्यू नहीं दी जाती है, तो कन्वर्ज़न ऐक्शन के लिए सेट की गई डिफ़ॉल्ट मुद्रा का इस्तेमाल किया जाता है. अगर मुद्रा सेट नहीं की गई है, तो खाते की मुद्रा का इस्तेमाल किया जाता है. यह ISO 4217 का तीन वर्ण वाला मुद्रा कोड होता है, जैसे कि USD या EUR. |
ConversionAdjustmentResult
सही तरीके से प्रोसेस किए गए कन्वर्ज़न अडजस्टमेंट की पहचान करने के बारे में जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "gclidDateTimePair": { object ( |
फ़ील्ड | |
---|---|
gclidDateTimePair |
कन्वर्ज़न का GCLID और कन्वर्ज़न की तारीख का समय. |
orderId |
अडजस्ट किए जाने वाले कन्वर्ज़न का ऑर्डर आईडी. |
adjustmentType |
अडजस्टमेंट का टाइप. |
conversionAction |
इस कन्वर्ज़न ऐक्शन से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. |
adjustmentDateTime |
वह तारीख और समय जब अडजस्टमेंट हुआ. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |