Etkinlik ve kitle yüklemelerinizin durumunu doğrulamak ve verilerinizle ilgili sorunları belirlemek için önerilen iş akışını aşağıda bulabilirsiniz.
Etkinlik gönderme veya kitle üyelerini gönderme ya da kaldırma istekleri gönderme
Her isteğin genel durumunu kontrol edin. Başarılı bir istekte
codedeğeri0'e (enum değeriOK, HTTP yanıtı200 OK) eşit olan birStatusbulunur veIngestEventsResponse,IngestAudienceMembersResponseveyaRemoveAudienceMembersResponsedö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_iddeğerini yakalayın. Böylece, sonraki adımda teşhis bilgilerini almak için bu değeri kullanabilirsiniz.30 dakika bekleyin, ardından her başarılı
RetrieveRequestStatusiçin birrequest_idisteği gönderin.Her bir
request_idiçin bu adımı, her bir hedef için hedef durumuSUCCESS,PARTIAL_SUCCESSveyaFAILUREolana kadar düzenli olarak tekrarlayın. Her istek arasında beklemek için eksponansiyel geri yükleme algoritması kullanın.Yüklemelerinizin düzgün çalıştığını onaylamak ve verilerinizle ilgili sorunları belirlemek için her
RetrieveRequestStatusResponseinceleyin.Veri sorunlarını düzeltin.
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.
RetrieveRequestStatusRequest, orijinal isteğin her hedefi için request_status, SUCCESS, FAILURE veya PARTIAL_SUCCESS değerine ulaşana kadar eksponansiyel geri yükleme algoritması kullanarak düzenli aralıklarla 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ını dengeleyen 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 ç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:
Grafik
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 1 saat ile sınırlı |
| 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 denemesine neden olan "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şleme işlemini 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: Hedef için 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 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_statusAlınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için
IngestUserDataStatus'ınrecord_countbölümünü kontrol edin.record_counthem 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_countiş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_statusAlınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için
IngestMobileDataStatusrecord_countsimgesini kontrol edin.record_counthem 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_countişaretini kontrol edin.pair_data_ingestion_statusAlınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için
IngestPairDataStatus'ınrecord_countbölümünü kontrol edin.record_counthem 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_countişaretini kontrol edin.ppid_data_ingestion_statusAlınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için
IngestPpidDataStatus'ınrecord_countbölümünü kontrol edin.record_counthem 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_countsimgesini kontrol edin.user_id_data_ingestion_statusAlınan toplam kayıt sayısının beklentilerinizi karşıladığını doğrulamak için
IngestUserIdDataStatus'ınrecord_countbölümünü kontrol edin.record_counthem 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_countişaretini kontrol edin.
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ı 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.
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
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 simgesini 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 Google Ads çevrimdışı dönüşümü için Event, şifrelenmiş UserIdentifier verileri ve gclid gibi AdIdentifiers içeriyorsa ve UserIdentifier verilerinin ş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 Google Ads çevrimdışı dönüşüm 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_infoWarningCountnesnenin listesi. HerWarningCount, uyarı türünü içeren birreasonve bu tür uyarıya sahip kayıt sayısını gösteren birrecord_countiçerir.Genel hedef durumu
SUCCESSolsa bilewarning_infosimgesini kontrol edin.error_infoErrorCountnesnenin listesi. HerErrorCount, hata türünü içeren birreasonve bu hata türü nedeniyle başarısız olan kayıt sayısını belirten birrecord_countiçerir.