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 interfejsem internetowym Google Ads.
Wybór odpowiedniego typu działania powodującego konwersję
Aby wybrać odpowiedni typ działania powodującego konwersję i przewodnik po konfiguracji integracji, skorzystaj z poniższej ścieżki decyzyjnej:
Gdzie występuje zdarzenie konwersji?
- W świecie offline (np. w biurze, siedzibie firmy lub przez telefon): przejdź do kroku 2.
- Bezpośrednio w witrynie (np. zakupy w witrynie, rejestracje lub przesłanie formularza): przejdź do kroku 3.
- W aplikacji mobilnej: przejdź do kroku 4.
- Połączenia telefoniczne nawiązywane bezpośrednio z reklam: użyj opcji Połączenia z reklam (
AD_CALL) (z wykorzystaniemCallAsset).
Konwersje offline:
Czy to rozmowa telefoniczna?
Tak: użyj
Importowanie konwersji telefonicznych (
UPLOAD_CALLS), aby śledzić wyniki połączeń.
Czy to sprzedaż w sklepie stacjonarnym?
Czy jest to sprzedaż offline lub postęp w procesie pozyskiwania potencjalnego klienta wynikający z wizyty w witrynie?
- Tak: użyj konwersji rozszerzonych dotyczących potencjalnych klientów za pomocą interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami po kliknięciu offline w przypadku dotychczasowych integracji z interfejsem Google Ads API. (Uwaga: od 15 czerwca 2026 r. przesyłanie konwersji po kliknięciu za pomocą
UploadClickConversionsjest ograniczone do tokenów programisty, które wcześniej przesyłały konwersje po kliknięciu offline).
- Tak: użyj konwersji rozszerzonych dotyczących potencjalnych klientów za pomocą interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami po kliknięciu offline w przypadku dotychczasowych integracji z interfejsem Google Ads API. (Uwaga: od 15 czerwca 2026 r. przesyłanie konwersji po kliknięciu za pomocą
Konwersje online (w witrynie):
- Czy chcesz śledzić wczytania strony (zakupy, paragony) czy kliknięcia użytkowników?
- Tak: użyj Konwersji w witrynie z fragmentem kodu tagu ustawionym na
WEBPAGElubWEBPAGE_ONCLICK.
- Tak: użyj Konwersji w witrynie z fragmentem kodu tagu ustawionym na
Czy chcesz śledzić połączenia z numerem telefonu podanym w Twojej witrynie?
Śledzenie rzeczywistego czasu trwania połączeń
Tak: użyj
Połączenia z witryny (
WEBSITE_CALL) z dynamicznym numerem Google do przekazywania połączeń i fragmentem kodu zdarzenia tagu.Nie (tylko śledzić kliknięcia przycisków lub linków w witrynie mobilnej)? Użyj
- Czy chcesz śledzić wczytania strony (zakupy, paragony) czy kliknięcia użytkowników?
Konwersje z aplikacji mobilnych:
- Czy śledzenie instalacji lub zakupów w Sklepie Google Play jest wystarczające?
- Tak: używaj konwersji z aplikacji (
GOOGLE_PLAY_DOWNLOADlubGOOGLE_PLAY_IN_APP_PURCHASE).
- Tak: używaj konwersji z aplikacji (
Czy śledzisz działania w aplikacji za pomocą Google Analytics (GA4) lub zewnętrznych narzędzi analitycznych ?
Tak: użyj
Firebase i analityka aplikacji innej firmy (przez włączenie działań powodujących konwersję
FIREBASE_*lubTHIRD_PARTY_*).
- Czy śledzenie instalacji lub zakupów w Sklepie Google Play jest wystarczające?
Konwersje offline
Konwersje offline pomagają śledzić zdarzenia konwersji, które mają miejsce w świecie offline, np. w biurze, w lokalizacji firmy lub przez telefon.
W tabeli poniżej znajdziesz parametry interfejsu API ConversionActionType, których należy używać w przypadku poszczególnych źródeł w interfejsie internetowym Google Ads, oraz link do dokumentacji dotyczącej 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 | Użyj interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami offline po kliknięciu, aby dowiedzieć się, jak korzystać z dotychczasowych integracji z interfejsem Google Ads API. |
UPLOAD_CALLS |
Śledź konwersje telefoniczne | Importowanie konwersji telefonicznych – przewodnik |
STORE_SALES |
Śledzenie konwersji polegających na sprzedaży w sklepie | Szczegółowe informacje znajdziesz w artykule Sprzedaż w sklepie: importowanie do działania powodującego konwersję z raportowaniem. |
Konwersje online (w witrynie)
Konwersja w witrynie umożliwia śledzenie działań w witrynie, takich jak sprzedaż online, kliknięcia linków, wyświetlenia strony i rejestracje.
Aby śledzić konwersje w witrynie, musisz utworzyć ConversionAction z ConversionActionType ustawionym na WEBPAGE i dodać fragment kodu zwany tagiem do strony konwersji w witrynie.
ConversionAction obejmuje kilka typó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 obiektu ConversionAction.
TagSnippet zawiera kod śledzenia, który należy umieścić w witrynie, aby śledzić działania powodujące konwersję.
Konwersje typu Witryna i Kliknięcie numeru telefonu wymagają 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 przesłania formularza kontaktowego, oraz global_site_tag, który należy zainstalować na każdej stronie 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 w 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 z aplikacji umożliwia śledzenie instalacji aplikacji mobilnych lub zakupów w aplikacji ze Sklepu Google Play.
W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API ConversionActionType, których należy używać w przypadku poszczególnych źródeł 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 sekcją Dodatkowe typy działań powodujących konwersję.
Konwersje telefoniczne
Śledzenie konwersji telefonicznych umożliwia śledzenie połączeń z reklam, połączeń na numer podany w Twojej witrynie i kliknięć numerów w witrynach mobilnych.
W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API ConversionActionType, których należy używać w przypadku poszczególnych źródeł 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 AD_CALL działania powodującego konwersję określ jego nazwę zasobu w call_conversion_action podczas tworzenia CallAsset.
Komponenty do wykonywania połączeń 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 widoczne w interfejsie internetowym Google Ads jako konwersja Połączenia z witryny.
W odróżnieniu od AD_CALL ten tag śledzenia wymaga dodania do witryny event_snippet i global_site_tag, aby pobierać dynamiczny numer Google do przekazywania połączeń na potrzeby śledzenia połączeń z numerami podanymi 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 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, ponieważ uzupełniają dotychczasowe tagi konwersji o własne dane o konwersjach, takie jak adres e-mail, imię i nazwisko, adres pocztowy i numer telefonu.
W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API, których należy używać w przypadku poszczególnych typów 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
Polepszają pomiar transakcji offline realizowanych przez potencjalnych klientów lub innych użytkowników korzystających z witryny. |
Użyj interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami po kliknięciu offline w przypadku istniejących integracji z interfejsem Google Ads 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ń. Możesz wysyłać zapytania o działania powodujące konwersję i ich typy za pomocą GoogleAdsService:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
Konwersje SKAdNetwork
Jeśli prowadzisz kampanie promujące aplikacje na iOS i masz wdrożony interfejs 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łoszona przez Apple. Te dane można podzielić na segmenty tylko za pomocą 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 |
Typ zdarzenia, które wystąpiło w przypadku konkretnej konwersji. |
segments.sk_ad_network_attribution_credit |
Sposób przypisywania udziału w konkretnej konwersji. |
segments.sk_ad_network_fine_conversion_value |
Wartość konwersji zgłoszona przez Apple. Tego segmentu nie można zastosować do żadnych danych innych niż Jeśli Apple zgłosi wartość |
segments.sk_ad_network_coarse_conversion_value |
Wartość ogólna pojedynczej konwersji. |
segments.sk_ad_network_postback_sequence_index |
Pozycja wywołania zwrotnego w sekwencji w przypadku konkretnej 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 dotyczy (np. w przypadku kampanii, która nie jest kierowana na urządzenia z iOS) lub nie występował 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 dotyczy (np. w przypadku kampanii, która nie jest prowadzona na iOS) lub że w żadnym wywołaniu zwrotnym wysłanym 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 dokładnych wartości konwersji zwróconych przez Apple i modelowanych wartości null od 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 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 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. - Zmień pola
primary_for_goalicategory, aby określić, jak ma wpływać na ustalanie 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ć analitykę aplikacji innych firm lub konwersje z Firebase, zmień wartość status elementu ConversionAction z HIDDEN na ENABLED za pomocą metody mutate elementu ConversionActionService. W przypadku tych działań powodujących konwersję aktualizowanie app_id nie jest obsługiwane.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_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
Podane niżej typy działań powodujących konwersję są w interfejsie Google Ads API dostępne tylko do odczytu i służą do celów raportowania.
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 typy działań powodujących konwersję, możesz zauważyć, że zapytania i raporty zwracają działania powodujące konwersję, w przypadku których pole ConversionAction.type ma wartość UNKNOWN. Interfejs API nie obsługuje zarządzania tymi działaniami powodującymi konwersję, ale zwraca je w raportach, aby dostarczać pełne wyniki dotyczące kluczowych danych o konwersjach, takich jak metrics.conversions i metrics.conversions_value.