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.

Konwersje offline

Konwersje offline pomagają śledzić zdarzenia konwersji, które mają miejsce w świecie offline, np. w biurze, siedzibie firmy 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 Przewodnik po zarządzaniu konwersjami po kliknięciu offline
Przewodnik po konwersjach rozszerzonych dotyczących potencjalnych klientów
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ć działanie powodujące konwersję typu 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 elementu ConversionAction.

TagSnippet udostępnia kod śledzenia, który musi zostać umieszczony w Twojej 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 z potwierdzeniem płatności lub na stronie z przesłanym formularzem kontaktowym, oraz tagu global_site_tag, który musi być zainstalowany na każdej stronie witryny. Oba te atrybuty możesz pobrać za pomocą ConversionActionService. Więcej informacji o tym, jak tagować strony, 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

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 odpowiedniki parametrów interfejsu APIConversionActionType 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 aplikacjach mobilnych 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 telefonu w Twojej witrynie i kliknięć numerów w witrynach mobilnych.

W tabeli poniżej znajdziesz odpowiedniki parametrów interfejsu APIConversionActionType 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 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 wywoływania 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

Działanie powodujące konwersję WEBSITE_CALL jest wyświetlane w interfejsie internetowym Google Ads jako konwersja Połączenia z witryny.

W przeciwieństwie do AD_CALL ten tag śledzenia wymaga dodania do witryny elementó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. 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ększać 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 rozszerzonej 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. 		Przewodnik po konfiguracji interfejsu 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ń.

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 do 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 Jak przypisywany jest udział w konkretnej 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, metrics.sk_ad_network_total_conversions i . 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ść. Aby odróżnić te 2 przypadki, sprawdź, czy występuje pole .
segments.sk_ad_network_coarse_conversion_value Przybliżona wartość pojedynczej konwersji.
segments.sk_ad_network_postback_sequence_index Pozycja postbacku 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 nie 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 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 o wysokiej precyzji 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 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 polagoogle_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 MUTATE_NOT_ALLOWEDbłędu. Możesz wprowadzać te zmiany tylko w interfejsie Google Ads.

Firebase i analityka aplikacji przez firmy zewnętrzne

Aby importować konwersje z analityki aplikacji innej firmy lub Firebase, zmień wartość status w ConversionAction z HIDDEN na ENABLED za pomocą metody mutate w ConversionActionService. Aktualizowanie parametru 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 typy działań powodujących konwersję, zapytania i raporty mogą zwracać działania powodujące konwersję, w których wartość ConversionAction.type to 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