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 z reklam 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.
Zatwierdzenie poziomu dostępu Niewymagane Włączenie interfejsu API umożliwia zarządzanie tylko testowymi kontami Google Ads. Aby zarządzać produkcyjnymi kontami Google Ads, Twój projekt w chmurze Google Cloud musi mieć dostęp na poziomie Explorer, Basic lub dostęp standardowy.
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 osobnej aplikacji ConversionAdjustmentUploadService.
Limity Limity oparte na projektach i limity na żądanie. Limity oparte na poziomie dostępu 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ć kontem konwersji 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. Konto konwersji Google Ads.

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

  2. Dowolne konto, które jest kontem nadrzędnym lub podrzędnym konta 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 identyfikatora 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 dla tego samego działania powodującego konwersję z tym samym identyfikatorem transakcji (order_id), żądanie się nie powiedzie.
  • W żądaniu musisz podać ConversionAdjustmentType.

In the Data Manager API:

  • Przesyłanie i dostosowywanie konwersji korzysta ze 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 dostosowanie. Interfejs API nie zwróci błędu dotyczącego 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 polega na całkowitym usunięciu wcześniej zarejestrowanej konwersji 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.