W tym przewodniku znajdziesz listę różnych typów działań powodujących konwersję, które możesz utworzyć za pomocą interfejsu Google Ads API, oraz informacje o tym, jak są one powiązane z internetowym interfejsem Google Ads.
Konwersje offline
Konwersje offline pomagają śledzić zdarzenia konwersji, które mają miejsce w świecie offline, np. w biurze, adresie sklepu lub podczas rozmowy telefonicznej.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu APIConversionActionType, których możesz używać w przypadku każdego źródła w interfejsie internetowym Google Ads, oraz linki do dokumentacji poszczególnych typów działań powodujących konwersję:
| Typ działania powodującego konwersję | Źródło Google Ads | Przewodnik po konfiguracji interfejsu API |
|---|---|---|
UPLOAD_CLICKS |
Śledzenie konwersji po kliknięciu i konwersji rozszerzonych dotyczących potencjalnych klientów | Korzystanie z interfejsu Data Manager API |
UPLOAD_CALLS |
Śledź konwersje telefoniczne | Przewodnik po importowaniu konwersji telefonicznych |
STORE_SALES |
Śledzenie konwersji polegających na sprzedaży w sklepie | Przewodnik po importowaniu konwersji polegających na sprzedaży w sklepie |
Konwersje online (w witrynie)
Konwersja w witrynie umożliwia śledzenie działań w witrynie, takich jak sprzedaż online, kliknięcia linków, wyświetlenia stron i rejestracje.
Aby śledzić konwersje w witrynie, musisz utworzyć działanie powodujące konwersję typu ConversionAction z parametrem ConversionActionType ustawionym na WEBPAGE i dodać do strony konwersji w witrynie fragment kodu nazywany tagiem.
ConversionAction obejmuje kilka rodzajów konwersji w witrynie, które są rozróżniane w interfejsie API za pomocą pola type w każdym elemencie TagSnippet wymienionym w polu tag_snippets elementu ConversionAction.
TagSnippet udostępnia kod śledzenia, który musi zostać umieszczony w Twojej witrynie, aby śledzić działania powodujące konwersję.
Konwersje Witryna i Kliknięcie numeru telefonu wymagają tagu
event_snippet,
który należy umieścić na stronach internetowych wskazujących działanie powodujące konwersję, np. na stronie potwierdzenia płatności lub na stronie przesyłania formularza kontaktowego, oraz tagu
global_site_tag,
który musi być zainstalowany na każdej stronie Twojej witryny. Oba te atrybuty możesz pobrać za pomocą ConversionActionService. Więcej informacji o tagowaniu stron znajdziesz w naszym Centrum pomocy.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu API, których możesz użyć w przypadku każdego źródła w interfejsie internetowym Google Ads:
| Typ kodu śledzenia | Źródło Google Ads |
|---|---|
WEBPAGE |
Witryna, Witryna (Google Analytics 4) |
WEBPAGE_ONCLICK |
Witryna, Witryna (Google Analytics 4) |
CLICK_TO_CALL |
Kliknięcia numeru telefonu |
Konwersje z aplikacji
Konwersja z aplikacji umożliwia śledzenie instalacji aplikacji mobilnych lub zakupów w aplikacji w Sklepie Google Play.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu APIConversionActionType
dla każdego źródła w interfejsie internetowym Google Ads:
| Typ działania powodującego konwersję | Źródło Google Ads |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Instalacje |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Zakupy w aplikacji |
Aby śledzić inne działania w aplikacjach mobilnych za pomocą usług w Google Analytics 4 lub analityki aplikacji innej firmy, zapoznaj się z sekcją Dodatkowe typy działań powodujących konwersję.
Konwersje telefoniczne
Śledzenie konwersji telefonicznych umożliwia śledzenie połączeń z reklam, połączeń na numer telefonu w Twojej witrynie i kliknięć numerów w witrynach mobilnych.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu APIConversionActionType
dla każdego źródła w interfejsie internetowym Google Ads:
| Typ działania powodującego konwersję | Źródło Google Ads |
|---|---|
AD_CALL |
Połączenia z reklam korzystających z rozszerzeń połączeń lub reklam typu „tylko połączenie” |
WEBSITE_CALL |
Połączenia z numerem telefonu w Twojej witrynie |
CLICK_TO_CALL |
Kliknięcia numeru w Twojej witrynie mobilnej |
AD_CALL
Działanie powodujące konwersjęAD_CALL jest wyświetlane w interfejsie internetowym Google Ads jako konwersja Połączenia z reklam. Po utworzeniu AD_CALLdziałania powodującego konwersjęcall_conversion_action podczas tworzenia CallAsset w polu call_conversion_action podaj jego nazwę zasobu. Komponenty do wywoływania umożliwiają wyświetlanie numeru telefonu bezpośrednio w reklamach.
Połączenie jest raportowane jako konwersja, jeśli trwa dłużej niż określony czas. Wartość domyślna to 60 sekund.
WEBSITE_CALL
Działanie powodujące konwersję WEBSITE_CALL jest wyświetlane w interfejsie internetowym Google Ads jako konwersja Połączenia z witryny.
W przeciwieństwie do AD_CALL ten moduł śledzenia wymaga dodania do witryny event_snippet i global_site_tag, aby pobrać dynamiczny numer Google do przekazywania połączeń na potrzeby śledzenia konwersji telefonicznych z numerów podanych w witrynie. Musisz też skonfigurować komponent do wykonywania połączeń i połączyć go na poziomie klienta, kampanii lub grupy reklam.
CLICK_TO_CALL
Działanie powodujące konwersję CLICK_TO_CALL
jest wyświetlane w interfejsie internetowym Google Ads jako konwersja Kliknięcia numeru telefonu w witrynie mobilnej.
Typ CLICK_TO_CALL różni się od typu AD_CALL tym, że nie śledzi rzeczywistych połączeń telefonicznych. Zamiast tego CLICK_TO_CALL śledzi tylko kliknięcia numeru telefonu na urządzeniu mobilnym. Jest to przydatne, gdy nie możesz używać numeru Google do przekazywania połączeń do śledzenia połączeń telefonicznych.
Konwersje rozszerzone
Konwersje rozszerzone pomagają zwiększyć dokładność pomiaru konwersji, uzupełniając dotychczasowe tagi konwersji o dane własne o konwersjach, takie jak adres e-mail, imię i nazwisko, adres domowy i numer telefonu.
W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API, których należy użyć w przypadku każdego typu konwersji rozszerzonych:
| Typ działania powodującego konwersję | Typ konwersji rozszerzonych | Przewodnik po konfiguracji interfejsu API |
|---|---|---|
UPLOAD_CLICKS |
Konwersje rozszerzone dotyczące potencjalnych klientów
Ulepszają pomiar transakcji offline realizowanych przez potencjalnych klientów lub innych użytkowników korzystających z witryny. |
Użyj interfejsu Data Manager API |
WEBPAGE |
Konwersje rozszerzone w kampaniach internetowych
Ulepszają pomiar konwersji online. |
Przewodnik po konfiguracji interfejsu API |
Dodatkowe typy działań powodujących konwersję
Interfejs Google Ads API udostępnia w raportach dodatkowe typy działań powodujących konwersję, ale może ograniczać lub uniemożliwiać tworzenie i modyfikowanie tych działań.
Konwersje SKAdNetwork
Jeśli prowadzisz kampanie promujące aplikacje na iOS i masz wdrożoną platformę SKAdNetwork, możesz uzyskać dostęp do danych SKAdNetwork przekazywanych do Google na poziomie Customer i Campaign, korzystając z tych zasobów:
| Pole raportu | Opis |
|---|---|
metrics.sk_ad_network_installs |
Liczba instalacji zgłoszonych przez Apple. Te dane można dzielić na segmenty tylko według dowolnej kombinacji segmentów segments.sk_ad_network_conversion_value i segmentów związanych z datą.
|
metrics.sk_ad_network_total_conversions |
Łączna liczba konwersji, w tym instalacji i innych typów konwersji raportowanych przez Apple. Te dane można dzielić na segmenty tylko według segmentów związanych z SKAdNetwork i segmentów związanych z datą. |
segments.sk_ad_network_ad_event_type |
Rodzaj zdarzenia, które wystąpiło w przypadku danej konwersji. |
segments.sk_ad_network_attribution_credit |
Jak przypisywany jest udział w konkretnej konwersji. |
segments.sk_ad_network_fine_conversion_value |
Wartość konwersji zgłoszona przez Apple. Tego segmentu nie można stosować do żadnych danych innych niż Jeśli Apple zgłosi wartość |
segments.sk_ad_network_coarse_conversion_value |
Przybliżona wartość pojedynczej konwersji. |
segments.sk_ad_network_postback_sequence_index |
Pozycja wywołania zwrotnego w sekwencji dla konkretnej konwersji. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
Identyfikator aplikacji, w której wyświetlono reklamę, która doprowadziła do zainstalowania aplikacji z pakietu iOS Store Kit Ad Network. |
segments.sk_ad_network_source_domain |
Witryna, w której wyświetliła się reklama, która doprowadziła do zainstalowania aplikacji z pakietu iOS Store Kit Ad Network. Wartość null oznacza, że ten segment nie ma zastosowania (np. w przypadku kampanii na urządzenia inne niż iOS) lub nie występuje w żadnych wywołaniach zwrotnych wysłanych przez Apple. |
segments.sk_ad_network_source_type |
Typ źródła, w którym wyświetliła się reklama, która doprowadziła do zainstalowania aplikacji z pakietu iOS Store Kit Ad Network. Wartość null oznacza, że ten segment nie ma zastosowania (np. w przypadku kampanii na urządzenia inne niż iOS) lub że w żadnym z postbacków wysłanych przez Apple nie było domeny źródłowej ani aplikacji źródłowej. |
segments.sk_ad_network_user_type |
Typ użytkownika, który wygenerował daną konwersję. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Wartości konwersji w tym segmencie obejmują wartości null, które zostały ponownie przypisane do wartości konwersji. Ten segment reprezentuje sumę obserwowanych wartości konwersji o wysokiej precyzji zwracanych przez Apple i modelowanych wartości null od Google. |
segments.sk_ad_network_version |
Użyta wersja interfejsu Store Kit Ad Network API na iOS. |
Google Analytics
Konwersje z połączonej usługi w Google Analytics mają jedną z tych wartości:type
Konwersja w usłudze w GA4:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Identyfikator usługi w GA4, nazwę usługi i nazwę zdarzenia możesz też pobrać z pola
google_analytics_4_settings.
W przypadku konwersji w usłudze w GA4 możesz wprowadzać te zmiany:
- Zaimportuj konwersję z usługi w GA4 na konto Google Ads, zmieniając wartość pola
statuszHIDDENnaENABLED. - Zmodyfikuj pola
primary_for_goalicategory, aby określić, jak powinna ona wpływać na określanie stawek i raporty w Google Ads. - zaktualizować
namelubvalue_settings. - Usuń konwersję z konta Google Ads za pomocą operacji
remove.
Każda próba zmodyfikowania innych atrybutów zaimportowanej konwersji w GA4 lub jakichkolwiek atrybutów zaimportowanej konwersji w Universal Analytics spowoduje wystąpienie MUTATE_NOT_ALLOWEDbłędu. Możesz wprowadzać te zmiany tylko w interfejsie Google Ads.
Firebase i analityka aplikacji innych firm
Aby importować konwersje z analityki aplikacji innych firm lub Firebase, zmień status elementu ConversionAction z HIDDEN na ENABLED za pomocą metody mutate elementu ConversionActionService. Aktualizowanie parametru app_id nie jest obsługiwane w przypadku tych działań powodujących konwersję.
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Sprzedaż w sklepie: importowanie do działania powodującego konwersję z raportowaniem
Za pomocą interfejsu Google Ads API nie możesz tworzyć działań powodujących konwersję STORE_SALES ani STORE_SALES_DIRECT_UPLOAD, ale interfejs API obsługuje importowanie transakcji sprzedaży w sklepie.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Typy działań powodujących konwersję tylko do odczytu
Te typy działań powodujących konwersję są dostępne w interfejsie Google Ads API tylko do odczytu i służą do generowania raportów.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Nieznany
Jeśli Twoje konto Google Ads zawiera inne rodzaje działań powodujących konwersję, w zapytaniach i raportach mogą się pojawiać działania powodujące konwersję, w których wartość ConversionAction.type wynosi UNKNOWN.
Interfejs API nie obsługuje zarządzania tymi działaniami powodującymi konwersję, ale zwraca je w raportach, aby dostarczać pełne wyniki kluczowych danych o konwersjach, takich jak metrics.conversions i metrics.conversions_value.