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