Informacje o wersjach

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

4.11.2026 r., wersja 1.9

  • Dodaliśmy obsługę wysyłania konwersji telefonicznych Google Ads.

    • Dodano pole call_info do Event. Użyj pola start_timestamp w CallInfo, aby określić, kiedy rozpoczęło się połączenie telefoniczne, które doprowadziło do konwersji.

    Aby rozpocząć, zapoznaj się z przewodnikiem po wysyłaniu konwersji telefonicznych lub dowiedz się, jak przejść na interfejs Google Ads API.

  • Dodaliśmy pole record_indices do ErrorCount i WarningCount, aby umożliwić identyfikowanie rekordów w żądaniu przetwarzania, które zawierały błędy lub ostrzeżenia. Szczegółowe informacje o tym, jak używać tego pola, znajdziesz w artykule Sprawdzanie rekordów, których dotyczy problem.

  • Dodano pole lead_id do AdIdentifiers, aby umożliwić wysyłanie wygenerowanego przez Google identyfikatora, który jest wydawany, gdy użytkownik przesyła formularz kontaktowy.

  • Do typu wyliczeniowego ErrorReason dodano te przyczyny błędów: ENCRYPTION_NOT_SUPPORTED, DUPLICATE_ELEMENTS, UNSUPPORTED_BASELINE_LOCATION, CONVERSION_PRECEDES_CALL, INVALID_AD_IDENTIFIER_FOR_ACCOUNT, CONVERSION_ACTION_TOO_RECENTLY_CREATED, REQUEST_TOO_OLD i INVALID_DATE.

  • Do typu wyliczeniowego ProcessingErrorReason dodano te przyczyny błędów: PROCESSING_ERROR_REASON_DESTINATION_TOO_RECENTLY_CREATED, PROCESSING_ERROR_REASON_TOO_RECENT_CALL, PROCESSING_ERROR_REASON_EXPIRED_CALL i PROCESSING_ERROR_REASON_INVALID_CALL.

  • Do typu wyliczeniowego ProcessingWarningReason dodano przyczyny ostrzeżeń PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED i PROCESSING_WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED.

  • Dodano przyczynę ostrzeżenia WARNING_REASON_INVALID_NUMBER_FORMAT do typu wyliczeniowego WarningReason.

30.07.2026 r. – wersja 1.8

  • Dodaliśmy metodę RemoveAllAudienceMembers do IngestionService, aby umożliwić 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. Możesz na przykład zapoznać się z przewodnikami po kierowaniu na listę klientów w Google Ads lub 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.
    • Dodaliśmy zasób FieldWarning, który zawiera reason (WarningReason), description i ścieżkę field.
    • Dodaliśmy typ wyliczeniowy WarningReason, aby określić przyczyny ostrzeżeń, np. 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

2026-05-07 v1.6

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 poprawy 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 wzmocnić dane i ogólną skuteczność.

    • Do typu wyliczeniowego AccountType dodano wartość GOOGLE_ANALYTICS_PROPERTY.
    • Dodano wiele pól do tabeli 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 usługi 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 na kontach 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.

  • Listy odbiorców przesłane za pomocą interfejsu API mogą być teraz używane do kierowania, gdy zawierają co najmniej 100 użytkowników. Wcześniej próg wynosił 1000 subskrybentów.

  • Podczas wysyłania konwersji offline lub konwersji rozszerzonych dotyczących potencjalnych klientów parametr transaction_id obiektu Event jest teraz opcjonalny. Parametr transaction_id jest nadal wymagany podczas wysyłania konwersji offline jako dodatkowego źródła 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 w momencie wystąpienia zdarzenia.
  • 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 do 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