عیب‌یابی

مدیریت تبدیل‌ها به ادغام پیچیده‌ای نیاز دارد که اغلب شامل چندین ابزار و فرایند وابسته به یکدیگر است. این راهنما مراحل دقیقی را ارائه می‌دهد که می‌توانید برای عیب‌یابی هر مشکلی که دارید انجام دهید، چه در حال دریافت خطاهایی از API باشید که متوجه نمی‌شوید، یا اگر درباره معیارها یا تشخیص‌هایی که در رابط کاربری می‌بینید سردرگم هستید.

خواندن سنجه‌ها در «میانای کاربری Google Ads»

رابط کاربری Google Ads سنجه‌های تبدیل را براساس تاریخ وارد کردن سازمان‌دهی نمی‌کند، بنابراین استفاده از گزارش‌ها در رابط کاربری برای تأیید نتایج وارد کردن می‌تواند گمراه‌کننده باشد. برای درستی‌سنجی سلامت وارد کردن، با تشخیص خرابی داده‌های آفلاین شروع کنید. همچنین می‌توانید درباره عیب‌یابی در میانای کاربری Google Ads برای تبدیل‌های بهبودیافته برای مشتریان بالقوه و تبدیل‌های بهبودیافته برای وب بیشتر بدانید.

مشکلات مربوط به «تبدیل‌های بهبودیافته برای مشتریان بالقوه»

این بخش بر رسیدگی به مشکلات رایجی که هنگام وارد کردن تبدیل‌های بهبودیافته برای مشتریان بالقوه با آن‌ها مواجه می‌شوید تمرکز دارد.

خطاهای رایج

راهنمایی‌های زیر به شما کمک می‌کند خطاهای رایج در تبدیل‌های بهبودیافته برای مشتریان بالقوه را تشخیص دهید و برطرف کنید.

خطا
NO_CONVERSION_ACTION_FOUND

کنش تبدیل مشخص‌شده یا فعال نیست یا حساب مشتری مشخص‌شده توسط فیلد customer_id در درخواست نمی‌تواند به آن دسترسی داشته باشد. مطمئن شوید کنش تبدیل در بارگذاری شما فعال است و متعلق به مشتری‌ای است که درخواست بارگذاری را ارسال می‌کند.

این خطا همچنین ممکن است زمانی رخ دهد که «شناسه کلیک Google» در درخواست متعلق به حساب مشتری‌ای باشد که به کنش تبدیل مشخص‌شده در درخواست دسترسی ندارد. می‌توانید بااستفاده از منبع click_view و با ارسال پُرسمانی که براساس click_view.gclid و segments.date فیلتر می‌کند، تأیید کنید که آیا «شناسه کلیک Google» به حساب مشتری تعلق دارد یا نه. تاریخ همان تاریخی است که کلیک انجام شده است.

INVALID_CONVERSION_ACTION_TYPE کنش تبدیل مشخص‌شده نوعی دارد که برای تبدیل‌های بهبودیافته برای مشتریان بالقوه معتبر نیست. مطمئن شوید ConversionAction مشخص‌شده در درخواست بارگذاری‌تان از نوع UPLOAD_CLICKS باشد.
CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS مطمئن شوید که تبدیل‌های بهبودیافته برای مشتریان بالقوه را در تنظیمات تبدیل خود فعال کرده‌اید. دستورالعمل‌های مربوط به این کار را در راهنمای پیش‌نیازها پیدا کنید.
DUPLICATE_ORDER_ID رویدادهای واردشده دارای چندین تبدیل با «شناسه سفارش» یکسان هستند و پردازش نشدند. مطمئن شوید «شناسه‌های سفارش» یکتا باشند و دوباره امتحان کنید.
CLICK_NOT_FOUND هیچ کلیکی که با شناسه‌های کاربر ارائه‌شده مطابقت داشته باشد پیدا نشد.

اگر تبدیلی با این هشدار مواجه شود، Google Ads API آن را در successful_event_count عیب‌یابی داده‌های آفلاین شما قرار می‌دهد. ‫Google Ads API شامل ورودی‌ای برای CLICK_NOT_FOUND در مجموعه alerts است تا بتوانید بسامد این هشدار را پایش کنید.

اگر کلیک از کمپین Google Ads نباشد، این خطا موردانتظار است. برای مثال، ممکن است از SA360 یا DV360 باشد. سایر علل احتمالی به‌شرح زیر است:

در موارد نادری که مشتری بارگذاری‌کننده با مشتری تبدیل Google Ads متفاوت است، این خطا می‌تواند به این معنی باشد که مشتری بارگذاری‌کننده شرایط داده‌های مشتری را پذیرفته است، اما مشتری ارائه‌دهنده نپذیرفته است.

با پُرسمان کردن منبع customer و بررسی فیلد customer.conversion_tracking_setting.accepted_customer_data_terms می‌توانید تعیین کنید که آیا حسابی شرایط داده‌های مشتری را پذیرفته است یا نه.

اختلاف در سنجه‌ها

مشکلات رایج زیر را به‌خاطر داشته باشید:

  • تبدیل‌ها ممکن است به‌دلایل مختلفی توسط خط لوله پردازش ما حذف شوند و چنین تبدیل‌هایی غیرقابل‌بازیابی هستند. برای اطلاعات بیشتر، به مغایرت‌های داده پس‌از بارگذاری موفق مراجعه کنید.

  • دوباره بررسی کنید که برچسب Google به‌درستی در صفحه وب شما راه‌اندازی شده باشد و هنگام ارسال فرم مشتری بالقوه فعال شود. اگر برچسب شما در ارسال فرم فعال نمی‌شود یا اگر داده‌های نادرست ارسال می‌کند، احتمالاً در تبدیل‌های بارگذاری‌شده، ارجاع کم یا بدون ارجاع خواهید دید. مقالات «مرکز راهنمایی» ما را درباره پیکربندی برچسب Google و پیکربندی Google Tag Manager برای تبدیل‌های بهبودیافته برای مشتریان بالقوه مرور کنید.

  • اگر از تبدیل‌های بهبودیافته برای مشتریان بالقوه بدون برچسب Google در صفحه وب خود استفاده می‌کنید، باید با تنظیم فیلد ClickConversion.gclid در هر تبدیل، GCLID را در وارد کردن تبدیل‌های خود لحاظ کنید.

  • بررسی کنید که رضایت را به‌درستی در بارگذاری‌هایتان مشخص کرده باشید. می‌توانید این کار را با تنظیم کردن تنظیمات پیش‌فرض رضایت برای حسابتان (در واسط کاربری Google Ads، روی ابزارها > مدیر داده‌ها > تنظیمات رضایت کلیک کنید) یا با تنظیم کردن فیلد ClickConversion.consent در هر تبدیل بارگذاری‌شده انجام دهید.

مشکلات مربوط به عملکرد پویش

اگر در بارگذاری تبدیل‌هایتان مشکل فنی ندارید و با سنجه‌های ارائه‌شده مشکلی ندارید، اما پس‌از پیاده‌سازی تبدیل‌های بهبودیافته برای مشتریان بالقوه، بهبود عملکرد پویش یا «بهینه‌سازی» موردانتظار را مشاهده نمی‌کنید، برای دریافت راهنمایی با پشتیبانی محصول Google Ads تماس بگیرید.

مشکلات مربوط به «تبدیل‌های بهبودیافته برای وب»

این بخش بر رسیدگی به مشکلات رایجی که هنگام وارد کردن تبدیل‌های بهبودیافته برای وب رخ می‌دهد تمرکز دارد.

خطاهای رایج

راهنمایی زیر به شما کمک می‌کند خطاهای رایج در تبدیل‌های بهبودیافته برای وب را تشخیص دهید و برطرف کنید.

خطا
CONVERSION_NOT_FOUND تبدیلی برای کنش تبدیل ارائه‌شده و جفت شناسه تبدیل یا order_id پیدا نشد. تأیید کنید که تبدیل یک تبدیل Google Ads برای مشتری تبدیل Google Ads مشخص‌شده در customer_id درخواست است.
علاوه‌براین، مطمئن شوید که تبدیل برای کلیکی نبوده است که در آن gbraid یا wbraid به‌جای gclid پر شده است. Google Ads از تبدیل‌های بهبودیافته برای وب برای این تبدیل‌ها پشتیبانی نمی‌کند.
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 ارائه‌شده واجدشرایط تبدیل‌های بهبودیافته برای وب نیست. در میانای کاربری Google Ads، حتماً چارگوش روشن کردن تبدیل‌های بهبودیافته را در کنش تبدیل ارجاع‌شده در درخواستتان علامت بزنید. دستورالعمل‌های مربوط به این کار را در مرکز راهنمایی پیدا کنید.

مشکلات عمومی مدیریت تبدیل

مشکلات رایج زیر را به‌خاطر داشته باشید:

  • تلاش برای تنظیم هر فیلد 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 1 تا 60 روز برای کنش‌های تبدیل با نوع AD_CALL و WEBSITE_CALL است. برای اکثر کنش‌های تبدیل دیگر، محدوده مجاز 1 تا 90 روز است.

  • محدوده مجاز برای فیلد view_through_lookback_window_days برای اکثر کنش‌های تبدیل 1 تا 30 روز است. این فیلد باید برای کنش‌های تبدیل از نوع AD_CALL و WEBSITE_CALL تنظیم‌نشده باشد.

  • تنظیم یا به‌روزرسانی فیلد include_in_conversions_metric در کنش تبدیل منجر به خطای 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 درخواست همان شناسه مشتری نیست که در زمان کلیک، حساب تبدیل Google Ads API بوده است. customer_id درخواست را به مشتری صحیح به‌روز کنید.
EVENT_NOT_FOUND Google Ads نمی‌تواند ترکیب شناسه کلیک و customer_id را پیدا کند. الزامات customer_id را مرور کنید و مطمئن شوید که بااستفاده از «حساب Google Ads» درست بارگذاری می‌کنید.
DUPLICATE_CLICK_CONVERSION_IN_REQUEST چندین تبدیل در درخواست دارای ترکیب یکسانی از شناسه کلیک، conversion_date_time و conversion_action هستند. تبدیل‌های تکراری را از درخواستتان بردارید.
CLICK_CONVERSION_ALREADY_EXISTS تبدیلی با ترکیب یکسان شناسه کلیک، conversion_date_time، و conversion_action قبلاً بارگذاری شده است. اگر بارگذاری را دوباره امتحان می‌کنید و این تبدیل قبلاً موفقیت‌آمیز بوده است، این خطا را نادیده بگیرید. اگر می‌خواهید تبدیل دیگری علاوه‌بر تبدیل بارگذاری‌شده قبلی اضافه کنید، conversion_date_time مربوط به ClickConversion را اصلاح کنید تا از تکرار تبدیل بارگذاری‌شده قبلی جلوگیری شود.
EVENT_NOT_FOUND Google Ads نمی‌تواند ترکیب شناسه کلیک و customer_id را پیدا کند. الزامات customer_id را مرور کنید و مطمئن شوید که بااستفاده از «حساب Google Ads» درست بارگذاری می‌کنید.
EXPIRED_EVENT کلیک واردشده قبل‌از چارچوب زمانی مشخص‌شده در فیلد click_through_lookback_window_days اتفاق افتاده است. تغییر click_through_lookback_window_days فقط بر کلیک‌های ثبت‌شده پس‌از تغییر تأثیر می‌گذارد، بنابراین تغییر پنجره بازگشتی این خطا را برای کلیک خاص برطرف نمی‌کند. درصورت لزوم، conversion_action را به کنش دیگری با پنجره بازگشتی طولانی‌تر تغییر دهید.
CONVERSION_PRECEDES_EVENT conversion_date_time قبل‌از تاریخ و زمان کلیک است. conversion_date_time را به مقدار جدیدتری به‌روز کنید.
GBRAID_WBRAID_BOTH_SET ClickConversion برای هر دو gbraid و wbraid مقدار تنظیم‌شده دارد. تبدیل را به‌روز کنید تا فقط از یک شناسه کلیک یا پارامتر نشانی وب استفاده کند و مطمئن شوید که چند کلیک را در یک تبدیل ترکیب نمی‌کنید. هر کلیک فقط یک شناسه کلیک یا پارامتر نشانی وب دارد.
VALUE_MUST_BE_UNSET location GoogleAdsError را بررسی کنید تا مشخص شود کدام‌یک از مشکلات زیر منجر به خطا شده است.
  • ClickConversion مقداری برای gclid و همچنین حداقل یکی از gbraid یا wbraid دارد. تبدیل را به‌روز کنید تا فقط از یک شناسه کلیک یا پارامتر نشانی وب استفاده کند و مطمئن شوید که چند کلیک را در یک تبدیل ترکیب نمی‌کنید. هر کلیک فقط یک شناسه کلیک یا پارامتر نشانی وب دارد.
  • ClickConversion دارای مقدار تنظیم‌شده برای gbraid یا wbraid است و دارای مقدار برای custom_variables است. Google Ads از متغیرهای سفارشی برای تبدیل با پارامتر نشانی وب gbraid یا wbraid پشتیبانی نمی‌کند. فیلد custom_variables تبدیل را لغو کنید.
قبلی
گزارش