Przejście z interfejsu Google Ads API

Przejdź z interfejsu Google Ads API na interfejs Data Manager API, aby uzyskać dostęp do kilku ulepszeń i funkcji.

Oto 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 z tagu Google Ads jako dodatkowego źródła danych o konwersjach z tagu, aby zmaksymalizować liczbę sygnałów interakcji z reklamą oraz zwiększyć ilość danych i ogólną skuteczność. Obsługiwane. Nieobsługiwane.
Model danych ujednolicony model danych we wszystkich przypadkach użycia konwersji Google Ads i we wszystkich usługach reklamowych Google; Model danych jest przeznaczony tylko do przypadków użycia w Google Ads i różni się w zależności od przypadku użycia.
Szyfrowanie Obsługuje szyfrowanie. Nieobsługiwane.
Token programisty Niewymagane Wymagane.
Obsługa przesyłania atrybutów sesji i adresów IP na potrzeby 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 osobnego ConversionAdjustmentUploadService.
Limity Limity i ograniczenia na żądanie oparte na projektach. Limity oparte na tokenie programisty i limity na żądanie.
Model błędu Używa modelu szybkiego niepowodzenia. Używa modelu częściowego błędu.

Różnice w wymaganiach dotyczących konta docelowego

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

Interfejs Google Ads API obsługuje wysyłanie konwersji na konto Google Ads za pomocą parametru customer_id:

  1. Klient, który dokonał konwersji z reklam Google Ads.

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

  2. Dowolne konto, które jest kontem nadrzędnym lub podrzędnym klienta konwersji z reklam 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 parametru customer_id, którego używasz w żądaniach do interfejsu Google Ads API.

Dostosowania konwersji

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

W interfejsie Google Ads API:

  • Dostosowywanie konwersji wymaga użycia osobnej metody UploadConversionAdjustments w ConversionAdjustmentUploadService.
  • Jeśli spróbujesz przesłać wiele konwersji za pomocą standardowej metody UploadClickConversions w przypadku tego samego działania powodującego konwersję i tego samego identyfikatora transakcji (order_id), żądanie się nie powiedzie.
  • W żądaniu musisz podać ConversionAdjustmentType.

W interfejsie Data Manager API:

  • Przesyłanie i dostosowywanie konwersji korzysta ze ujednoliconego punktu końcowego IngestEvents.
  • Przesłanie zdarzenia z dotychczasowym parametrem transaction_id dla tego samego działania powodującego konwersję ze zaktualizowanymi wartościami konwersji lub danymi użytkownika jest automatycznie traktowane jako dostosowanie. Interfejs API nie zwróci błędu zduplikowanego identyfikatora transakcji.
  • W żądaniu nie jest wymagany typ korekty. Interfejs Data Manager API określa, jak przetworzyć dostosowanie, 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ę przez ustawienie jej wartości i liczby na 0. Możesz zmienić wartość konwersji, ale liczba konwersji pozostanie taka sama.

Więcej informacji znajdziesz w artykule Dostosowania konwersji.