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:

• 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: przesłane wcześniej zdarzenia offline dotyczące działania powodującego konwersję UPLOAD_CLICKS.

Uwaga: dostosowywanie konwersji polegających na sprzedaży w sklepie stacjonarnym nie jest obsługiwane.

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ł.

Ważne: interfejs Data Manager API weryfikuje każde zdarzenie po otrzymaniu żądania, zanim zacznie szukać pasującego identyfikatora transactionId. Korekta musi spełniać te same wymagania dotyczące pól i identyfikatorów co nowe zdarzenie. Jeśli tak się nie stanie, żądanie nie powiedzie się i pojawi się błąd, np. NO_IDENTIFIERS_PROVIDED.

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.

Uwaga: w początkowym 14-dniowym okresie próbnym obejmującym konwersje z wieloma źródłami aktualizacje wartości są wyłączone. Wartość zarejestrowana przez tag nie zostanie zastąpiona w raportach Google Ads do czasu zakończenia okresu próbnego.

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ę.

  Uwaga: aby uzyskać optymalną skuteczność, zalecamy przesyłanie dodatkowych danych offline w ciągu 24 godzin od pierwotnego zdarzenia.

• 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.

Uwaga: w początkowym 14-dniowym okresie próbnym obejmującym konwersje z wielu źródeł nowo utworzone konwersje są widoczne w raportach, ale nie są używane do określania stawek. Po zakończeniu okresu próbnego te konwersje staną się automatycznie dostępne na potrzeby określania stawek.