Dostosowania konwersji

Użyj metody IngestEvents, aby wprowadzić dostosowania 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, przeczytaj artykuł Przejście z interfejsu Google Ads API, aby dowiedzieć się, jak dostosowania są obsługiwane w poszczególnych interfejsach API.

Obsługiwane typy konwersji

Możesz dostosowywać te typy konwersji Google Ads:

Jak działają korekty

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

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

Wysyłanie korekty

Aby dostosować utworzoną wcześniej konwersję, wyślij żądanie IngestEvents, które zawiera:

  • Taki sam transactionId jak w pierwotnym wydarzeniu.
  • To samo miejsce docelowe i 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 wysyłanie tych samych identyfikatorów, które zostały wysł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, jak przetworzyć żądanie, na podstawie parametru transactionId i podanych przez Ciebie pól.

Więcej informacji o wysyłaniu żądań pozyskiwania znajdziesz w przewodnikach dotyczących wysyłania zdarzeń w przypadku konwersji offline lub konwersji 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 dotychczasowej konwersji:

Pole Zachowanie
conversionValue, currency Zastąpione. Nowa wartość zastępuje zarejestrowaną wartość.
userData Uzupełniane, jeśli pierwotne zdarzenie nie zawierało danych użytkownika, w przeciwnym razie ignorowane.
Wszystkie pozostałe pola, takie jak adIdentifiers.gclid Nie zaktualizowano. Google Ads zachowuje wartości zarejestrowane w pierwotnym zdarzeniu. Wymagane pola muszą być nadal obecne.

Wartości konwersji

Aby zmienić wartość zarejestrowanej konwersji, wyślij nowe parametry conversionValue i currency. Nowa wartość zastępuje wcześniej zarejestrowaną wartość w raportach i określaniu stawek, nie zwiększając liczby konwersji.

Dane użytkownika

Oto jak Google Ads postępuje z userData, takimi jak adres e-mail czy numer telefonu:

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

  • Ignoruj, jeśli dane są już dostępne: jeśli tag Google lub poprzednie przesłanie danych już przechwyciło dane użytkownika, nowe dane użytkownika są ignorowane. Istniejące dane użytkownika nie zostaną zastąpione ani uzupełnione.

Inne pola

W przypadku dopasowanych zdarzeń nie można aktualizować identyfikatorów i metadanych innych niż wartość konwersji, waluta i dane użytkownika, takich jak adIdentifiers.gclid. Google Ads zachowuje wartości zarejestrowane w pierwotnym zdarzeniu.

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

Niedopasowane zdarzenia

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

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