Ten przewodnik zawiera 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 mapowane na interfejs internetowy 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) (za pomocąCallAsset). - W usługach Google opartych na lokalizacji (np. wskazówki dojazdu, połączenia telefoniczne lub kliknięcia w Mapach Google): zobacz Konwersje polegające na działaniach lokalnych (
GOOGLE_HOSTED).
Konwersje offline:
Czy to rozmowa telefoniczna?
Tak: użyj
Importowanie konwersji telefonicznych (
UPLOAD_CALLS), aby śledzić wyniki połączeń.
Czy jest to sprzedaż w sklepie stacjonarnym?
Czy jest to sprzedaż offline lub postęp w zdobywaniu potencjalnego klienta wynikający z wizyty w witrynie?
- Tak: używaj konwersji rozszerzonych dotyczących potencjalnych klientów za pomocą interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami offline po kliknięciu, aby dowiedzieć się więcej o dotychczasowych integracjach 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 offline po kliknięciu).
- Tak: używaj konwersji rozszerzonych dotyczących potencjalnych klientów za pomocą interfejsu Data Manager API (zalecane) lub zapoznaj się z artykułem Zarządzanie konwersjami offline po kliknięciu, aby dowiedzieć się więcej o dotychczasowych integracjach z interfejsem Google Ads API. (Uwaga: od 15 czerwca 2026 r. przesyłanie konwersji po kliknięciu za pomocą
Konwersje online (w witrynie):
- Chcesz śledzić wczytania strony (zakupy, rachunki) 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 wykonywane na numer telefonu podany 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 (śledź tylko kliknięcia przycisku lub linku w witrynie mobilnej) Użyj
- Chcesz śledzić wczytania strony (zakupy, rachunki) 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 narzędzi analitycznych innej firmy?
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, siedzibie 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 w 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 zarządzać dotychczasowymi integracjami 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 obiekcie TagSnippet wymienionym w polu tag_snippets obiektu ConversionAction.
TagSnippet udostępnia 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 Centrum pomocy.
W tabeli poniżej znajdziesz odpowiednie parametry 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 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 w 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 w 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ętrznej usługi 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ń z numerem telefonu podanym w Twojej witrynie i kliknięć numeru telefonu w witrynie mobilnej.
W tabeli poniżej znajdziesz parametry interfejsu API ConversionActionType odpowiadające poszczególnym źródłom w interfejsie internetowym Google Ads:
| Typ działania powodującego konwersję | Źródło w 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 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 pojawia się 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 offline po kliknięciu, aby dowiedzieć się więcej o dotychczasowych integracjach z interfejsem Google Ads API. |
WEBPAGE |
Konwersje rozszerzone w kampaniach internetowych
Polepszają 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ń. Działania powodujące konwersję i ich typy możesz sprawdzać za pomocą pola GoogleAdsService:
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.origin,
conversion_action.category,
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 dzielić 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 raportowana 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 dla 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 dotyczy (np. w przypadku kampanii, która nie jest prowadzona na 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ę zaobserwowanych 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 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. - Zmień pola
primary_for_goalicategory, aby określić, jak ma wpływać na określanie stawek i raporty w Google Ads. - zaktualizować
namelubvalue_settings, - Usuń konwersję z konta Google Ads za pomocą operacji
remove.
Próba zmiany innych atrybutów zaimportowanej konwersji GA4 lub dowolnych atrybutów zaimportowanej konwersji Universal Analytics spowoduje błąd MUTATE_NOT_ALLOWED. Te zmiany możesz wprowadzać tylko w interfejsie Google Ads.
Firebase i analityka aplikacji innych firm
Aby importować analitykę aplikacji innych firm lub konwersje z Firebase, zmień wartość pola status w obiekcie ConversionAction z HIDDEN na ENABLED, używając metody mutate w 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
Chociaż nie możesz tworzyć działań powodujących konwersję typu STORE_SALES ani STORE_SALES_DIRECT_UPLOAD za pomocą interfejsu Google Ads API, interfejs ten obsługuje importowanie transakcji sprzedaży w sklepie.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Działania lokalne powodujące konwersje
Google Ads automatycznie tworzy konwersje polegające na działaniach lokalnych, aby śledzić działania w usługach Google związanych z lokalizacją (np. w Mapach Google) po interakcji użytkownika z reklamą.
W interfejsie Google Ads API wszystkie konwersje polegające na działaniach lokalnych są zasobami ConversionAction tylko do odczytu z tymi wartościami pól:
Pola name (zlokalizowane w języku konta) i category identyfikują poszczególne konwersje polegające na działaniach lokalnych, jak pokazano w tabeli poniżej. Działania lokalne – wizyty w witrynie i Działania lokalne – wyświetlenia menu korzystają z kategorii PAGE_VIEW i są rozróżniane w raportach za pomocą conversion_action.name lub conversion_action.id.
| Nazwa działania powodującego konwersję w Google Ads | Pole ConversionAction.category |
Opis |
|---|---|---|
| Kliknięcia przycisku połączenia | CONTACT |
Kliknięcie przycisku Zadzwoń w reklamie lub usłudze Google dotyczącej konkretnej lokalizacji. |
| Działania lokalne – wyznaczanie trasy | GET_DIRECTIONS |
Kliknięcia przycisku Wyznacz trasę w reklamie lub usłudze Google dotyczącej konkretnej lokalizacji. |
| Działania lokalne – wizyty w witrynie | PAGE_VIEW |
Kliknięcie adresu URL witryny w reklamie lub usłudze Google dotyczącej konkretnej lokalizacji. |
| Działania lokalne – wyświetlenia menu | PAGE_VIEW |
Kliknięcie adresu URL menu w reklamie lub usłudze Google dotyczącej konkretnej lokalizacji. |
| Działania lokalne – zamówienia | BEGIN_CHECKOUT |
Kliknięcie przycisku Zamów w reklamie lub usłudze Google dotyczącej konkretnej lokalizacji. |
| Działania lokalne – inne interakcje | ENGAGEMENT |
Kliknięcia w ramach innych śledzonych działań (np. udostępnienie lub zapisanie lokalizacji) w reklamie lub usłudze Google związanej z konkretną lokalizacją. |
Domyślnie wszystkie cele konwersji GOOGLE_HOSTED nie są używane do określania stawek (biddable ma wartość false). Możesz włączyć określanie stawek tylko w przypadku tych celów związanych z działaniami lokalnymi:
- Działania lokalne – wyznaczanie trasy (
categorytoGET_DIRECTIONS,origintoGOOGLE_HOSTED):- Poziom konta: ustaw pole
biddablena wartośćtruew zasobieCustomerConversionGoaldla kategoriiGET_DIRECTIONSi źródłaGOOGLE_HOSTEDlub uwzględnij działanie powodujące konwersję wCustomConversionGoal. - Poziom kampanii (tylko kampanie Performance Max, kampanie w sieci wyszukiwania i kampanie produktowe): ustaw pole
biddablena wartośćtruew zasobieCampaignConversionGoaldla kategoriiGET_DIRECTIONSi źródłaGOOGLE_HOSTED.
- Poziom konta: ustaw pole
- Kliknięcia, by połączyć (
categorytoCONTACT,origintoGOOGLE_HOSTED):- Poziom kampanii (tylko kampanie Performance Max): ustaw pole
biddablena wartośćtruew zasobieCampaignConversionGoaldla kategoriiCONTACTi źródłaGOOGLE_HOSTED. W przypadku tego celu nie jest obsługiwane określanie stawek na poziomie konta za pomocą strategiiCustomerConversionGoal.
- Poziom kampanii (tylko kampanie Performance Max): ustaw pole
Wszystkie pozostałe kategorie GOOGLE_HOSTED (PAGE_VIEW, BEGIN_CHECKOUT i ENGAGEMENT) nie są używane do określania stawek. Więcej informacji znajdziesz w artykule Cele konwersji.
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.