Sürüm notları

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

2026-07-30 v1.8

• 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 tüm üyeleri bir kitleye ekleme ve bu kitleden 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.
  • reason (WarningReason ), description ve field yolu içeren FieldWarning kaynağı eklendi.
  • WarningReason enum'u, uyarıların nedenlerini (ör. özel değişkenlerin etkinleştirilmemesi veya alışveriş sepeti verilerinde satıcı kimliklerinin eksik olması) 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.

28.05.2026 v1.7

• IngestEventsRequest kullanarak Campaign Manager 360, Search Ads 360 ve Display & Video 360 dahil olmak üzere Google Marketing Platform ürünlerine çevrimdışı dönüşüm etkinlikleri gönderme desteği 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 adlı 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'e third_party_user_data alanı eklendi. Bu sayede, alınan verilerin açıkça üçüncü tarafa ait olduğu 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 nesnelerin 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 kılavuzlara 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ını 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)

  Reklamverenlerin hatayı çözmek için 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 alma dahil olmak üzere kitleleri yönetmeye yönelik tüm uçtan uca iş akışını destekliyor.

• Kullanıcı listelerinin oluşturulmasına, alınmasına, güncellenmesine ve silinmesine 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.
  • IngestUserIdDataStatus ve RemoveUserIdDataStatus, RetrieveRequestStatus yöntemi tarafından döndürülen durumlara eklendi. Kullanıcı kimliği alımı ve kaldırılmasıyla 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ğıyla dönüşüm 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 Veri Yöneticisi API'deki karşılıklarıyla eşleme hakkında daha fazla bilgiyi etkinlikler kılavuzunda bulabilirsiniz.

• AwsWrappedKeyInfo AWS Anahtar Yönetim Hizmeti'ten şifreleme anahtarlarının kullanılmasını desteklemek için 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

• Veri Yöneticisi API'si 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ğı talep 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 üyesi olduğunda hedefleme için uygun hale gelir. Daha önce, üye eşiği bin üyeydi.

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

2025-08-06 v1.2

• IngestEvents yöntemini kullanarak çevrimdışı dönüşümleri ve potansiyel müşteriler için gelişmiş dönüşümleri Google Ads hedeflerine gönderme desteği eklendi. Bu dönüşümler için şifrelemeyi nasıl yapılandıracağınızı öğrenmek istiyorsanız 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ı, bir Event için yalnızca hedeflerin bir alt kümesine özel değişken değeri 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.