Data Manager API'yi kullanırken aşağıdaki en iyi uygulamaları göz önünde bulundurun.
Tüm kullanıcı kimliklerini gönder
UserData ile kitle üyeleri veya etkinlikler gönderirken, aynı türden birden fazla tanımlayıcı göndermek de dahil olmak üzere mümkün olduğunca çok user_identifiers ekleyin.
Örneğin, bir kullanıcının birden fazla e-posta adresi varsa her e-posta adresi için ayrı bir UserIdentifier ekleyin. Benzer şekilde, bir kullanıcı için e-posta adresleri, telefon numaraları ve adresler gibi farklı türlerde tanımlayıcılarınız varsa maksimum tanımlayıcı sayısına kadar her tanımlayıcı için ayrı bir UserIdentifier ekleyin.
İstekleri optimize etme
Günlük istek sınırlarını aşma olasılığını azaltmak için her istekte mümkün olduğunca çok öğeyi istek başına sınırlara kadar gruplandırın.
Örneğin, bir kitleye 10.000 kitle üyesi eklemek istiyorsanız 10.000 üyenin tamamını tek bir IngestAudienceMembersRequest içinde audience_members listesine ekleyin. 10.000 üyenin tamamını tek bir istekte toplu olarak eklemek,her bir kitle üyesini eklemek için ayrı bir istek göndermekten daha verimlidir.
Eşzamanlı istekler gönderme
Verileri almak için gereken toplam süreyi azaltmak istiyorsanız IngestionService'e eşzamanlı istekler gönderin. Dakika başına istek sınırının aşılma olasılığını azaltmak için aynı anda en fazla 10 istek göndermenizi öneririz.
İstekler aynı destinations değerine sahip olsa bile eşzamanlı istekler gönderebilirsiniz.
Hızlı başarısızlık hatalarını kontrol etmek için validateOnly kullanın.
Hızlı başarısızlık hatalarını yakalamak için validateOnly parametresi true olarak ayarlanmış istekler gönderin. Veri Yöneticisi API'si, normal bir istekte olduğu gibi aynı doğrulama kontrollerini çalıştırır ancak herhangi bir veriyi beslemez veya kaldırmaz.
Yalnızca doğrulama isteğinin başarılı olması, işleme sırasında hata olmayacağını garanti etmez. Bu nedenle, normal bir istek gönderdikten sonra teşhisleri kontrol etmeye devam edin.
Teşhisleri kontrol et
Her IngestAudienceMembersResponse veya IngestEventsResponse için request_id değerini yakalayıp toplayın ve teşhisleri kontrol etmek için istek kimliklerini kullanın.
Kotaları izleme ve kotalarla ilgili uyarılar alma
Beklenmedik istek retlerini önlemek için Google Cloud Console'da kota uyarıları ve izleme ayarlarını yapın. Kota kullanımını izlemek, tüketim modellerini takip etmenize ve uygulamanız günlük veya dakikalık sınırlara ulaşmadan önce istek gruplandırmayı optimize etmenize yardımcı olur.
Üretime dağıtma
Yerel testten üretim iş yüklerine geçerken etkileşimli olmayan ve güvenli bir şekilde kimlik doğrulaması yapmak için ekli bir hizmet hesabı veya Workload Identity Federasyonu ile Uygulama Varsayılan Kimlik Bilgileri'ni kullanın.
Farklı üretim ortamları için kimlik doğrulama yapılandırması hakkında ayrıntılı bilgi edinmek istiyorsanız Üretim ortamına dağıtma başlıklı makaleyi inceleyin.