चेतावनी: आप एपीआई के REST इंटरफ़ेस के बारे में दस्तावेज़ देख रहे हैं. हमारी ज़्यादातर आधिकारिक क्लाइंट लाइब्रेरी, gRPC का इस्तेमाल करती हैं. ज़्यादा जानकारी के लिए, REST के बारे में जानकारी देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

Method: customers.uploadClickConversions

एचटीटीपी अनुरोध
पाथ पैरामीटर
अनुरोध का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
जवाब का मुख्य हिस्सा
- JSON फ़ॉर्मैट में दिखाना
अनुमति के दायरे
ClickConversion
- JSON फ़ॉर्मैट में दिखाना
ExternalAttributionData
- JSON फ़ॉर्मैट में दिखाना
CartData
- JSON फ़ॉर्मैट में दिखाना
आइटम
- JSON फ़ॉर्मैट में दिखाना
ConversionEnvironment
ClickConversionResult
- JSON फ़ॉर्मैट में दिखाना
इसे आज़माएं!

दिए गए क्लिक कन्वर्ज़न को प्रोसेस करता है.

थ्रो की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError PartialFailureError QuotaError RequestError

एचटीटीपी अनुरोध

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadClickConversions

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ के पैरामीटर

पैरामीटर

पैरामीटर
`customerId`	`string` ज़रूरी है. अपलोड करने वाले ग्राहक का आईडी.

customerId

string

ज़रूरी है. अपलोड करने वाले ग्राहक का आईडी.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{ "conversions": [ { object (`ClickConversion`) } ], "partialFailure": boolean, "validateOnly": boolean, "debugEnabled": boolean }

फ़ील्ड
`conversions[]`	`object (ClickConversion)` ज़रूरी है. अपलोड किए जा रहे कन्वर्ज़न.
`partialFailure`	`boolean` ज़रूरी है. सही होने पर, सही कार्रवाइयां की जाएंगी और अमान्य ऑपरेशन से गड़बड़ियां दिखेंगी. अगर गलत है, तो सभी कार्रवाइयां एक ही लेन-देन में तभी पूरी की जाएंगी, जब वे सभी मान्य हों. यह हमेशा सही पर सेट होना चाहिए. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं.
`validateOnly`	`boolean` सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता है. सिर्फ़ गड़बड़ियां मिलती हैं, नतीजे नहीं.
`debugEnabled`	`boolean` सही होने पर, एपीआई अपलोड की सभी जांच करेगा और कोई गड़बड़ी मिलने पर उसे दिखाएगा. अगर यह गलत है, तो यह सिर्फ़ बुनियादी इनपुट की पुष्टि करेगा और बाद में अपलोड की जांच को छोड़ देगा. दिए गए `userIdentifiers` के लिए कोई क्लिक न मिलने पर भी, सही नतीजे दिखाए जाएंगे. इस सेटिंग का असर, सिर्फ़ उन लीड अपलोड के लिए बेहतर कन्वर्ज़न ट्रैकिंग पर पड़ता है जो `GCLID`, `GBRAID` या `WBRAID` के बजाय `userIdentifiers` का इस्तेमाल करते हैं. लीड के लिए बेहतर कन्वर्ज़न ट्रैकिंग अपलोड करते समय, आपको एपीआई में सभी कन्वर्ज़न इवेंट अपलोड करने चाहिए. इनमें ऐसे कन्वर्ज़न इवेंट भी शामिल होने चाहिए जो Google Ads कैंपेन से न मिले हों. अगर इस फ़ील्ड को `true` पर सेट किया गया है, तो ऐसे इवेंट को अपलोड करने पर `CLICK_NOT_FOUND` गड़बड़ी होगी जो Google Ads कैंपेन से नहीं है. इस तरह के इवेंट के लिए ये गड़बड़ियां हो सकती हैं. इसलिए, इस फ़ील्ड को `false` पर सेट करें, ताकि यह पक्का किया जा सके कि आपके अपलोड सही तरीके से फ़ॉर्मैट किए गए हैं. हालांकि, उन सभी कन्वर्ज़न में `CLICK_NOT_FOUND` गड़बड़ियों को अनदेखा करें जो किसी Google Ads कैंपेन से नहीं हैं. इससे, सिर्फ़ उन गड़बड़ियों पर फ़ोकस किया जा सकेगा जिन्हें ठीक किया जा सकता है. डिफ़ॉल्ट रूप से गलत पर सेट होती है.

जवाब का मुख्य भाग

ConversionUploadService.UploadClickConversions के लिए जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{ "partialFailureError": { object (`Status`) }, "results": [ { object (`ClickConversionResult`) } ], "jobId": string }

फ़ील्ड

फ़ील्ड
`partialFailureError`	`object (Status)` पार्शियल फ़ेलियर मोड में कन्वर्ज़न न होने की वजह से होने वाली गड़बड़ियां. कन्वर्ज़न में सभी गड़बड़ियां होने पर वापस लौटाता है. अगर कन्वर्ज़न के बाहर कोई भी गड़बड़ी होती है, जैसे कि पुष्टि करने से जुड़ी गड़बड़ियां, तो हम RPC लेवल की गड़बड़ी दिखाते हैं. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं.
`results[]`	`object (ClickConversionResult)` सही तरीके से प्रोसेस किए गए कन्वर्ज़न के लिए लौटाया गया. जिन पंक्तियों के लिए गड़बड़ी मिली है उनके लिए Proto खाली रहेगा. पुष्टि करने के बाद वाले नतीजों में सिर्फ़ सही होने पर नतीजे नहीं दिखाए जाते हैं.
`jobId`	`string (int64 format)` अपलोड बैच के लिए जॉब आईडी.

partialFailureError

object (Status)

पार्शियल फ़ेलियर मोड में कन्वर्ज़न न होने की वजह से होने वाली गड़बड़ियां. कन्वर्ज़न में सभी गड़बड़ियां होने पर वापस लौटाता है. अगर कन्वर्ज़न के बाहर कोई भी गड़बड़ी होती है, जैसे कि पुष्टि करने से जुड़ी गड़बड़ियां, तो हम RPC लेवल की गड़बड़ी दिखाते हैं. ऐप्लिकेशन पूरी न होने के बारे में ज़्यादा जानकारी के लिए, https://developers.google.com/google-ads/api/docs/best-practices/partial-failures पर जाएं.

results[]

object (ClickConversionResult)

सही तरीके से प्रोसेस किए गए कन्वर्ज़न के लिए लौटाया गया. जिन पंक्तियों के लिए गड़बड़ी मिली है उनके लिए Proto खाली रहेगा. पुष्टि करने के बाद वाले नतीजों में सिर्फ़ सही होने पर नतीजे नहीं दिखाए जाते हैं.

jobId

string (int64 format)

अपलोड बैच के लिए जॉब आईडी.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

https://www.googleapis.com/auth/adwords

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

ClickConversion

एक क्लिक कन्वर्ज़न.

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "gbraid": string, "wbraid": string, "externalAttributionData": { object (`ExternalAttributionData`) }, "customVariables": [ { object (`CustomVariable`) } ], "cartData": { object (`CartData`) }, "userIdentifiers": [ { object (`UserIdentifier`) } ], "conversionEnvironment": enum (`ConversionEnvironment`), "gclid": string, "conversionAction": string, "conversionDateTime": string, "conversionValue": number, "currencyCode": string, "orderId": string }

{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}

फ़ील्ड
`gbraid`	`string` ऐप्लिकेशन कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर.
`wbraid`	`string` यह वेब कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर है.
`externalAttributionData`	`object (ExternalAttributionData)` बाहर से एट्रिब्यूट किए गए कन्वर्ज़न के बारे में अतिरिक्त डेटा. यह फ़ील्ड बाहर से एट्रिब्यूट किए गए कन्वर्ज़न ऐक्शन के साथ कन्वर्ज़न के लिए ज़रूरी है, लेकिन इसे किसी और तरीके से सेट नहीं किया जाना चाहिए.
`customVariables[]`	`object (CustomVariable)` इस कन्वर्ज़न से जुड़े कस्टम वैरिएबल.
`cartData`	`object (CartData)` इस कन्वर्ज़न से जुड़ा कार्ट डेटा.
`userIdentifiers[]`	`object (UserIdentifier)` इस कन्वर्ज़न से जुड़े उपयोगकर्ता आइडेंटिफ़ायर. कन्वर्ज़न अपलोड करने के लिए, सिर्फ़ हैश किए गए ईमेल और hashedPhoneNumber की सुविधा इस्तेमाल की जा सकती है. हर कन्वर्ज़न के लिए, उपयोगकर्ता आइडेंटिफ़ायर की ज़्यादा से ज़्यादा संख्या पांच होती है.
`conversionEnvironment`	`enum (ConversionEnvironment)` वह परिवेश जिस पर इस कन्वर्ज़न को रिकॉर्ड किया गया था, उदाहरण के लिए, ऐप्लिकेशन या वेब.
`gclid`	`string` इस कन्वर्ज़न से जुड़ा Google क्लिक आईडी (gclid).
`conversionAction`	`string` इस कन्वर्ज़न से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. ध्यान दें: हालांकि, इस संसाधन के नाम में ग्राहक आईडी और कन्वर्ज़न ऐक्शन आईडी शामिल होता है, लेकिन पुष्टि करने की प्रोसेस में इस ग्राहक आईडी को नज़रअंदाज़ कर दिया जाएगा और कन्वर्ज़न ऐक्शन आईडी को कन्वर्ज़न ऐक्शन के एकमात्र आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाएगा.
`conversionDateTime`	`string` कन्वर्ज़न होने की तारीख. क्लिक किए जाने के समय के बाद का होना चाहिए. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+\|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00".
`conversionValue`	`number` विज्ञापन देने वाले के लिए कन्वर्ज़न की वैल्यू.
`currencyCode`	`string` कन्वर्ज़न वैल्यू से जुड़ी मुद्रा. यह ISO 4217 का तीन वर्ण वाला मुद्रा कोड है. उदाहरण के लिए: USD, EUR.
`orderId`	`string` कन्वर्ज़न से जुड़ा ऑर्डर आईडी. एक ऑर्डर आईडी का इस्तेमाल हर कन्वर्ज़न कार्रवाई के सिर्फ़ एक कन्वर्ज़न के लिए किया जा सकता है.

ExternalAttributionData

इसमें बाहर से एट्रिब्यूट किए गए कन्वर्ज़न के बारे में ज़्यादा जानकारी शामिल होती है.

जेएसओएन के काेड में दिखाना
{ "externalAttributionCredit": number, "externalAttributionModel": string }

फ़ील्ड

फ़ील्ड
`externalAttributionCredit`	`number` Google Ads क्लिक को एट्रिब्यूट किए गए कन्वर्ज़न का वह हिस्सा दिखाता है.
`externalAttributionModel`	`string` एट्रिब्यूशन मॉडल का नाम बताता है.

externalAttributionCredit

number

Google Ads क्लिक को एट्रिब्यूट किए गए कन्वर्ज़न का वह हिस्सा दिखाता है.

externalAttributionModel

string

एट्रिब्यूशन मॉडल का नाम बताता है.

CartData

इसमें कार्ट डेटा के बारे में ज़्यादा जानकारी होती है.

जेएसओएन के काेड में दिखाना
{ "merchantId": string, "feedCountryCode": string, "feedLanguageCode": string, "localTransactionCost": number, "items": [ { object (`Item`) } ] }

फ़ील्ड
`merchantId`	`string (int64 format)` Merchant Center का आईडी, जहां आइटम की जानकारी अपलोड की गई है.
`feedCountryCode`	`string` उस फ़ीड से जुड़ा देश कोड जहां सामान अपलोड किए गए हैं.
`feedLanguageCode`	`string` उस फ़ीड से जुड़ा भाषा कोड जहां आइटम अपलोड किए जाते हैं.
`localTransactionCost`	`number` पूरे कार्ट के लिए सभी ट्रांजैक्शन पर मिलने वाली सभी छूट, जैसे कि मुफ़्त शिपिंग और कूपन की छूट. मुद्रा कोड, ClickConversion मैसेज के जैसा ही होता है.
`items[]`	`object (Item)` खरीदे गए आइटम का डेटा.

आइटम

इसमें खरीदे गए आइटम का डेटा होता है.

जेएसओएन के काेड में दिखाना
{ "productId": string, "quantity": integer, "unitPrice": number }

फ़ील्ड

फ़ील्ड
`productId`	`string` आइटम का शॉपिंग आईडी. यह Merchant Center के प्रॉडक्ट आइडेंटिफ़ायर से मेल खाना चाहिए.
`quantity`	`integer` बेचे गए आइटम की संख्या.
`unitPrice`	`number` यूनिट की कीमत. इसमें टैक्स, शिपिंग, और ट्रांजैक्शन पर मिलने वाली किसी भी तरह की छूट शामिल नहीं है. मुद्रा कोड, ClickConversion मैसेज के जैसा ही होता है.

productId

string

आइटम का शॉपिंग आईडी. यह Merchant Center के प्रॉडक्ट आइडेंटिफ़ायर से मेल खाना चाहिए.

quantity

integer

बेचे गए आइटम की संख्या.

unitPrice

number

यूनिट की कीमत. इसमें टैक्स, शिपिंग, और ट्रांजैक्शन पर मिलने वाली किसी भी तरह की छूट शामिल नहीं है. मुद्रा कोड, ClickConversion मैसेज के जैसा ही होता है.

ConversionEnvironment

अपलोड किए गए कन्वर्ज़न का कन्वर्ज़न एनवायरमेंट.

Enums
`UNSPECIFIED`	जानकारी नहीं दी गई.
`UNKNOWN`	इसका इस्तेमाल सिर्फ़ रिटर्न वैल्यू के लिए किया जाता है. इस वर्शन में ऐसी वैल्यू दिखाता है जिसकी जानकारी नहीं है.
`APP`	कन्वर्ज़न को किसी ऐप्लिकेशन पर रिकॉर्ड किया गया.
`WEB`	कन्वर्ज़न को वेबसाइट पर रिकॉर्ड किया गया था.

ClickConversionResult

सफलतापूर्वक संसाधित क्लिक कन्वर्ज़न के लिए जानकारी की पहचान करना.

जेएसओएन के काेड में दिखाना
{ "gbraid": string, "wbraid": string, "userIdentifiers": [ { object (`UserIdentifier`) } ], "gclid": string, "conversionAction": string, "conversionDateTime": string }

फ़ील्ड
`gbraid`	`string` ऐप्लिकेशन कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर.
`wbraid`	`string` यह वेब कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर है.
`userIdentifiers[]`	`object (UserIdentifier)` इस कन्वर्ज़न से जुड़े उपयोगकर्ता आइडेंटिफ़ायर. कन्वर्ज़न अपलोड करने के लिए, सिर्फ़ हैश किए गए ईमेल और hashedPhoneNumber की सुविधा इस्तेमाल की जा सकती है. हर कन्वर्ज़न के लिए, उपयोगकर्ता आइडेंटिफ़ायर की ज़्यादा से ज़्यादा संख्या पांच होती है.
`gclid`	`string` इस कन्वर्ज़न से जुड़ा Google क्लिक आईडी (gclid).
`conversionAction`	`string` इस कन्वर्ज़न से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम.
`conversionDateTime`	`string` कन्वर्ज़न होने की तारीख. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+\|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00".