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:
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_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 usługi w GA4 możesz wprowadzić te zmiany:
- Zaimportuj konwersję z usługi w GA4 na konto Google Ads, zmieniając wartość pola
statuszHIDDENnaENABLED. - Zmień wartości pól
primary_for_goalicategory, aby wskazać, jak ma to wpływać na ustalanie stawek i raporty w Google Ads. - Zaktualizuj wartości pól
namelubvalue_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_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_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 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_SALESSTORE_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_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 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.