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, siedzibie firmy 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?

    • Czy to sprzedaż w sklepie stacjonarnym?

    • 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 lub UploadClickConversion 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?

    • Czy chcesz śledzić połączenia wywołane przez numer telefonu podany w Twojej witrynie?

  4. Konwersje z aplikacji mobilnych:

    • Czy śledzenie instalacji lub zakupów ze Sklepu Google Play jest wystarczające?

    • Czy śledzisz działania w aplikacji za pomocą Google Analytics (GA4) lub zewnętrznej analityki aplikacji?

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 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 stron i rejestracje.

Aby śledzić konwersje w witrynie, musisz utworzyć ConversionAction z ustawionym na WEBPAGE parametrem ConversionActionType i dodać do strony konwersji w witrynie fragment kodu zwany tagiem.

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 elementu ConversionAction.

TagSnippet udostępnia kod śledzenia, który musi być umieszczony w 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 stronie przesyłania formularza kontaktowego, oraz tagu global_site_tag, który 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 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 (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 odpowiedniki parametrów interfejsu APIConversionActionType, 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 innych firm, 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, 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 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 wyświetlane w interfejsie internetowym Google Ads jako konwersja Połączenia z witryny.

W odróżnieniu od AD_CALL ten moduł śledzący 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 numerów podanych w witrynie. Dodatkowo musisz skonfigurować komponent do połączeń i

połączyć ją 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 Twojej 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 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ą 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 innych niż 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 żadnym z postbacków 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 Użyta 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_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:

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ń wartość 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 generowania raportów.

  • 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 dostarczać pełne wyniki kluczowych danych o konwersjach, takich jak metrics.conversions i metrics.conversions_value.

Wstecz
Przegląd
Dalej
Pierwsze kroki z konwersjami