Teşhisler

Etkinlik ve kitle yüklemelerinizin durumunu doğrulayıp 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 (numara değeri OK, HTTP yanıtı 200 OK) eşit olan bir Status bulunur ve IngestEventsResponse, IngestAudienceMembersResponse veya RemoveAudienceMembersResponse döndürülür.

   Bir istek 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şhisleri almak için bu değeri kullanabilirsiniz.

3. 30 dakika bekleyin, ardından her başarılı RetrieveRequestStatus için bir request_id isteği gönderin.

   Her request_id için bu adımı, her hedef için hedef durumu SUCCESS, PARTIAL_SUCCESS veya FAILURE değerine ulaşana kadar düzenli olarak tekrarlayın. Her istek arasında beklemek için eksponansiyel geri yükleme algoritması kullanın.

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

5. Veri sorunlarını düzeltin.

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

İstekleri gönderme

RetrieveRequestStatusRequest için tek bir request_id değeri gerekir. Başarılı bir alım isteğinden aldığınız her istek kimliği için ayrı bir durum isteği gönderin.

RetrieveRequestStatusRequest, request_status her hedef için orijinal istekte SUCCESS, FAILURE veya PARTIAL_SUCCESS değerine ulaşana kadar eksponansiyel geri yükleme algoritması kullanılarak düzenli aralıklarla gönderilir. Bu işlem 24 saate kadar sürebilir. Ancak Data Manager API, bazı isteklerin işlenmesini 30 dakika gibi kısa bir sürede tamamlayabilir.

Canlılık ve kota kullanımını dengeleyen makul bir ilk bekleme süresi ve yeniden deneme yapılandırması örneğini aşağıda bulabilirsiniz:

Ayar	Değer
İlk teşhis isteğinden önceki bekleme süresi (dakika)	30
Geri çekilme çarpanı	1.3
Maksimum geri yükleme aralığı (dakika)	60 (1 saat)
Maksimum toplam süre (dakika)	1440 (24 saat)

Bu yapılandırmayla istek sırası ve geçen süre aşağıda verilmiştir:

Birçok istemcinin aynı anda yeniden denediği "gürleyen sürü" sorununu önlemek için geri çekilme gecikmelerine küçük bir rastgele titreme miktarı ekleyin.

Yanıtları incele

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 Data Manager API'nin 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. Bu aşamada hedef için uyarılar ve hatalar doldurulmaz.

• SUCCESS: Hedefle ilgili istek işleme hatasız tamamlandı. İşleme sırasında işaretlenen uyarıları kontrol edin.

• FAILURE: Hedefle ilgili tüm kayıtlar hatalar nedeniyle başarısız oldu. Tüm kayıtların neden başarısız olduğunu belirlemek için uyarı ve hataları kontrol edin. Ayrıca, işleme sırasında işaretlenen uyarıları da kontrol edin.

• PARTIAL_SUCCESS: Hedefle ilgili bazı kayıtlar başarılı oldu ancak diğerleri hatalar nedeniyle başarısız oldu. Bazı kayıtların neden başarısız olduğunu belirlemek için hataları kontrol edin. Ayrıca, işleme sırasında işaretlenen uyarıları da kontrol edin.

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 besleme durumu

İstek bir IngestEventsRequest ise events_ingestion_status alanı doldurulur.

Alınan toplam kayıt sayısının beklentilerinize uygun olduğunu doğrulamak için IngestEventStatus record_count bölümünü 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.

composite_data_ingestion_status

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

Tanımlayıcı sayısının beklentilerinizi karşıladığını onaylamak için data_type_counts işaretini kontrol edin. Bu listede, DataType tarafından alınan tüm tanımlayıcıların (ör. e-posta adresi, telefon numarası, fiziksel adres ve IP adresi) dökümü yer alır.

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

google_user_id_data_ingestion_status

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

Alınan Google kullanıcı kimliklerinin sayısının beklentilerinizi karşıladığını onaylamak için google_user_id_count işaretini kontrol edin.

mobile_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını onaylamak için record_countIngestMobileDataStatus sayısını 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 değerini kontrol edin. record_count hem başarılı hem de başarısız kayıtları içerir.

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

partner_provided_id_data_ingestion_status

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

İş ortağı tarafından sağlanan kimliklerin sayısının beklentilerinizi karşıladığını onaylamak için partner_provided_id_count işaretini kontrol edin.

ppid_data_ingestion_status

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

Alınan PPID sayısının beklentilerinizi karşıladığını onaylamak için ppid_count işaretini kontrol edin.

user_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestUserDataStatus record_count değerini 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.

user_id_data_ingestion_status

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

Alınan kullanıcı kimliği sayısının beklentilerinizle eşleştiğini onaylamak için user_id_count işaretini kontrol edin.

Kitle üyelerinin kaldırılma durumu

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

composite_data_removal_status

Bileşik veriler için kaldırma durumu

google_user_id_data_removal_status

Google kullanıcı kimliği 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.

partner_provided_id_data_removal_status

İş ortağı tarafından sağlanan kimlik verileri

için kaldırma durumu

ppid_data_removal_status

PPID verileri için kaldırma durumu.

user_data_removal_status

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

user_id_data_removal_status

Kullanıcı kimliği 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 tanımlayıcıların toplam sayısını onaylamak için user_identifier_count, mobile_id_count, pair_id_count, ppid_count, user_id_count, google_user_id_count veya partner_provided_id_count'yı kontrol edin.

Bileşik veriler için data_type_counts simgesini kontrol ederek tanımlayıcı sayısının beklentilerinizi karşıladığını doğrulayın. Bu listede, DataType tarafından alınan tüm tanımlayıcıların (ör. e-posta adresi, telefon numarası, fiziksel adres ve IP adresi) dökümü yer alır.

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ı yoksaymak zorunda kaldığını gösterir.

Örneğin, bir Event şifrelenmiş UserIdentifier veriler ve gclid gibi AdIdentifiers içeriyorsa ve UserIdentifier verilerin şifresi çözülemiyorsa Data Manager API'si, AdIdentifiers kullanarak kaydı 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. Bu alanlar, genel hedef durumu SUCCESS, PARTIAL_SUCCESS veya FAILURE'ye ulaştığında doldurulur.

warning_info

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

Genel hedef durumu SUCCESS olsa bile warning_info simgesini kontrol edin.

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ı gösteren bir record_count içerir.