Method: customers.uploadConversionAdjustments

تنظیمات تبدیل داده شده را پردازش می کند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلیError PartialFailureError QuotaError RequestError

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری که بارگذاری را انجام می دهد.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
زمینه های
conversionAdjustments[]

object ( ConversionAdjustment )

ضروری. تنظیمات تبدیلی که در حال بارگذاری هستند.

partialFailure

boolean

ضروری. اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام می‌شود، اگر و تنها در صورتی که همه آنها معتبر باشند. این باید همیشه روی true تنظیم شود. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج.

بدن پاسخگو

پیام پاسخ برای ConversionAdjustmentUploadService.UploadConversionAdjustments .

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "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 برای ردیف هایی که خطا دریافت کرده اند خالی خواهد بود. زمانی که validateOnly true باشد، نتایج برگردانده نمی شوند.

jobId

string ( int64 format)

شناسه شغلی برای دسته آپلود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

تنظیم تبدیل

یک تنظیم تبدیل

نمایندگی JSON
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
زمینه های
gclidDateTimePair

object ( GclidDateTimePair )

برای تنظیمات، تبدیلی را که بدون تعیین شناسه سفارش گزارش شده است، به طور منحصربه‌فرد شناسایی می‌کند. اگر adjustmentType ENHANCEMENT باشد، این مقدار اختیاری است اما ممکن است علاوه بر orderId تنظیم شود.

adjustmentType

enum ( ConversionAdjustmentType )

نوع تنظیم

restatementValue

object ( RestatementValue )

اطلاعات مورد نیاز برای بیان مجدد ارزش تبدیل. برای بیان مجدد لازم است. نباید برای عقب نشینی عرضه شود. اگر برای پس گرفتن ارائه شده باشد، خطا برگردانده می شود. توجه: اگر می‌خواهید بیانیه دوم را با مقدار تعدیل‌شده متفاوت بارگذاری کنید، باید زمان وقوع تعدیل جدیدتر و جدیدتر داشته باشد. در غیر این صورت، به عنوان تکراری از بیان قبلی تلقی شده و نادیده گرفته می شود.

userIdentifiers[]

object ( UserIdentifier )

شناسه های کاربر برای افزایش تبدیل اصلی. ConversionAdjustmentUploadService فقط شناسه های کاربر را در پیشرفت ها می پذیرد. حداکثر تعداد شناسه های کاربر برای هر بهبود 5 عدد است.

orderId

string

شناسه سفارش تبدیل که باید تنظیم شود. اگر تبدیل با شناسه سفارش مشخص شده گزارش شده است، آن شناسه سفارش باید به عنوان شناسه در اینجا استفاده شود. شناسه سفارش برای بهبودها لازم است.

conversionAction

string

نام منبع عمل تبدیل مرتبط با این تنظیم تبدیل. توجه: اگرچه این نام منبع از یک شناسه مشتری و یک شناسه اقدام تبدیل تشکیل شده است، اعتبارسنجی شناسه مشتری را نادیده می گیرد و از شناسه اقدام تبدیل به عنوان تنها شناسه کنش تبدیل استفاده می کند.

adjustmentDateTime

string

تاریخی که در آن تعدیل اتفاق افتاده است. باید بعد از conversionDateTime باشد. منطقه زمانی باید مشخص شود. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00".

userAgent

string

عامل کاربر برای افزایش تبدیل اصلی. این را می توان در هدر درخواست HTTP کاربر هنگام تبدیل در صفحه وب شما یافت. به عنوان مثال، "Mozilla/5.0 (iPhone؛ CPU iPhone OS 12_2 مانند Mac OS X)". عامل کاربر را فقط می توان در پیشرفت ها با شناسه های کاربر مشخص کرد. این باید با عامل کاربر درخواستی که تبدیل اصلی را ارسال کرده است مطابقت داشته باشد، بنابراین تبدیل و بهبود آن هر دو به عنوان همان دستگاه نسبت داده می شوند یا هر دو به عنوان بین دستگاه نسبت داده می شوند.

GclidDateTimePair

منحصر به فرد تبدیلی را شناسایی می کند که بدون شناسه سفارش مشخص شده گزارش شده است.

نمایندگی JSON
{
  "gclid": string,
  "conversionDateTime": string
}
زمینه های
gclid

string

شناسه کلیک Google (gclid) مرتبط با تبدیل اصلی برای این تنظیم.

conversionDateTime

string

زمانی که تبدیل اصلی برای این تعدیل انجام شد. منطقه زمانی باید مشخص شود. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00".

ConversionAdjustmentType

اقدامات مختلفی که تبلیغ‌کنندگان می‌توانند برای تنظیم تبدیل‌هایی که قبلاً گزارش کرده‌اند انجام دهند. پسرفت ها یک تبدیل را نفی می کنند. بیان مجدد ارزش یک تبدیل را تغییر می دهد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN نشان دهنده مقدار ناشناخته در این نسخه است.
RETRACTION یک تبدیل را نفی می کند به طوری که مقدار کل و تعداد آن هر دو صفر باشد.
RESTATEMENT مقدار یک تبدیل را تغییر می دهد.
ENHANCEMENT یک تبدیل موجود را با شناسه های کاربر و عامل کاربر ارائه شده تکمیل می کند، که می تواند توسط Google برای افزایش تعداد تبدیل استفاده شود.

RestatementValue

حاوی اطلاعات مورد نیاز برای بیان مجدد ارزش تبدیل است.

نمایندگی JSON
{
  "adjustedValue": number,
  "currencyCode": string
}
زمینه های
adjustedValue

number

ارزش تبدیل مجدد ارائه شده است. این مقدار تبدیل پس از ارائه مجدد است. به عنوان مثال، برای تغییر مقدار تبدیل از 100 به 70، باید مقدار تعدیل شده 70 گزارش شود. توجه: اگر می‌خواهید بیانیه دوم را با مقدار تعدیل‌شده متفاوت بارگذاری کنید، باید زمان وقوع تعدیل جدیدتر و جدیدتر داشته باشد. در غیر این صورت، به عنوان تکراری از بیان قبلی تلقی شده و نادیده گرفته می شود.

currencyCode

string

واحد پول ارزش تجديد شده اگر ارائه نشده باشد، از ارز پیش‌فرض حاصل از عمل تبدیل استفاده می‌شود، و اگر تنظیم نشده باشد، از ارز حساب استفاده می‌شود. این کد ارز 3 کاراکتری ISO 4217 برای مثال USD یا EUR است.

Conversion Adjustment Result

اطلاعات شناسایی یک ConversionAdjustment که با موفقیت پردازش شده است.

نمایندگی JSON
{
  "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" است، برای مثال، "01-01-2019 12:32:45-08:00".