Informacje o wersjach

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

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ć importowane 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:
    • Przekształcanie kampanii z poziomu 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ń
    • Przekształcanie kampanii z poziomu 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 dla implementacji tagu lub Google Analytics dla Firebase (GA4F) pakietu SDK.
  • Ta funkcja jest dostępna tylko w przypadku usług Google Analytics na liście dozwolonych; wypełnij ten formularz, jeśli chcesz dodać swoją usługę do tej listy.
• 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 kuponu 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ę konwersji polegających na sprzedaży w sklepie stacjonarnym i importowanie zdarzeń 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, importowanie 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 dowiedzieć się, jak tworzyć, wypełniać i weryfikować listy 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 przekształcania kampanii z poziomu 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.
  • 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 dotyczące importowania i usuwania 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 przypadku usług Google Analytics 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 dla konwersji tagu, aby maksymalizować sygnały interakcji z reklamą 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ń purchase z Google Analytics oraz o tym, jak mapować parametry zdarzeń i właściwości użytkownika z 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.

• 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 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 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 dotyczących żądań importowania 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 importowane za pomocą interfejsu API mogą być używane do kierowania, gdy mają 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 w 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 powtarzające się pole 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 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 czerwca 2025 r. v1.1

• Dodaliśmy metodę IngestEvents do IngestionService. Użyj IngestEvents jako dodatkowego źródła danych dla konwersji tagu, aby maksymalizować sygnały interakcji z reklamą 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 mają co najmniej 1000 członków.