Method: customers.uploadConversionAdjustments

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

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

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

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

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

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

पैरामीटर
customerId

string

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
फ़ील्ड
conversionAdjustments[]

object (ConversionAdjustment)

ज़रूरी है. अपलोड किए जा रहे कन्वर्ज़न में बदलाव.
partialFailure

boolean

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

boolean

सही होने पर, अनुरोध की पुष्टि की जाती है, लेकिन उसे लागू नहीं किया जाता है. सिर्फ़ गड़बड़ियां मिलती हैं, नतीजे नहीं.

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

ConversionAdjustmentUploadService.UploadConversionAdjustments के लिए जवाब.

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

जेएसओएन के काेड में दिखाना 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
फ़ील्ड
partialFailureError

object (Status)

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

object (ConversionAdjustmentResult)

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

string (int64 format)

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

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

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

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

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

ConversionAdjustment

कन्वर्ज़न में बदलाव.

जेएसओएन के काेड में दिखाना 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
फ़ील्ड
gclidDateTimePair

object (GclidDateTimePair)

अडजस्टमेंट के लिए, ऐसे कन्वर्ज़न की पहचान खास तौर पर करें जिसे बिना ऑर्डर आईडी के रिपोर्ट किया गया था. अगर AdjustType ENHANCEMENT है, तो यह वैल्यू ज़रूरी नहीं है. हालांकि, इसे ऑर्डर आईडी के साथ सेट किया जा सकता है.
adjustmentType

enum (ConversionAdjustmentType)

अडजस्टमेंट का टाइप.
restatementValue

object (RestatementValue)

कन्वर्ज़न वैल्यू को फिर से बताने के लिए ज़रूरी जानकारी. रीस्टेटमेंट के लिए ज़रूरी है. दावा वापसी के लिए नहीं दिया जाना चाहिए. दावा वापस लेने के लिए, गड़बड़ी का मैसेज दिया जाएगा. ध्यान दें: अगर आपको बदले गए मान के साथ दूसरा रीस्टेटमेंट अपलोड करना है, तो इसमें नया और सबसे हाल का बदलाव होने का समय होना चाहिए. अगर ऐसा नहीं किया जाता है, तो इसे पिछले रीस्टेटमेंट का डुप्लीकेट माना जाएगा और इसे अनदेखा किया जाएगा.
userIdentifiers[]

object (UserIdentifier)

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

string

अडजस्ट किए जाने वाले कन्वर्ज़न का ऑर्डर आईडी. अगर कन्वर्ज़न को किसी ऑर्डर आईडी के साथ रिपोर्ट किया गया है, तो उस ऑर्डर आईडी को यहां आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाना चाहिए. बेहतर बनाने के लिए ऑर्डर आईडी डालना ज़रूरी है.
conversionAction

string

इस कन्वर्ज़न ऐक्शन से जुड़े कन्वर्ज़न ऐक्शन के संसाधन का नाम. ध्यान दें: हालांकि, इस संसाधन के नाम में ग्राहक आईडी और कन्वर्ज़न ऐक्शन आईडी शामिल होता है, लेकिन पुष्टि करने की प्रोसेस में इस ग्राहक आईडी को नज़रअंदाज़ कर दिया जाएगा और कन्वर्ज़न ऐक्शन आईडी को कन्वर्ज़न ऐक्शन के एकमात्र आइडेंटिफ़ायर के तौर पर इस्तेमाल किया जाएगा.
adjustmentDateTime

string

वह तारीख और समय जब अडजस्टमेंट हुआ. conversionDateTime के बाद की होनी चाहिए. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00".
userAgent

string

ओरिजनल कन्वर्ज़न को बेहतर बनाने के लिए उपयोगकर्ता एजेंट. यह आपके उपयोगकर्ताओं के एचटीटीपी अनुरोध के हेडर में तब मिल सकता है, जब वे आपके वेब पेज पर ग्राहक में बदल जाएंगे. उदाहरण के लिए, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". उपयोगकर्ता एजेंट की जानकारी सिर्फ़ उपयोगकर्ता आइडेंटिफ़ायर की मदद से बेहतर बनाकर दी जा सकती है. यह मूल कन्वर्ज़न भेजने वाले अनुरोध के उपयोगकर्ता एजेंट से मेल खाना चाहिए, ताकि कन्वर्ज़न और बेहतर बनाने की प्रोसेस, दोनों को एक ही डिवाइस को एट्रिब्यूट किया जा सके या दोनों को क्रॉस-डिवाइस के तौर पर एट्रिब्यूट किया जा सके.

GclidDateTimePair

उस कन्वर्ज़न की पहचान करता है जिसे बिना ऑर्डर आईडी के रिपोर्ट किया गया था.

जेएसओएन के काेड में दिखाना 
{
  "gclid": string,
  "conversionDateTime": string
}
फ़ील्ड
gclid

string

इस अडजस्टमेंट के लिए, ओरिजनल कन्वर्ज़न से जुड़ा Google क्लिक आईडी (gclid).
conversionDateTime

string

वह तारीख और समय जब इस अडजस्टमेंट के लिए मूल कन्वर्ज़न हुआ था. समय क्षेत्र की जानकारी देना ज़रूरी है. फ़ॉर्मैट "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

number

फिर से जनरेट की गई कन्वर्ज़न वैल्यू. यह रीस्टेटमेंट के बाद होने वाले कन्वर्ज़न की वैल्यू है. उदाहरण के लिए, किसी कन्वर्ज़न की वैल्यू को 100 से 70 में बदलने के लिए, 70 की अडजस्ट की गई वैल्यू रिपोर्ट की जानी चाहिए. ध्यान दें: अगर आपको बदले गए मान के साथ दूसरा रीस्टेटमेंट अपलोड करना है, तो इसमें नया और सबसे हाल का बदलाव होने का समय होना चाहिए. अगर ऐसा नहीं किया जाता है, तो इसे पिछले रीस्टेटमेंट का डुप्लीकेट माना जाएगा और इसे अनदेखा किया जाएगा.
currencyCode

string

बदली गई वैल्यू की मुद्रा. अगर वैल्यू नहीं दी जाती है, तो कन्वर्ज़न ऐक्शन के लिए सेट की गई डिफ़ॉल्ट मुद्रा का इस्तेमाल किया जाता है. अगर मुद्रा सेट नहीं की गई है, तो खाते की मुद्रा का इस्तेमाल किया जाता है. यह ISO 4217 का तीन वर्ण वाला मुद्रा कोड होता है, जैसे कि USD या EUR.

ConversionAdjustmentResult

सही तरीके से प्रोसेस किए गए कन्वर्ज़न अडजस्टमेंट की पहचान करने के बारे में जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
फ़ील्ड
gclidDateTimePair

object (GclidDateTimePair)

कन्वर्ज़न का GCLID और कन्वर्ज़न की तारीख का समय.
orderId

string

अडजस्ट किए जाने वाले कन्वर्ज़न का ऑर्डर आईडी.
adjustmentType

enum (ConversionAdjustmentType)

अडजस्टमेंट का टाइप.
conversionAction

string

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

string

वह तारीख और समय जब अडजस्टमेंट हुआ. फ़ॉर्मैट "yyyy-mm-dd hh:mm:ss+|-hh:mm" है. उदाहरण के लिए, "2019-01-01 12:32:45-08:00".