- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- CallConversion
- CallConversionResult
- इसे आज़माएं!
दिए गए कॉल कन्वर्ज़न को प्रोसेस करता है.
थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
एचटीटीपी अनुरोध
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
customerId |
ज़रूरी है. अपलोड करने वाले ग्राहक का आईडी. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"conversions": [
{
object ( |
फ़ील्ड | |
---|---|
conversions[] |
ज़रूरी है. अपलोड किए जा रहे कन्वर्ज़न. |
partialFailure |
ज़रूरी है. सही होने पर, सही कार्रवाइयां की जाएंगी और अमान्य ऑपरेशन से गड़बड़ियां दिखेंगी. अगर गलत है, तो सभी कार्रवाइयां एक ही लेन-देन में तभी पूरी की जाएंगी, जब वे सभी मान्य हों. यह हमेशा सही पर सेट होना चाहिए. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं. |
validateOnly |
सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता है. सिर्फ़ गड़बड़ियां मिलती हैं, नतीजे नहीं. |
जवाब का मुख्य भाग
ConversionUploadService.UploadCallConversions
के लिए जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{ "partialFailureError": { object ( |
फ़ील्ड | |
---|---|
partialFailureError |
पार्शियल फ़ेलियर मोड में कन्वर्ज़न न होने की वजह से होने वाली गड़बड़ियां. कन्वर्ज़न में सभी गड़बड़ियां होने पर वापस लौटाता है. अगर कन्वर्ज़न के बाहर कोई भी गड़बड़ी होती है, जैसे कि पुष्टि करने से जुड़ी गड़बड़ियां, तो हम RPC लेवल की गड़बड़ी दिखाते हैं. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं. |
results[] |
सही तरीके से प्रोसेस किए गए कन्वर्ज़न के लिए लौटाया गया. जिन पंक्तियों के लिए गड़बड़ी मिली है उनके लिए Proto खाली रहेगा. पुष्टि करने के बाद वाले नतीजों में सिर्फ़ सही होने पर नतीजे नहीं दिखाए जाते हैं. |
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/adwords
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
CallConversion
एक कॉल कन्वर्ज़न.
जेएसओएन के काेड में दिखाना |
---|
{ "customVariables": [ { object ( |
फ़ील्ड | |
---|---|
customVariables[] |
इस कन्वर्ज़न से जुड़े कस्टम वैरिएबल. |
consent |
इवेंट के लिए सहमति की सेटिंग. |
callerId |
वह कॉलर आईडी जिससे यह कॉल किया गया था. कॉलर आईडी, E.164 फ़ॉर्मैट में होना चाहिए. इसके पहले '+' चिह्न होना चाहिए. जैसे, "+16502531234". |
callStartDateTime |
कॉल करने की तारीख. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |
conversionAction |
इस कन्वर्ज़न से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. ध्यान दें: हालांकि, इस संसाधन के नाम में ग्राहक आईडी और कन्वर्ज़न ऐक्शन आईडी शामिल होता है, लेकिन पुष्टि करने की प्रोसेस में इस ग्राहक आईडी को नज़रअंदाज़ कर दिया जाएगा और कन्वर्ज़न ऐक्शन आईडी को कन्वर्ज़न ऐक्शन के एकमात्र आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाएगा. |
conversionDateTime |
कन्वर्ज़न होने की तारीख. कॉल के समय के बाद का होना चाहिए. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |
conversionValue |
विज्ञापन देने वाले के लिए कन्वर्ज़न की वैल्यू. |
currencyCode |
कन्वर्ज़न वैल्यू से जुड़ी मुद्रा. यह ISO 4217 का तीन वर्ण वाला मुद्रा कोड है. उदाहरण के लिए: USD, EUR. |
CallConversionResult
सही तरीके से प्रोसेस किए गए CallConversionUpload के लिए जानकारी की पहचान करना.
जेएसओएन के काेड में दिखाना |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
फ़ील्ड | |
---|---|
callerId |
वह कॉलर आईडी जिससे यह कॉल किया गया था. कॉलर आईडी, E.164 फ़ॉर्मैट में होना चाहिए. इसके पहले '+' चिह्न होना चाहिए. |
callStartDateTime |
कॉल करने की तारीख. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |
conversionAction |
इस कन्वर्ज़न से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. |
conversionDateTime |
कन्वर्ज़न होने की तारीख. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00". |