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ş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 olana 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 bir 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.

İ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.

Orijinal isteğin her hedefi için RetrieveRequestStatusRequest, request_status, SUCCESS, FAILURE veya PARTIAL_SUCCESS değerine ulaşana kadar eksponansiyel geri yükleme algoritması kullanarak request_status değerini düzenli olarak gönderin. Veri Yöneticisi API'si bazı isteklerin işlenmesini 30 dakika gibi kısa bir sürede tamamlayabilse de bu işlem 24 saati bulabilir.

Aşağıda, canlılık ve kota kullanımı arasında denge kuran makul bir ilk bekleme süresi ve yeniden deneme yapılandırması örneği verilmiştir:

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

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

Grafik

Yoklama Stratejisi

Veriler

Deneme Besleme İsteğinden Bu Yana Geçen Süre (ss:dd) Denemeden Önceki Gecikme Notlar
1 00:30 30,0 dk. Öncelikle durumun kullanılabilirliğini kontrol edin
2 01:09 39,0 dk.
3 01:59 50,7 dk
4 02:59 60,0 dk. Gecikme süresi artık en fazla 1 saat olabilir.
5 03:59 60,0 dk.
6 04:59 60,0 dk.
7 05:59 60,0 dk.
8 06:59 60,0 dk.
9 07:59 60,0 dk.
10 08:59 60,0 dk.
11 09:59 60,0 dk.
12 10:59 60,0 dk.
13 11:59 60,0 dk. 12 saatlik işaret
14 12:59 60,0 dk.
15 13:59 60,0 dk.
16 14:59 60,0 dk.
17 15:59 60,0 dk.
18 16:59 60,0 dk.
19 17:59 60,0 dk.
20 18:59 60,0 dk.
21 19:59 60,0 dk.
22 20:59 60,0 dk.
23 21:59 60,0 dk.
24 22:59 60,0 dk.
25 23:59 60,0 dk. 24 saatlik maksimum toplam süreden önceki son istek

Birçok istemcinin aynı anda yeniden denemesinden kaynaklanan "gürleyen kalabalık" 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 hata olup olmadığını 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:

Etkinlik alma durumu

İstek bir IngestEventsRequest ise events_ingestion_status alanı doldurulur.

Alınan toplam kayıt 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'ın 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 beklentilerinizi karşıladığını 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 bölümü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'ın 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.

ppid_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestPpidDataStatus'ın 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 PPID sayısının beklentilerinizi karşıladığını onaylamak için ppid_count simgesini kontrol edin.

user_id_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestUserIdDataStatus'ın 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ı kimliklerinin sayısının beklentilerinizi karşıladığını onaylamak için user_id_count işaretini kontrol edin.

composite_data_ingestion_status

Alınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için IngestCompositeDataStatus record_count bölümü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.

Kitle üyelerinin kaldırılma 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ı verilerinin kaldırılma durumu.
mobile_data_removal_status
Mobil verilerin kaldırılma durumu.
pair_data_removal_status
PAIR verileri için kaldırma durumu.
ppid_data_removal_status
PPID verileri için kaldırma durumu.
user_id_data_removal_status
Kullanıcı kimliği verileri için kaldırma durumu
composite_data_removal_status
Bileşik veriler 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 veya user_id_count değerlerini kontrol edin.

Bileşik veriler için, tanımlayıcı sayısının beklentilerinizi karşıladığını doğrulamak üzere data_type_counts simgesini 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.

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 veriler ve gclid gibi AdIdentifiers içeriyorsa ve UserIdentifier verilerin şifresi çözülemiyorsa Data Manager 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. Bu alanlar, genel hedef durumu SUCCESS, PARTIAL_SUCCESS veya FAILURE'e ulaştığında doldurulur.

warning_info

WarningCount nesnelerin listesi. Her WarningCount, uyarı türünü içeren bir reason ve bu tür uyarıya 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 nesnelerin 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.