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

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

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

تشخیص سطح حساب

برای بازیابی عیب‌یابی آپلود تبدیل سطح حساب، از عبارت 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_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 = < INSERT 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 از درخواست‌های آپلود از 7 روز گذشته، گروه‌بندی شده بر اساس date آپلود.
job_summaries

7 درخواست آپلود اخیر که بر اساس job_id گروه‌بندی شده‌اند، successful_count ، failed_count ، و pending_count هستند. 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 باشد، می‌تواند نشان دهد که فرآیند آپلود شما که از API Google Ads استفاده می‌کند اخیراً اجرا نشده است.

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

محدودیت ها

هنگام بازیابی خلاصه های آپلود موارد زیر را در نظر داشته باشید:

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

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

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