از روش IngestEvents برای ایجاد
اصلاحات در تبدیل‌های Google Ads که قبلاً ثبت شده‌اند استفاده کنید.
در Data Manager API، تعدیل می‌تواند مقدار تبدیل را مجدداً بیان کند یا داده‌های کاربر را تکمیل کند.
اگر از Google Ads API منتقل می‌شوید، به ارتقا دادن از Google Ads API مراجعه کنید تا نحوه مدیریت اصلاحات را در هر API مقایسه کنید.
انواع تبدیل پشتیبانی‌شده
می‌توانید انواع تبدیل Google Ads زیر را تنظیم کنید:
- تبدیل‌های چندمنبعی: تبدیل‌های ثبت‌شده توسط برچسب Google وب‌سایت شما برای کنش تبدیل
WEBSITE. - تبدیل‌های آفلاین و تبدیل‌های بهبودیافته برای مشتریان بالقوه:
رویدادهای آفلاین قبلاً بارگذاری‌شده برای کنش تبدیل
UPLOAD_CLICKS.
نحوه عملکرد تعدیل‌ها
در همان کنش تبدیل، Google Ads رویدادها را بااستفاده از
transactionId مطابقت می‌دهد:
- اگر
transactionIdبا تبدیل موجودی برای همان کنش تبدیل مطابقت داشته باشد، Data Manager API درخواست را به‌عنوان اصلاح تبدیل درنظر می‌گیرد. - اگر
transactionIdبا تبدیل موجودی مطابقت نداشته باشد، Google Ads تبدیل جدیدی ایجاد می‌کند. رویدادهای مطابقت‌نداده را ببینید.
ارسال اصلاحیه
برای اصلاح تبدیل موجود، درخواست IngestEvents ارسال کنید
که شامل موارد زیر باشد:
- همان
transactionIdرویداد اصلی. - مقصد و کنش تبدیل یکسان با رویداد اصلی.
- مقادیر به‌روزشده برای فیلدهایی که می‌خواهید تنظیم کنید.
- همه فیلدهای لازم برای رویداد، ازجمله حداقل یک شناسه،
مثل
adIdentifiersیاuserData. الزامات شناسه و رویداد را برای تبدیل‌های آفلاین یا تبدیل‌های چندمنبعی ببینید.
توصیه می‌کنیم همان شناسه‌هایی را ارسال کنید که با رویداد اصلی ارسال یا ضبط کرده‌اید. اگر transactionId با تبدیل موجودی مطابقت نداشته باشد،
Google Ads از این شناسه‌ها برای نسبت دادن
تبدیل جدید استفاده می‌کند.
نیازی نیست نوع اصلاح را مشخص کنید. Data Manager API براساس 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، تبدیل جدید را به کلیک آگهی نسبت دهد.