Sürüm notları

Her Data Manager API sürümünde değişenleri buradan öğrenebilirsiniz.

30.07.2026 1.8 sürümü

• Belirtilen kullanıcı listelerindeki tüm kitle üyelerini kaldırmak veya değiştirmek için IngestionService'ye RemoveAllAudienceMembers yöntemi eklendi.
  • Başlamak için belirli entegrasyonunuzda bir kitledeki tüm üyeleri kaldırma kılavuzunu inceleyin. Örneğin, Google Ads veya Display & Video 360 için Müşteri Eşleştirme kılavuzlarına bakın.
• Etkinlik ve kitle alımı sırasında ayrıntılı uyarılar döndürme desteği eklendi.
  • field_warnings alanı, IngestEventsResponse ve IngestAudienceMembersResponse'ye eklendi. Bu alanlar, FieldWarning nesnelerinin listesini içerir.
  • FieldWarning kaynağı eklendi. Bu kaynakta reason (WarningReason ), description ve field yolu bulunuyor.
  • WarningReason enum'u, özel değişkenlerin etkinleştirilmemesi veya alışveriş sepeti verilerinde satıcı kimliklerinin eksik olması gibi uyarı nedenlerini tanımlamak için ekledik.
• Google Analytics etkinlik alımı için ek adres alanları gönderme desteği eklendi.
  • AddressInfo (UserData içinde kullanılır) öğesine address_line, city ve administrative_area alanları eklendi.
• INVALID_REMOVE_AS_OF_TIME ve REQUIRED_PREREQUISITE_LINK_MISSING hata nedenleri, ErrorReason enum'ına eklendi.

2026-05-28 v1.7

• Çevrimdışı dönüşüm etkinliklerinin Campaign Manager 360, Search Ads 360 ve Display & Video 360 dahil olmak üzere Google Marketing Platform ürünlerine IngestEventsRequest kullanılarak gönderilmesi için destek eklendi.

  • Floodlight hedeflerini desteklemek için AccountType enum'una FLOODLIGHT_CONFIG eklendi.
  • AdIdentifiers öğesine dclid, impression_id, match_id ve encrypted_user_ids alanları eklendi.
  • Dönüşüm miktarlarının izlenmesini desteklemek için Event kaynağına conversion_count alanı eklendi.

  Başlamak için etkinlik gönderme kılavuzuna göz atın veya Campaign Manager 360 API'den nasıl yükselteceğinizi öğrenin.

• AudienceMember kaynağına composite_data alanı eklendi. Bu alan, CompositeData nesnesini kabul eder ve UserData ile IpData gibi birden fazla tanımlayıcı türünü birleştirmenize olanak tanır. Daha fazla bilgi için Bileşik veriler bölümüne bakın.

  • CompositeData kullanan kitle üyesi istekleri için teşhisleri (record_count ve data_type_counts) içeren yeni durumlar (IngestCompositeDataStatus ve RemoveCompositeDataStatus) eklendi.

• Birleşik verilerde IpData göndererek Google Ads Müşteri Eşleştirme için IP adreslerinin alınması desteği eklendi.

• ErrorReason enum'una FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED ve INSIGHTS_MISSING_FOR_DIMENSION yeni hata nedenleri eklendi.

• Etkinlik alımı sırasında oluşan hatalarla ilgili daha ayrıntılı geri bildirim sağlamak için ProcessingErrorReason'ye yeni teşhis değerleri eklendi.

2026-05-07 v1.6

• IngestEventsRequest kullanarak Google Ads mağaza satışı dönüşümlerini gönderme desteği eklendi. Bu özelliği kullanmak için Google Ads hesabınızın belirli uygunluk koşullarını karşılaması gerekir.
  • Event öğesine event_location alanı eklendi. Bu alan, fiziksel store_id. sağlamayı destekler.
  • Event öğesine third_party_user_data alanı eklendi. Böylece, alınan veriler açıkça üçüncü tarafa ait olarak işaretlenebilecek.
    • Bu alanın doldurulmasına yalnızca veri iş ortakları izin verilir.
  • Item kaynağına aşağıdaki alanlar eklendi:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (ItemCustomVariable nesnelerinin listesini kabul eder)
  • Başlamak için aşağıdaki rehberlere göz atın:
    • Google Ads'den yükseltme
    • Etkinlik gönderme
• Ayrılmış etkinlik olmayan tüm web veya uygulama etkinliklerinin Google Analytics'e gönderilmesi için destek eklendi.
  • Event kaynağına app_instance_id alanı eklendi.
  • Kullanıcının cihazıyla ilgili meta veriler sağlamak için DeviceInfo'ye alanlar eklendi.
  • AdIdentifiers'a mobile_device_id alanı eklendi.
  • event_location alanını Event'a ekleyerek city, subdivision_code, region_code, subcontinent_code ve continent_code gibi alanları yakalayın.
  • Başlamak için aşağıdaki rehberlere göz atın:
    • Önerilen ve özel etkinlikleri gönderme
    • Measurement Protocol'den yükseltme
    • Önerilen etkinlikler referansı
• İşlem kimliği içeren tüm etkinliklerin hem web hem de uygulama veri akışlarına gönderilmesi için destek eklendi. Bu özellik, etiket veya Firebase için Google Analytics (GA4F) SDK uygulamalarınızda ek bir veri kaynağı olarak kullanılabilir.
  • Bu özellik, izin verilenler listesindeki Google Analytics mülkleriyle sınırlıdır. Mülkünüzü izin verilenler listesine eklemek istiyorsanız bu formu doldurun.
• Google Ads ve Google Analytics'e gönderilen etkinlikler için sepete uygulanan tüm kupon kodlarını izlemek üzere CartData'e coupon_codes alanı eklendi.
  • Google Ads'deki kupon kullanımıyla ilgili kullanım alanları için OFFLINE_PROMOTION_REDEMPTION dönüşüm türünü kullanın.
• İş ortağı bağlantıları oluşturma, arama ve silmeyle ilgili yöntemler için yeni bir OAuth kapsamı (https://www.googleapis.com/auth/datamanager.partnerlink) eklendi.
• Mağaza satışları ve Google Analytics etkinliklerinin ayrıntılı olarak doğrulanmasını desteklemek için ErrorReason numaralandırılmış türüne yeni değerler eklendi.
• SizeInfo kaynağına youtube_members_count ve gmail_members_count alanları eklendi.

2026-03-26

• EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED, ErrorReason enum'ına eklendi.

  Google, Avrupa Birliği Siyasi Reklamlar Tüzüğü'ne (EU PAR) uymak için tüm müşterilerin, reklamlarının EU PAR kapsamında siyasi reklam olarak kabul edilip edilmediğini beyan etmesini zorunlu kılar. AB siyasi reklamlarının nasıl tanımlandığını ve Google'ın AB'deki siyasi reklamlarla ilgili kısıtlamalarını öğrenin.

  1 Nisan 2026'dan itibaren, bu beyanın bulunmadığı hesaplarda aşağıdaki işlemler kısıtlanabilir veya EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED hatasıyla başarısız olabilir.

  • UserListService (create, update ve delete)
  • IngestionService (ingestAudienceMembers)

  Hatayı çözmek için reklamverenlerin Google Ads kullanıcı arayüzünde zorunlu beyanı sağlaması gerekir. Hesabınız için nasıl onay vereceğiniz hakkında daha fazla bilgi edinin.

• INVALID_MERCHANT_ID, ErrorReason enum'ına eklendi.

17.02.2026 v1.5

Data Manager API artık kitle oluşturma, alma ve getirme dahil olmak üzere kitleleri yönetmeye yönelik tüm uçtan uca iş akışını destekliyor.

• Kullanıcı listeleri oluşturma, alma, güncelleme ve silme işlemlerine olanak tanımak için UserList kaynağı ve UserListService eklendi.
  • Data Manager API'yi kullanarak müşteri eşleştirme kitlelerini oluşturma, doldurma ve doğrulama sürecinin tamamını öğrenmek için Google Ads veya Display & Video 360 kılavuzlarına göz atın.
  • Taşıma adımları için Google Ads veya Display & Video 360 yükseltme kılavuzlarına bakın.
• Kitle üyesi alımı aracılığıyla kullanıcı kimliği gönderme desteği eklendi. Bu sayede, Google Ads'de Müşteri Eşleştirme ile birlikte kullanılabilir.
  • UserIdData, AudienceMember listesine eklendi.
  • RetrieveRequestStatus yönteminin döndürdüğü durumlara IngestUserIdDataStatus ve RemoveUserIdDataStatus eklendi. Kullanıcı kimliği alma ve kaldırma ile ilgili teşhis bilgilerini almak için bu alanları kullanın.
• Reklamveren ve veri iş ortağı hesapları arasında bağlantı oluşturmak ve bu bağlantıları yönetmek için PartnerLink kaynağı ve PartnerLinkService eklendi.
  • Başlamak için İş ortağı bağlantıları kılavuzlarına göz atın.

2026-02-10

Performansı ve veri gücünü artırmak için birden fazla veri kaynağı içeren dönüşümler gönderme özelliği artık tüm Google Ads hesaplarında genel olarak kullanılabilir.

Bu özellik, yalnızca izin verilenler listesindeki Google Analytics mülklerinde kullanılabilir. Google Analytics mülkünüzü izin verilenler listesine eklemek istiyorsanız formu doldurun.

2025-11-05 v1.4

• Reklam etkileşimi sinyallerini en üst düzeye çıkarmak, verilerinizi ve genel performansınızı güçlendirmek için Google Analytics purchase etkinliklerinin etiket dönüşümleriniz için ek bir veri kaynağı olarak gönderilmesine destek eklendi.

  • GOOGLE_ANALYTICS_PROPERTY, AccountType enum'una eklendi.
  • Event öğesine birden fazla alan eklendi:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • additional_user_properties, UserProperties listesine eklendi.

  Google Analytics purchase etkinliklerini gönderme ve Google Analytics etkinlik parametreleri ile kullanıcı özelliklerini Data Manager API'sindeki karşılıklarıyla eşleme hakkında daha fazla bilgiyi etkinlikler kılavuzunda bulabilirsiniz.

• AWS Anahtar Yönetim Hizmeti'ten şifreleme anahtarlarının kullanımını desteklemek için AwsWrappedKeyInfo eklendi.

• ErrorReason öğesine aşağıdaki enum değerleri eklendi:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

• Data Manager API artık tüm kullanıcılar tarafından genel olarak kullanılabilir.

  Performansı ve veri gücünü artırmak için birden fazla veri kaynağı içeren dönüşümler gönderme özelliği, yalnızca izin verilenler listesindeki hesaplar tarafından kullanılabilir. Hesabınızı eklemek istiyorsanız formu doldurun.

  Veri iş ortağı olmak istediğinizi belirtmek için iş ortağı ilgi formunu doldurun.

• Etkinlik ve kitle alımı istekleri için teşhis bilgilerini alma amacıyla RetrieveRequestStatus yöntemi eklendi.

• ProductAccount ve Product enum'unun product alanı kullanımdan kaldırıldı. Bunun yerine account_type alanını ve yeni AccountType enum'ını kullanın.

• IngestAudienceMembersRequest içindeki her AudienceMember için destination belirtme desteği eklendi. Bu özelliği kullanarak kitle verilerini tek bir istekte birden fazla farklı hedefe gönderebilirsiniz.

• API ile alınan kitleler, en az 100 üyeye ulaştıktan sonra hedeflenmeye uygun hale gelir. Daha önce üye eşiği bin üyeydi.

• Potansiyel müşteriler için çevrimdışı dönüşümler veya gelişmiş dönüşümler gönderilirken Event parametresinin transaction_id değeri artık isteğe bağlıdır. Performansı ve veri gücünü artırmak için çevrimdışı dönüşümleri ek veri kaynağı olarak gönderirken transaction_id hâlâ gereklidir.

2025-08-06 v1.2

• IngestEvents yöntemini kullanarak Google Ads reklam hedeflerine çevrimdışı dönüşümler ve potansiyel müşteriler için gelişmiş dönüşümler gönderme desteği eklendi. Bu dönüşümler için şifrelemenin nasıl yapılandırılacağını öğrenmek üzere güncellenen şifreleme kılavuzuna bakın.
• EventSource enum'una APP, IN_STORE, PHONE ve OTHER değerleri eklendi. Çevrimdışı dönüşümler ve potansiyel müşteriler için gelişmiş dönüşümler için event_source gereklidir.
• Event öğesine user_properties alanı eklendi. Etkinlik gerçekleştiğinde kullanıcı hakkında UserProperties nesnesine bu alanı ayarlayarak reklamveren tarafından değerlendirilen bilgileri ekleyin.
• CustomVariable öğesine destination_references yinelenen alan eklendi. Bu alanı, özelleştirilebilen değişken değerini bir Event için hedeflerin yalnızca bir alt kümesine uygulamak üzere kullanın.
• Çevrimdışı dönüşümler ve potansiyel müşteriler için gelişmiş dönüşümlerle ilgili aşağıdaki hatalar eklendi:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

• IngestionService sınıfına IngestEvents yöntemi eklendi. Reklam etkileşimi sinyallerini en üst düzeye çıkarmak, verilerinizi ve genel performansınızı güçlendirmek için IngestEvents'i etiket dönüşümleriniz için ek bir veri kaynağı olarak kullanın.

2025-04-02 v1.0

• Kitle verilerinin Google Ads ve Display & Video 360'a gönderilmesini destekleyen Data Manager API'nin ilk sürümü.
• gRPC ve REST için destek eklendi.
• Aşağıdaki veri türlerini kullanarak kitle üyelerini yönetmek için IngestionService ile IngestAudienceMembers ve RemoveAudienceMembers yöntemleri eklendi:
  • İletişim bilgileri
  • Mobil kimlikler
  • PAIR kimlikleri
• Data Manager API kullanılarak yönetilen kitlelerin hedeflenebilmesi için en az 1.000 üyesi olması gerekir.