Informacje o wersjach

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

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.

  • Dodaliśmy FLOODLIGHT_CONFIG do AccountType wyliczenia, aby obsługiwać Floodlight miejsca docelowe.
  • Dodaliśmy pola dclid, impression_id, match_id, i encrypted_user_ids do 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ść z interfejsu Campaign Manager 360 API.

• Dodaliśmy pole composite_data do zasobu AudienceMember, 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ą 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ę pozyskiwania 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 pozyskiwania 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ą 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 umożliwia podanie fizycznego store_id.
  • Dodaliśmy pole third_party_user_data do Event, co pozwala wyraźnie oznaczyć pozyskane dane jako należące 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ę obiektów)ItemCustomVariable
  • 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.
  • 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 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 z Measurement Protocol
    • Zalecane zdarzenia
• Dodaliśmy obsługę wysyłania dowolnego zdarzenia z identyfikatorem transakcji ID do strumieni danych z witryn i aplikacji jako dodatkowego źródła danych na potrzeby 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 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, dla 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ę pozyskiwania zdarzeń dotyczących sprzedaży w sklepie stacjonarnym i Google Analytics
• Dodaliśmy pola youtube_members_count i gmail_members_count do zasobu SizeInfo.

26 marca 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 tym, jak potwierdzić deklarację na swoim koncie.

• Dodaliśmy INVALID_MERCHANT_ID do ErrorReason wyliczenia.

17 lutego 2026 r. v1.5

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

• Dodaliśmy zasób UserList i UserListService, aby umożliwić tworzenie, pobieranie, aktualizowanie i usuwanie list użytkowników.
  • Aby uzyskać szczegółowe informacje o tym, jak tworzyć, wypełniać i weryfikować listy 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 pozyskiwania 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 pozyskiwaniu 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 lutego 2026 r.

Wysyłanie konwersji z wielu źródeł 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 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ść.

  • Dodaliśmy GOOGLE_ANALYTICS_PROPERTY do wyliczenia AccountType.
  • Dodaliśmy kilka pól do Event:
    • 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 dotyczącym zdarzeń.

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

• Dodaliśmy te wartości wyliczeniowe 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 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 wielu źródeł 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. Wypełnij formularz, jeśli chcesz dodać swoje konto.

  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 pozyskiwania zdarzeń i list odbiorców.

• Pole product w 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 an IngestAudienceMembersRequest. Użyj tej funkcji, aby wysyłać dane o odbiorcach do wielu różnych miejsc docelowych w jednym żądaniu.

• Listy odbiorców pozyskane 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.

• Pole transaction_id w 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 tym, jak skonfigurować szyfrowanie tych konwersji, znajdziesz w zaktualizowanym przewodniku dotyczącym szyfrowania.
• 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 powtórzone pole destination_references do CustomVariable. Użyj tego pola, aby zastosować wartość zmiennej niestandardowej tylko do podzbioru miejsc docelowych Event.
• Dodaliśmy te błędy dotyczące 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 czerwca 2025 r. v1.1

• Dodaliśmy metodę IngestEvents do IngestionService. 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 IngestionService z IngestAudienceMembers i RemoveAudienceMembers metodami do zarządzania członkami listy odbiorców za pomocą tych typów danych:
  • Dane kontaktowe
  • Identyfikatory mobilne
  • 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.