Przejście z interfejsu Google Ads API

Zaktualizuj przesyłanie konwersji z interfejsu Google Ads API do interfejsu Data Manager API, aby uzyskać dostęp do kilku ulepszeń i funkcji.

Poniżej znajdziesz porównanie zarządzania konwersjami za pomocą interfejsu Data Manager API i interfejsu Google Ads API.

	Data Manager API	Interfejs Google Ads API
Obsługa wysyłania konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów	Obsługiwane.	Obsługiwane.
Obsługa wysyłania konwersji tagu Google Ads jako dodatkowego źródła danych o konwersjach tagu, aby maksymalizować sygnały interakcji z reklamami oraz wzmacniać dane i ogólną skuteczność.	Obsługiwane.	Nieobsługiwane.
Model danych	Ujednolicony model danych we wszystkich przypadkach użycia konwersji w Google Ads i we wszystkich usługach reklamowych Google.	Model danych jest przeznaczony tylko do przypadków użycia Google Ads i różni się w zależności od nich.
Szyfrowanie	Obsługuje szyfrowanie.	Nieobsługiwane.
Token programisty	Niewymagane	Wymagane.
Obsługa przesyłania atrybutów sesji i adresów IP w przypadku zdarzeń	Dostępne dla wszystkich użytkowników interfejsu API.	Dostępne tylko dla określonych użytkowników interfejsu API.
Korekty konwersji	Obsługiwane w ujednoliconej metodzie IngestEvents.	Wymaga oddzielnego ConversionAdjustmentUploadService.
Limity	Limity i limity żądań dotyczące projektu.	Limity oparte na tokenie programisty i limity poszczególnych żądań.
Model błędu	Korzysta z modelu szybkiego wykrywania błędów.	Wykorzystuje model częściowej awarii.

Różnice w wymaganiach dotyczących konta docelowego

W interfejsie Data Manager API operating_account miejsca docelowego musi być klientem konwersji Google Ads. Różni się on od interfejsu Google Ads API.

Kluczowe pojęcie: Klient konwersji Google Ads to konto Google Ads, do którego należy działanie powodujące konwersję określone przez parametr product_destination_id miejsca docelowego.

Interfejs Google Ads API umożliwia wysyłanie konwersji na konto Google Ads za pomocą customer_id:

1. Klient konwersji Google Ads.

   Interfejs Data Manager API obsługuje to podejście.

2. Każde konto, które jest nadrzędne lub podrzędne względem klienta konwersji Google Ads.

   Interfejs Data Manager API nie obsługuje tego podejścia. Jeśli korzystasz z tego zachowania w interfejsie Google Ads API, zmień operating_account każdego miejsca docelowego na właściciela działania powodującego konwersję. Może się on różnić od customer_id używanego w żądaniach do interfejsu Google Ads API.

Dostosowania konwersji

Interfejs Data Manager API ujednolica początkowe przesyłanie konwersji i późniejsze korekty konwersji w jedną metodę.

W interfejsie Google Ads API:

• Korygowanie konwersji wymaga użycia oddzielnej metody UploadConversionAdjustments w ConversionAdjustmentUploadService.
• Jeśli spróbujesz przesłać wiele konwersji za pomocą standardowej metody UploadClickConversions dla tego samego działania powodującego konwersję z tym samym identyfikatorem transakcji (order_id), żądanie zakończy się niepowodzeniem.
• W żądaniu musisz podać parametr ConversionAdjustmentType.

W interfejsie Data Manager API:

• Przesyłanie i dostosowywanie konwersji odbywa się za pomocą ujednoliconego punktu końcowego IngestEvents.
• Przesłanie zdarzenia z istniejącym parametrem transaction_id dla tego samego działania powodującego konwersję ze zaktualizowanymi wartościami konwersji lub danymi użytkownika jest automatycznie traktowane jako korekta. Interfejs API nie zwróci błędu związanego z duplikatem identyfikatora transakcji.
• W prośbie nie jest wymagany żaden typ korekty. Interfejs Data Manager API wywnioskuje, jak przetworzyć korektę, na podstawie pól podanych w zdarzeniu.
• W przeciwieństwie do interfejsu Google Ads API interfejs Data Manager API nie obsługuje wycofywania konwersji, które całkowicie usuwa wcześniej zarejestrowaną konwersję, ustawiając jej wartość i liczbę na 0. Możesz zmienić wartość konwersji, ale liczba konwersji pozostanie taka sama.

Więcej informacji znajdziesz w artykule Korekty konwersji.