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 ich mapowaniu na interfejs internetowy Google Ads.
Konwersje offline
Konwersje offline pomagają śledzić zdarzenia konwersji, które występują w świecie offline, np. w biurze, lokalizacji firmy lub przez telefon.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu API ConversionActionType
dla każdej źródła w interfejsie internetowym Google Ads oraz link do dokumentacji dotyczącej poszczególnych typów działań konwersji:
Typ działania powodującego konwersję | Źródło Google Ads | Przewodnik po konfigurowaniu interfejsu API |
---|---|---|
UPLOAD_CLICKS |
Śledzenie konwersji po kliknięciu i konwersji rozszerzonych dotyczących potencjalnych klientów | Przewodnik po zarządzaniu konwersjami z kliknięć offline
Przewodnik po konwersjach rozszerzonych dotyczących potencjalnych klientów |
UPLOAD_CALLS |
Śledź konwersje telefoniczne | Importowanie konwersji telefonicznych – przewodnik |
STORE_SALES |
Śledzenie konwersji polegających na sprzedaży w sklepie | Importowanie danych o konwersjach polegających na sprzedaży w sklepie stacjonarnym – przewodnik |
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ć ConversionAction
z ustawieniem ConversionActionType
równym WEBPAGE
i dodać do strony konwersji w witrynie fragment kodu zwany tagiem.
Parametr ConversionAction
obejmuje kilka typów konwersji w witrynie, które są rozróżniane w interfejsie API za pomocą pola type
w każdym rekordzie TagSnippet
w polu tag_snippets w ConversionAction
.
TagSnippet
zawiera kod śledzenia, który musisz uwzględnić w swojej witrynie, aby móc śledzić działania powodujące konwersję.
Konwersje na stronie internetowej i po kliknięciu numeru telefonu wymagają tagu event_snippet
, który należy umieścić na stronach internetowych wskazujących na działanie powodujące konwersję, np. na stronie potwierdzenia płatności lub stronie przesyłania formularza kontaktowego. Tag global_site_tag
musi być zainstalowany na każdej stronie witryny. Oba te atrybuty możesz pobrać za pomocą funkcji ConversionActionService
. Więcej informacji o tagowaniu stron znajdziesz w Centrum pomocy.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu API, których należy używać w przypadku poszczególnych źródeł w interfejsie internetowym Google Ads:
Typ kodu śledzenia | Źródło Google Ads |
---|---|
WEBPAGE |
Witryna, Witryna (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Witryna, Witryna (Google Analytics (GA4)) |
CLICK_TO_CALL |
Kliknięcia numeru telefonu |
Konwersje z aplikacji
Konwersja w aplikacji umożliwia śledzenie instalacji aplikacji mobilnej lub zakupów w aplikacji ze Sklepu Google Play.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu API ConversionActionType
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 aplikacji mobilnej za pomocą usług w Google Analytics 4 lub zewnętrznych usług analityki aplikacji, zapoznaj się z artykułem Dodatkowe typy działań konwersji.
Konwersje telefoniczne
Śledzenie konwersji polegających na połączeniach telefonicznych umożliwia śledzenie połączeń z reklam, połączeń na numer telefonu podany w Twojej witrynie oraz kliknięć numerów w witrynach mobilnych.
W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu API ConversionActionType
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 widoczne w interfejsie internetowym Google Ads jako konwersja Połączenia z reklam. Po utworzeniu działania powodującego konwersję AD_CALL
podaj jego nazwę zasobu w polu call_conversion_action
podczas tworzenia tagu CallAsset
. Zasoby połączeń umożliwiają wyświetlanie numeru telefonu bezpośrednio w reklamach.
Połączenie jest zgłaszane jako konwersja, jeśli trwa dłużej niż określony czas. Wartość domyślna to 60 sekund.
WEBSITE_CALL
W interfejsie internetowym Google Ads działanie powodujące konwersję WEBSITE_CALL
jest widoczne jako konwersja Połączenia z witryny.
W przeciwieństwie do tagu AD_CALL
ten tag wymaga dodania do witryny tagów event_snippet
i global_site_tag
, aby pobrać dynamiczny numer Google do przekazywania połączeń do śledzenia połączeń na numery wymienione w witrynie. Dodatkowo musisz 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 widoczne w interfejsie Google Ads jako konwersja kliknięć 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 z urządzenia mobilnego. 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ększać dokładność pomiaru konwersji dzięki uzupełnianiu dotychczasowych tagów konwersji o dane własne o konwersjach, np. adres e-mail, imię i nazwisko, adres pocztowy i numer telefonu.
W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API, które należy stosować w przypadku każdego typu konwersji Enhanced Conversion:
Typ działania powodującego konwersję | Typ konwersji rozszerzonej | Przewodnik po konfigurowaniu interfejsu API |
---|---|---|
UPLOAD_CLICKS |
Konwersje rozszerzone dotyczące potencjalnych klientów
Poprawia pomiar transakcji offline realizowanych przez potencjalnych klientów lub innych użytkowników korzystających z witryny. |
Przewodnik po konfiguracji interfejsu API |
WEBPAGE |
Konwersje rozszerzone w kampaniach internetowych
Ulepszenia pomiaru 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 zaimplementowaną SKAdNetwork, możesz uzyskać dostęp do danych SKAdNetwork przekazywanych do Google na poziomie Customer
i Campaign
za pomocą 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 za pomocą dowolnej kombinacji segmentów związanych z tymi wymiarami: segments.sk_ad_network_conversion_value i datami.
|
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 datami. |
segments.sk_ad_network_ad_event_type |
Typ zdarzenia, które miało miejsce w przypadku danej konwersji. |
segments.sk_ad_network_attribution_credit |
Sposób przypisywania udziału w przypadku danej konwersji. |
segments.sk_ad_network_fine_conversion_value |
Wartość konwersji zgłoszonej przez Apple. Tego segmentu nie można zastosować do żadnych danych innych niż Jeśli Apple podaje wartość |
segments.sk_ad_network_coarse_conversion_value |
Przybliżona wartość pojedynczej konwersji. |
segments.sk_ad_network_postback_sequence_index |
Kolejność pozycji wywołania zwrotnego w przypadku danej konwersji. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
Identyfikator aplikacji, w której wyświetliła się reklama, 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 jest odpowiedni (np. kampania nie dotyczy systemu iOS) lub nie był obecny 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 nieobejmującej iOS) lub że ani domena źródłowa, ani aplikacja źródłowa nie były obecne w żadnych wywołaniach zwrotnych wysłanych przez Apple. |
segments.sk_ad_network_user_type |
Typ użytkownika, który dokonał określonej konwersji. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Wartości konwersji w tym segmencie obejmują wartości null, które zostały rozdzielone na wartości konwersji. Ten segment reprezentuje sumę odnotowanych wartości konwersji z dokładnością zwracanych przez Apple i modelowanych wartości null z Google. |
segments.sk_ad_network_version |
Używana wersja interfejsu API sieci reklamowej Store Kit na iOS. |
Google Analytics
Konwersje z połączonej usługi w Google Analytics mają jedną z tych wartości:type
Konwersja usługi w GA4:
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
Identyfikator, nazwę usługi w GA4 i nazwę zdarzenia możesz też pobrać z pola
google_analytics_4_settings
.
W konwersji w usłudze w GA4 możesz wprowadzić te zmiany:
- Zaimportuj konwersję z usługi w GA4 na konto Google Ads, zmieniając w niej pole
status
z wartościHIDDEN
naENABLED
. - Zmień pola
primary_for_goal
icategory
, aby określić, jak ma ono wpływać na określanie stawek i raporty Google Ads. - Zaktualizuj
name
lubvalue_settings
. - Usuń konwersję ze swojego konta Google Ads za pomocą operacji
remove
.
Każda próba zmodyfikowania innych atrybutów zaimportowanej konwersji GA4 lub jakichkolwiek atrybutów zaimportowanej konwersji Universal Analytics powoduje błąd MUTATE_NOT_ALLOWED
. Zmiany te możesz wprowadzać tylko w interfejsie Google Ads.
Analityka aplikacji w Firebase i w usługach zewnętrznych
Aby zaimportować konwersje z narzędzia analitycznego innej firmy lub z Firebase, zmień status
w z HIDDEN
na ENABLED
, używając metody mutate
w ConversionActionService
.ConversionAction
W przypadku tych działań powodujących konwersję nie można aktualizować parametru app_id
.
FIREBASE_ANDROID_FIRST_OPEN
FIREBASE_ANDROID_IN_APP_PURCHASE
FIREBASE_ANDROID_CUSTOM
FIREBASE_IOS_FIRST_OPEN
FIREBASE_IOS_IN_APP_PURCHASE
FIREBASE_IOS_CUSTOM
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Sprzedaż w sklepie: importowanie do działania powodującego konwersję z raportowaniem
Chociaż za pomocą interfejsu Google Ads API nie możesz tworzyć działań powodujących konwersję STORE_SALES
ani STORE_SALES_DIRECT_UPLOAD
, interfejs ten obsługuje importowanie transakcji sprzedaży w sklepie stacjonarnym.
STORE_SALES
STORE_SALES_DIRECT_UPLOAD
Typy działań powodujących konwersję tylko do odczytu
W interfejsie Google Ads API wymienione niżej typy działań powodujących konwersję są dostępne tylko do odczytu i służą do celów raportowania.
ANDROID_APP_PRE_REGISTRATION
ANDROID_INSTALLS_ALL_OTHER_APPS
FLOODLIGHT_ACTION
FLOODLIGHT_TRANSACTION
GOOGLE_HOSTED
LEAD_FORM_SUBMIT
SALESFORCE
SEARCH_ADS_360
SMART_CAMPAIGN_AD_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL
SMART_CAMPAIGN_MAP_DIRECTIONS
SMART_CAMPAIGN_TRACKED_CALLS
STORE_VISITS
WEBPAGE_CODELESS
Nieznany
Jeśli na Twoim koncie Google Ads występują inne typy działań powodujących konwersję, zapytania i raporty mogą zwracać działania powodujące konwersję, w których ConversionAction.type
to UNKNOWN
.
Interfejs API nie obsługuje zarządzania tymi działaniami powodującymi konwersję, ale zwraca je w raportach, aby zapewnić pełne wyniki dotyczące kluczowych danych o konwersjach, takich jak metrics.conversions
i metrics.conversions_value
.