Catatan rilis

Di sini Anda dapat mempelajari perubahan di setiap rilis Data Manager API.

2026-11-04 v1.9

• Menambahkan dukungan untuk mengirim konversi panggilan Google Ads.

  • Menambahkan kolom call_info ke Event. Gunakan kolom start_timestamp dari CallInfo untuk menentukan kapan panggilan telepon yang menghasilkan konversi dimulai.

  Lihat panduan mengirim konversi panggilan untuk memulai, atau pelajari cara mengupgrade dari Google Ads API.

• Menambahkan kolom record_indices ke ErrorCount dan WarningCount untuk mengidentifikasi data dalam permintaan penyerapan yang memiliki setiap error atau peringatan pemrosesan. Untuk mengetahui detail tentang cara menggunakan kolom ini, lihat Memeriksa data yang terpengaruh.

• Menambahkan kolom lead_id ke AdIdentifiers untuk mendukung pengiriman ID yang dibuat Google yang dikeluarkan saat pengguna mengirimkan formulir prospek.

• Menambahkan alasan error ENCRYPTION_NOT_SUPPORTED, DUPLICATE_ELEMENTS, UNSUPPORTED_BASELINE_LOCATION, CONVERSION_PRECEDES_CALL, INVALID_AD_IDENTIFIER_FOR_ACCOUNT, CONVERSION_ACTION_TOO_RECENTLY_CREATED, REQUEST_TOO_OLD, dan INVALID_DATE ke enum ErrorReason.

• Menambahkan alasan error PROCESSING_ERROR_REASON_DESTINATION_TOO_RECENTLY_CREATED, PROCESSING_ERROR_REASON_TOO_RECENT_CALL, PROCESSING_ERROR_REASON_EXPIRED_CALL, dan PROCESSING_ERROR_REASON_INVALID_CALL ke enum ProcessingErrorReason.

• Menambahkan alasan peringatan PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED dan PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED ke enum ProcessingWarningReason.

• Menambahkan alasan peringatan WARNING_REASON_INVALID_NUMBER_FORMAT ke enum WarningReason.

30-07-2026 v1.8

• Menambahkan metode RemoveAllAudienceMembers ke IngestionService untuk menghapus atau mengganti semua anggota audiens untuk daftar pengguna yang ditentukan.
  • Untuk memulai, tinjau panduan tentang cara menghapus semua anggota dari audiens untuk integrasi spesifik Anda. Misalnya, lihat panduan Customer Match untuk Google Ads atau Display & Video 360.
• Menambahkan dukungan untuk menampilkan peringatan mendetail selama penyerapan peristiwa dan audiens.
  • Menambahkan kolom field_warnings ke IngestEventsResponse dan IngestAudienceMembersResponse yang berisi daftar objek FieldWarning.
  • Menambahkan resource FieldWarning, yang berisi jalur reason (WarningReason ), description, dan field.
  • Menambahkan enum WarningReason untuk menentukan alasan peringatan, seperti variabel kustom yang tidak diaktifkan atau ID penjual yang tidak ada dalam data keranjang.
• Menambahkan dukungan untuk mengirim kolom alamat tambahan untuk penyerapan peristiwa Google Analytics.
  • Menambahkan kolom address_line, city, dan administrative_area ke AddressInfo (digunakan di UserData).
• Menambahkan alasan error INVALID_REMOVE_AS_OF_TIME dan REQUIRED_PREREQUISITE_LINK_MISSING ke enum ErrorReason.

28-05-2026 v1.7

• Menambahkan dukungan untuk mengirim peristiwa konversi offline ke produk Google Marketing Platform, termasuk Campaign Manager 360, Search Ads 360, dan Display & Video 360, menggunakan IngestEventsRequest.

  • Menambahkan FLOODLIGHT_CONFIG ke enum AccountType untuk mendukung tujuan Floodlight.
  • Menambahkan kolom dclid, impression_id, match_id, dan encrypted_user_ids ke AdIdentifiers.
  • Menambahkan kolom conversion_count ke resource Event untuk mendukung pelacakan jumlah konversi.

  Lihat panduan mengirim peristiwa untuk memulai, atau pelajari cara mengupgrade dari Campaign Manager 360 API.

• Menambahkan kolom composite_data ke resource AudienceMember, yang menerima objek CompositeData dan memungkinkan Anda menggabungkan beberapa jenis ID, seperti UserData dan IpData. Lihat Data gabungan untuk mengetahui informasi selengkapnya.

  • Menambahkan status baru IngestCompositeDataStatus dan RemoveCompositeDataStatus yang menyertakan diagnostik (record_count dan data_type_counts) untuk permintaan anggota audiens yang menggunakan CompositeData.

• Menambahkan dukungan untuk penyerapan alamat IP untuk Customer Match Google Ads dengan mengirimkan IpData dalam data gabungan.

• Menambahkan alasan error baru FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, dan INSIGHTS_MISSING_FOR_DIMENSION ke enum ErrorReason.

• Menambahkan nilai diagnostik baru ke ProcessingErrorReason untuk memberikan masukan yang lebih terperinci terkait kegagalan selama penyerapan peristiwa.

07-05-2026 v1.6

• Menambahkan dukungan untuk mengirim konversi penjualan toko Google Ads menggunakan IngestEventsRequest. Untuk menggunakan fitur ini, akun Google Ads Anda harus memenuhi persyaratan kelayakan tertentu.
  • Menambahkan kolom event_location ke Event, yang mendukung penyediaan store_id. fisik
  • Menambahkan kolom third_party_user_data ke Event, sehingga data yang diserap dapat ditandai secara eksplisit sebagai milik pihak ketiga.
    • Pengisian kolom ini hanya diizinkan untuk partner data.
  • Menambahkan kolom berikut ke resource Item:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (menerima daftar objek ItemCustomVariable)
  • Lihat panduan berikut untuk memulai:
    • Mengupgrade dari Google Ads
    • Mengirim peristiwa
• Menambahkan dukungan untuk mengirim peristiwa web atau aplikasi apa pun ke Google Analytics yang bukan merupakan peristiwa yang dicadangkan.
  • Menambahkan kolom app_instance_id ke resource Event.
  • Menambahkan kolom ke DeviceInfo untuk memberikan metadata tentang perangkat pengguna.
  • Menambahkan kolom mobile_device_id ke AdIdentifiers.
  • Menambahkan kolom event_location ke Event untuk mengambil kolom seperti city, subdivision_code, region_code, subcontinent_code, dan continent_code.
  • Lihat panduan berikut untuk memulai:
    • Mengirim peristiwa yang direkomendasikan dan peristiwa kustom
    • Mengupgrade dari Measurement Protocol
    • Referensi peristiwa yang direkomendasikan
• Menambahkan dukungan untuk mengirim peristiwa apa pun dengan ID transaksi ke aliran data web dan aplikasi sebagai sumber data tambahan untuk penerapan tag atau Google Analytics for Firebase (GA4F) SDK Anda.
  • Fitur ini terbatas untuk properti Google Analytics yang ada dalam daftar yang diizinkan; isi formulir ini jika Anda tertarik untuk menambahkan properti Anda ke daftar yang diizinkan.
• Menambahkan kolom coupon_codes ke CartData untuk melacak semua kode kupon yang diterapkan ke keranjang untuk peristiwa yang dikirim ke Google Ads dan Google Analytics.
  • Untuk kasus penggunaan penukaran kupon di Google Ads, gunakan jenis konversi OFFLINE_PROMOTION_REDEMPTION.
• Menambahkan cakupan OAuth baru, https://www.googleapis.com/auth/datamanager.partnerlink, untuk metode yang terkait dengan pembuatan, penelusuran, dan penghapusan link partner.
• Menambahkan nilai baru ke enum ErrorReason untuk mendukung validasi mendetail untuk penjualan toko dan penyerapan peristiwa Google Analytics.
• Menambahkan kolom youtube_members_count dan gmail_members_count ke resource SizeInfo.

2026-03-26

• Menambahkan EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ke enum ErrorReason.

  Untuk mematuhi Peraturan Iklan Politik Uni Eropa (EU PAR), Google mewajibkan semua pelanggan untuk menyatakan sendiri apakah iklan mereka dianggap politik berdasarkan PAR Uni Eropa. Pelajari definisi iklan politik Uni Eropa dan pembatasan Google terhadap iklan politik di Uni Eropa.

  Mulai 1 April 2026, operasi berikut pada akun yang tidak memiliki pernyataan ini mungkin dibatasi atau gagal dengan error EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

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

  Untuk mengatasi error ini, pengiklan harus memberikan pernyataan wajib di UI Google Ads. Pelajari lebih lanjut cara memberikan konfirmasi untuk akun Anda.

• Menambahkan INVALID_MERCHANT_ID ke enum ErrorReason.

17-02-2026 v1.5

Data Manager API kini mendukung seluruh alur kerja menyeluruh untuk mengelola audiens, termasuk pembuatan, penyerapan, dan pengambilan audiens.

• Menambahkan resource UserList dan UserListService untuk memungkinkan pembuatan, pengambilan, pembaruan, dan penghapusan daftar pengguna.
  • Lihat panduan Google Ads atau Display & Video 360 untuk mengetahui panduan menyeluruh tentang cara membuat, mengisi, dan memverifikasi audiens Customer Match menggunakan Data Manager API.
  • Lihat panduan upgrade Google Ads atau Display & Video 360 untuk mengetahui langkah-langkah migrasi.
• Menambahkan dukungan untuk mengirim ID Pengguna melalui penyerapan anggota audiens, sehingga dapat digunakan dengan Customer Match di Google Ads.
  • UserIdData ditambahkan ke AudienceMember.
  • Menambahkan IngestUserIdDataStatus dan RemoveUserIdDataStatus ke status yang ditampilkan oleh metode RetrieveRequestStatus. Gunakan kolom ini untuk mengambil informasi diagnostik tentang penyerapan dan penghapusan ID Pengguna.
• Menambahkan resource PartnerLink dan PartnerLinkService untuk membuat dan mengelola tautan antara akun pengiklan dan partner data.
  • Lihat panduan Link partner untuk memulai.

2026-02-10

Pengiriman konversi dengan beberapa sumber data untuk meningkatkan performa dan kekuatan data kini tersedia secara umum untuk semua akun Google Ads.

Fitur ini masih hanya tersedia untuk properti Google Analytics yang ada dalam daftar yang diizinkan. Isi formulir jika Anda tertarik untuk menambahkan properti Google Analytics ke daftar yang diizinkan.

2025-11-05 v1.4

• Menambahkan dukungan untuk mengirim peristiwa purchase Google Analytics sebagai sumber data tambahan untuk konversi tag Anda, guna memaksimalkan sinyal interaksi iklan serta memperkuat data dan performa Anda secara keseluruhan.

  • Menambahkan GOOGLE_ANALYTICS_PROPERTY ke enum AccountType.
  • Menambahkan beberapa kolom ke Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • additional_user_properties ditambahkan ke UserProperties.

  Baca selengkapnya tentang cara mengirim peristiwa purchase Google Analytics dan cara memetakan parameter peristiwa dan properti pengguna Google Analytics ke parameter dan properti yang setara di Data Manager API dalam panduan peristiwa.

• Menambahkan AwsWrappedKeyInfo untuk mendukung penggunaan kunci enkripsi dari AWS Key Management Service.

• Menambahkan nilai enum berikut ke ErrorReason:

  • 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

06-10-2025 v1.3

• Data Manager API kini tersedia secara umum untuk semua pengguna.

  Mengirim konversi dengan beberapa sumber data untuk meningkatkan performa dan kekuatan data masih hanya tersedia untuk akun yang diizinkan. Isi formulir jika Anda tertarik untuk menambahkan akun.

  Isi formulir minat partner untuk menyatakan minat menjadi partner data.

• Menambahkan metode RetrieveRequestStatus untuk mengambil informasi diagnostik untuk permintaan penyerapan peristiwa dan audiens.

• Kolom product dari ProductAccount dan enum Product tidak digunakan lagi. Sebagai gantinya, gunakan kolom account_type dan enum AccountType baru.

• Menambahkan dukungan untuk menentukan destination untuk setiap AudienceMember dalam IngestAudienceMembersRequest. Gunakan fitur ini untuk mengirim data audiens ke beberapa tujuan yang berbeda dalam satu permintaan.

• Audiens yang diserap dengan API kini memenuhi syarat untuk penargetan setelah memiliki minimal 100 anggota. Sebelumnya, batas jumlah anggota adalah seribu anggota.

• transaction_id Event kini bersifat opsional saat mengirim konversi offline atau konversi yang disempurnakan untuk prospek. transaction_id masih diperlukan saat mengirim konversi offline sebagai sumber data tambahan untuk meningkatkan performa dan kekuatan data.

06-08-2025 v1.2

• Menambahkan dukungan untuk mengirim konversi offline dan konversi yang disempurnakan untuk prospek ke tujuan Google Ads menggunakan metode IngestEvents. Lihat panduan enkripsi yang diperbarui untuk mengetahui cara mengonfigurasi enkripsi untuk konversi ini.
• Menambahkan nilai APP, IN_STORE, PHONE, dan OTHER ke enum EventSource. event_source diperlukan untuk konversi offline dan konversi yang disempurnakan untuk prospek.
• Menambahkan kolom user_properties ke Event. Tetapkan kolom ini ke objek UserProperties untuk menambahkan informasi yang dinilai pengiklan tentang pengguna saat peristiwa terjadi.
• Menambahkan kolom berulang destination_references ke CustomVariable. Gunakan kolom ini untuk menerapkan nilai variabel kustom hanya ke subkumpulan tujuan untuk Event.
• Menambahkan error berikut untuk konversi offline dan konversi yang disempurnakan untuk prospek:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

25-06-2025 v1.1

• Menambahkan metode IngestEvents ke IngestionService. Gunakan IngestEvents sebagai sumber data tambahan untuk konversi tag Anda, guna memaksimalkan sinyal interaksi iklan dan memperkuat data serta performa Anda secara keseluruhan.

2025-04-02 v1.0

• Rilis pertama Data Manager API, dengan dukungan untuk mengirim data audiens ke Google Ads dan Display & Video 360.
• Menambahkan dukungan untuk gRPC dan REST.
• Menambahkan IngestionService dengan metode IngestAudienceMembers dan RemoveAudienceMembers untuk mengelola anggota audiens menggunakan jenis data berikut:
  • Contact information
  • Mobile ID
  • ID PAIR
• Audiens yang dikelola menggunakan Data Manager API hanya memenuhi syarat untuk penargetan jika memiliki minimal 1.000 anggota.