Data Manager API güncellemeleri: RemoveAllAudienceMembers yöntemi, veri kullanımı alanı uyarıları, genişletilmiş adres verileri

30 Temmuz 2026, Perşembe

Data Manager API'nin en son sürümü, kitle yönetimini basitleştiren, alan düzeyinde uyarılarla veri alımı iş akışlarını iyileştiren ve Google Analytics için daha ayrıntılı kullanıcı tarafından sağlanan veriler sağlayan özellikler sunar.

Tüm kitle üyelerini kaldırma

Belirtilen kullanıcı listelerindeki tüm üyeleri tek bir işlemle temizlemek için yeni RemoveAllAudienceMembers yöntemini kullanın. İsteğe bağlı removeAsOfTime parametresi, yalnızca belirli bir zaman damgasından önce eklenen üyeleri hedeflemenize olanak tanır.

Bu, özellikle kitle verilerinizin tam yenilemesini (veya "tümünü değiştir") yapmanız gerektiğinde kullanışlıdır. Mevcut listeyi temizleyip yeni bir kullanıcı grubuyla doldurmanıza olanak tanır.

Besleme alanı uyarıları

Data Manager API'nin veri alma yanıtları artık isteğe bağlı alanlardaki doğrulama sorunları için alan düzeyinde ayrıntılı uyarılar içeriyor. API, isteğe bağlı alanlarla ilgili doğrulama sorunları tespit ederse besleme isteğiniz başarılı olur ve besleme verilerinizin geri kalanı işlenmeye devam eder. Zorunlu alanlar için doğrulama hataları, hızlı başarısızlık modelini izleyerek tüm isteğin başarısız olmasına neden olmaya devam eder.

Sağladığınız isteğe bağlı alanlardan herhangi biri geçersizse IngestEventsRequest veya IngestAudienceMembersRequest yanıtı, FieldWarning nesnelerinin listesini içeren bir field_warnings alanı içerir. Her uyarıda belirli bir neden (WarningReason), açıklayıcı bir mesaj ve isteğin içinde sorunun oluştuğu alanın konumu yer alır.

Google Analytics etkinlikleri için ek adres verileri

Artık etkinlikleri Google Analytics hedeflerine aktarırken ek kullanıcı adresi bilgileri sağlayabilirsiniz. AddressInfo kaynağı, given_name, family_name, region_code ve postal_code alanlarının yanı sıra artık şunları da destekliyor:

  • address_line (açık adres)
  • city
  • administrative_area (eyalet veya il)

Ayrıca, Web veri akışlarına gönderilen çok kaynaklı etkinlikler için tanımlayıcı şartını karşılamak üzere mevcut kullanıcı tarafından sağlanan veriler (user_data) alanını kullanabilirsiniz. Bu sayede, çok kaynaklı bir etkinlik için ad_identifiers.gclid, user_id veya client_id yoksa başka bir seçeneğiniz olur.

Başlayın

Yapay zeka ajanı becerileriyle daha hızlı geliştirme yapın: Entegrasyonlarınızı hızlandırmanıza yardımcı olmak için kısa süre önce yeni Data Manager API yapay zeka ajanı becerilerini kullanıma sunduk. Yapay zeka destekli kodlama ortamınızda doğrudan daha doğru ve verimli rehberlik almak için Google Skills GitHub deposundaki yeni becerileri keşfedin.

Sorularınız varsa veya bu yayın hakkında görüşmek isterseniz lütfen "Google Reklamcılık ve Ölçüm Topluluğu" Discord sunucumuzdan bize ulaşın. API ile ilgili bir sorununuz varsa veya yardıma ihtiyacınız olursa destek sayfasından da bizimle iletişime geçebilirsiniz.

Veri iş ortağı olmak istiyorsanız lütfen İş Ortağı Talep Formu'nu doldurun.

Yazarın portresi - Lindsey Volta, Data Manager API Ekibi adına

Etiketler: analytics, data-manager-api