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 dữ liệu ngoại tuyến, chứa thông tin về tình trạng tổng thể của các quy trình nhập 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 sử dụng một trong các tài nguyên sau:

Chẩn đoán ở cấp tài khoản

Để truy xuất thông tin chẩn đoán về lượt tải lượt chuyển đổi lên ở cấp tài khoản, hãy sử dụng truy vấn GAQL sau:

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

Truy vấn này trả về các hàng OfflineConversionUploadClientSummary riêng biệt cho từng loại ứng dụng được dùng trong các lần nhập gần đây. Ví dụ: nếu gần đây bạn nhập 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 biệt cho các giá trị client của GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.

Thông tin chẩn đoán ở cấp hành động chuyển đổi

Để truy xuất thông tin chẩn đoán về lượt tải lượt chuyển đổi lên ở cấp hành động chuyển đổi, hãy sử dụng truy vấn GAQL sau:

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 >

Tương tự như thông tin chẩn đoán ở cấp tài khoản, truy vấn này trả về các hàng OfflineConversionUploadConversionActionSummary riêng biệt cho từng loại ứng dụng được dùng trong các lần nhập gần đây. Ví dụ: nếu gần đây bạn nhập 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 biệt cho các giá trị client của GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.

Cách diễn giải các bản tóm tắt này

Mỗi OfflineConversionUploadClientSummary hoặc OfflineConversionUploadConversionActionSummary có một trường status, phản ánh tình trạng tổng thể của các tệp nhập cho client. Tệp này cũng chứa các thông tin sau:

  • Tổng số sự kiện đã nhận được.
  • Số lượng sự kiện đã xử lý thành công.
  • Số lượng sự kiện đang chờ xử lý (sự kiện vẫn đang được xử lý).
  • Trường alerts cung cấp thông tin tóm tắt về lỗi, được nhóm theo OfflineConversionError.

Tất cả các trường này đều chứa thông tin từ ngày đầy đủ gần đây nhất trong lịch. Hãy sử dụng thông tin này để đánh giá tình trạng hiện tại của dữ liệu nhập.

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

daily_summaries
successful_count, failed_count và pending_count của các yêu cầu nhập trong 7 ngày qua, được nhóm theo date nhập.
job_summaries

successful_count, failed_count và pending_count của 7 yêu cầu nhập gần đây nhất, được nhóm theo job_id. job_id là 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 sẽ trả về job_id.

Một trường hợp mà việc chỉ định job_id của riêng bạn sẽ hữu ích là khi bạn có một công việc hoặc quy trình nhập một số lượng lớn lượt chuyển đổi bằng nhiều yêu cầu. Nếu đặt job_id trên mỗi yêu cầu đó thành cùng một giá trị, thì bạn có thể truy xuất một mục duy nhất cho công việc từ job_summaries. Thay vào đó, nếu bạn cho phép API Google Ads chỉ định 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 riêng cho mỗi 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 nhập của bạn đang ghi lại các lượt chuyển đổi và điểm cải tiến như dự kiến, hãy định kỳ truy xuất bản tóm tắt cho từng tài khoả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 nhập nhằm giảm thiểu 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 lớn các thao tác nhập 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 nhập để giảm thiểu hoặc loại bỏ các lỗi đó.

  • Nếu trạng thái là NO_RECENT_UPLOADS, thì Google Ads chưa nhận được bất kỳ lượt nhập nào gần đây cho client. Nếu điều này không mong muốn, hãy xem lại các quy trình thực hiện nhập 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 quy trình nhập sử dụng API Google Ads đã ngừng chạy gần đây.

  • Để xác định xem có ngày hoặc công việc nhập cụ thể nào đã gửi một lượng lớn sự kiện không xử lý được hay không, hãy kiểm tra successful_count, failed_count và pending_count của daily_summaries và job_summaries. Mọi sự kiện ở trạng thái đang chờ xử lý có thể mất đến 24 giờ để hoàn tất.

Bạn có thể xem thêm thông tin về cách cải thiện tính năng chẩn đoán dữ liệu ngoại tuyến trong Trung tâm trợ giúp.

Quy định hạn chế

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

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

    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 quá trình nhập.

  • Google Ads coi các lỗi CLICK_NOT_FOUND từ lượt nhập lượt chuyển đổi nâng cao cho khách hàng tiềm năng 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.

Trước
Biến lượt chuyển đổi tùy chỉnh
Tiếp
Liên kết với các chỉ số giao diện người dùng