Użyj metody IngestEvents, aby wprowadzić korekty do wcześniej zarejestrowanych konwersji Google Ads.
W interfejsie Data Manager API korekta 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 API obsługiwane są korekty.
Obsługiwane typy konwersji
Możesz dostosować te typy konwersji Google Ads:
- Konwersje z wieloma źródłami: konwersje zarejestrowane przez tag Google w Twojej witrynie w przypadku działania powodującego konwersję
WEBSITE. - Konwersje offline i konwersje rozszerzone dotyczące potencjalnych klientów: wcześniej przesłane zdarzenia offline dotyczące działania powodującego konwersję
UPLOAD_CLICKS.
Jak działają dostosowania
W ramach tego samego działania powodującego konwersję Google Ads dopasowuje zdarzenia za pomocą tych parametrów:transactionId
- Jeśli
transactionIdpasuje do istniejącej konwersji w ramach tego samego działania powodującego konwersję, interfejs Data Manager API traktuje żądanie jako korektę konwersji. - Jeśli
transactionIdnie 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
transactionIdjak w przypadku pierwotnego wydarzenia. - To samo miejsce docelowe i działanie powodujące konwersję co w przypadku pierwotnego zdarzenia.
- zaktualizowane wartości pól, które chcesz dostosować;
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 przesyłania danych znajdziesz w artykule Wysyłanie zdarzeń.
Obsługiwane pola
W tabeli poniżej znajdziesz listę pól, które możesz dostosować, oraz informacje o tym, jak są stosowane aktualizacje:
| Pole | Zachowanie |
|---|---|
conversionValue, currency |
Zastąpiono. 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, np. adIdentifiers.gclid |
Zignorowane |
Wartości konwersji
Wyślij nowe parametry conversionValue i currency, aby ponownie określić 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, np. 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ż zarejestrowały dane użytkownika, nowe dane użytkownika są ignorowane. Istniejące dane użytkownika nie zostaną zastąpione ani dołączone.
Inne pola
W przypadku dopasowanych zdarzeń nie można aktualizować identyfikatorów i metadanych innych niż wartość konwersji, waluta i dane użytkownika, np. adIdentifiers.gclid. Google Ads ignoruje te pola i zachowuje wartości zarejestrowane w przypadku pierwotnego zdarzenia.
Niedopasowane zdarzenia
Jeśli wartość transactionId nie pasuje do żadnego z istniejących zdarzeń, żądanie jest traktowane jako przesłanie nowej konwersji, a nie korekty.
Google Ads próbuje przypisać nową konwersję do kliknięcia reklamy za pomocą podanych przez Ciebie identyfikatorów, np. adIdentifiers.gclid lub userData.