Kategorie działań powodujących konwersję

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.

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 tego schematu decyzyjnego:

1. Gdzie występuje zdarzenie konwersji?

   • W świecie offline (np. w biurze, firmie lub przez telefon): przejdź do kroku 2.
   • Bezpośrednio w witrynie (np. zakupy w witrynie, rejestracje lub przesłania formularza): przejdź do kroku 3.
   • W aplikacji mobilnej: przejdź do kroku 4.
   • Podczas rozmowy telefonicznej nawiązanej bezpośrednio z reklamy: użyj Połączenia z reklam (AD_CALL) (za pomocą CallAsset).

2. Konwersje offline:

   • Czy to połączenie telefoniczne?
     • Tak: użyj importu konwersji telefonicznych (UPLOAD_CALLS), aby śledzić wyniki połączeń.
   • Czy to sprzedaż w sklepie stacjonarnym?
     • Tak: użyj konwersji typu „Sprzedaż w sklepie” (STORE_SALES).
   • Czy jest to sprzedaż offline lub postęp w zdobywaniu potencjalnych klientów wynikający z wizyty w witrynie?
     • Tak: używaj konwersji rozszerzonych dotyczących potencjalnych klientów za pomocą interfejsu Data Manager API. (Uwaga: przesyłanie konwersji polegających na kliknięciu za pomocą UPLOAD_CLICKS lubUploadClickConversion zostało wycofane 15 czerwca 2026 r.).

3. Konwersje online (w witrynie):

   • Czy chcesz śledzić wczytania stron (zakupy, paragony) czy kliknięcia użytkowników?
     • Tak: używaj konwersji w witrynie z kodem tagu ustawionym na WEBPAGE lub WEBPAGE_ONCLICK.
   • Czy chcesz śledzić połączenia wywołane przez numer telefonu podany w Twojej witrynie?
     • Śledzić rzeczywisty czas trwania połączeń?
       • Tak: użyj Połączeń z witryny (WEBSITE_CALL) z dynamicznym numerem Google do przekazywania połączeń i fragmentem kodu zdarzenia tagu zdarzenia.
       • Nie (tylko śledzić kliknięcia przycisków lub linków w witrynie mobilnej)? Użyj Kliknięcia numeru telefonu komórkowego (CLICK_TO_CALL).

4. Konwersje z aplikacji mobilnych:

   • Czy śledzenie instalacji lub zakupów ze Sklepu Google Play jest wystarczające?
     • Tak: używaj konwersji w aplikacji (GOOGLE_PLAY_DOWNLOAD lubGOOGLE_PLAY_IN_APP_PURCHASE).
   • Czy śledzisz działania w aplikacji za pomocą Google Analytics (GA4) lub zewnętrznej analityki aplikacji?
     • Tak: użyj Firebase i analityki aplikacji innych firm (włączając działania powodujące konwersję FIREBASE_* lub THIRD_PARTY_*).

Konwersje offline

Ostrzeżenie: od 15 czerwca 2026 r. żądania UploadClickConversion będą kończyć się niepowodzeniem, jeśli token dewelopera nie wysyłał wcześniej żądań przesyłania konwersji offline ani konwersji rozszerzonych dotyczących potencjalnych klientów. Zamiast tego używaj interfejsu Data Manager API. Więcej informacji znajdziesz w sekcji Wycofane funkcje.

Konwersje offline pomagają śledzić zdarzenia konwersji, które mają miejsce w świecie offline, np. w biurze, w 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ć 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 w obiekcie ConversionAction.

TagSnippet udostępnia kod śledzenia, który musi być uwzględniony w Twojej witrynie, aby śledzić działania powodujące konwersję. Konwersje Witryna i Kliknięcie numeru telefonu wymagają tagu event_snippet, który powinien być umieszczony 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ą funkcji 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

Uwaga: źródła WEBPAGE i WEBPAGE_ONCLICK są takie same jak w przypadku Witryny. Różnica polega na opcji Fragment kodu zdarzenia w interfejsie internetowym. WEBPAGE odpowiada opcji Wczytanie strony, a WEBPAGE_ONCLICK – opcji Kliknięcie. Więcej informacji znajdziesz w tym artykule w Centrum pomocy.

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 parametry interfejsu ConversionActionType API, których możesz użyć w przypadku 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ę.

Uwaga: jeśli określasz też pole category, ustaw je na DOWNLOAD tylko wtedy, gdy typ konwersji to GOOGLE_PLAY_DOWNLOAD.

Konwersje telefoniczne

Śledzenie konwersji telefonicznych umożliwia śledzenie połączeń z reklam, połączeń na numer telefonu podany w Twojej witrynie i kliknięć numerów w witrynach mobilnych.

W tabeli poniżej znajdziesz parametry interfejsu ConversionActionType API, których możesz użyć w przypadku 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_CALL działania powodującego konwersję określ 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ę AWEBSITE_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 tagów event_snippet i global_site_tag, aby pobrać dynamiczny numer Google do przekazywania połączeń na potrzeby śledzenia połączeń z numerami podanymi 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. 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

Ostrzeżenie: od 15 czerwca 2026 r. żądania UploadClickConversion będą kończyć się niepowodzeniem, jeśli token dewelopera nie wysyłał wcześniej żądań przesyłania konwersji offline ani konwersji rozszerzonych dotyczących potencjalnych klientów. Zamiast tego używaj interfejsu Data Manager API. Więcej informacji znajdziesz w sekcji Wycofane funkcje.

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 pocztowy 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 zabraniać tworzenia i modyfikowania 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 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	Sposób przypisywania atrybucji do danej konwersji.
segments.sk_ad_network_fine_conversion_value	Wartość konwersji zgłoszona przez Apple. Tego segmentu nie można stosować do żadnych danych poza metrics.sk_ad_network_installs i metrics.sk_ad_network_total_conversions. Można go łączyć tylko z segmentami związanymi z datą. Jeśli Apple zgłosi wartość 0, zwracana jest wartość 0. W innych przypadkach nie jest zwracana żadna wartość. Sprawdź obecność pola, aby odróżnić te 2 przypadki.
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 nieobejmującej urządzeń z 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 żadnych wywołaniach zwrotnych wysłanych przez Apple nie występowała ani domena źródłowa, ani aplikacja źródłowa.
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 rozdzielone na wartości konwersji. Ten segment reprezentuje sumę obserwowanych wartości konwersji precyzyjnych zwracanych przez Apple i modelowanych wartości null od Google.
segments.sk_ad_network_version	Wersja interfejsu Store Kit Ad Network API na iOS, która została użyta.

Google Analytics

Konwersje z połączonej usługi w Google Analytics mają jedną z tych type wartości:

• Konwersja w usłudze w GA4:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_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 status z HIDDEN na ENABLED.
• Zmodyfikuj pola primary_for_goal i category, aby określić, jak ma wpływać na określanie stawek i raporty w Google Ads.
• zaktualizować name lub value_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 błęduMUTATE_NOT_ALLOWED. 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ń status elementu ConversionAction z HIDDEN na ENABLED za pomocą metody mutate elementu ConversionActionService. Aktualizowanie app_id nie jest obsługiwane w przypadku tych działań powodujących konwersję.

• 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

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_SALES
• STORE_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 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 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 ConversionAction.type ma wartość UNKNOWN. Interfejs API nie obsługuje zarządzania tymi działaniami powodującymi konwersję, ale zwraca je w raportach, aby zapewnić pełne wyniki kluczowych danych o konwersjach, takich jak metrics.conversions i metrics.conversions_value.