از Google Ads API برای بازیابی عیبیابی دادههای آفلاین استفاده کنید، که حاوی اطلاعاتی درباره سلامت کلی فرآیندهای وارد کردن و تنظیم تبدیل شما است.
برای بازیابی آخرین عیبیابی دادههای آفلاین برای حساب خود، از یکی از منابع زیر استفاده کنید:
-
offline_conversion_upload_client_summaryعیبیابی را در سطح حساب وارد میکند. -
offline_conversion_upload_conversion_action_summaryعیبیابی را در سطح اقدام تبدیل وارد میکند.
تشخیص سطح حساب
برای بازیابی عیبیابی آپلود تبدیل سطح حساب، از عبارت 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_countdatepending_count -
job_summaries successful_count,failed_countوpending_countاز 7 درخواست واردات اخیر که بر اساسjob_idگروه بندی شده اند.job_idیک فیلد اختیاری ازUploadClickConversionsRequestوUploadConversionAdjustmentsRequestاست. میتوانیدjob_idروی یک عدد غیر منفی کمتر از2^31تنظیم کنید یا به Google Ads API اجازه دهید یک شناسه شغلی ایجاد شده توسط سیستم را به درخواست شما اختصاص دهد. صرف نظر از اینکه کدام گزینه را انتخاب می کنید،UploadClickConversionsResponseیاUploadConversionAdjustmentsResponsejob_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دریافت نکرده است. اگر این غیرمنتظره است، فرآیندهایی را که با استفاده از آن کلاینت واردات را انجام می دهند، مرور کنید.برای مثال، اگر
statusGOOGLE_ADS_APINO_RECENT_UPLOADSباشد، میتواند نشان دهد که فرآیند واردات شما که از API Google Ads استفاده میکند اخیراً اجرا نشده است.برای تعیین اینکه آیا تاریخ یا کار وارد کردن خاصی وجود داشته است که تعداد زیادی رویداد را ارسال کرده است که پردازش نشدند،
successful_count،failed_count، وpending_countdaily_summariesوjob_summariesرا بررسی کنید. هر رویدادی در حالت معلق ممکن است تا 24 ساعت طول بکشد.
اطلاعات بیشتر در مورد نحوه بهبود تشخیص دادههای آفلاین را میتوانید در مرکز راهنمایی بیابید.
محدودیت ها
هنگام بازیابی خلاصه واردات موارد زیر را در نظر داشته باشید:
Google Ads API فقط در صورتی عیبیابی داده آفلاین را برمیگرداند که
customer_idمربوط بهsearchStreamیا درخواستsearchهمان مشتری باشد که اخیراً برای وارد کردن تبدیلها استفاده کردهاید.برای مثال، حساب مشتری که از ردیابی تبدیل بین حسابها استفاده میکند ممکن است حاوی هیچ عیبیابی نباشد. با این حال، میتوانید با ارسال درخواستی که در آن
customer_idباcustomer_idحساب مدیری که در واردات استفاده میکنید، عیبیابی را بازیابی کنید.Google Ads با
CLICK_NOT_FOUNDخطاهای تبدیلهای پیشرفته برای واردات سرنخها به عنوان هشدار برخورد میکند. در نتیجه، اگرalertsحاوی ورودی برای این خطا باشد، عملیات مربوطه همچنان موفق تلقی میشوند و درsuccessful_event_countگنجانده میشوند.