عیب‌یابی

مدیریت تبدیل‌ها به ادغام پیچیده‌ای نیاز دارد که اغلب شامل چندین ابزار و فرایند وابسته به یکدیگر است. این راهنما مراحل مفصلی را ارائه می‌دهد که می‌توانید برای عیب‌یابی هر مشکلی که دارید انجام دهید، چه خطاهایی از 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 متفاوت است. برچسب‌گذاری برای فرم مشتری بالقوه شما به‌درستی پیکربندی نشده است. داده‌های بارگذاری‌شده به‌درستی نرمال‌سازی و درهم‌سازی نشده است. در موارد نادری که مشتری بارگذاری‌کننده با مشتری تبدیل Google Ads متفاوت است، این خطا می‌تواند به این معنی باشد که مشتری بارگذاری‌کننده شرایط داده‌های مشتری را پذیرفته است، اما مشتری ارائه‌دهنده نپذیرفته است. با پُرسمان کردن منبع customer و بررسی فیلد customer.conversion_tracking_setting.accepted_customer_data_terms می‌توانید تعیین کنید که آیا حسابی شرایط داده‌های مشتری را پذیرفته است یا نه.

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

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

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

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

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

• بررسی کنید که رضایت را به‌درستی در بارگذاری‌های خود مشخص کرده باشید. می‌توانید این کار را با تنظیم کردن تنظیمات پیش‌فرض رضایت برای حسابتان (در واسط کاربری 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 تبدیل را لغو تنظیم کنید.