از Google Ads API برای بازیابی عیبیابی دادههای آفلاین استفاده کنید، که حاوی اطلاعاتی درباره سلامت کلی فرآیندهای آپلود و تنظیم تبدیل شما است.
برای بازیابی آخرین عیبیابی دادههای آفلاین برای حساب خود، از یکی از منابع زیر استفاده کنید:
-
offline_conversion_upload_client_summary
عیبیابی آپلود را در سطح حساب جمعآوری میکند. -
offline_conversion_upload_conversion_action_summary
(فقط در نسخه 17 یا جدیدتر موجود است) تشخیصهای آپلود را در سطح کنش تبدیل جمعآوری میکند.
تشخیص سطح حساب
برای بازیابی عیبیابی آپلود تبدیل سطح حساب، از عبارت 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
گنجانده میشوند.