Informacje o wersjach

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

30.07.2026 r., wersja 1.8

  • Dodaliśmy do interfejsu IngestionService metodę RemoveAllAudienceMembers, która umożliwia usuwanie lub zastępowanie wszystkich odbiorców na określonych listach użytkowników.
    • Aby rozpocząć, zapoznaj się z przewodnikiem po usuwaniu wszystkich użytkowników z listy odbiorców w przypadku konkretnej integracji. Zapoznaj się na przykład z przewodnikami po kierowaniu na listę klientów w Google Ads i Display & Video 360.
  • Dodaliśmy obsługę zwracania szczegółowych ostrzeżeń podczas pozyskiwania zdarzeń i odbiorców.
    • Dodano pole field_warnings do IngestEventsResponse i IngestAudienceMembersResponse, które zawiera listę obiektów FieldWarning.
    • Dodano zasób FieldWarning, który zawiera reason (WarningReason), description i ścieżkę field.
    • Dodaliśmy typ wyliczeniowy WarningReason, aby określić przyczyny ostrzeżeń, takich jak brak włączonych zmiennych niestandardowych lub brak identyfikatorów sprzedawców w danych koszyka.
  • Dodaliśmy obsługę wysyłania dodatkowych pól adresowych na potrzeby pozyskiwania zdarzeń Google Analytics.
    • Dodaliśmy pola address_line, city i administrative_area do AddressInfo (używane w UserData).
  • Dodano przyczyny błędów INVALID_REMOVE_AS_OF_TIME i REQUIRED_PREREQUISITE_LINK_MISSING do typu wyliczeniowego ErrorReason.

28.05.2026, wersja 1.7

7.05.2026, wersja 1.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.
    • Dodano pole event_location do Event, które umożliwia podanie fizycznego store_id..
    • Dodano pole third_party_user_data do Event, co umożliwia wyraźne oznaczenie pozyskanych danych jako należących do innej firmy.
    • 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:
  • Dodaliśmy obsługę wysyłania do Google Analytics dowolnego zdarzenia w witrynie lub aplikacji, które nie jest zdarzeniem zarezerwowanym.
  • Dodaliśmy obsługę wysyłania dowolnego zdarzenia z identyfikatorem transakcji do strumieni danych zarówno z witryny, jak i ze strumieni danych z aplikacji jako dodatkowego źródła danych na potrzeby implementacji tagu lub pakietu SDK Google Analytics dla Firebase (GA4F).
    • Ta funkcja jest ograniczona do usług w 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 wykorzystania kuponów w Google Ads użyj typu konwersji OFFLINE_PROMOTION_REDEMPTION.
  • Dodano nowy zakres protokołu OAuth, https://www.googleapis.com/auth/datamanager.partnerlink, dla metod związanych z tworzeniem, wyszukiwaniem i usuwaniem linków partnerów.
  • Dodano nowe wartości do typu wyliczeniowego ErrorReason, aby umożliwić szczegółową weryfikację sprzedaży w sklepie stacjonarnym i pozyskiwania zdarzeń Google Analytics.
  • Dodano pola youtube_members_count i gmail_members_count do zasobu SizeInfo.

2026-03-26

17.02.2026 r., wersja 1.5

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

2026-02-10

Przesyłanie konwersji z wielu źródeł danych w celu zwiększenia skuteczności i polepszenia jakości danych jest teraz ogólnie dostępne na wszystkich kontach Google Ads.

Ta funkcja jest nadal dostępna tylko w przypadku usług 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 formularz.

5.11.2025 r., wersja 1.4

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

    • Do typu wyliczeniowego AccountType dodano wartość GOOGLE_ANALYTICS_PROPERTY.
    • Dodano wiele pól do Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • Dodano additional_user_properties do: UserProperties.

    Więcej informacji o wysyłaniu zdarzeń Google Analytics purchase i mapowaniu parametrów zdarzeń oraz właściwości użytkownika Google Analytics na ich odpowiedniki w interfejsie Data Manager API znajdziesz w przewodniku po zdarzeniach.

  • Dodano AwsWrappedKeyInfo, aby umożliwić korzystanie z kluczy szyfrowania z systemu zarządzania kluczami AWS.

  • Dodano te wartości typu wyliczeniowego 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., wersja 1.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 polepszenia jakości danych jest nadal dostępne tylko dla kont z listy dozwolonych. Jeśli chcesz dodać swoje konto, wypełnij formularz.

    Wypełnij formularz zgłoszenia zainteresowania dla partnerów, aby wyrazić zainteresowanie zostaniem dostawcą danych.

  • Dodaliśmy metodę RetrieveRequestStatus do pobierania informacji diagnostycznych dotyczących żądań pozyskiwania zdarzeń i odbiorców.

  • Pole product w ProductAccount i typ wyliczeniowy Product zostały wycofane. Zamiast tego użyj pola account_type i nowego typu wyliczeniowego AccountType.

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

  • Odbiorcy pozyskani za pomocą interfejsu API mogą być teraz kierowani, gdy mają co najmniej 100 członków. Wcześniej próg wynosił 1000 subskrybentów.

  • Parametr transaction_id obiektu Event jest teraz opcjonalny podczas wysyłania konwersji offline lub konwersji rozszerzonych dotyczących potencjalnych klientów. Parametr transaction_id jest nadal wymagany, gdy wysyłasz konwersje offline jako dodatkowe źródło danych, aby zwiększyć skuteczność i ilość danych.

6.08.2025 r., wersja 1.2

  • Dodaliśmy obsługę wysyłania konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów do miejsc docelowych reklam Google Ads za pomocą metody IngestEvents. Aby dowiedzieć się, jak skonfigurować szyfrowanie tych konwersji, zapoznaj się ze zaktualizowanym przewodnikiem po szyfrowaniu.
  • Dodano wartości APP, IN_STORE, PHONE i OTHER do typu wyliczeniowego EventSource. W przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów wymagany jest event_source.
  • Dodano pole user_properties do Event. Ustaw to pole na obiekt UserProperties, aby dodać informacje ocenione przez reklamodawcę o użytkowniku, gdy wystąpiło zdarzenie.
  • Dodano pole powtarzane destination_references do CustomVariable. Użyj tego pola, aby zastosować wartość zmiennej niestandardowej tylko do podzbioru miejsc docelowych dla 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.06.2025 r., wersja 1.1

  • Dodaliśmy metodę IngestEvents do IngestionService. Używaj IngestEvents jako dodatkowego źródła danych dla konwersji tagu, aby zmaksymalizować sygnały interakcji z reklamą oraz zwiększyć ilość danych i ogólną skuteczność.

2.04.2025 r., wersja 1.0