از روش IngestEvents برای ایجاد
اصلاحات در تبدیل‌های Google Ads ضبط‌شده قبلی استفاده کنید.
در Data Manager API، یک تعدیل می‌تواند مقدار تبدیل را بازبیان کند یا داده‌های کاربر را تکمیل کند.
اگر از Google Ads API انتقال می‌دهید، برای مقایسه نحوه مدیریت اصلاحات در هر API، به ارتقا از Google Ads API مراجعه کنید.
انواع تبدیل پشتیبانی‌شده
می‌توانید انواع تبدیل Google Ads زیر را تنظیم کنید:
- تبدیل‌های چندمنبعی: تبدیل‌هایی که برچسب Google وب‌سایتتان برای کنش تبدیل
WEBSITEضبط کرده است. - تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه:
رویدادهای آفلاین قبلاً بارگذاری‌شده برای کنش تبدیل
UPLOAD_CLICKS.
نحوه عملکرد اصلاحات
در همان کنش تبدیل، Google Ads رویدادها را بااستفاده از
transactionId مطابقت می‌دهد:
- اگر
transactionIdبا تبدیل موجودی برای همان کنش تبدیل مطابقت داشته باشد، Data Manager API درخواست را به‌عنوان اصلاح تبدیل درنظر می‌گیرد. - اگر
transactionIdبا تبدیل موجودی مطابقت نداشته باشد، Google Ads تبدیل جدیدی ایجاد می‌کند. رویدادهای بدون مطابقت را ببینید.
ارسال اصلاح
برای اصلاح تبدیل موجود، درخواست IngestEvents ارسال کنید
که شامل موارد زیر باشد:
- همان
transactionIdرویداد اصلی. - همان مقصد و کنش تبدیل رویداد اصلی.
- مقادیر به‌روزشده برای فیلدهایی که می‌خواهید تنظیم کنید.
- همه فیلدهای لازم برای رویداد، ازجمله حداقل یک شناسه،
مثل
adIdentifiersیاuserData. الزامات رویداد و شناسه را برای تبدیل‌های آفلاین یا تبدیل‌های چندمنبعی ببینید.
توصیه می‌کنیم همان شناسه‌هایی را ارسال کنید که با رویداد اصلی ارسال یا ضبط کرده‌اید. اگر transactionId با تبدیل موجودی مطابقت نداشته باشد،
Google Ads از این شناسه‌ها برای نسبت دادن
تبدیل جدید استفاده می‌کند.
نیازی نیست نوع اصلاح را مشخص کنید. «میانای برنامه‌سازی کاربردی مدیر داده» براساس transactionId و فیلدهایی که ارائه می‌کنید، نحوه پردازش درخواست را استنباط می‌کند.
برای اطلاعات بیشتر درباره ارسال درخواست‌های انتقال داده، راهنمای ارسال رویدادها برای تبدیل‌های آفلاین یا تبدیل‌های چندمنبعی را ببینید.
فیلدهای پشتیبانی‌شده
جدول زیر نشان می‌دهد که Google Ads چگونه هر فیلد را وقتی رویدادی با تبدیل موجودی مطابقت می‌کند اعمال می‌کند:
| فیلد | رفتار |
|---|---|
conversionValue، currency |
رونویسی شد. مقدار جدید جایگزین مقدار ضبط‌شده می‌شود. |
userData |
اگر رویداد اصلی داده‌های کاربر نداشته باشد، تکمیل می‌شود، درغیراین‌صورت نادیده گرفته می‌شود. |
همه فیلدهای دیگر، مثل adIdentifiers.gclid |
به‌روزرسانی نشد. Google Ads مقادیر ضبط‌شده با رویداد اصلی را حفظ می‌کند. فیلدهای الزامی باید همچنان وجود داشته باشند. |
مقادیر تبدیل
conversionValue و currency جدیدی برای بیان مجدد مقدار تبدیل ضبط‌شده ارسال کنید. مقدار جدید مقدار قبلاً ضبط‌شده را در گزارش‌دهی
و پیشنهاد قیمت لغو می‌کند، بدون اینکه تعداد تبدیل را افزایش دهد.
داده‌های کاربر
در اینجا نحوه مدیریت userData توسط Google Ads، مانند نشانی ایمیل یا شماره تلفن، آورده شده است:
درصورت نبود تکمیل می‌شود: اگر رویداد اصلی بدون داده‌های کاربر ضبط شده باشد، اصلاح داده‌های کاربر را برای بهبود اسناد پیوست می‌کند.
درصورت وجود نادیده گرفته می‌شود: اگر برچسب Google یا بارگذاری قبلی قبلاً داده‌های کاربر را ضبط کرده باشد، داده‌های کاربر جدید نادیده گرفته می‌شود. داده‌های کاربر موجود رونویسی یا به آن اضافه نمی‌شود.
فیلدهای دیگر
شناسه‌ها و فراداده‌های دیگر به‌جز مقدار تبدیل، ارز، و داده‌های کاربر،
مثل adIdentifiers.gclid، برای رویدادهای منطبق قابل‌به‌روزرسانی نیستند. Google Ads
مقادیر ضبط‌شده با رویداد اصلی را حفظ می‌کند.
همچنان باید هریک از این فیلدهایی را که الزامی هستند، مثل حداقل یک شناسه، اضافه کنید. Data Manager API آن‌ها را برای هر رویداد اعتبارسنجی می‌کند.
رویدادهای نامنطبق
اگر transactionId با رویداد موجودی مطابقت نداشته باشد، درخواست به‌جای اصلاح به‌عنوان بارگذاری تبدیل جدید درنظر گرفته می‌شود.
Google Ads تلاش می‌کند تبدیل جدید را بااستفاده از
شناسه‌هایی که ارائه کرده‌اید، مثل adIdentifiers.gclid یا userData، به کلیک آگهی نسبت دهد.