Sử dụng API Google Ads để truy xuất 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 tệp tải lên chuyển đổi và các quá trình điều chỉnh.
Để 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:
offline_conversion_upload_client_summary
tổng hợp thông tin chẩn đoán về video tải lên ở tài khoản.offline_conversion_upload_conversion_action_summary
(chỉ có trong phiên bản 17 trở lên) tổng hợp thông tin chẩn đoán về video tải lên ở cấp hành động chuyển đổi.
Thông tin 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 làm theo các bước sau Truy vấn 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
Truy vấn này trả về các giá trị riêng biệt
OfflineConversionUploadClientSummary
hàng cho mỗi 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 bạn
tải lên gần đây bằng cả API Google Ads và Giao diện người dùng Google Ads, thì kết quả
chứa các mục nhập riêng 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ư chẩn đoán cấp tài khoản, truy vấn này trả về các truy vấn riêng biệt
OfflineConversionUploadConversionActionSummary
hàng cho mỗi 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 bạn
tải lên gần đây bằng cả API Google Ads và Giao diện người dùng Google Ads, thì kết quả
chứa các mục nhập riêng 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ó trường status
phản ánh
sức khoẻ tổng thể
video tải lên cho client
. Trường này cũng chứa các thông tin sau:
- Tổng số sự kiện đã nhận.
- Số lượng sự kiện được 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 bản tóm tắt các lỗi, được nhóm theoOfflineConversionError
.
Tất cả các trường này chứa thông tin từ ngày đầy đủ gần đây nhất theo lịch video tải lên. 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
hoặc
OfflineConversionUploadConversionActionSummary
chứa hai ngôn ngữ khác nhau
loại báo cáo:
daily_summaries
successful_count
,failed_count
vàpending_count
yêu cầu tải lên trong 7 ngày qua, được nhóm theo dữ liệu tải lêndate
.job_summaries
successful_count
,failed_count
vàpending_count
trong số 7 trò chơi phổ biến nhất các yêu cầu tải lên gần đây, được nhóm theojob_id
.job_id
là trường không bắt buộc trong sốUploadClickConversionsRequest
vàUploadConversionAdjustmentsRequest
. Bạn có thể đặtjob_id
thành một số không âm nhỏ hơn2^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 phương án nào chọn,UploadClickConversionsResponse
hoặcUploadConversionAdjustmentsResponse
trả vềjob_id
.Có một tình huống trong đó việc chỉ định
job_id
của riêng bạn lại hữu ích là khi bạn có công việc hoặc quy trình tải lên một số lượng lớn chuyển đổi sử dụng nhiều yêu cầu. Nếu bạn đặ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
. Thay vào đó, nếu bạn để API Google Ads chỉ định dữ liệu do hệ thống tạo vàojob_id
của mỗi yêu cầu, thìjob_summaries
sẽ chứa một mã cho mỗi yêu cầu, nhờ đó có thể giúp bạn phân tích tình trạng tổng thể của công việc 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 đang ghi lại các lượt chuyển đổi và tính năng nâng cao dưới dạng
như dự kiến, hãy truy xuất định kỳ các bản tóm tắt cho mỗi 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 để giảm bớt hoặc
loại bỏ những lỗi đó.
Ví dụ:
Nếu trạng thái là
NEEDS_ATTENTION
, thì một phần đáng kể của không thực hiện được thao tác tải lên. Xem lại các lỗi trongalerts
và sửa đổi để 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ỳ dữ liệu nào gần đây video tải lên 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 tải lên bằng ứng dụng đó.Ví dụ: nếu
status
choGOOGLE_ADS_API
làNO_RECENT_UPLOADS
, thì có thể cho biết rằng quy trình tải lên sử dụng API Google Ads đã ngừng chạy gần đây.Để xác định xem có một ngày tải lên hoặc một công việc cụ thể nào đã gửi một lượng lớn số lượng sự kiện không xử lý được, hãy xem
successful_count
,failed_count
,pending_count
/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.
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
/ Yêu cầusearchStream
hoặcsearch
giống với khách hàng 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 yêu cầu trong đó
customer_id
khớp vớicustomer_id
của người quản lý tài khoản mà bạn sử dụng trong video tải lên.Google Ads xử lý
CLICK_NOT_FOUND
lỗi từ lượt chuyển đổi nâng cao cho khách hàng tiềm năng tải lên dưới dạng cảnh báo. Như kết quả, nếualerts
chứa mục nhập cho lỗi này, thì giá trị vẫn được coi là thành công và được đưa vàosuccessful_event_count
.