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

از 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 وارد کرده باشید، نتایج حاوی ورودی‌های جداگانه‌ای برای مقادیر 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 را روی عددی غیرمنفی کمتر از 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 گنجانده می‌شود.

قبلی
متغیرهای تبدیل سفارشی
بعدی
گزارش