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

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

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

• 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 UI وارد کرده باشید، نتایج حاوی ورودی‌های جداگانه برای مقادیر 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 UI وارد کرده باشید، نتایج حاوی ورودی‌های جداگانه برای مقادیر 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 را روی عدد غیرمنفی کمتر از 2^31 تنظیم کنید یا به Google Ads API اجازه دهید شناسه کار تولیدشده توسط سیستم را به درخواستتان اختصاص دهد. صرف‌نظر از اینکه کدام گزینه را انتخاب کنید، UploadClickConversionsResponse یا UploadConversionAdjustmentsResponse job_id را برمی‌گرداند.

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

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

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