Google Ads API cung cấp một công cụ mạnh mẽ cho phép bạn theo dõi và chẩn đoán dữ liệu ngoại tuyến, từ đó giúp cải thiện quá trình tải lên chuyển đổi. Việc này không chỉ giúp bạn theo dõi hiệu suất của các chiến dịch mà còn hỗ trợ xử lý các lỗi tiềm ẩn nhanh chóng và hiệu quả. Trong bài viết này, chúng ta sẽ tìm hiểu cách truy xuất thông tin chẩn đoán dữ liệu ngoại tuyến từ Google Ads API và các bước cần thực hiện để đánh giá tình trạng tải lên chuyển đổi của bạn.
Sử dụng Google Ads API để truy xuất thông tin chẩn đoán dữ liệu ngoại tuyến là một quy trình quan trọng, giúp theo dõi tình trạng của các lượt tải lên chuyển đổi và các điều chỉnh liên quan. Công cụ này cung cấp cái nhìn tổng thể về hiệu suất của tệp dữ liệu chuyển đổi, từ đó hỗ trợ tối ưu hóa các chiến dịch quảng cáo.
Để truy xuất thông tin chẩn đoán mới nhất liên quan đến dữ liệu ngoại tuyến cho tài khoản của bạn, bạn có thể sử dụng các tài nguyên sau:
- offline_conversion_upload_client_summary: Cung cấp tổng quan về tình trạng của các lượt tải lên chuyển đổi ở cấp độ tài khoản, bao gồm các thông tin về tỷ lệ thành công, số lượng sự kiện đang chờ xử lý, và các cảnh báo lỗi cần được giải quyết.
- offline_conversion_upload_conversion_action_summary (chỉ có sẵn từ phiên bản API 17 trở lên): Tóm tắt chi tiết về hiệu suất tải lên ở cấp hành động chuyển đổi, cho phép bạn phân tích sâu hơn về từng chiến dịch hoặc hành động cụ thể trong quá trình chuyển đổi.
Thông tin chẩn đoán ở cấp tài khoản
Để truy xuất dữ liệu chẩn đoán liên quan đến các lượt tải lên chuyển đổi tại cấp độ tài khoản, bạn có thể thực hiện truy vấn GAQL theo cú pháp 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 sẽ trả về các giá trị riêng biệt cho mỗi OfflineConversionUploadClientSummary, tương ứng với từng loại ứng dụng được sử dụng trong các lần tải lên gần đây. Ví dụ, nếu quá trình tải lên gần đây sử dụng cả Google Ads API và giao diện người dùng Google Ads, kết quả sẽ chứa các mục riêng cho các giá trị client như 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 dữ liệu chẩn đoán cho các lượt tải lên chuyển đổi tại cấp độ hành động chuyển đổi, bạn có thể sử dụng truy vấn GAQL dưới đây:
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ư ở cấp tài khoản, truy vấn này sẽ trả về dữ liệu riêng biệt cho từng OfflineConversionUploadConversionActionSummary, dựa trên loại ứng dụng được sử dụng trong các lần tải lên. Nếu bạn đã tải lên dữ liệu chuyển đổi gần đây qua cả API Google Ads và giao diện web, kết quả sẽ bao gồm các mục nhập khác nhau cho từng giá trị client như GOOGLE_ADS_API và GOOGLE_ADS_WEB_CLIENT.
Cách diễn giải các bản tóm tắt
Mỗi bản tóm tắt như OfflineConversionUploadClientSummary hoặc OfflineConversionUploadConversionActionSummary có trường status phản ánh tình trạng tổng thể của quá trình tải lên chuyển đổi cho client. Trường này cung cấp thông tin chi tiết về:
- Tổng số sự kiện đã nhận.
- Số sự kiện được xử lý thành công.
- Số lượng sự kiện đang chờ xử lý (các sự kiện đang trong quá trình xử lý).
Trường alerts cung cấp danh sách các lỗi, được phân loại theo OfflineConversionError. Tất cả các thông tin này đều dựa trên dữ liệu cập nhật nhất từ lịch sử tải lên. Bạn có thể sử dụng các dữ liệu này để đánh giá tình trạng hiện tại của các tệp tải lên chuyển đổi.
Ngoài ra, mỗi OfflineConversionUploadClientSummary hoặc OfflineConversionUploadConversionActionSummary đều cung cấp hai loại báo cáo riêng biệt:
- daily_summaries
- Bao gồm các chỉ số như
successful_count,failed_count, vàpending_countđối với các yêu cầu tải lên trong 7 ngày gần nhất, được nhóm theo ngày tải lên.
- Bao gồm các chỉ số như
- job_summaries
- Tóm tắt các chỉ số
successful_count,failed_count, vàpending_countdựa trên 7 công việc tải lên gần nhất, được nhóm theojob_id. Trườngjob_idlà không bắt buộc trong các yêu cầu nhưUploadClickConversionsRequestvàUploadConversionAdjustmentsRequest. Bạn có thể đặtjob_idcủa riêng mình với giá trị bất kỳ dưới 2^31, hoặc để hệ thống Google Ads API tự tạo mãjob_idcho mỗi yêu cầu. - Trong một số trường hợp, việc sử dụng
job_idtùy chỉnh sẽ hữu ích nếu bạn đang quản lý nhiều yêu cầu tải lên liên quan đến cùng một công việc lớn. Bằng cách này, bạn có thể truy xuất một mục nhập duy nhất trongjob_summariescho toàn bộ công việc. Nếu bạn để Google Ads API tự động tạo mãjob_id, mỗi yêu cầu sẽ có một mã riêng, điều này có thể khiến việc phân tích công việc phức tạp hơn.
- Tóm tắt các chỉ số
Cách sử dụng bản tóm tắt
Để đảm bảo rằng quy trình tải lên của bạn đang ghi nhận chính xác các lượt chuyển đổi và tính năng nâng cao như mong đợi, bạn cần truy xuất các bản tóm tắt định kỳ cho từng tài khoản. Nếu trạng thái (status) của bất kỳ bản tóm tắt nào không phải là EXCELLENT, hãy xem xét danh sách lỗi trong alerts để điều chỉnh quy trình tải lên 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, điều đó có nghĩa là một phần lớn trong các lần tải lên đã không thành công. Bạn nên kiểm tra lại các lỗi trong mụcalertsvà thực hiện các điều chỉnh cần thiết để giảm thiểu hoặc khắc phục 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ỳ dữ liệu tải lên nào gần đây từ client. Trong trường hợp đây không phải là mong muốn của bạn, hãy xem xét lại quy trình tải lên và kiểm tra ứng dụng liên quan. - Ví dụ: Nếu trạng thái của
GOOGLE_ADS_APIlàNO_RECENT_UPLOADS, điều đó có thể chỉ ra rằng quy trình tải lên qua Google Ads API đã ngừng hoạt động gần đây. - Để 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ý hay không, bạn có thể kiểm tra các chỉ số
successful_count,failed_count,pending_counttrong các bản tóm tắt hàng ngày (daily_summaries) và bản tóm tắt công việc (job_summaries). Lưu ý rằng các sự kiện ở trạng thái chờ xử lý có thể mất đến 24 giờ để hoàn tất.
Quy định hạn chế
Khi truy xuất bản tóm tắt nội dung tải lên qua Google Ads API, bạn cần lưu ý các quy định sau:
- Google Ads API chỉ trả về thông tin chẩn đoán liên quan đến dữ liệu ngoại tuyến nếu
customer_idtrong yêu cầusearchStreamhoặcsearchkhớp vớicustomer_idcủa tài khoản đã thực hiện tải lên lượt chuyển đổi gần đây.
Ví dụ: một tài khoản khách hàng có thể sử dụng tính năng theo dõi lượt chuyển đổi cho nhiều tài khoản khác nhau, và trong trường hợp này, có thể sẽ không có bất kỳ thông tin chẩn đoán nào được trả về. Tuy nhiên, bạn có thể lấy thông tin này bằng cách gửi yêu cầu vớicustomer_idkhớp vớicustomer_idcủa người quản lý tài khoản đã thực hiện quá trình tải lên chuyển đổi. - Google Ads xử lý lỗi
CLICK_NOT_FOUNDtừ các lượt tải lên chuyển đổi nâng cao dưới dạng cảnh báo. Do đó, nếualertschứa mục nhập cho lỗi này, giá trị tải lên vẫn được coi là thành công và được tính vàosuccessful_event_count.
Sử dụng Google Ads API để chẩn đoán dữ liệu ngoại tuyến là một cách hiệu quả để đảm bảo quy trình tải lên chuyển đổi của bạn hoạt động trơn tru. Bằng cách theo dõi và xử lý các thông tin cảnh báo, bạn có thể nâng cao tỷ lệ thành công của các lượt tải lên và tối ưu hóa hiệu suất chiến dịch. Hãy đảm bảo truy xuất thông tin chẩn đoán định kỳ để kịp thời phát hiện và khắc phục các lỗi, giúp chiến dịch Google Ads của bạn đạt hiệu quả tốt nhất.
