Kategorie działań powodujących konwersję

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 powiązane z interfejsem Google Ads.

Konwersje offline

Konwersje offline pomagają śledzić zdarzenia konwersji, które mają miejsce w świecie offline, np. w biurze, adresie sklepu lub przez telefon.

W tabeli poniżej znajdziesz odpowiednie parametry interfejsu API ConversionActionType , których należy używać w przypadku poszczególnych źródeł w interfejsie Google Ads oraz link do dokumentacji każdego typu działania powodującego 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 Śledzenie konwersji telefonicznych Przewodnik po importowaniu konwersji telefonicznych
STORE_SALES Śledzenie konwersji polegających na sprzedaży w sklepie stacjonarnym Przewodnik po importowaniu konwersji polegających na sprzedaży w sklepie stacjonarnym

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 parametrem ConversionActionType ustawionym na WEBPAGE, i dodać do strony konwersji w witrynie fragment kodu nazywany tagiem.

The ConversionAction obejmuje kilka typów konwersji w witrynie, które są rozróżniane w interfejsie API za pomocą pola type w każdym TagSnippet wymienionym w polu tag_snippets ConversionAction.

TagSnippet zawiera kod śledzenia, który należy dodać do witryny, aby śledzić działania powodujące konwersję. Konwersje w witrynie i kliknięcia numeru telefonu wymagają użycia event_snippet, który należy umieścić na stronach internetowych wskazujących działanie powodujące konwersję, np. na stronie potwierdzenia zakupu lub na stronie przesłania formularza kontaktowego, oraz 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 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 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 odpowiednie parametry interfejsu API ConversionActionType , których należy używać w przypadku poszczególnych źródeł w interfejsie 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ę.

Konwersje telefoniczne

Śledzenie konwersji telefonicznych umożliwia śledzenie połączeń z reklam, połączeń na numer telefonu w 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 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 Google Ads jako konwersja Połączenia z reklam. Po utworzeniu działania powodującego konwersję AD_CALL 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. Domyślnie jest to 60 sekund.

WEBSITE_CALL

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

W przeciwieństwie do AD_CALL, ten moduł śledzący wymaga dodania do witryny event_snippet i global_site_tag, aby pobrać dynamiczny numer Google do przekazywania połączeń na numery podane 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 wyświetlane w interfejsie Google Ads jako konwersja Kliknięcia numeru w witrynie mobilnej.

Typ CLICK_TO_CALL różni się od AD_CALL typu tym, że nie śledzi rzeczywistych połączeń telefonicznych. Zamiast tego CLICK_TO_CALL śledzi tylko kliknięcia numeru telefonu z urządzenia mobilnego. 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ż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.
Korzystanie z interfejsu Data Manager 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 zabraniać tworzenia bądź 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 do Google na poziomie Customer i Campaign za pomocą tych zasobów:

Pole raportu Opis
metrics.sk_ad_network_installs Liczba instalacji zgłoszonych przez Apple. Ten rodzaj danych można dzielić na segmenty tylko według dowolnej kombinacji 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 zgłoszonych przez Apple. Ten rodzaj danych 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 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, 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 przeciwnym razie nie jest zwracana żadna wartość. Aby odróżnić te 2 przypadki, sprawdź obecność pola .

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 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 wyświetliła się.
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 innej niż na iOS) lub nie był obecny w żadnych zwrotnych wywołaniach 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 innej niż na iOS) lub że w żadnych zwrotnych wywołaniach wysłanych przez Apple nie było ani 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 przedstawia sumę obserwowanych wartości konwersji zwróconych przez Apple i modelowanych wartości null z Google.
segments.sk_ad_network_version Wersja interfejsu iOS Store Kit Ad Network API, 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 usługi 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 usługi w GA4 możesz wprowadzić te zmiany:

  • Zaimportuj konwersję z usługi w GA4 na konto Google Ads, zmieniając wartość pola status z HIDDEN na ENABLED.
  • Zmień wartości pól primary_for_goal i category, aby wskazać, jak ma to wpływać na ustalanie stawek i raporty w Google Ads.
  • Zaktualizuj wartości pól 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 powoduje błąd MUTATE_NOT_ALLOWED. Te zmiany możesz wprowadzać tylko w interfejsie Google Ads.

Firebase i analityka aplikacji innej firmy

Aby zaimportować konwersje z analityki aplikacji innej firmy lub Firebase, zmień wartość pola status w ConversionAction z HIDDEN na ENABLED za pomocą metody mutate w ConversionActionService. W przypadku tych działań powodujących konwersję aktualizowanie pola app_id nie jest obsługiwane.

  • 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 stacjonarnym: importowanie do działania powodującego konwersję z raportowaniem

Chociaż nie możesz tworzyć STORE_SALES ani STORE_SALES_DIRECT_UPLOAD działań powodujących konwersję za pomocą interfejsu Google Ads API, interfejs API obsługuje importowanie transakcji sprzedaży w sklepie stacjonarnym.

  • STORE_SALES
  • STORE_SALES_DIRECT_UPLOAD

Typy działań powodujących konwersję tylko do odczytu

Te typy działań powodujących konwersję są w interfejsie Google Ads API tylko do odczytu i są udostępniane na potrzeby 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 typy działań powodujących konwersję, możesz zauważyć że zapytania i raporty zwracają 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 w przypadku kluczowych danych o konwersjach, takich jak metrics.conversions i metrics.conversions_value.