Dostosowania konwersji

Użyj metody IngestEvents, aby wprowadzić korekty do wcześniej zarejestrowanych konwersji Google Ads. W interfejsie Data Manager API dostosowanie może zmienić wartość konwersji lub uzupełnić dane użytkownika.

Jeśli przechodzisz z interfejsu Google Ads API, zapoznaj się z artykułem Uaktualnianie z interfejsu Google Ads API, aby porównać, jak w każdym interfejsie obsługiwane są korekty.

Obsługiwane typy konwersji

Możesz dostosować te typy konwersji Google Ads:

Jak działają korekty

W ramach tego samego działania powodującego konwersję Google Ads dopasowuje zdarzenia za pomocą:transactionId

  • Jeśli transactionId pasuje do istniejącej konwersji dla tego samego działania powodującego konwersję, interfejs Data Manager API traktuje żądanie jako korektę konwersji.
  • Jeśli transactionId nie pasuje do istniejącej konwersji, Google Ads utworzy nową konwersję. Zobacz Niedopasowane zdarzenia.

Wysyłanie korekty

Aby dostosować istniejącą konwersję, wyślij żądanie IngestEvents, które zawiera:

  • Taki sam transactionId jak w przypadku pierwotnego zdarzenia.
  • Ten sam cel i to samo działanie powodujące konwersję co w przypadku pierwotnego zdarzenia.
  • zaktualizowane wartości pól, które chcesz dostosować.
  • Wszystkie pola wymagane w przypadku zdarzenia, w tym co najmniej 1 identyfikator, np. adIdentifiers lub userData. Zapoznaj się z wymaganiami dotyczącymi zdarzeń i identyfikatorów w przypadku konwersji offline lub konwersji z wielu źródeł.

Zalecamy przesyłanie tych samych identyfikatorów, które zostały przesłane lub zarejestrowane w przypadku pierwotnego zdarzenia. Jeśli transactionId nie pasuje do istniejącej konwersji, Google Ads używa tych identyfikatorów do przypisania nowej konwersji.

Nie musisz określać typu korekty. Interfejs Data Manager API określa sposób przetwarzania żądania na podstawie transactionId i podanych przez Ciebie pól.

Więcej informacji o wysyłaniu żądań dotyczących pozyskiwania danych znajdziesz w przewodnikach dotyczących wysyłania zdarzeń związanych z konwersjami offline lub konwersjami z wielu źródeł.

Obsługiwane pola

W tabeli poniżej znajdziesz informacje o tym, jak Google Ads stosuje poszczególne pola, gdy zdarzenie pasuje do istniejącej konwersji:

Pole Zachowanie
conversionValue, currency Zastąpiono. Nowa wartość zastępuje zarejestrowaną wartość.
userData Uzupełnione, jeśli pierwotne zdarzenie nie zawierało danych użytkownika, w przeciwnym razie zignorowane.
Wszystkie pozostałe pola, np. adIdentifiers.gclid Nie zaktualizowano. Google Ads zachowuje wartości zarejestrowane w przypadku pierwotnego zdarzenia. Wymagane pola muszą być nadal obecne.

Wartości konwersji

Wyślij nowe parametry conversionValue i currency, aby ponownie wprowadzić wartość zarejestrowanej konwersji. Nowa wartość zastępuje wcześniej zarejestrowaną wartość w raportowaniu i określaniu stawek bez zwiększania liczby konwersji.

Dane użytkownika

Oto jak Google Ads obsługuje userData, takie jak adres e-mail lub numer telefonu:

  • Uzupełniane w przypadku braku: jeśli pierwotne zdarzenie zostało zarejestrowane bez danych użytkownika, korekta dołącza dane użytkownika, aby poprawić atrybucję.

  • Ignorowane, jeśli występuje: jeśli tag Google lub poprzednie przesłanie już przechwyciło dane użytkownika, nowe dane użytkownika są ignorowane. Istniejące dane użytkownika nie zostaną zastąpione ani dołączone.

Inne pola

Identyfikatorów i metadanych innych niż wartość konwersji, waluta i dane użytkownika, np. adIdentifiers.gclid, nie można aktualizować w przypadku dopasowanych zdarzeń. Google Ads zachowuje wartości zarejestrowane w przypadku pierwotnego zdarzenia.

Nadal musisz uwzględniać wszystkie te pola, które są wymagane, np. co najmniej jeden identyfikator. Interfejs Data Manager API weryfikuje je w przypadku każdego zdarzenia.

Niedopasowane zdarzenia

Jeśli transactionId nie pasuje do istniejącego zdarzenia, żądanie jest traktowane jako przesłanie nowej konwersji, a nie korekta.

Google Ads próbuje przypisać nową konwersję do kliknięcia reklamy za pomocą podanych przez Ciebie identyfikatorów, np. adIdentifiers.gclid lub userData.