- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- تبدیل تماس
- CallConversion Result
- آن را امتحان کنید!
تبدیل تماس های داده شده را پردازش می کند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلیError PartialFailureError QuotaError RequestError
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
URL از دستور GRPC Transcoding استفاده می کند.
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که بارگذاری را انجام می دهد. |
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"conversions": [
{
object ( |
زمینه های | |
---|---|
conversions[] | ضروری. تبدیل هایی که در حال آپلود هستند. |
partialFailure | ضروری. اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. این باید همیشه روی true تنظیم شود. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
پیام پاسخ برای ConversionUploadService.UploadCallConversions
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "partialFailureError": { object ( |
زمینه های | |
---|---|
partialFailureError | خطاهایی که مربوط به شکست تبدیل در حالت شکست جزئی است. زمانی که همه خطاها در داخل تبدیل ها رخ می دهد، برگردانده می شود. اگر هر خطایی خارج از تبدیل ها رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید. |
results[] | برای تبدیلهای پردازش شده با موفقیت برگردانده شد. Proto برای ردیف هایی که خطا دریافت کرده اند خالی خواهد بود. زمانی که validateOnly true باشد، نتایج برگردانده نمی شوند. |
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
تبدیل تماس
نمایندگی JSON |
---|
{ "customVariables": [ { object ( |
زمینه های | |
---|---|
customVariables[] | متغیرهای سفارشی مرتبط با این تبدیل. |
consent | تنظیم رضایت برای رویداد. |
callerId | شناسه تماس گیرنده که از آن تماس گرفته شده است. انتظار میرود شناسه تماسگیرنده در قالب E.164 با علامت «+» قبل باشد، به عنوان مثال، «+16502531234». |
callStartDateTime | تاریخی که در آن تماس برقرار شد. منطقه زمانی باید مشخص شود. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |
conversionAction | نام منبع عمل تبدیل مرتبط با این تبدیل. توجه: اگرچه این نام منبع از یک شناسه مشتری و یک شناسه اقدام تبدیل تشکیل شده است، اعتبارسنجی شناسه مشتری را نادیده می گیرد و از شناسه اقدام تبدیل به عنوان تنها شناسه کنش تبدیل استفاده می کند. |
conversionDateTime | تاریخی که در آن تبدیل صورت گرفته است. باید بعد از زمان تماس باشد. منطقه زمانی باید مشخص شود. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |
conversionValue | ارزش تبدیل برای تبلیغ کننده. |
currencyCode | ارز مرتبط با ارزش تبدیل. این کد ارز 3 کاراکتری ISO 4217 است. به عنوان مثال: USD، EUR. |
شناسایی اطلاعات برای یک CallConversionUpload با موفقیت پردازش شده است.
نمایندگی JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
زمینه های | |
---|---|
callerId | شناسه تماس گیرنده که از آن تماس گرفته شده است. انتظار می رود شناسه تماس گیرنده در قالب E.164 با علامت «+» قبل باشد. |
callStartDateTime | تاریخی که در آن تماس برقرار شد. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |
conversionAction | نام منبع عمل تبدیل مرتبط با این تبدیل. |
conversionDateTime | تاریخی که در آن تبدیل صورت گرفته است. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |