- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- تنظیم تبدیل
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- Conversion Adjustment Result
- آن را امتحان کنید!
تنظیمات تبدیل داده شده را پردازش می کند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلیError PartialFailureError QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadConversionAdjustments
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که بارگذاری را انجام می دهد. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"conversionAdjustments": [
{
object ( |
زمینه های | |
---|---|
conversionAdjustments[] | ضروری. تنظیمات تبدیلی که در حال بارگذاری هستند. |
partialFailure | ضروری. اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. این باید همیشه روی true تنظیم شود. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
بدن پاسخگو
پیام پاسخ برای ConversionAdjustmentUploadService.UploadConversionAdjustments
.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "partialFailureError": { object ( |
زمینه های | |
---|---|
partialFailureError | خطاهایی که مربوط به خرابی های تنظیم تبدیل در حالت شکست جزئی است. هنگامی که همه خطاها در تنظیمات رخ می دهد، برگردانده می شود. اگر هر گونه خطایی خارج از تنظیمات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. برای اطلاعات بیشتر درباره خرابی جزئی به https://developers.google.com/google-ads/api/docs/best-practices/partial-failures مراجعه کنید. |
results[] | برای تنظیمات تبدیل با موفقیت پردازش شده است. Proto برای ردیف هایی که خطا دریافت کرده اند خالی خواهد بود. زمانی که validateOnly true باشد، نتایج برگردانده نمی شوند. |
jobId | شناسه شغلی برای دسته آپلود. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
تنظیم تبدیل
یک تنظیم تبدیل
نمایندگی JSON |
---|
{ "gclidDateTimePair": { object ( |
زمینه های | |
---|---|
gclidDateTimePair | برای تنظیمات، تبدیلی را که بدون تعیین شناسه سفارش گزارش شده است، به طور منحصربهفرد شناسایی میکند. اگر adjustmentType ENHANCEMENT باشد، این مقدار اختیاری است اما ممکن است علاوه بر orderId تنظیم شود. |
adjustmentType | نوع تنظیم |
restatementValue | اطلاعات مورد نیاز برای بیان مجدد ارزش تبدیل. برای بیان مجدد لازم است. نباید برای عقب نشینی عرضه شود. اگر برای پس گرفتن ارائه شده باشد، خطا برگردانده می شود. توجه: اگر میخواهید بیانیه دوم را با مقدار تعدیلشده متفاوت بارگذاری کنید، باید زمان وقوع تعدیل جدیدتر و جدیدتر داشته باشد. در غیر این صورت، به عنوان تکراری از بیان قبلی تلقی شده و نادیده گرفته می شود. |
userIdentifiers[] | شناسه های کاربر برای افزایش تبدیل اصلی. ConversionAdjustmentUploadService فقط شناسه های کاربر را در پیشرفت ها می پذیرد. حداکثر تعداد شناسه های کاربر برای هر بهبود 5 عدد است. |
orderId | شناسه سفارش تبدیل که باید تنظیم شود. اگر تبدیل با شناسه سفارش مشخص شده گزارش شده است، آن شناسه سفارش باید به عنوان شناسه در اینجا استفاده شود. شناسه سفارش برای بهبودها لازم است. |
conversionAction | نام منبع عمل تبدیل مرتبط با این تنظیم تبدیل. توجه: اگرچه این نام منبع از یک شناسه مشتری و یک شناسه اقدام تبدیل تشکیل شده است، اعتبارسنجی شناسه مشتری را نادیده می گیرد و از شناسه اقدام تبدیل به عنوان تنها شناسه کنش تبدیل استفاده می کند. |
adjustmentDateTime | تاریخی که در آن تعدیل اتفاق افتاده است. باید بعد از conversionDateTime باشد. منطقه زمانی باید مشخص شود. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |
userAgent | عامل کاربر برای افزایش تبدیل اصلی. این را می توان در هدر درخواست HTTP کاربر هنگام تبدیل در صفحه وب شما یافت. به عنوان مثال، "Mozilla/5.0 (iPhone؛ CPU iPhone OS 12_2 مانند Mac OS X)". عامل کاربر را فقط می توان در پیشرفت ها با شناسه های کاربر مشخص کرد. این باید با عامل کاربر درخواستی که تبدیل اصلی را ارسال کرده است مطابقت داشته باشد، بنابراین تبدیل و بهبود آن هر دو به عنوان همان دستگاه نسبت داده می شوند یا هر دو به عنوان بین دستگاه نسبت داده می شوند. |
GclidDateTimePair
منحصر به فرد تبدیلی را شناسایی می کند که بدون شناسه سفارش مشخص شده گزارش شده است.
نمایندگی JSON |
---|
{ "gclid": string, "conversionDateTime": string } |
زمینه های | |
---|---|
gclid | شناسه کلیک Google (gclid) مرتبط با تبدیل اصلی برای این تنظیم. |
conversionDateTime | زمانی که تبدیل اصلی برای این تعدیل انجام شد. منطقه زمانی باید مشخص شود. قالب "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 | ارزش تبدیل مجدد ارائه شده است. این مقدار تبدیل پس از ارائه مجدد است. به عنوان مثال، برای تغییر مقدار تبدیل از 100 به 70، باید مقدار تعدیل شده 70 گزارش شود. توجه: اگر میخواهید بیانیه دوم را با مقدار تعدیلشده متفاوت بارگذاری کنید، باید زمان وقوع تعدیل جدیدتر و جدیدتر داشته باشد. در غیر این صورت، به عنوان تکراری از بیان قبلی تلقی شده و نادیده گرفته می شود. |
currencyCode | واحد پول ارزش تجديد شده اگر ارائه نشده باشد، از ارز پیشفرض حاصل از عمل تبدیل استفاده میشود، و اگر تنظیم نشده باشد، از ارز حساب استفاده میشود. این کد ارز 3 کاراکتری ISO 4217 برای مثال USD یا EUR است. |
Conversion Adjustment Result
اطلاعات شناسایی یک ConversionAdjustment که با موفقیت پردازش شده است.
نمایندگی JSON |
---|
{ "gclidDateTimePair": { object ( |
زمینه های | |
---|---|
gclidDateTimePair | gclid و زمان تاریخ تبدیل تبدیل. |
orderId | شناسه سفارش تبدیل که باید تنظیم شود. |
adjustmentType | نوع تنظیم |
conversionAction | نام منبع عمل تبدیل مرتبط با این تنظیم تبدیل. |
adjustmentDateTime | تاریخ زمانی که در آن تعدیل رخ داده است. قالب "yyyy-mm-dd hh:mm:ss+|-hh:mm" است، برای مثال، "01-01-2019 12:32:45-08:00". |