Informacje o wersjach

Tutaj dowiesz się, co się zmieniło w poszczególnych wersjach interfejsu Data Manager API.

30 lipca 2026 r. v1.8

• Aby usuwać lub zastępować wszystkich członków list odbiorców określonych użytkowników, dodaliśmy do IngestionService metodę RemoveAllAudienceMembers.
  • Na początek zapoznaj się z przewodnikiem na temat usuwania wszystkich członków z listy odbiorców w przypadku konkretnej integracji. Na przykład zapoznaj się z przewodnikami dotyczącymi kierowania na listę klientów w Google Ads lub Display & Video 360.
• Dodaliśmy obsługę zwracania szczegółowych ostrzeżeń podczas importowania zdarzeń i list odbiorców.
  • Do interfejsów IngestEventsResponse i IngestAudienceMembersResponse dodaliśmy pole field_warnings, które zawiera listę FieldWarning obiektów.
  • Dodaliśmy zasób FieldWarning , który zawiera pole reason (WarningReason ), description i ścieżkę field.
  • Dodaliśmy WarningReason wyliczenie, aby określać przyczyny ostrzeżeń, np. brak włączenia zmiennych niestandardowych lub brak identyfikatorów sprzedawców w danych koszyka.
• Dodaliśmy obsługę wysyłania dodatkowych pól adresu na potrzeby importowania zdarzeń Google Analytics.
  • Dodaliśmy pola address_line, city i administrative_area do AddressInfo (używanego w UserData).
• Do typu wyliczeniowego ErrorReason dodaliśmy przyczyny błędów INVALID_REMOVE_AS_OF_TIME i REQUIRED_PREREQUISITE_LINK_MISSING.

28 maja 2026 r. v1.7

• Dodaliśmy obsługę wysyłania zdarzeń konwersji offline do usług Google Marketing Platform, w tym Campaign Managera 360, Search Ads 360 i Display & Video 360, za pomocą IngestEventsRequest.

  • Do typu wyliczeniowego AccountType dodaliśmy wartość FLOODLIGHT_CONFIG, aby obsługiwać miejsca docelowe Floodlight.
  • Dodaliśmy pola dclid, impression_id, match_id i encrypted_user_ids do AdIdentifiers.
  • Aby obsługiwać śledzenie liczby konwersji, do zasobu Event dodaliśmy pole conversion_count.

  Aby rozpocząć, zapoznaj się z przewodnikiem na temat wysyłania zdarzeń lub dowiedz się, jak przejść z interfejsu Campaign Manager 360 API.

• Do zasobu AudienceMember dodaliśmy pole composite_data, które akceptuje obiekt CompositeData i umożliwia łączenie wielu typów identyfikatorów, takich jak UserData i IpData. Więcej informacji znajdziesz w artykule Dane złożone.

  • Dodaliśmy nowe stany IngestCompositeDataStatus i RemoveCompositeDataStatus , które zawierają informacje diagnostyczne (record_count i data_type_counts) dotyczące żądań członków listy odbiorców korzystających z CompositeData.

• Dodaliśmy obsługę importowania adresów IP na potrzeby kierowania na listę klientów w Google Ads Match przez wysyłanie IpData w danych złożonych.

• Do wyliczenia ErrorReason enum dodaliśmy nowe przyczyny błędów: FIELD_VALUE_TOO_SHORT, TOO_FEW_ELEMENTS, BASELINE_LOCATION_AUTO_DETECTION_FAILED, i INSIGHTS_MISSING_FOR_DIMENSION.

• Do wyliczenia ProcessingErrorReason dodaliśmy nowe wartości diagnostyczne, aby zapewnić bardziej szczegółowe informacje o błędach podczas importowania zdarzeń.

7 maja 2026 r. v1.6

• Dodaliśmy obsługę wysyłania konwersji polegających na sprzedaży w sklepie stacjonarnym w Google Ads za pomocą interfejsu IngestEventsRequest. Aby korzystać z tej funkcji, Twoje konto Google Ads musi spełniać określone wymagania.
  • Do interfejsu Event dodaliśmy pole event_location, które obsługuje podawanie fizycznego store_id.
  • Do interfejsu Event dodaliśmy pole third_party_user_data, które umożliwia wyraźne oznaczenie importowanych danych jako należących do innej firmy.
    • Wypełnianie tego pola jest dozwolone tylko w przypadku dostawców danych.
  • Do zasobu Item dodaliśmy te pola:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (akceptuje listę ItemCustomVariable obiektów)
  • Aby rozpocząć, zapoznaj się z tymi przewodnikami:
    • Przejście z Google Ads
    • Wysyłanie zdarzeń
• Dodaliśmy obsługę wysyłania do Google Analytics dowolnego zdarzenia w witrynie lub aplikacji, które nie jest zdarzeniem zarezerwowanym.
  • Do zasobu Event dodaliśmy pole app_instance_id.
  • Do interfejsu DeviceInfo dodaliśmy pola, które umożliwiają podawanie metadanych o urządzeniu użytkownika.
  • Do interfejsu AdIdentifiers dodaliśmy pole mobile_device_id.
  • Do interfejsu Event dodaliśmy pole event_location, które umożliwia rejestrowanie pól takich jak city, subdivision_code, region_code, subcontinent_code i continent_code.
  • Aby rozpocząć, zapoznaj się z tymi przewodnikami:
    • Wysyłanie zalecanych i niestandardowych zdarzeń
    • Przejście z platformy Measurement Protocol
    • Dokumentacja zalecanych zdarzeń
• Dodaliśmy obsługę wysyłania dowolnego zdarzenia z identyfikatorem transakcjido strumieni danych z witryn i aplikacji jako dodatkowego źródła danych w przypadku implementacji tagu lub Google Analytics dla Firebase (GA4F) pakietu SDK.
  • Ta funkcja jest dostępna tylko w usługach w Google Analytics znajdujących się na liście dozwolonych; wypełnij ten formularz, jeśli chcesz dodać swoją usługę do tej listy.
• Do interfejsu CartData dodaliśmy pole coupon_codes, które umożliwia śledzenie wszystkich kodów kuponów zastosowanych w koszyku w przypadku zdarzeń wysyłanych do Google Ads i Google Analytics.
  • W przypadku przypadków użycia związanych z realizacją kuponów w Google Ads użyj typu konwersji OFFLINE_PROMOTION_REDEMPTION.
• Dodaliśmy nowy zakres OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, w przypadku metod związanych z tworzeniem, wyszukiwaniem i usuwaniem połączeń z partnerami.
• Do wyliczenia ErrorReason dodaliśmy nowe wartości, aby obsługiwać szczegółową weryfikację importowania zdarzeń związanych ze sprzedażą w sklepie stacjonarnym i zdarzeń Google Analytics.
• Do zasobu SizeInfo dodaliśmy pola youtube_members_count i gmail_members_count.

26 marca 2026 r.

• Do wyliczenia ErrorReason dodaliśmy wartość EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  Aby zachować zgodność z rozporządzeniem Unii Europejskiej w sprawie reklam politycznych, Google wymaga od wszystkich klientów zadeklarowania, czy ich reklamy są uznawane za polityczne zgodnie z zapisami tego rozporządzenia. Dowiedz się, jak definiujemy reklamę polityczną w UE i jakie ograniczenia Google stosuje w przypadku takich reklam w UE.

  Od 1 kwietnia 2026 r. te działania na kontach, na których nie ma tej deklaracji, mogą być ograniczone lub zakończyć się niepowodzeniem z powodu błędu EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

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

  Aby rozwiązać ten problem, reklamodawcy muszą przesłać obowiązkową deklarację w interfejsie Google Ads. Dowiedz się więcej o potwierdzaniu na koncie.

• Do wyliczenia ErrorReason dodaliśmy wartość INVALID_MERCHANT_ID.

17 lutego 2026 r. v1.5

Interfejs Data Manager API obsługuje teraz cały proces zarządzania listami odbiorców, w tym ich tworzenie, importowanie i pobieranie.

• Aby umożliwić tworzenie, pobieranie, aktualizowanie i usuwanie list użytkowników, dodaliśmy zasób UserList i UserListService.
  • Aby zapoznać się z pełnym przewodnikiem po tworzeniu, wypełnianiu i weryfikowaniu list odbiorców kierowania na listę klientów za pomocą interfejsu Data Manager API, zapoznaj się z przewodnikami Google Ads lub Display & Video 360.
  • Kroki migracji znajdziesz w przewodnikach przejścia na Google Ads lub Display & Video 360.
• Dodaliśmy obsługę wysyłania identyfikatora użytkownika podczas importowania członków listy odbiorców, co umożliwia korzystanie z niego w kierowaniu na listę klientów w Google Ads.
  • Do interfejsu AudienceMember dodaliśmy UserIdData.
  • Do stanów zwracanych przez metodę RetrieveRequestStatus dodaliśmy IngestUserIdDataStatus i RemoveUserIdDataStatus. Użyj tych pól, aby pobrać informacje diagnostyczne o importowaniu i usuwaniu identyfikatorów użytkowników.
• Aby tworzyć połączenia między kontami reklamodawców i dostawców danych oraz nimi zarządzać, dodaliśmy zasób PartnerLink i PartnerLinkService.
  • Aby rozpocząć, zapoznaj się z przewodnikami dotyczącymi połączeń z partnerami.

10 lutego 2026 r.

Wysyłanie konwersji z wieloma źródłami danych w celu zwiększenia skuteczności i jakości danych jest teraz ogólnie dostępne na wszystkich kontach Google Ads.

Ta funkcja jest nadal dostępna tylko w usługach w Google Analytics znajdujących się na liście dozwolonych. Jeśli chcesz dodać swoją usługę w Google Analytics do listy dozwolonych, wypełnij ten formularz.

5 listopada 2025 r. v1.4

• Dodaliśmy obsługę wysyłania zdarzeń purchase z Google Analytics jako dodatkowego źródła danych na potrzeby konwersji tagu, aby maksymalizować sygnały interakcji z reklamami oraz zwiększać jakość danych i ogólną skuteczność.

  • Do typu wyliczeniowego AccountType dodaliśmy wartość GOOGLE_ANALYTICS_PROPERTY.
  • Do interfejsu Event dodaliśmy te pola:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Dodaliśmy additional_user_properties do UserProperties.

  Więcej informacji o wysyłaniu zdarzeń Google Analytics purchase oraz o tym, jak mapować parametry zdarzeń i właściwości użytkowników Google Analytics na ich odpowiedniki w interfejsie Data Manager API, znajdziesz w przewodniku po zdarzeniach.

• Dodano AwsWrappedKeyInfo, aby obsługiwać używanie kluczy szyfrowania z systemu zarządzania kluczami AWS.

• Do typu wyliczeniowego ErrorReason dodaliśmy te wartości:

  • 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

6 października 2025 r. v1.3

• Interfejs Data Manager API jest teraz ogólnie dostępny dla wszystkich użytkowników.

  Wysyłanie konwersji z wieloma źródłami danych w celu zwiększenia skuteczności i jakości danych jest nadal dostępne tylko na kontach znajdujących się na liście dozwolonych. Jeśli chcesz dodać swoje konto, wypełnij ten formularz.

  Jeśli chcesz zostać dostawcą danych, wypełnij formularz zgłoszenia partnera.

• Aby pobierać informacje diagnostyczne o żądaniach importowania zdarzeń i list odbiorców, dodaliśmy metodę RetrieveRequestStatus.

• Pole product w interfejsie ProductAccount i wyliczenie Product zostały wycofane. Zamiast nich używaj pola account_type i nowego AccountType typu wyliczeniowego.

• Dodaliśmy obsługę określania destination dla każdego AudienceMember w interfejsie IngestAudienceMembersRequest. Użyj tej funkcji, aby wysyłać dane o odbiorcach do wielu różnych miejsc docelowych w jednym żądaniu.

• Listy odbiorców importowane za pomocą interfejsu API mogą być używane do kierowania, gdy zawierają co najmniej 100 członków. Wcześniej próg wynosił 1000 członków.

• Pole transaction_id w interfejsie Event jest teraz opcjonalne podczas wysyłania konwersji offline lub konwersji rozszerzonych dotyczących potencjalnych klientów. Pole transaction_id jest nadal wymagane podczas wysyłania konwersji offline jako dodatkowego źródła danych w celu zwiększenia skuteczności i jakości danych.

6 sierpnia 2025 r. v1.2

• Dodaliśmy obsługę wysyłania konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów do miejsc docelowych Google Ads za pomocą metody IngestEvents. Informacje o konfigurowaniu szyfrowania w przypadku tych konwersji znajdziesz w zaktualizowanym przewodniku po szyfrowaniu.
• Do typu wyliczeniowego EventSource dodaliśmy wartości APP, IN_STORE, PHONE i OTHER. W przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów wymagane jest pole event_source.
• Do interfejsu Event dodaliśmy pole user_properties. Ustaw to pole na obiekt UserProperties, aby dodać informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia.
• Dodaliśmy powtarzające się pole destination_references do CustomVariable. Użyj tego pola, aby zastosować wartość zmiennej niestandardowej tylko do podzbioru miejsc docelowych w przypadku Event.
• W przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów dodaliśmy te błędy:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

25 czerwca 2025 r. v1.1

• Do interfejsu IngestionService dodaliśmy metodę IngestEvents. Używaj IngestEvents jako dodatkowego źródła danych na potrzeby konwersji tagu, aby maksymalizować sygnały interakcji z reklamami oraz zwiększać jakość danych i ogólną skuteczność.

2 kwietnia 2025 r. v1.0

• Pierwsza wersja interfejsu Data Manager API z obsługą wysyłania danych o odbiorcach do Google Ads i Display & Video 360.
• Dodaliśmy obsługę gRPC i REST.
• Dodaliśmy interfejs IngestionService z metodami IngestAudienceMembers i RemoveAudienceMembers do zarządzania członkami listy odbiorców za pomocą tych typów danych:
  • Dane kontaktowe
  • Mobile ID
  • Identyfikatory PAIR
• Listy odbiorców zarządzane za pomocą interfejsu Data Manager API mogą być używane do kierowania tylko wtedy,gdy zawierają co najmniej 1000 członków.