Teşhisler

Etkinlik ve kitle yüklemelerinizin durumunu doğrulamak ve verilerinizdeki sorunları belirlemek için önerilen iş akışını aşağıda bulabilirsiniz.

1. Etkinlik gönderme veya kitle üyelerini gönderme ya da kaldırma istekleri gönderme

2. Her isteğin genel durumunu kontrol edin. Başarılı bir istekte code değeri 0'e (enum değeri OK, HTTP yanıtı 200 OK) eşit olan bir Status bulunur ve IngestEventsResponse, IngestAudienceMembersResponse veya RemoveAudienceMembersResponse döndürülür.

   İstek başarılı olmazsa hatayı gidermek için isteği değiştirin ve tekrar gönderin.

   Bir istek başarılı olursa yanıtın request_id değerini yakalayın. Böylece, sonraki adımda teşhis bilgilerini almak için bu değeri kullanabilirsiniz.

3. Her başarılı request_id için bir RetrieveRequestStatus isteği gönderin.

4. Yüklemelerinizin düzgün çalıştığını onaylamak ve verilerinizle ilgili sorunları belirlemek için her RetrieveRequestStatusResponse inceleyin.

5. Veri sorunlarını düzeltin.

6. 1. adıma geri dönün ve yüklemelerinizle ilgili tüm sorunları giderene kadar tekrarlayın.

Oluşturma istekleri

Bir RetrieveRequestStatusRequest, tek bir request_id alana sahiptir. Alma istekleri gönderirken yakaladığınız her başarılı istek kimliği için bir istek gönderin.

Yanıtları inceleme

RetrieveRequestStatusResponse içindeki request_status_per_destination, ilgili alım isteğindeki her hedef için ayrı bir giriş içerir.

Örneğin, IngestAudienceMembersRequest, 3 farklı kitleye veri göndermek için destinations listesinde 3 giriş içeriyorsa durum yanıtı request_status_per_destination içinde 3 giriş içerir (kitle başına bir giriş).

Genel hedef durumunu kontrol etme

İlk adım olarak, request_status alanını kontrol ederek Veri Yöneticisi API'sinin RequestStatusPerDestination destination için verileri işlemeyi tamamlayıp tamamlamadığını belirleyin. request_status için olası değerler şunlardır:

• PROCESSING: Hedefle ilgili veriler hâlâ işleniyor.
• SUCCESS: Hedef için istek işleme hatasız tamamlandı.
• FAILURE: Hedefle ilgili tüm kayıtlar hatalar nedeniyle başarısız oldu.
• PARTIAL_SUCCESS: Hedefle ilgili bazı kayıtlar başarılı oldu ancak diğerleri hatalar nedeniyle başarısız oldu.

Hedef başına etkinlik veya kitle durumunu kontrol etme

Alım isteği türüne karşılık gelen durum alanını inceleyin. Her RequestStatusPerDestination üzerinde aşağıdaki alanlardan yalnızca biri ayarlanır:

• events_ingestion_status
• audience_members_ingestion_status
• audience_members_removal_status

Etkinlik alma durumu

İstek bir IngestEventsRequest ise events_ingestion_status alanı doldurulur.

Alınan kayıtların toplam sayısının beklentilerinizi karşıladığını doğrulamak için IngestEventStatus record_count değerini kontrol edin. record_count, hem başarılı hem de başarısız kayıtları içerir.

Kitle üyelerinin alım durumu

İstek bir IngestAudienceMembersRequest ise audience_members_ingestion_status alanı doldurulur. Her kitle verisi türü için kontrol edilecek IngestAudienceMembersStatus alanı aşağıda verilmiştir. Bu alanlardan yalnızca biri ayarlanır.

user_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestUserDataStatus record_count bölümünü kontrol edin. record_count hem başarılı hem de başarısız kayıtları içerir.

Alınan kullanıcı tanımlayıcılarının sayısının beklentilerinizle eşleştiğini onaylamak için user_identifier_count işaretini kontrol edin.

İstek yeterli sayıda kayıt içeriyorsa upload_match_rate_range, istekteki kayıtların eşleşme oranı aralığını gösterir.

mobile_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestMobileDataStatus record_count değerini kontrol edin. record_count hem başarılı hem de başarısız kayıtları içerir.

Alınan mobil kimlik sayısının beklentilerinizi karşıladığını onaylamak için mobile_id_count işaretini kontrol edin.

pair_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestPairDataStatus record_count bölümünü kontrol edin. record_count hem başarılı hem de başarısız kayıtları içerir.

Alınan PAIR kimliklerinin sayısının beklentilerinizi karşıladığını onaylamak için pair_id_count işaretini kontrol edin.

Kitle üyelerini kaldırma durumu

İstek bir RemoveAudienceMembersRequest ise audience_members_removal_status alanı doldurulur. Her bir kitle verisi türü için kontrol edilecek RemoveAudienceMembersStatus alanı aşağıda verilmiştir. Bu alanlardan yalnızca biri ayarlanır.

user_data_removal_status

Kullanıcı verileri için kaldırma durumu.

mobile_data_removal_status

Mobil veriler için kaldırma durumu.

pair_data_removal_status

PAIR verileri için kaldırma durumu.

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını onaylamak için record_count işaretini kontrol edin. record_count, hem başarılı hem de başarısız kayıtları içerir.

Ayrıca, alınan kullanıcı tanımlayıcılarının, mobil kimliklerin veya PAIR kimliklerinin toplam sayısını onaylamak için user_identifier_count, mobile_id_count ya da pair_id_count simgelerini kontrol edin.

Uyarıları ve hataları kontrol etme

Hedef ve istek türüyle ilgili durum alanlarına ek olarak, RetrieveRequestStatusResponse, istekle ilgili uyarı ve hataların dökümünü içerir.

• Hata, API'nin kaydı tamamen reddettiğini gösterir.
• Uyarı, API'nin kaydı reddetmediğini ancak kaydın verilerinin bir kısmını yoksayması gerektiğini gösterir.

Örneğin, bir Event şifrelenmiş UserIdentifier verileri ve gclid gibi AdIdentifiers içeriyorsa ve UserIdentifier verilerinin şifresi çözülemiyorsa Veri Yöneticisi API, kaydı AdIdentifiers kullanarak işlemeye devam eder ancak PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR uyarısını döndürür.

Ancak Event, AdIdentifiers içermiyorsa ve UserIdentifier verilerinin şifresi çözülemiyorsa Data Manager API, kaydın tamamını reddeder ve PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR hatasını bildirir. Bunun nedeni, geçerli bir Event'nın en az bir ad_identifiers veya user_data içermesi gerektiğidir.

Uyarı ve hata bilgilerini içeren yanıt alanları aşağıda verilmiştir.

warning_info

WarningCount nesnelerinin listesi. Her WarningCount, uyarı türünü içeren bir reason ve bu türde uyarı içeren kayıt sayısını gösteren bir record_count içerir.

error_info

ErrorCount nesnelerinin listesi. Her ErrorCount, hata türünü içeren bir reason ve bu hata türü nedeniyle başarısız olan kayıt sayısını belirten bir record_count içerir.