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 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 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 dla tagu lub Google Analytics dla Firebase (GA4F) pakietu SDK implementacji.
  • Ta funkcja jest dostępna tylko w przypadku usług Google Analytics znajdujących się 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 zastosowań 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ę 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 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 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 dla konwersji tagu, aby zmaksymalizować sygnały interakcji z reklamami oraz zwiększyć 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 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 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 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 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 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 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 zmaksymalizować sygnały interakcji z reklamami oraz zwiększyć 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.