مدیریت تبدیل‌ها نیازمند یکپارچه‌سازی پیچیده‌ای است که اغلب شامل چندین ابزار و فرآیند وابسته به هم می‌شود. این راهنما مراحل دقیقی را ارائه می‌دهد که می‌توانید برای عیب‌یابی هرگونه مشکلی که دارید، چه خطاهایی از API دریافت کنید که آنها را نمی‌فهمید و چه اگر در مورد معیارها یا تشخیصی که در رابط کاربری می‌بینید، سردرگم هستید، انجام دهید.
خواندن معیارها در رابط کاربری گوگل ادز
رابط کاربری گوگل ادز، معیارهای تبدیل را بر اساس تاریخ وارد کردن سازماندهی نمی‌کند ، بنابراین استفاده از گزارش‌های موجود در رابط کاربری برای تأیید نتایج وارد کردن می‌تواند گمراه‌کننده باشد. برای تأیید سلامت وارد کردن، با تشخیص آفلاین شروع کنید. همچنین می‌توانید در مورد تشخیص در رابط کاربری گوگل ادز برای تبدیل‌های بهبود یافته برای سرنخ‌ها و تبدیل‌های بهبود یافته برای وب اطلاعات بیشتری کسب کنید.
مشکلات مربوط به تبدیل‌های پیشرفته برای سرنخ‌ها
این بخش بر روی پرداختن به مشکلات رایجی که هنگام وارد کردن تبدیل‌های بهبود یافته برای سرنخ‌ها با آنها مواجه می‌شوید، تمرکز دارد.
خطاهای رایج
| خطا | |
|---|---|
NO_CONVERSION_ACTION_FOUND | اقدام تبدیل مشخص‌شده یا فعال نیست، یا توسط حساب کاربری مشخص‌شده توسط فیلد `client_id` در درخواست قابل دسترسی نیست. مطمئن شوید که اقدام تبدیل در آپلود شما فعال است و متعلق به مشتری ارسال‌کننده درخواست آپلود است. این خطا همچنین ممکن است در صورتی رخ دهد که GCLID موجود در درخواست متعلق به یک حساب کاربری باشد که به عمل تبدیل مشخص شده در درخواست دسترسی ندارد. شما می‌توانید با ارسال یک پرس‌وجو که بر اساس |
INVALID_CONVERSION_ACTION_TYPE | نوع عمل تبدیل مشخص شده برای تبدیل‌های پیشرفته برای سرنخ‌ها معتبر نیست. مطمئن شوید که ConversionAction مشخص شده در درخواست آپلود شما از نوع UPLOAD_CLICKS باشد. |
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS | مطمئن شوید که در تنظیمات تبدیل، تبدیل‌های پیشرفته برای سرنخ‌ها را فعال کرده‌اید. دستورالعمل‌های مربوط به این مورد را در راهنمای پیش‌نیازها بیابید. |
DUPLICATE_ORDER_ID | رویدادهای وارد شده شامل چندین تبدیل با شناسه سفارش یکسان هستند و پردازش نشده‌اند. مطمئن شوید که شناسه‌های سفارش منحصر به فرد هستند و دوباره امتحان کنید. |
CLICK_NOT_FOUND | هیچ کلیکی مطابق با شناسه‌های کاربری ارائه شده یافت نشد. API تبلیغات گوگل فقط در صورتی این خطا را برمی‌گرداند که debug_enabled در UploadClickConversionsRequest true داشته باشد. اگر یک تبدیل با این هشدار مواجه شود، API گوگل ادز آن را در اگر کلیک از یک کمپین تبلیغات گوگل نباشد، این خطا قابل انتظار است. برای مثال، ممکن است از SA360 یا DV360 باشد. سایر علل احتمالی به شرح زیر است:
در موارد نادری که مشتری آپلودکننده با مشتری تبدیل گوگل ادز متفاوت است، این خطا می‌تواند به این معنی باشد که مشتری آپلودکننده شرایط داده‌های مشتری را پذیرفته است، اما مشتری ارائه‌دهنده خدمات این شرایط را نپذیرفته است. شما می‌توانید با پرس‌وجو از منبعcustomer و بررسی فیلد customer.offline_conversion_tracking_info.accepted_customer_data_terms ، تشخیص دهید که آیا یک حساب کاربری شرایط داده‌های مشتری را پذیرفته است یا خیر. |
اختلاف در معیارها
مسائل رایج زیر را در نظر داشته باشید:
تبدیل‌ها ممکن است به دلایل مختلف توسط خط پردازش ما از بین بروند و چنین تبدیل‌هایی غیرقابل بازیابی هستند. برای اطلاعات بیشتر به مقاله « اختلافات داده‌ها پس از آپلود موفقیت‌آمیز» مراجعه کنید.
دوباره بررسی کنید که برچسب گوگل به درستی در صفحه وب شما تنظیم شده باشد و هنگام ارسال فرم‌های سرنخ فعال شود. اگر برچسب شما هنگام ارسال فرم فعال نشود ، یا اگر داده‌های نادرستی ارسال کند، احتمالاً در تبدیل‌های آپلود شده، میزان تخصیص کم یا صفر را مشاهده خواهید کرد. مقالات مرکز راهنمای ما در مورد پیکربندی برچسب گوگل و پیکربندی مدیریت برچسب گوگل را برای تبدیل‌های بهبود یافته برای سرنخ‌ها مرور کنید.
اگر از تبدیل‌های پیشرفته برای سرنخ‌ها بدون برچسب گوگل در صفحه وب خود استفاده می‌کنید، باید با تنظیم فیلد ClickConversion.gclid در هر تبدیل، GCLID را در ورودی‌های تبدیل خود لحاظ کنید.
بررسی کنید که در آپلودهای خود به درستی رضایت را مشخص می‌کنید. می‌توانید این کار را با تنظیم تنظیمات پیش‌فرض رضایت برای حساب خود انجام دهید (در رابط کاربری Google Ads، روی ابزارها -> مدیر داده -> تنظیمات رضایت کلیک کنید) یا با تنظیم فیلد ClickConversion.consent در هر تبدیل آپلود شده.
مشکلات مربوط به عملکرد کمپین
اگر در آپلود تبدیل‌های خود هیچ مشکل فنی ندارید و با معیارهای ارائه شده مشکلی ندارید، اما پس از اجرای تبدیل‌های بهبود یافته برای سرنخ‌ها، بهبود عملکرد کمپین یا "افزایش" مورد انتظار را مشاهده نمی‌کنید، برای کمک با پشتیبانی محصول گوگل ادز تماس بگیرید.
مشکلات تبدیل‌های پیشرفته برای وب
این بخش بر روی رسیدگی به مشکلات رایجی که هنگام وارد کردن تبدیل‌های پیشرفته برای وب با آنها مواجه می‌شوید، تمرکز دارد.
خطاهای رایج
| خطا | |
|---|---|
CONVERSION_NOT_FOUND | تبدیلی برای جفت عمل تبدیل و شناسه تبدیل یا order_id ارائه شده یافت نشد. تأیید کنید که تبدیل، تبدیل گوگل ادز برای مشتری تبدیل گوگل ادز مشخص شده در customer_id درخواست است.علاوه بر این، تأیید کنید که تبدیل برای کلیکی نبوده که در آن به جای gclid از gbraid یا wbraid استفاده شده باشد. گوگل ادز از تبدیل‌های پیشرفته برای وب برای این تبدیل‌ها پشتیبانی نمی‌کند. |
CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS | شرایط و ضوابط داده‌های مشتری برای customer_id درخواست پذیرفته نشده است. دستورالعمل‌های مربوط به این مورد را در راهنمای پیش‌نیازها بیابید. |
CONVERSION_ALREADY_ENHANCED | این تبدیل قبلاً با order_id و conversion_action داده شده، تنظیم شده است. حتماً برای هر تبدیل، order_id منحصر به فردی ارائه دهید. |
CONVERSION_ACTION_NOT_ELIGIBLE_FOR_ENHANCEMENT | conversion_action ارائه شده برای تبدیل‌های پیشرفته برای وب واجد شرایط نیست. در رابط کاربری گوگل ادز، مطمئن شوید که کادر Turn on enhanced conversions را در اکشن تبدیلی که در درخواست شما به آن اشاره شده است، علامت زده‌اید. دستورالعمل‌های مربوط به این مورد را در مرکز راهنما بیابید. |
مسائل عمومی مدیریت تبدیل
مسائل رایج زیر را در نظر داشته باشید:
تلاش برای تنظیم هر فیلد enum به
UNKNOWNمنجر به خطایRequestError.INVALID_ENUM_VALUEخواهد شد. این یک مشکل رایج هنگام تعیینconsentاست، زمانی که تبلیغ‌کننده ممکن است نداند که آیا رضایت داده شده است یا خیر. اگر وضعیتconsentناشناخته است، باید رویDENIEDتنظیم شود.هنگام ایجاد یک اقدام تبدیل برای تبدیل‌های برنامه یا Firebase و تجزیه و تحلیل برنامه‌های شخص ثالث ، فقط می‌توانید فیلد
app_idرا در هنگام ایجاد تغییر دهید، پس از ایجاد اقدام تبدیل، این فیلد قابل تغییر نیست.هنگام ایجاد یک اقدام تبدیل، فقط می‌توانید فیلد
ConversionAction.attribution_model_settings.attribution_modelرا رویGOOGLE_ADS_LAST_CLICKیاGOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVENتنظیم کنید. هر گزینه دیگری منجر به خطایCANNOT_SET_RULE_BASED_ATTRIBUTION_MODELSخواهد شد. پست وبلاگ ما که منسوخ شدن سایر مدل‌های انتساب را اعلام می‌کند، جزئیات بیشتری دارد.محدوده مجاز برای فیلد
click_through_lookback_window_daysبرای اقدامات تبدیل با نوعAD_CALLوWEBSITE_CALL[1, 60]است. برای اکثر اقدامات تبدیل دیگر، محدوده مجاز[1, 30]است.محدوده مجاز برای فیلد
view_through_lookback_window_daysبرای اکثر اقدامات تبدیل،[1, 30]است. این فیلد باید برای اقدامات تبدیل از نوعAD_CALLوWEBSITE_CALLغیرفعال شود.تنظیم یا به‌روزرسانی فیلد
include_in_conversion_metricsدر یک اقدام تبدیل منجر به خطایFieldError.IMMUTABLE_FIELDخواهد شد. در عوض، فیلدprimary_for_goalهمانطور که در راهنمای اهداف تبدیل توضیح داده شده است، تنظیم کنید.هنگام ایجاد یک اکشن تبدیل از نوع
WEBSITE_CALLیاAD_CALL، مقدارvalue_settings.always_use_default_valueباید رویtrueتنظیم شود. تعیین مقدارfalseمنجر به خطایINVALID_VALUEخواهد شد.
خطاهای رایج
| خطا | |
|---|---|
INVALID_CONVERSION_ACTION_TYPE | عمل تبدیل مشخص شده نوعی دارد که برای آپلود تبدیل‌های کلیک معتبر نیست. مطمئن شوید که ConversionAction مشخص شده در درخواست آپلود شما از نوع UPLOAD_CLICKS باشد. |
NO_CONVERSION_ACTION_FOUND | عمل تبدیل مشخص شده یا فعال نیست یا در customer_id در حال آپلود یافت نمی‌شود. اطلاعات مربوط به تنظیمات تبدیل خود را بازیابی کنید تا مطمئن شوید که عمل تبدیل در آپلود شما فعال است و متعلق به customer_id درخواست آپلود است. |
TOO_RECENT_CONVERSION_ACTION | عملیات تبدیل به تازگی ایجاد شده است. قبل از تلاش مجدد برای تبدیل‌های ناموفق، حداقل ۶ ساعت پس از ایجاد عملیات صبر کنید. |
INVALID_CUSTOMER_FOR_CLICK | customer_id درخواست، همان شناسه مشتری حساب تبدیل API گوگل ادز در زمان کلیک نیست. شناسه customer_id درخواست را به مشتری صحیح به‌روزرسانی کنید. |
EVENT_NOT_FOUND | گوگل ادز نمی‌تواند ترکیب click ID و customer_id را پیدا کند. الزامات customer_id را بررسی کنید و مطمئن شوید که با استفاده از حساب گوگل ادز صحیح، آپلود می‌کنید. |
DUPLICATE_CLICK_CONVERSION_IN_REQUEST | تبدیل‌های چندگانه در درخواست، ترکیب یکسانی از شناسه کلیک، conversion_date_time و conversion_action دارند. تبدیل‌های تکراری را از درخواست خود حذف کنید. |
CLICK_CONVERSION_ALREADY_EXISTS | قبلاً تبدیلی با همین ترکیب click ID، conversion_date_time و conversion_action آپلود شده است. اگر دوباره سعی در آپلود دارید و این تبدیل قبلاً با موفقیت انجام شده است، این خطا را نادیده بگیرید. اگر می‌خواهید علاوه بر تبدیل آپلود شده قبلی، تبدیل دیگری اضافه کنید، conversion_date_time مربوط به ClickConversion را تنظیم کنید تا از تکرار تبدیل آپلود شده قبلی جلوگیری شود. |
EVENT_NOT_FOUND | گوگل ادز نمی‌تواند ترکیب click ID و customer_id را پیدا کند. الزامات customer_id را بررسی کنید و مطمئن شوید که با استفاده از حساب گوگل ادز صحیح، آپلود می‌کنید. |
EXPIRED_EVENT | کلیک وارد شده قبل از بازه زمانی مشخص شده در فیلد click_through_lookback_window_days رخ داده است. تغییر در click_through_lookback_window_days فقط روی کلیک‌های ثبت شده پس از تغییر تأثیر می‌گذارد ، بنابراین تغییر پنجره lookback این خطا را برای آن کلیک خاص برطرف نمی‌کند. در صورت لزوم، conversion_action به اکشن دیگری با پنجره lookback طولانی‌تر تغییر دهید. |
CONVERSION_PRECEDES_EVENT | مقدار conversion_date_time قبل از تاریخ و زمان کلیک است. مقدار conversion_date_time به مقداری جدیدتر به‌روزرسانی کنید. |
GBRAID_WBRAID_BOTH_SET | ClickConversion برای هر دو gbraid و wbraid یک مقدار تنظیم شده دارد. تبدیل را طوری به‌روزرسانی کنید که فقط از یک شناسه کلیک استفاده کند و مطمئن شوید که چندین کلیک را در یک تبدیل ترکیب نمی‌کنید. هر کلیک فقط یک شناسه کلیک دارد. |
VALUE_MUST_BE_UNSET | location GoogleAdsError را بررسی کنید تا مشخص شود کدام یک از مشکلات زیر منجر به خطا شده است.
|