Diagnostik

Berikut alur kerja yang direkomendasikan untuk memverifikasi kondisi upload peristiwa dan audiens Anda serta mengidentifikasi masalah pada data Anda.

Kirim permintaan untuk mengirim peristiwa atau mengirim atau menghapus anggota audiens.
Periksa status keseluruhan setiap permintaan. Permintaan yang berhasil memiliki Status dengan code yang sama dengan 0 (nilai enum OK, HTTP respons 200 OK), dan menampilkan IngestEventsResponse, IngestAudienceMembersResponse, atau RemoveAudienceMembersResponse.

Jika permintaan tidak berhasil, ubah permintaan untuk mengatasi error dan kirim permintaan lagi.

Jika permintaan berhasil, ambil request_id respons sehingga Anda dapat menggunakannya untuk mengambil diagnostik pada langkah berikutnya.

Catatan:Anda hanya dapat mengambil diagnostik untuk permintaan yang berhasil dan tidak memiliki validate_only yang ditetapkan ke true.
Kirim permintaan RetrieveRequestStatus untuk setiap request_id yang berhasil.
Tinjau setiap RetrieveRequestStatusResponse untuk mengonfirmasi bahwa upload Anda berfungsi dengan baik dan mengidentifikasi masalah pada data Anda.
Koreksi masalah data.
Kembali ke langkah 1 dan ulangi hingga Anda mengatasi semua masalah pada upload Anda.

Kirim permintaan

A RetrieveRequestStatusRequest memiliki satu request_id kolom. Kirim satu permintaan untuk setiap ID permintaan yang berhasil Anda ambil saat mengirim permintaan transfer.

Coba permintaan di browser Anda menggunakan API Explorer.

Tinjau respons

request_status_per_destination di RetrieveRequestStatusResponse berisi entri terpisah untuk setiap tujuan dalam permintaan transfer yang sesuai.

Misalnya, jika IngestAudienceMembersRequest Anda berisi 3 entri dalam daftar destinations untuk mengirim data ke 3 audiens yang berbeda, respons status akan berisi 3 entri di request_status_per_destination (satu entri per audiens).

Memeriksa status tujuan keseluruhan

Sebagai langkah pertama, periksa kolom request_status untuk menentukan apakah Data Manager API telah selesai memproses data untuk destination dari RequestStatusPerDestination. Berikut adalah kemungkinan nilai dari request_status:

PROCESSING: Data untuk tujuan masih diproses.
SUCCESS: Pemrosesan permintaan untuk tujuan selesai tanpa error.
FAILURE: Semua data untuk tujuan gagal karena error.
PARTIAL_SUCCESS: Beberapa data untuk tujuan berhasil, tetapi yang lain gagal karena error.

Memeriksa status peristiwa atau audiens per tujuan

Periksa kolom status yang sesuai dengan jenis permintaan transfer. Hanya satu kolom berikut yang ditetapkan pada setiap RequestStatusPerDestination:

events_ingestion_status
audience_members_ingestion_status
audience_members_removal_status

Status transfer peristiwa

Kolom events_ingestion_status diisi jika permintaan adalah IngestEventsRequest.

Periksa record_count dari IngestEventStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal records.

Status transfer anggota audiens

Kolom audience_members_ingestion_status diisi jika permintaan adalah IngestAudienceMembersRequest. Berikut kolom IngestAudienceMembersStatus yang akan diperiksa untuk setiap jenis data audiens. Hanya satu kolom ini yang ditetapkan.

user_data_ingestion_status

Periksa record_count dari IngestUserDataStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Periksa user_identifier_count untuk mengonfirmasi bahwa jumlah ID pengguna yang diterima sesuai dengan harapan Anda.

Jika permintaan memiliki jumlah data yang cukup, upload_match_rate_range akan berisi rentang rasio kecocokan untuk data dalam permintaan.

mobile_data_ingestion_status

Periksa record_count dari IngestMobileDataStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Periksa mobile_id_count untuk mengonfirmasi bahwa jumlah ID seluler yang diterima sesuai dengan harapan Anda.

pair_data_ingestion_status

Periksa record_count dari IngestPairDataStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Periksa pair_id_count untuk mengonfirmasi bahwa jumlah ID PAIR yang diterima sesuai dengan harapan Anda.

ppid_data_ingestion_status

Periksa record_count dari IngestPpidDataStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Periksa ppid_count untuk mengonfirmasi bahwa jumlah PPID yang diterima sesuai dengan harapan Anda.

user_id_data_ingestion_status

Periksa record_count dari IngestUserIdDataStatus untuk mengonfirmasi bahwa total jumlah data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Periksa user_id_count untuk mengonfirmasi bahwa jumlah ID pengguna yang diterima sesuai dengan harapan Anda.

Status penghapusan anggota audiens

Kolom audience_members_removal_status diisi jika permintaan adalah RemoveAudienceMembersRequest. Berikut kolom RemoveAudienceMembersStatus yang akan diperiksa untuk setiap jenis data audiens. Hanya satu kolom ini yang ditetapkan.

user_data_removal_status: Status penghapusan untuk data pengguna.
mobile_data_removal_status: Status penghapusan untuk data seluler.
pair_data_removal_status: Status penghapusan untuk data PAIR.
ppid_data_removal_status: Status penghapusan untuk data PPID.
user_id_data_removal_status

Periksa record_count untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. The record_count mencakup data yang berhasil dan gagal.

Selain itu, periksa user_identifier_count, mobile_id_count, atau pair_id_count untuk mengonfirmasi jumlah total ID pengguna, ID seluler, atau ID PAIR yang diterima.

Memeriksa peringatan dan error

Selain kolom status untuk jenis tujuan dan permintaan, the RetrieveRequestStatusResponse berisi perincian peringatan dan error untuk permintaan.

Error menunjukkan bahwa API sepenuhnya menolak data.
Peringatan menunjukkan bahwa API tidak menolak data, tetapi harus mengabaikan sebagian data.

Misalnya, jika Event berisi data terenkripsi UserIdentifier dan AdIdentifiers seperti gclid, dan data UserIdentifier tidak dapat didekripsi, Data Manager API akan tetap memproses data menggunakan AdIdentifiers, tetapi menampilkan peringatan PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR.

Namun, jika Event tidak berisi AdIdentifiers dan UserIdentifier data tidak dapat didekripsi, Data Manager API akan menolak seluruh data dan melaporkan error PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR karena Event yang valid harus memiliki setidaknya salah satu dari ad_identifiers atau user_data.

Berikut kolom respons yang berisi informasi peringatan dan error.

warning_info: Daftar objek WarningCount. Setiap WarningCount berisi reason dengan jenis peringatan, dan a record_count yang menunjukkan jumlah data yang memiliki peringatan jenis that type.
error_info: Daftar objek ErrorCount. Setiap ErrorCount berisi reason dengan jenis error, dan record_count yang menunjukkan jumlah data yang gagal karena jenis error tersebut.