Informacje o wersjach

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

30.07.2026 r. v1.8

• Dodaliśmy metodę RemoveAllAudienceMembers do IngestionService, aby umożliwić usuwanie lub zastępowanie wszystkich członków list odbiorców w przypadku określonych list użytkowników.
  • Aby rozpocząć, zapoznaj się z przewodnikiem dotyczącym 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 przesyłania zdarzeń i list odbiorców.
  • Dodaliśmy pole field_warnings do elementów IngestEventsResponse i IngestAudienceMembersResponse, które zawiera listę obiektów FieldWarning.
  • Dodaliśmy zasób FieldWarning, który zawiera reason (WarningReason ), description, i ścieżkę field.
  • Dodaliśmy WarningReason wyliczenie, aby określić przyczyny ostrzeżeń, np. brak włączenia zmiennych niestandardowych lub brak identyfikatorów sprzedawcy w danych koszyka.
• Dodaliśmy obsługę wysyłania dodatkowych pól adresu podczas przesyłania zdarzeń do Google Analytics.
  • Dodaliśmy pola address_line, city i administrative_area do AddressInfo (używanego w UserData).
• Dodaliśmy przyczyny błędów INVALID_REMOVE_AS_OF_TIME i REQUIRED_PREREQUISITE_LINK_MISSING do ErrorReason wyliczenia.

28.05.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ą elementu IngestEventsRequest.

  • Dodaliśmy FLOODLIGHT_CONFIG do AccountType wyliczenia, aby obsługiwać Floodlight usługi docelowe.
  • Dodaliśmy pola dclid, impression_id, match_id, i encrypted_user_ids do elementu AdIdentifiers.
  • Dodaliśmy pole conversion_count do zasobu Event, aby obsługiwać śledzenie liczby konwersji.

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

• Dodaliśmy pole composite_data do zasobu AudienceMember, które akceptuje obiekt CompositeData i umożliwia łączenie różnych 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ą dane diagnostyczne (record_count i data_type_counts) dotyczące żądań członków listy odbiorców korzystających z CompositeData.

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

• 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 ErrorReason wyliczenia.

• Dodaliśmy nowe wartości diagnostyczne do ProcessingErrorReason, aby zapewnić bardziej szczegółowe informacje zwrotne o błędach podczas przesyłania zdarzeń.

7.05.2026 r. v1.6

• Dodaliśmy obsługę wysyłania konwersji polegających na sprzedaży w sklepie stacjonarnym w Google Ads za pomocą elementu IngestEventsRequest. Aby korzystać z tej funkcji, Twoje konto Google Ads musi spełniać określone wymagania.
  • Dodaliśmy pole event_location do Event, które obsługuje podawanie fizycznego store_id.
  • Dodaliśmy pole third_party_user_data do elementu Event, co umożliwia wyraźne oznaczenie przesyłanych danych jako należących do innej firmy.
    • Wypełnianie tego pola jest dozwolone tylko w przypadku dostawców danych.
  • Dodaliśmy te pola do zasobu Item:
    • merchant_id
    • merchant_feed_label
    • merchant_feed_language_code
    • conversion_value
    • custom_variables (akceptuje listę ItemCustomVariableobiektów)
  • Aby rozpocząć, zapoznaj się z tymi przewodnikami:
    • Przejście na nową wersję 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.
  • Dodaliśmy pole app_instance_id do zasobu Event.
  • Dodaliśmy pola do DeviceInfo, aby udostępniać metadane o urządzeniu użytkownika.
  • Dodaliśmy pole mobile_device_id do AdIdentifiers.
  • Dodaliśmy pole event_location do elementu Event aby rejestrować pola takie 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 na nową wersję z platformy Measurement Protocol
    • Zalecane zdarzenia
• Dodaliśmy obsługę wysyłania dowolnego zdarzenia z identyfikatorem transakcji do 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 ograniczona do usług Google Analytics znajdujących się na liście dozwolonych. Jeśli chcesz dodać swoją usługę do tej listy, wypełnij ten formularz.
• Dodaliśmy pole coupon_codes do CartData, aby śledzić wszystkie kody kuponów zastosowane w koszyku w przypadku zdarzeń wysyłanych do Google Ads i Google Analytics.
  • W przypadku użycia 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 linków partnerskich.
• Dodaliśmy nowe wartości do wyliczenia ErrorReason, aby obsługiwać szczegółową weryfikację przesyłania zdarzeń dotyczących sprzedaży w sklepie stacjonarnym i zdarzeń Google Analytics.
• Dodaliśmy pola youtube_members_count i gmail_members_count do zasobu SizeInfo.

26.03.2026 r.

• Dodaliśmy EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED do wyliczenia ErrorReason.

  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 informacji na swoim koncie.

• Dodaliśmy INVALID_MERCHANT_ID do ErrorReason wyliczenia.

17.02.2026 r. v1.5

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

• Dodaliśmy zasób UserList i UserListService, aby umożliwić tworzenie, pobieranie, aktualizowanie i usuwanie list użytkowników.
  • 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 nową wersję Google Ads lub Display & Video 360.
• Dodaliśmy obsługę wysyłania identyfikatora użytkownika podczas przesyłania członków listy odbiorców, co umożliwia jego używanie w kierowaniu na listę klientów w Google Ads.
  • Dodaliśmy UserIdData do AudienceMember.
  • Dodaliśmy IngestUserIdDataStatus i RemoveUserIdDataStatus do stanów zwracanych przez metodę RetrieveRequestStatus. Użyj tych pól, aby pobrać informacje diagnostyczne o przesyłaniu i usuwaniu identyfikatorów użytkowników.
• Dodaliśmy zasób PartnerLink i PartnerLinkService, aby tworzyć linki między kontami reklamodawców i dostawców danych oraz nimi zarządzać.
  • Aby rozpocząć, zapoznaj się z przewodnikami dotyczącymi linków partnerskich.

10.02.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 Google Analytics znajdujących się na liście dozwolonych. Jeśli chcesz dodać swoją usługę w Google Analytics do listy dozwolonych, wypełnij formularz.

5.11.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ść.

  • Dodaliśmy GOOGLE_ANALYTICS_PROPERTY do wyliczenia AccountType.
  • Dodaliśmy kilka pól do elementu Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Dodaliśmy additional_user_properties do UserProperties.

  Więcej informacji o wysyłaniu zdarzeń purchase z Google Analytics 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.

• Dodaliśmy AwsWrappedKeyInfo aby obsługiwać używanie kluczy szyfrowania z systemu zarządzania kluczami AWS Key Management Service.

• Dodaliśmy te wartości wyliczenia do 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

6.10.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 do tej listy, wypełnij formularz.

  Aby wyrazić zainteresowanie współpracą jako dostawca danych, wypełnij formularz dla dostawców danych.

• Dodaliśmy metodę RetrieveRequestStatus do pobierania informacji diagnostycznych o żądaniach przesyłania zdarzeń i list odbiorców.

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

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

• Listy odbiorców przesłane za pomocą interfejsu API mogą być używane do kierowania, gdy znajdzie się na nich co najmniej 100 członków. Wcześniej próg wynosił 1000 członków.

• Element transaction_id elementu Event jest teraz opcjonalny 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.08.2025 r. v1.2

• Dodaliśmy obsługę wysyłania konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów do usług docelowych Google Ads za pomocą metody IngestEvents. Informacje o konfigurowaniu szyfrowania w przypadku tych konwersji znajdziesz w zaktualizowanym przewodniku po szyfrowaniu.
• Dodaliśmy wartości APP, IN_STORE, PHONE i OTHER do wyliczenia EventSource. W przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów wymagane jest pole event_source.
• Dodaliśmy pole user_properties do Event. Ustaw to pole na obiekt UserProperties, aby dodać informacje o użytkowniku ocenione przez reklamodawcę w momencie wystąpienia zdarzenia.
• Dodaliśmy powtarzane pole destination_references do CustomVariable. Użyj tego pola, aby zastosować wartość zmiennej niestandardowej tylko do podzbioru usług docelowych w przypadku elementu Event.
• Dodaliśmy te błędy w przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów:
  • 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 r. v1.1

• Dodaliśmy metodę IngestEvents do IngestionService. Użyj metody 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.04.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 usługę IngestionService z metodami IngestAudienceMembers i RemoveAudienceMembers do zarządzania członkami listy odbiorców za pomocą tych typów danych:
  • Dane kontaktowe
  • Identyfikatory urządzeń mobilnych
  • Identyfikatory PAIR
• Listy odbiorców zarządzane za pomocą interfejsu Data Manager API mogą być używane do kierowania tylko wtedy,gdy znajdzie się na nich co najmniej 1000 członków.