Method: customers.uploadCallConversions

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

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

درخواست HTTP

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

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

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

مولفه های
customerId

string

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

درخواست بدن

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

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

object ( CallConversion )

ضروری. تبدیل هایی که در حال آپلود هستند.

partialFailure

boolean

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

validateOnly

boolean

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

بدن پاسخگو

پیام پاسخ برای ConversionUploadService.UploadCallConversions .

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

نمایندگی JSON
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
زمینه های
partialFailureError

object ( Status )

خطاهایی که مربوط به شکست تبدیل در حالت شکست جزئی است. زمانی که همه خطاها در داخل تبدیل ها رخ می دهد، برگردانده می شود. اگر هر خطایی خارج از تبدیل ها رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید.

results[]

object ( CallConversionResult )

برای تبدیل‌های پردازش شده با موفقیت برگردانده شد. Proto برای ردیف هایی که خطا دریافت کرده اند خالی خواهد بود. زمانی که validateOnly true باشد، نتایج برگردانده نمی شوند.

محدوده مجوز

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

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

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

تبدیل تماس

تبدیل تماس

نمایندگی JSON
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
زمینه های
customVariables[]

object ( CustomVariable )

متغیرهای سفارشی مرتبط با این تبدیل.

callerId

string

شناسه تماس گیرنده که از آن تماس گرفته شده است. انتظار می‌رود شناسه تماس‌گیرنده در قالب E.164 با علامت «+» قبل باشد، به عنوان مثال، «+16502531234».

callStartDateTime

string

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

conversionAction

string

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

conversionDateTime

string

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

conversionValue

number

ارزش تبدیل برای تبلیغ کننده.

currencyCode

string

ارز مرتبط با ارزش تبدیل. این کد ارز 3 کاراکتری ISO 4217 است. به عنوان مثال: USD، EUR.

CallConversion Result

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

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

string

شناسه تماس گیرنده که از آن تماس گرفته شده است. انتظار می رود شناسه تماس گیرنده در قالب E.164 با علامت «+» قبل باشد.

callStartDateTime

string

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

conversionAction

string

نام منبع عمل تبدیل مرتبط با این تبدیل.

conversionDateTime

string

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