Diagnostik

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

  1. Mengirim permintaan untuk mengirim peristiwa atau mengirim atau menghapus anggota audiens.
  2. Ambil request_id dari setiap IngestEventsResponse, IngestAudienceMembersResponse, atau RemoveAudienceMembersResponse.
  3. Kirim permintaan RetrieveRequestStatus untuk setiap request_id.
  4. Tinjau setiap RetrieveRequestStatusResponse untuk mengonfirmasi bahwa upload Anda berfungsi dengan benar dan mengidentifikasi masalah apa pun pada data Anda.
  5. Perbaiki masalah data.
  6. Kembali ke langkah 1 dan ulangi hingga Anda mengatasi semua masalah pada upload Anda.

Membuat permintaan

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

Meninjau respons

request_status_per_destination dalam RetrieveRequestStatusResponse berisi entri terpisah untuk setiap tujuan dalam permintaan penyerapan 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 dalam request_status_per_destination (satu entri per audiens).

Memeriksa status keseluruhan tujuan

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 request_status:

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

Memeriksa status peristiwa atau audiens per tujuan

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

Status penyerapan 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. record_count mencakup catatan yang berhasil dan gagal.

Status penyerapan anggota audiens

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

user_data_ingestion_status

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

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

Jika permintaan memiliki jumlah data yang memadai, upload_match_rate_range berisi rentang tingkat kecocokan untuk data dalam permintaan.

mobile_data_ingestion_status

Periksa record_countIngestMobileDataStatus untuk mengonfirmasi bahwa total jumlah data yang diterima sesuai dengan harapan Anda. record_count mencakup record 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_countIngestPairDataStatus untuk mengonfirmasi bahwa jumlah total data yang diterima sesuai dengan harapan Anda. record_count mencakup catatan yang berhasil dan gagal.

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

Status penghapusan anggota audiens

Kolom audience_members_removal_status diisi jika permintaan adalah RemoveAudienceMembersRequest. Berikut kolom RemoveAudienceMembersStatus yang harus 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.

Periksa record_count untuk mengonfirmasi bahwa total jumlah data yang diterima sesuai dengan harapan Anda. record_count mencakup catatan 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.

Periksa peringatan dan error

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

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

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

Namun, jika Event tidak berisi AdIdentifiers dan data UserIdentifier tidak dapat didekripsi, Data Manager API akan menolak seluruh rekaman 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 adalah kolom respons yang berisi informasi peringatan dan error.

warning_info
Daftar objek WarningCount. Setiap WarningCount berisi reason dengan jenis peringatan, dan record_count yang menunjukkan jumlah data yang memiliki peringatan jenis tersebut.
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.