تنظیمات تبدیل

از متد IngestEvents برای اعمال تنظیمات روی تبدیل‌های ثبت‌شده‌ی قبلی گوگل ادز استفاده کنید. در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، یک تنظیم می‌تواند مقدار تبدیل را مجدداً بیان کند یا داده‌های کاربر را تکمیل کند.

اگر از API تبلیغات گوگل (Google Ads API) مهاجرت می‌کنید، برای مقایسه نحوه مدیریت تنظیمات در هر API، به بخش «ارتقا از API تبلیغات گوگل» مراجعه کنید.

انواع تبدیل پشتیبانی شده

شما می‌توانید انواع تبدیل‌های گوگل ادز زیر را تنظیم کنید:

• تبدیل‌های چند منبعی : تبدیل‌هایی که توسط برچسب گوگل وب‌سایت شما برای یک اقدام تبدیل WEBSITE ثبت شده‌اند.
• تبدیل‌های آفلاین و تبدیل‌های بهبود یافته برای سرنخ‌ها : رویدادهای آفلاین قبلاً آپلود شده برای اقدام تبدیل UPLOAD_CLICKS .

توجه: تنظیمات مربوط به تبدیل فروش فروشگاه پشتیبانی نمی‌شود.

نحوه عملکرد تنظیمات

در همان اقدام تبدیل، گوگل ادز رویدادها را با استفاده از transactionId مطابقت می‌دهد:

• اگر transactionId با یک تبدیل موجود برای همان اقدام تبدیل مطابقت داشته باشد، Data Manager API درخواست را به عنوان یک تنظیم تبدیل در نظر می‌گیرد.
• اگر transactionId با یک تبدیل موجود مطابقت نداشته باشد، گوگل ادز یک تبدیل جدید ایجاد می‌کند. به رویدادهای تطبیق نیافته مراجعه کنید.

ارسال تعدیل

برای تنظیم یک تبدیل موجود، یک درخواست IngestEvents ارسال کنید که شامل موارد زیر باشد:

• همان transactionId رویداد اصلی.
• همان مقصد و عمل تبدیل به عنوان رویداد اصلی.
• مقادیر به‌روزرسانی‌شده برای فیلدهایی که می‌خواهید تنظیم کنید.

نیازی به مشخص کردن نوع تنظیم نیست. رابط برنامه‌نویسی کاربردی مدیریت داده، نحوه پردازش درخواست را بر اساس transactionId و فیلدهایی که ارائه می‌دهید، استنباط می‌کند.

برای اطلاعات بیشتر در مورد ارسال درخواست‌های مصرف، به «ارسال رویدادها» مراجعه کنید.

فیلدهای پشتیبانی شده

جدول زیر فیلدهایی را که می‌توانید تنظیم کنید و نحوه اعمال به‌روزرسانی‌ها را فهرست می‌کند:

میدان	رفتار
conversionValue ، currency	مقدار جدید جایگزین مقدار ثبت شده می‌شود .
userData	اگر رویداد اصلی هیچ داده کاربری نداشت، تکمیل می‌شود ، در غیر این صورت نادیده گرفته می‌شود .
تمام فیلدهای دیگر، مانند adIdentifiers.gclid	نادیده گرفته شده

مقادیر تبدیل

برای بیان مجدد ارزش یک تبدیل ثبت‌شده، یک conversionValue و currency جدید ارسال کنید. مقدار جدید، بدون افزایش تعداد تبدیل، بر مقدار ثبت‌شده قبلی در گزارش‌دهی و پیشنهاد قیمت غلبه می‌کند.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، به‌روزرسانی‌های مقدار غیرفعال هستند. مقدار تگ تا پایان دوره آزمایشی در گزارش‌های گوگل ادز بازنویسی نخواهد شد.

داده‌های کاربر

نحوه مدیریت userData ، مانند آدرس ایمیل یا شماره تلفن توسط گوگل ادز به شرح زیر است:

• در صورت عدم وجود، تکمیل می‌شود: اگر رویداد اصلی بدون داده‌های کاربر ثبت شده باشد، تنظیمات، داده‌های کاربر را برای بهبود انتساب پیوست می‌کند.

  توجه: برای عملکرد بهینه، توصیه می‌کنیم داده‌های آفلاین تکمیلی را ظرف ۲۴ ساعت پس از رویداد اصلی آپلود کنید.

• در صورت وجود، نادیده گرفته می‌شود: اگر برچسب گوگل یا بارگذاری قبلی، داده‌های کاربر را از قبل ثبت کرده باشد، داده‌های کاربر جدید نادیده گرفته می‌شوند. داده‌های کاربر موجود رونویسی یا اضافه نمی‌شوند.

سایر زمینه‌ها

شناسه‌ها و فراداده‌های غیر از مقدار تبدیل، واحد پول و داده‌های کاربر، مانند adIdentifiers.gclid ، نمی‌توانند برای رویدادهای منطبق به‌روزرسانی شوند. گوگل ادز این فیلدها را نادیده می‌گیرد و مقادیر ثبت‌شده با رویداد اصلی را نگه می‌دارد.

رویدادهای بی‌نظیر

اگر transactionId با یک رویداد موجود مطابقت نداشته باشد، درخواست به عنوان یک آپلود تبدیل جدید به جای یک تنظیم در نظر گرفته می‌شود.

گوگل ادز تلاش می‌کند تا با استفاده از شناسه‌هایی که شما ارائه کرده‌اید، مانند adIdentifiers.gclid یا userData ، تبدیل جدید را به یک کلیک تبلیغاتی نسبت دهد.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، تبدیل‌های تازه ایجاد شده در گزارش‌ها ظاهر می‌شوند اما برای پیشنهاد قیمت استفاده نمی‌شوند. پس از پایان دوره آزمایشی، آنها به طور خودکار قابل پیشنهاد قیمت می‌شوند.

،

از متد IngestEvents برای اعمال تنظیمات روی تبدیل‌های ثبت‌شده‌ی قبلی گوگل ادز استفاده کنید. در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، یک تنظیم می‌تواند مقدار تبدیل را مجدداً بیان کند یا داده‌های کاربر را تکمیل کند.

اگر از API تبلیغات گوگل (Google Ads API) مهاجرت می‌کنید، برای مقایسه نحوه مدیریت تنظیمات در هر API، به بخش «ارتقا از API تبلیغات گوگل» مراجعه کنید.

انواع تبدیل پشتیبانی شده

شما می‌توانید انواع تبدیل‌های گوگل ادز زیر را تنظیم کنید:

• تبدیل‌های چند منبعی : تبدیل‌هایی که توسط برچسب گوگل وب‌سایت شما برای یک اقدام تبدیل WEBSITE ثبت شده‌اند.
• تبدیل‌های آفلاین و تبدیل‌های بهبود یافته برای سرنخ‌ها : رویدادهای آفلاین قبلاً آپلود شده برای اقدام تبدیل UPLOAD_CLICKS .

توجه: تنظیمات مربوط به تبدیل فروش فروشگاه پشتیبانی نمی‌شود.

نحوه عملکرد تنظیمات

در همان اقدام تبدیل، گوگل ادز رویدادها را با استفاده از transactionId مطابقت می‌دهد:

• اگر transactionId با یک تبدیل موجود برای همان اقدام تبدیل مطابقت داشته باشد، Data Manager API درخواست را به عنوان یک تنظیم تبدیل در نظر می‌گیرد.
• اگر transactionId با یک تبدیل موجود مطابقت نداشته باشد، گوگل ادز یک تبدیل جدید ایجاد می‌کند. به رویدادهای تطبیق نیافته مراجعه کنید.

ارسال تعدیل

برای تنظیم یک تبدیل موجود، یک درخواست IngestEvents ارسال کنید که شامل موارد زیر باشد:

• همان transactionId رویداد اصلی.
• همان مقصد و عمل تبدیل به عنوان رویداد اصلی.
• مقادیر به‌روزرسانی‌شده برای فیلدهایی که می‌خواهید تنظیم کنید.

نیازی به مشخص کردن نوع تنظیم نیست. رابط برنامه‌نویسی کاربردی مدیریت داده، نحوه پردازش درخواست را بر اساس transactionId و فیلدهایی که ارائه می‌دهید، استنباط می‌کند.

برای اطلاعات بیشتر در مورد ارسال درخواست‌های مصرف، به «ارسال رویدادها» مراجعه کنید.

فیلدهای پشتیبانی شده

جدول زیر فیلدهایی را که می‌توانید تنظیم کنید و نحوه اعمال به‌روزرسانی‌ها را فهرست می‌کند:

میدان	رفتار
conversionValue ، currency	مقدار جدید جایگزین مقدار ثبت شده می‌شود .
userData	اگر رویداد اصلی هیچ داده کاربری نداشت، تکمیل می‌شود ، در غیر این صورت نادیده گرفته می‌شود .
تمام فیلدهای دیگر، مانند adIdentifiers.gclid	نادیده گرفته شده

مقادیر تبدیل

برای بیان مجدد ارزش یک تبدیل ثبت‌شده، یک conversionValue و currency جدید ارسال کنید. مقدار جدید، بدون افزایش تعداد تبدیل، بر مقدار ثبت‌شده قبلی در گزارش‌دهی و پیشنهاد قیمت غلبه می‌کند.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، به‌روزرسانی‌های مقدار غیرفعال هستند. مقدار تگ تا پایان دوره آزمایشی در گزارش‌های گوگل ادز بازنویسی نخواهد شد.

داده‌های کاربر

نحوه مدیریت userData ، مانند آدرس ایمیل یا شماره تلفن توسط گوگل ادز به شرح زیر است:

• در صورت عدم وجود، تکمیل می‌شود: اگر رویداد اصلی بدون داده‌های کاربر ثبت شده باشد، تنظیمات، داده‌های کاربر را برای بهبود انتساب پیوست می‌کند.

  توجه: برای عملکرد بهینه، توصیه می‌کنیم داده‌های آفلاین تکمیلی را ظرف ۲۴ ساعت پس از رویداد اصلی آپلود کنید.

• در صورت وجود، نادیده گرفته می‌شود: اگر برچسب گوگل یا بارگذاری قبلی، داده‌های کاربر را از قبل ثبت کرده باشد، داده‌های کاربر جدید نادیده گرفته می‌شوند. داده‌های کاربر موجود رونویسی یا اضافه نمی‌شوند.

سایر زمینه‌ها

شناسه‌ها و فراداده‌های غیر از مقدار تبدیل، واحد پول و داده‌های کاربر، مانند adIdentifiers.gclid ، نمی‌توانند برای رویدادهای منطبق به‌روزرسانی شوند. گوگل ادز این فیلدها را نادیده می‌گیرد و مقادیر ثبت‌شده با رویداد اصلی را نگه می‌دارد.

رویدادهای بی‌نظیر

اگر transactionId با یک رویداد موجود مطابقت نداشته باشد، درخواست به عنوان یک آپلود تبدیل جدید به جای یک تنظیم در نظر گرفته می‌شود.

گوگل ادز تلاش می‌کند تا با استفاده از شناسه‌هایی که شما ارائه کرده‌اید، مانند adIdentifiers.gclid یا userData ، تبدیل جدید را به یک کلیک تبلیغاتی نسبت دهد.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، تبدیل‌های تازه ایجاد شده در گزارش‌ها ظاهر می‌شوند اما برای پیشنهاد قیمت استفاده نمی‌شوند. پس از پایان دوره آزمایشی، آنها به طور خودکار قابل پیشنهاد قیمت می‌شوند.

،

از متد IngestEvents برای اعمال تنظیمات روی تبدیل‌های ثبت‌شده‌ی قبلی گوگل ادز استفاده کنید. در رابط برنامه‌نویسی کاربردی مدیریت داده (Data Manager API)، یک تنظیم می‌تواند مقدار تبدیل را مجدداً بیان کند یا داده‌های کاربر را تکمیل کند.

اگر از API تبلیغات گوگل (Google Ads API) مهاجرت می‌کنید، برای مقایسه نحوه مدیریت تنظیمات در هر API، به بخش «ارتقا از API تبلیغات گوگل» مراجعه کنید.

انواع تبدیل پشتیبانی شده

شما می‌توانید انواع تبدیل‌های گوگل ادز زیر را تنظیم کنید:

• تبدیل‌های چند منبعی : تبدیل‌هایی که توسط برچسب گوگل وب‌سایت شما برای یک اقدام تبدیل WEBSITE ثبت شده‌اند.
• تبدیل‌های آفلاین و تبدیل‌های بهبود یافته برای سرنخ‌ها : رویدادهای آفلاین قبلاً آپلود شده برای اقدام تبدیل UPLOAD_CLICKS .

توجه: تنظیمات مربوط به تبدیل فروش فروشگاه پشتیبانی نمی‌شود.

نحوه عملکرد تنظیمات

در همان اقدام تبدیل، گوگل ادز رویدادها را با استفاده از transactionId مطابقت می‌دهد:

• اگر transactionId با یک تبدیل موجود برای همان اقدام تبدیل مطابقت داشته باشد، Data Manager API درخواست را به عنوان یک تنظیم تبدیل در نظر می‌گیرد.
• اگر transactionId با یک تبدیل موجود مطابقت نداشته باشد، گوگل ادز یک تبدیل جدید ایجاد می‌کند. به رویدادهای Unmatched مراجعه کنید.

ارسال تعدیل

برای تنظیم یک تبدیل موجود، یک درخواست IngestEvents ارسال کنید که شامل موارد زیر باشد:

• همان transactionId رویداد اصلی.
• همان مقصد و عمل تبدیل به عنوان رویداد اصلی.
• مقادیر به‌روزرسانی‌شده برای فیلدهایی که می‌خواهید تنظیم کنید.

نیازی به مشخص کردن نوع تنظیم نیست. رابط برنامه‌نویسی کاربردی مدیریت داده، نحوه پردازش درخواست را بر اساس transactionId و فیلدهایی که ارائه می‌دهید، استنباط می‌کند.

برای اطلاعات بیشتر در مورد ارسال درخواست‌های مصرف، به «ارسال رویدادها» مراجعه کنید.

فیلدهای پشتیبانی شده

جدول زیر فیلدهایی را که می‌توانید تنظیم کنید و نحوه اعمال به‌روزرسانی‌ها را فهرست می‌کند:

میدان	رفتار
conversionValue ، currency	مقدار جدید جایگزین مقدار ثبت شده می‌شود .
userData	اگر رویداد اصلی هیچ داده کاربری نداشت، تکمیل می‌شود ، در غیر این صورت نادیده گرفته می‌شود .
تمام فیلدهای دیگر، مانند adIdentifiers.gclid	نادیده گرفته شده

مقادیر تبدیل

برای بیان مجدد ارزش یک تبدیل ثبت‌شده، یک conversionValue و currency جدید ارسال کنید. مقدار جدید، بدون افزایش تعداد تبدیل، بر مقدار ثبت‌شده قبلی در گزارش‌دهی و پیشنهاد قیمت غلبه می‌کند.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، به‌روزرسانی‌های مقدار غیرفعال هستند. مقدار تگ تا پایان دوره آزمایشی در گزارش‌های گوگل ادز بازنویسی نخواهد شد.

داده‌های کاربر

نحوه مدیریت userData ، مانند آدرس ایمیل یا شماره تلفن توسط گوگل ادز به شرح زیر است:

• در صورت عدم وجود، تکمیل می‌شود: اگر رویداد اصلی بدون داده‌های کاربر ثبت شده باشد، تنظیمات، داده‌های کاربر را برای بهبود انتساب پیوست می‌کند.

  توجه: برای عملکرد بهینه، توصیه می‌کنیم داده‌های آفلاین تکمیلی را ظرف ۲۴ ساعت پس از رویداد اصلی آپلود کنید.

• در صورت وجود، نادیده گرفته می‌شود: اگر برچسب گوگل یا بارگذاری قبلی، داده‌های کاربر را از قبل ثبت کرده باشد، داده‌های کاربر جدید نادیده گرفته می‌شوند. داده‌های کاربر موجود رونویسی یا اضافه نمی‌شوند.

سایر زمینه‌ها

شناسه‌ها و فراداده‌های غیر از مقدار تبدیل، واحد پول و داده‌های کاربر، مانند adIdentifiers.gclid ، نمی‌توانند برای رویدادهای منطبق به‌روزرسانی شوند. گوگل ادز این فیلدها را نادیده می‌گیرد و مقادیر ثبت‌شده با رویداد اصلی را نگه می‌دارد.

رویدادهای بی‌نظیر

اگر transactionId با یک رویداد موجود مطابقت نداشته باشد، درخواست به عنوان یک آپلود تبدیل جدید به جای یک تنظیم در نظر گرفته می‌شود.

گوگل ادز تلاش می‌کند تا با استفاده از شناسه‌هایی که شما ارائه کرده‌اید، مانند adIdentifiers.gclid یا userData ، تبدیل جدید را به یک کلیک تبلیغ نسبت دهد.

توجه: در طول دوره آزمایشی اولیه ۱۴ روزه برای تبدیل‌های چند منبعی، تبدیل‌های تازه ایجاد شده در گزارش‌ها ظاهر می‌شوند اما برای پیشنهاد قیمت استفاده نمی‌شوند. پس از پایان دوره آزمایشی، آنها به طور خودکار قابل پیشنهاد قیمت می‌شوند.