Hãy sử dụng API Google Ads để truy xuất thông tin chẩn đoán dữ liệu ngoại tuyến. Thông tin này 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.
Để truy xuất thông tin chẩn đoán về dữ liệu ngoại tuyến mới nhất cho tài khoản của bạn, hãy gửi truy vấn sau cho tài nguyên offline_conversion_upload_client_summary
bằ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 biệt 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 tệp tải lên cho client
. Bảng này cũng chứa tổng số sự kiện đã nhận được, số sự kiện được xử lý thành công và trường alerts
cung cấp thông tin tóm tắt về các lỗi, được nhóm theo OfflineConversionError
.
Tất cả các trường này đều chứa thông tin về ngày tải lên đầy đủ 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 tệp 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
- Một
successful_count
vàfailed_count
yêu cầu tải lên trong 7 ngày qua, được nhóm theodate
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 theojob_id
.job_id
là trường không bắt buộc củaUploadClickConversionsRequest
vàUploadConversionAdjustmentsRequest
. Bạn có thể đặtjob_id
thành một số không âm nhỏ hơn2^31
hoặc cho phép 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ặcUploadConversionAdjustmentsResponse
đều 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 khi bạn có một công việc hoặc quy trình tải lên một lượng lớn lượt chuyển đổi thông qua nhiều yêu cầu. Nếu đặtjob_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 nhập duy nhất cho công việc từjob_summaries
. Nếu bạn cho phép API Google Ads chỉ định một giá trị do hệ thống tạo chojob_id
của mỗi yêu cầu, thìjob_summaries
sẽ chứa một mục nhập 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 tính năng tóm tắt
Để đảm bảo quy trình tải lên của bạn đang ghi lại các lượt chuyển đổi và tính năng nâng cao như mong đợi, hãy truy xuất bản tóm tắt định kỳ 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 bớt hoặc loại bỏ các lỗi đó.
Ví dụ:
Nếu trạng thái là
NEEDS_ATTENTION
, tức là một phần đáng kể hoạt động tải lên của bạn đã thất bại. Xem xét các lỗi trongalerts
và sửa đổi quy trình tải lên để giảm hoặc loại bỏ những lỗi đó.Nếu trạng thái là
NO_RECENT_UPLOADS
, tức là Google Ads chưa nhận được bất kỳ tệp tải lên nào gần đây choclient
. Nếu đây không phải là điều bạn mong muốn, hãy xem lại các quy trình thực hiện việc tải lên bằng ứng dụng đó.Ví dụ: nếu
status
choGOOGLE_ADS_API
làNO_RECENT_UPLOADS
, thì điều đó có thể cho thấy rằng gần đây, quy trình tải lên sử dụng API Google Ads đã ngừng chạy.Kiểm tra
successful_count
vàfailed_count
củadaily_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 các bản tóm tắt đã tải lên:
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ầusearchStream
hoặcsearch
giống với 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 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 yêu cầu trong đó
customer_id
khớp vớicustomer_id
của tài khoản người quản lý mà bạn sử dụng trong tệp tải lên.Google Ads coi
CLICK_NOT_FOUND
lỗi trong các lượt tải lên 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ếualerts
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àosuccessful_event_count
.