Theo dõi chẩn đoán dữ liệu ngoại tuyến

Sử dụng API Google Ads để truy xuất thông tin chẩn đoán về dữ liệu ngoại tuyến, trong đó chứa thông tin về tình trạng tổng thể của các quy trình tải lượt chuyển đổi lên và điều chỉnh lượt chuyển đổi.

Để truy xuất thông tin chẩn đoán mới nhất về dữ liệu ngoại tuyến cho tài khoản của bạn, hãy gửi truy vấn sau cho các tài nguyên offline_conversion_upload_client_summary bằng cách sử dụng 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

Truy vấn ở trên trả về một OfflineConversionUploadClientSummary riêng biệt cho từng loại ứng dụng được dùng trong các lần tải lên gần đây. Ví dụ: nếu gần đây bạn đã tải lên bằng cả API Google Ads và giao diện người dùng Google Ads, thì kết quả sẽ chứa các mục riêng cho giá trị client của GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.

Mỗi OfflineConversionUploadClientSummary có một trường status phản ánh tình trạng tổng thể của các tệp tải lên cho client. Tệp này cũng chứa tổng số sự kiện đã nhận, số sự kiện được xử lý thành công và trường alerts cung cấp bản tóm tắt các lỗi, được nhóm theo OfflineConversionError. Tất cả các trường này chứa thông tin của ngày tải lên trọn vẹn gần đây nhất theo lịch. Hãy sử dụng thông tin này để đánh giá tình trạng hiện tại của video tải lên.

Ngoài ra, mỗi OfflineConversionUploadClientSummary còn chứa hai loại báo cáo khác nhau:

daily_summaries

successful_count và failed_count yêu cầu tải lên trong 7 ngày qua, được nhóm theo date lượt tải lên.

job_summaries

successful_count và failed_count trong số 7 yêu cầu tải lên gần đây nhất, được nhóm theo job_id. job_id là một trường không bắt buộc của UploadClickConversionsRequest và UploadConversionAdjustmentsRequest. Bạn có thể đặt job_id thành một số không âm nhỏ hơn 2^31 hoặc để API Google Ads chỉ định mã công việc do hệ thống tạo cho yêu cầu của bạn. Bất kể bạn chọn tuỳ chọn nào, UploadClickConversionsResponse hoặc UploadConversionAdjustmentsResponse đều sẽ trả về job_id.

Có một tình huống mà việc chỉ định job_id của riêng bạn hữu ích là khi bạn có một công việc hoặc quy trình tải lên một số lượng lớn lượt chuyển đổi bằng cách sử dụng nhiều yêu cầu. Nếu đặt job_id trên mỗi yêu cầu đó về cùng một giá trị, thì bạn có thể truy xuất một mục nhập cho công việc từ job_summaries. Thay vào đó, nếu bạn để API Google Ads gán một giá trị do hệ thống tạo cho job_id của mỗi yêu cầu, thì job_summaries sẽ chứa một mục nhập riêng cho từng yêu cầu. Điều này có thể khiến việc phân tích tình trạng tổng thể của công việc trở nên khó khăn hơn.

Cách sử dụng bản tóm tắt

Để đảm bảo quy trình tải lên của bạn ghi lại lượt chuyển đổi và tính năng nâng cao như mong đợi, hãy định kỳ truy xuất bản tóm tắt cho từng tài khoản của bạn. Nếu status của bất kỳ bản tóm tắt nào không phải là EXCELLENT, hãy sử dụng danh sách lỗi trong alerts để hướng dẫn bạn sửa đổi quy trình tải lên nhằm giảm hoặc loại bỏ các lỗi đó.

Ví dụ:

• Nếu trạng thái là NEEDS_ATTENTION, thì một phần đáng kể các hoạt động tải lên của bạn đã không thành công. Xem lại các lỗi trong alerts và sửa đổi quy trình tải lên để giảm hoặc loại bỏ các lỗi đó.

• Nếu trạng thái là NO_RECENT_UPLOADS, tức là Google Ads không nhận được bất kỳ tệp tải lên nào gần đây cho client. Nếu đây là điều bạn không mong muốn, hãy xem lại các quy trình tải lên bằng ứng dụng đó.

  Ví dụ: nếu status cho GOOGLE_ADS_API là NO_RECENT_UPLOADS, thì điều đó có thể cho biết rằng gần đây quy trình tải lên bằng API Google Ads đã ngừng chạy.

• Kiểm tra successful_count và failed_count của daily_summaries và job_summaries để xác định xem có ngày tải lên hoặc công việc cụ thể nào đã gửi một số lượng lớn sự kiện không được xử lý thành công hay không.

Các quy định hạn chế

Hãy lưu ý những điều sau khi truy xuất bản tóm tắt nội dung tải lên:

• API Google Ads chỉ trả về thông tin chẩn đoán về dữ liệu ngoại tuyến nếu customer_id của yêu cầu searchStream hoặc search là khách hàng mà bạn đã sử dụng gần đây để tải lượt chuyển đổi lên.

  Ví dụ: một tài khoản khách hàng sử dụng tính năng theo dõi lượt chuyển đổi trên nhiều tài khoản có thể không chứa bất kỳ thông tin chẩn đoán nào. Tuy nhiên, bạn có thể truy xuất thông tin chẩn đoán bằng cách gửi một yêu cầu trong đó customer_id khớp với customer_id của tài khoản người quản lý mà bạn sử dụng trong các tệp tải lên.

• Google Ads coi các lỗi CLICK_NOT_FOUND của lượt chuyển đổi nâng cao cho khách hàng tiềm năng được tải lên là cảnh báo. Do đó, nếu alerts chứa một mục nhập cho lỗi này, thì các thao tác tương ứng vẫn được coi là thành công và được đưa vào successful_event_count.