Interfejs Data Manager API wymaga danych logowania o innym zakresie niż interfejs Google Ads API. Aby wygenerować nowe dane logowania, które obejmują zakres interfejsu Data Manager API, wykonaj czynności opisane w artykule Konfigurowanie dostępu do interfejsu API.
Opcjonalne domyślne ustawienia zgody na zdarzenia w żądaniu. Możesz zastąpić tę wartość w przypadku pojedynczego zdarzenia, ustawiając pole consent w Event.
Brak odpowiednika
encoding
Wymagane: ustaw na Encoding używane dla wartości UserIdentifier.
Brak odpowiednika
encryption_info
Ustaw, jeśli żądanie zawiera zaszyfrowane wartości. Szczegółowe informacje znajdziesz w artykule Szyfrowanie.
Interfejs Data Manager API korzysta z modelu błędów typu „fast-fail”. Jeśli którekolwiek pole obiektu IngestEventsRequest nie przejdzie weryfikacji, interfejs Data Manager API odrzuci całe żądanie.
validate_only
validate_only
conversions
events
Lista konwersji lub zdarzeń. Szczegółowe informacje znajdziesz w sekcji Pola konwersji.
Pola klienta i działania powodującego konwersję
Interfejs Google Ads API wymaga nagłówka żądania developer-token, a nagłówki żądania login-customer-id i linked-customer-id ustawiasz w przypadku różnych scenariuszy uwierzytelniania.
Interfejs Data Manager API nie wymaga tokena programisty, a informacje o logowaniu i połączonym kliencie podajesz za pomocą pól Destination, a nie nagłówków żądań. Więcej informacji o miejscach docelowych znajdziesz w artykule Konfigurowanie miejsc docelowych.
Oto jak zmapować pola interfejsu Google Ads API dla pojedynczego elementu conversion_action na odpowiednie pola w elemencie Destination:
Token programisty nie jest wymagany w przypadku interfejsu Data Manager API.
Nagłówek żądania login-customer-id
login_account
Ustaw account_id na identyfikator klienta konta logowania. Ustaw parametr account_type na GOOGLE_ADS, jeśli konto logowania jest kontem Google Ads, lub na DATA_PARTNER, jeśli konto logowania jest kontem dostawcy danych.
Nagłówek żądania linked-customer-id
linked_account
Jeśli uzyskujesz dostęp do operating_account za pomocą linku partnera, ustaw account_id na identyfikator klienta połączonego konta, a account_type na DATA_PARTNER. W przeciwnym razie nie ustawiaj pola linked_account.
conversion_action z ClickConversion
product_destination_id
Ustaw identyfikator numeryczny działania powodującego konwersję. Nie używaj nazwy zasobu ConversionAction.
Oba interfejsy API używają podobnego obiektu Consent (ad_user_data, ad_personalization).
W przypadku interfejsu Data Manager API możesz też ustawić zgodę na wszystkie zdarzenia w żądaniu, ustawiając pole consent na poziomie żądania.
Żaden z tych interfejsów API nie obsługuje tych identyfikatorów w przypadku konwersji offline ani konwersji rozszerzonych dotyczących potencjalnych klientów, a interfejs Data Manager API nie obsługuje tych identyfikatorów podczas wysyłania zdarzeń konwersji jako dodatkowego źródła danych.
Interfejs Data Manager API korzysta z modelu błędów typu „fast-fail”. Jeśli którekolwiek pole obiektu IngestEventsRequest nie przejdzie weryfikacji, interfejs Data Manager API odrzuci całe żądanie.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2026-10-21 UTC."],[],[]]
