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

از 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 جداگانه‌ای را برمی‌گرداند. برای مثال، اگر اخیراً با استفاده از هر دو رابط برنامه‌نویسی کاربردی گوگل ادز و رابط کاربری گوگل ادز، ایمپورت انجام داده‌اید، نتایج شامل ورودی‌های جداگانه‌ای برای مقادیر 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 جداگانه‌ای را برمی‌گرداند. برای مثال، اگر اخیراً با استفاده از هر دو رابط برنامه‌نویسی کاربردی گوگل ادز و رابط کاربری گوگل ادز وارد کرده‌اید، نتایج شامل ورودی‌های جداگانه‌ای برای مقادیر client GOOGLE_ADS_API و GOOGLE_ADS_WEB_CLIENT است.

چگونه این خلاصه‌ها را تفسیر کنیم

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

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

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

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

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

تعداد successful_count ، failed_count و pending_count از ۷ درخواست واردات اخیر، که بر اساس job_id گروه‌بندی شده‌اند. job_id یک فیلد اختیاری برای UploadClickConversionsRequest و UploadConversionAdjustmentsRequest است. می‌توانید job_id را روی یک عدد غیرمنفی کمتر از 2^31 تنظیم کنید یا اجازه دهید API تبلیغات گوگل یک شناسه کار تولید شده توسط سیستم را به درخواست شما اختصاص دهد. صرف نظر از اینکه کدام گزینه را انتخاب می‌کنید، UploadClickConversionsResponse یا UploadConversionAdjustmentsResponse ، job_id برمی‌گردانند.

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

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

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

برای مثال:

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

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

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

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

اطلاعات بیشتر در مورد چگونگی بهبود تشخیص داده‌های آفلاین را می‌توانید در مرکز راهنما بیابید.

محدودیت‌ها

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

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

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

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

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