پایش تشخیص خرابی داده‌های آفلاین

از Google Ads API برای بازیابی عیب‌یابی داده‌های آفلاین استفاده کنید که حاوی اطلاعاتی درباره سلامت کلی فرایندهای وارد کردن و اصلاح تبدیل شما است.

توجه: برای وارد کردن تبدیل‌های بهبودیافته برای مشتریان بالقوه، سلامت وارد کردن را در گزارش تشخیص خرابی تبدیل‌های بهبودیافته برای مشتریان بالقوه در میانای کاربر Google Ads پایش کنید. برای تبدیل‌های بهبودیافته برای وب (ENHANCEMENT اصلاحات)، عیب‌یابی داده‌های آفلاین فقط خطاهای جذب در سطح درخواست میانای برنامه‌سازی کاربردی را ردیابی می‌کند. برای نظارت بر تطابق غیرهمگام برچسب به میانای برنامه‌سازی کاربردی order_id، پوشش بهبود میانای برنامه‌سازی کاربردی، و کامل بودن شناسه کاربر، از گزارش تشخیص خرابی تبدیل‌های بهبودیافته در میانای کاربر Google Ads استفاده کنید. برای مراحل عیب‌یابی، هشدارهای عیب‌یابی میانای کاربر پس‌از بارگذاری موفق میانای برنامه‌سازی کاربردی را ببینید.

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

• offline_conversion_upload_client_summary تشخیص‌های واردات را در سطح حساب تجمیع می‌کند.
• offline_conversion_upload_conversion_action_summary تشخیص خرابی وارد کردن را در سطح کنش تبدیل تجمیع می‌کند.

عیب‌یابی سطح حساب

برای بازیابی تشخیص خرابی بارگذاری تبدیل در سطح حساب، از پُرسمان GAQL زیر استفاده کنید:

SELECT
  customer.id,
  offline_conversion_upload_client_summary.alerts,
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.daily_summaries,
  offline_conversion_upload_client_summary.job_summaries,
  offline_conversion_upload_client_summary.last_upload_date_time,
  offline_conversion_upload_client_summary.pending_event_count,
  offline_conversion_upload_client_summary.pending_rate,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.success_rate,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.total_event_count
FROM offline_conversion_upload_client_summary

این پُرسمان ردیف‌های OfflineConversionUploadClientSummary جداگانه‌ای را برای هر نوع کارخواه استفاده‌شده در وارد کردن‌های اخیر برمی‌گرداند. برای مثال، اگر اخیراً بااستفاده از Google Ads API و میانای کاربر Google Ads وارد کرده باشید، نتایج حاوی ورودی‌های جداگانه‌ای برای مقادیر client مربوط به GOOGLE_ADS_API و GOOGLE_ADS_WEB_CLIENT است.

تشخیص خرابی سطح کنش تبدیل

برای بازیابی عیب‌یابی بارگذاری تبدیل در سطح کنش تبدیل، از پُرسمان GAQL زیر استفاده کنید:

SELECT
  offline_conversion_upload_conversion_action_summary.conversion_action_id,
  offline_conversion_upload_conversion_action_summary.conversion_action_name,
  offline_conversion_upload_conversion_action_summary.alerts,
  offline_conversion_upload_conversion_action_summary.client,
  offline_conversion_upload_conversion_action_summary.daily_summaries,
  offline_conversion_upload_conversion_action_summary.job_summaries,
  offline_conversion_upload_conversion_action_summary.last_upload_date_time,
  offline_conversion_upload_conversion_action_summary.pending_event_count,
  offline_conversion_upload_conversion_action_summary.status,
  offline_conversion_upload_conversion_action_summary.successful_event_count,
  offline_conversion_upload_conversion_action_summary.total_event_count
FROM offline_conversion_upload_conversion_action_summary
WHERE offline_conversion_upload_conversion_action_summary.conversion_action_id = <CONVERSION_ACTION_ID>

مشابه عیب‌یابی سطح حساب، این پُرسمان ردیف‌های جداگانه‌ای OfflineConversionUploadConversionActionSummary برای هر نوع مشتری مورداستفاده در وارد کردن‌های اخیر برمی‌گرداند. برای مثال، اگر اخیراً بااستفاده از Google Ads API و میانای کاربر Google Ads وارد کرده باشید، نتایج حاوی ورودی‌های جداگانه‌ای برای مقادیر client مربوط به GOOGLE_ADS_API و GOOGLE_ADS_WEB_CLIENT است.

نحوه تفسیر این خلاصه‌ها

هر OfflineConversionUploadClientSummary یا OfflineConversionUploadConversionActionSummary دارای فیلد status است که وضعیت کلی واردات برای client را نشان می‌دهد. همچنین حاوی اطلاعات زیر است:

• تعداد کل رویدادهای دریافتی.
• تعداد رویدادهایی که باموفقیت پردازش شده‌اند.
• تعداد رویدادهای درانتظار (رویدادهایی که هنوز درحال پردازش هستند).
• فیلد alerts که خلاصه‌ای از خطاها را ارائه می‌دهد، گروه‌بندی‌شده براساس OfflineConversionError.

همه این فیلدها حاوی اطلاعاتی از جدیدترین روز تقویمی کامل واردات هستند. از این اطلاعات برای ارزیابی سلامت کنونی واردات خود استفاده کنید.

علاوه‌براین، هر OfflineConversionUploadClientSummary یا OfflineConversionUploadConversionActionSummary حاوی دو نوع مختلف گزارش است:

daily_summaries

successful_count، failed_count، و pending_count درخواست‌های وارد کردن از ۷ روز گذشته، گروه‌بندی‌شده براساس date وارد کردن.

job_summaries

‫successful_count،‏ failed_count، و pending_count مربوط به ۷ درخواست وارد کردن اخیر، گروه‌بندی‌شده براساس job_id. job_id فیلدی اختیاری از UploadClickConversionsRequest و UploadConversionAdjustmentsRequest است. می‌توانید فیلد job_id را روی یک عدد صحیح ۳۲ بیتی مثبت (1 تا 2^31 - 1) تنظیم کنید یا اجازه دهید Google Ads API یک شناسه کار تولیدشده توسط سیستم را به درخواست شما اختصاص دهد. صرف‌نظر از اینکه کدام گزینه را انتخاب می‌کنید، UploadClickConversionsResponse یا UploadConversionAdjustmentsResponse، job_id را برمی‌گرداند.

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

نحوه استفاده از خلاصه‌ها

برای تأیید اینکه فرایندهای وارد کردن شما تبدیل‌ها و بهبودها را بدون خطاهای API دریافت می‌کنند، به‌طور دوره‌ای خلاصه‌های هریک از حساب‌هایتان را بازیابی کنید. اگر فیلد status هیچ خلاصه‌ای EXCELLENT نیست، از فهرست خطاها در فیلد alerts استفاده کنید تا شما را در اصلاح فرایند وارد کردن برای کاهش یا حذف آن خطاها راهنمایی کند.

برای مثال:

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

• اگر وضعیت NO_RECENT_UPLOADS باشد، Google Ads هیچ واردسازی اخیری برای client دریافت نکرده است. اگر این مورد غیرمنتظره است، فرایندهایی را که بااستفاده از آن کارخواه واردسازی انجام می‌دهند مرور کنید.

  برای مثال، اگر status برای GOOGLE_ADS_API برابر با NO_RECENT_UPLOADS باشد، این می‌تواند نشان دهد که فرایند وارد کردن شما که از Google Ads API استفاده می‌کند اخیراً متوقف شده است.

• برای تعیین اینکه آیا تاریخ وارد کردن یا کار خاصی وجود داشته است که تعداد زیادی رویداد ارسال کرده باشد که پردازش نشده‌اند، successful_count، failed_count، و pending_count مربوط به daily_summaries و job_summaries را بررسی کنید. تکمیل رویدادهایی که در وضعیت معلق هستند ممکن است تا ۲۴ ساعت طول بکشد.

اطلاعات بیشتر درباره نحوه بهبود عیب‌یابی داده‌های آفلاین را می‌توانید در مرکز راهنمایی پیدا کنید.

محدودیت‌ها

هنگام بازیابی خلاصه وارد کردن، موارد زیر را به‌خاطر داشته باشید:

• Google Ads API فقط درصورتی عیب‌یابی داده‌های آفلاین را برمی‌گرداند که customer_id درخواست searchStream یا search همان مشتری‌ای باشد که اخیراً برای وارد کردن تبدیل‌ها استفاده کرده‌اید.

  برای مثال، حساب مشتری‌ای که از ردگیری تبدیل میان‌حسابی استفاده می‌کند ممکن است هیچ عیب‌یابی‌ای نداشته باشد. بااین‌حال، می‌توانید با ارسال درخواستی که در آن customer_id با customer_id حساب مدیر مورداستفاده شما در وارد کردن مطابقت داشته باشد، عیب‌یابی‌ها را بازیابی کنید.

• Google Ads خطاهای CLICK_NOT_FOUND مربوط به وارد کردن تبدیل‌های بهبودیافته برای مشتریان بالقوه را به‌عنوان هشدار درنظر می‌گیرد. درنتیجه، اگر alerts حاوی ورودی‌ای برای این خطا باشد، عملیات مربوطه همچنان موفقیت‌آمیز درنظر گرفته می‌شود و در successful_event_count گنجانده می‌شود.