Method: customers.uploadClickConversions

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

इस्तेमाल की गई गड़बड़ियों की सूची: AuthenticationError AuthorizationError ConversionUploadError HeaderError InternalError PartialFailureError QuotaError RequestError

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

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

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

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

पैरामीटर
customerId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "conversions": [
    {
      object (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean,
  "jobId": integer
}
फ़ील्ड
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 कैंपेन से नहीं हैं. इससे, सिर्फ़ उन गड़बड़ियों पर फ़ोकस किया जा सकेगा जिन्हें ठीक किया जा सकता है.

डिफ़ॉल्ट रूप से गलत पर सेट होती है.
jobId

integer

ज़रूरी नहीं. जॉब आईडी सेट करने के लिए वैकल्पिक इनपुट. अगर दिया गया हो, तो यह 2^31 से छोटी नॉन-नेगेटिव नंबर होनी चाहिए. अगर यह फ़ील्ड नहीं दिया जाता है, तो एपीआई [2^31, (2^63)-1] की रेंज में जॉब आईडी जनरेट करेगा. एपीआई इस अनुरोध के लिए, UploadClickConversionsResponse के jobId फ़ील्ड में वैल्यू दिखाएगा.

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

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)

सही तरीके से प्रोसेस किए गए कन्वर्ज़न के लिए लौटाया गया. जिन पंक्तियों में गड़बड़ी मिली है उनके लिए प्रोटो खाली रहेगा. पुष्टि करने की सुविधा सही होने पर नतीजे नहीं दिखाए जाते.
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),
  "consent": {
    object (Consent)
  },
  "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)

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

enum (ConversionEnvironment)

वह नेटवर्क जिस पर यह कन्वर्ज़न रिकॉर्ड किया गया था. उदाहरण के लिए, ऐप्लिकेशन या वेब.
consent

object (Consent)

इवेंट के लिए सहमति की सेटिंग.
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

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

CartData

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

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

string (int64 format)

Merchant Center का आईडी, जहां आइटम की जानकारी अपलोड की गई है.
feedCountryCode

string

उस फ़ीड से जुड़ा देश कोड जहां सामान अपलोड किए गए हैं.
feedLanguageCode

string

उस फ़ीड से जुड़ा भाषा कोड जहां आइटम अपलोड किए गए हैं.
localTransactionCost

number

पूरे कार्ट के लिए, लेन-देन पर मिलने वाली सभी छूट, जैसे कि मुफ़्त शिपिंग और कूपन की छूट. यह मुद्रा कोड, Clickकन्वर्ज़न मैसेज में इस्तेमाल होने वाले मुद्रा कोड के जैसा होता है.
items[]

object (Item)

खरीदे गए आइटम का डेटा.

आइटम

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

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

string

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

integer

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

number

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

ConversionEnvironment

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

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

ClickConversionResult

सही से प्रोसेस किए गए Clickकन्वर्ज़न के लिए जानकारी की पहचान करने के लिए.

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

string

ऐप्लिकेशन कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर.
wbraid

string

वेब कन्वर्ज़न से जुड़े और iOS14 से शुरू होने वाले iOS डिवाइसों से मिले क्लिक के लिए क्लिक आइडेंटिफ़ायर.
userIdentifiers[]

object (UserIdentifier)

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

string

इस कन्वर्ज़न से जुड़ा Google क्लिक आईडी (gclid).
conversionAction

string

इस कन्वर्ज़न से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम.
conversionDateTime

string

कन्वर्ज़न होने की तारीख. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00".