Method: customers.uploadConversionAdjustments

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

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

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

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

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

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

पैरामीटर
customerId

string

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

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

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

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

object (ConversionAdjustment)

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

boolean

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

boolean

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

integer

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

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

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)

सही तरीके से प्रोसेस किए गए कन्वर्ज़न अडजस्टमेंट के लिए, इसे लौटाया गया है. जिन पंक्तियों में गड़बड़ी मिली है उनके लिए प्रोटो खाली रहेगा. पुष्टि करने की सुविधा सही होने पर नतीजे नहीं दिखाए जाते.
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

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