En iyi uygulamalar

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.

İstemci tarafında verileri doğrulama

Data Manager API, hızlı başarısızlık modelini kullanır. Bir istekteki herhangi bir kayıt, eşzamanlı doğrulamada başarısız olursa isteğin tamamı başarısız olur ve kayıtların hiçbiri işlenmez. Ayrıca API, istekleri sıralı katmanlarda doğrular. Bu nedenle, bir hatanın düzeltilmesi sonraki bir doğrulama katmanındaki hatayı ortaya çıkarabilir.

Tekrarlanan gidiş dönüşleri ve reddedilen istekleri önlemek için verilerinizi göndermeden önce doğrulayın ve temizleyin:

• Karma oluşturmadan önce boş değerleri kaldırın: SHA-256 karmalarını hesaplamadan önce email_address ve phone_number gibi alanlarda boş veya yalnızca boşluk içeren dizeler olup olmadığını kontrol edin. Boş bir dizeye karma oluşturma işlemi uygulandığında, söz dizimi kontrollerini geçen ancak eşleşme oranlarını düşüren geçerli bir karma oluşturulur.

• Eksik bileşik nesneleri bırakma: Bileşik nesneleri bir kayda eklemeden önce tüm zorunlu alanların doldurulduğundan emin olun. Örneğin, bir AddressInfo nesnesinin gerekli dört alanından (given_name, family_name, region_code veya postal_code) herhangi biri eksikse REQUIRED_FIELD_MISSING hatalarını önlemek için address tanımlayıcısının tamamını bırakın.

• Kodlama ve düz metin alanlarını doğrulayın: Karma oluşturma işlemi uygulanmış alanların, ham düz metin göndermek yerine beyan edilen encoding ile eşleştiğini doğrulayın ve düz metin olarak kalması gereken alanların (ör. mobile_ids) karma oluşturma işlemine tabi tutulmadığından emin olun.

• Sınır dışı zaman damgalarını filtreleme: Zaman damgalarının gelecekte veya hedefin dönüşüm yeniden inceleme aralığından daha eski olmadığından emin olun.

  İstekleri JSON kullanarak gönderiyorsanız zaman damgası dizelerinin saat dilimi farkıyla RFC 3339 biçimini kullandığından emin olun.

• Telefon numaralarını temizleme: Karma oluşturma işleminden önce telefon numaralarının ülke kodu içerdiğini ve E.164 biçimini kullandığını doğrulayın.

• Boş veya çok büyük kayıtları ayıklayın: user_identifiers değerini kayıt başına sınır (10 tanımlayıcı) ile sınırlayın, boş özel parametreleri bırakın ve geçerli tanımlayıcı içermeyen kayıtları atlayın.

• Kullanım alanı koşullarını doğrulayın: Her etkinliğin, hedefi ve kullanım alanı için tüm zorunlu alanları (ör. Google Ads online dönüşümleri için transaction_id) içerdiğinden emin olun. Kullanım alanına göre zorunlu alanların tam listesi için Etkinliklere genel bakış bölümünde hedefinizle ilgili etkinlik gönderme kılavuzuna bakın.

• İstekleri test etmek için validateOnly kullanın: Verileri beslemeden veya kaldırmadan hızlı başarısızlık hatalarını yakalamak için validateOnly parametresi true olarak ayarlanmış istekler gönderin. Yalnızca doğrulama isteğinin başarılı olması, eşzamansız işleme sırasında hata olmayacağını garanti etmez. Bu nedenle, normal bir istek gönderdikten sonra istek durumunu ve teşhisleri kontrol etmeye devam edin.

Ayrıntılı normalleştirme ve karma oluşturma kuralları için Kullanıcı verilerini biçimlendirme başlıklı makaleyi inceleyin.

İstek durumunu ve teşhisleri kontrol etme

Her IngestAudienceMembersResponse veya IngestEventsResponse için request_id bilgisini yakalayıp toplayın ve istek kimliklerini kullanarak istek durumunu ve teşhis bilgilerini kontrol edin.

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.