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

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

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

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.resource_name,
  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 هستند.

هر OfflineConversionUploadClientSummary دارای یک فیلد status است که سلامت کلی آپلودها را برای client منعکس می کند. همچنین شامل تعداد کل رویدادهای دریافت شده، تعداد رویدادهای پردازش شده با موفقیت، و یک فیلد alerts که خلاصه ای از خطاها را ارائه می دهد، گروه بندی شده بر اساس OfflineConversionError . همه این فیلدها حاوی اطلاعاتی از آخرین روز تقویم کامل آپلودها هستند. از این اطلاعات برای ارزیابی سلامت فعلی آپلودهای خود استفاده کنید.

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

daily_summaries

successful_count و failed_count درخواست‌های آپلود در 7 روز گذشته، گروه‌بندی شده بر اساس date آپلود.

job_summaries

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

• برای تعیین اینکه آیا تاریخ آپلود یا شغل خاصی وجود داشته است که تعداد زیادی رویداد را ارسال کرده است که با موفقیت پردازش نشده اند، successful_count و failed_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 گنجانده می‌شوند.