از 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
گنجانده میشوند.