ConversionAction

Działanie powodujące konwersję.

Zapis JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Pola
resourceName

string

Stałe. Nazwa zasobu działania powodującego konwersję. Nazwy zasobów działań powodujących konwersję mają postać:

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

Stan tego działania powodującego konwersję na potrzeby gromadzenia zdarzeń konwersji.
type

enum (ConversionActionType)

Stałe. Typ tego działania powodującego konwersję.
origin

enum (ConversionOrigin)

Tylko dane wyjściowe. Źródło konwersji powiązane z tym działaniem powodującym konwersję.
category

enum (ConversionActionCategory)

Kategoria konwersji zgłoszonych dla tego działania powodującego konwersję.
valueSettings

object (ValueSettings)

Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.
countingType

enum (ConversionActionCountingType)

Jak zliczać zdarzenia konwersji w przypadku danego działania powodującego konwersję.
attributionModelSettings

object (AttributionModelSettings)

Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.
tagSnippets[]

object (TagSnippet)

Tylko dane wyjściowe. Fragmenty kodu służące do śledzenia konwersji.
mobileAppVendor

enum (MobileAppVendor)

Tylko dane wyjściowe. Dostawca aplikacji mobilnej dla działania powodującego konwersję w aplikacji.
firebaseSettings

object (FirebaseSettings)

Tylko dane wyjściowe. Ustawienia Firebase dla typów konwersji Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Tylko dane wyjściowe. Ustawienia analityki aplikacji przez firmy zewnętrzne w przypadku typów konwersji ze źródeł zewnętrznych.
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Tylko dane wyjściowe. Ustawienia Google Analytics 4 dla typów konwersji Google Analytics 4.
id

string (int64 format)

Tylko dane wyjściowe. Identyfikator działania powodującego konwersję.
name

string

Nazwa działania powodującego konwersję.

To pole jest wymagane i nie powinno być puste podczas tworzenia nowych działań powodujących konwersję.
primaryForGoal

boolean

Jeśli parametr primaryForGoal ma wartość false (fałsz), w przypadku działania powodującego konwersję nie można ustalać stawki w żadnej kampanii, niezależnie od celu konwersji klienta czy celu konwersji kampanii. Niestandardowe cele konwersji nie uwzględniają jednak ustawień primaryForGoal, więc jeśli w kampanii cel konwersji niestandardowy jest skonfigurowany z ustawieniem primaryForGoal = false działanie powodujące konwersję, za to działanie powodujące konwersję nadal można ustalać stawki. Jeśli nie zostanie ustawiony, zasada mainForGoal ma domyślnie wartość prawda. W wersji 9 parametr mainForGoal może mieć wartość „false” (fałsz) po utworzeniu za pomocą operacji „update”, ponieważ nie jest on zadeklarowany jako opcjonalny.
ownerCustomer

string

Tylko dane wyjściowe. Nazwa zasobu klienta właściciela działania powodującego konwersję lub wartość null, jeśli jest to działanie powodujące konwersję zdefiniowane przez system.
includeInConversionsMetric

boolean

Określa, czy to działanie powodujące konwersję ma być uwzględniane w danych „Konwersje”.
clickThroughLookbackWindowDays

string (int64 format)

Maksymalna liczba dni, jaka może upływać między interakcją (np. kliknięciem) a zdarzeniem konwersji.
viewThroughLookbackWindowDays

string (int64 format)

Maksymalna liczba dni, które mogą upłynąć od wyświetlenia do konwersji bez interakcji.
phoneCallDurationSeconds

string (int64 format)

Czas trwania połączenia telefonicznego (w sekundach), po którym powinna zostać zarejestrowana konwersja dla tego działania powodującego konwersję.

Wartość musi mieścić się w zakresie od 0 do 10 000 włącznie.
appId

string

Identyfikator aplikacji działania powodującego konwersję z aplikacji.

ConversionActionStatus

Możliwe stany działania powodującego konwersję.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ENABLED Konwersje będą rejestrowane.
REMOVED Konwersje nie będą rejestrowane.
HIDDEN Konwersje nie będą rejestrowane, a działanie powodujące konwersję nie będzie widoczne w interfejsie.

ConversionActionType

Możliwe typy działania powodującego konwersję.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AD_CALL Konwersje, które mają miejsce, gdy użytkownik kliknie rozszerzenie połączeń w reklamie.
CLICK_TO_CALL Konwersje, które mają miejsce, gdy użytkownik kliknie numer telefonu na urządzeniu mobilnym.
GOOGLE_PLAY_DOWNLOAD Konwersje, które mają miejsce, gdy użytkownik pobierze aplikację mobilną ze Sklepu Google Play.
GOOGLE_PLAY_IN_APP_PURCHASE Konwersje, które mają miejsce, gdy użytkownik dokonuje zakupu w aplikacji, korzystając z płatności na Androidzie.
UPLOAD_CALLS Konwersje telefoniczne śledzone przez reklamodawcę i przesyłane.
UPLOAD_CLICKS Konwersje śledzone przez reklamodawcę i przesyłane z przypisanymi kliknięciami.
WEBPAGE Konwersje na stronie internetowej.
WEBSITE_CALL Konwersje, które mają miejsce, gdy użytkownik zadzwoni pod dynamicznie generowany numer telefonu z witryny reklamodawcy.
STORE_SALES_DIRECT_UPLOAD Konwersje polegające na sprzedaży w sklepie stacjonarnym obliczane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych. Z typów przesyłania bezpośredniego sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych.
STORE_SALES Konwersje polegające na sprzedaży w sklepie są określane na podstawie przesłanych danych własnych lub pochodzących od sprzedawców zewnętrznych lub zakupów w sklepie przy użyciu kart z sieci płatniczych. Z typów sprzedaży w sklepie mogą korzystać tylko klienci z listy dozwolonych. Tylko do odczytu.
FIREBASE_ANDROID_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone przez Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na Androida w aplikacji śledzone przez Firebase.
FIREBASE_ANDROID_CUSTOM Niestandardowe konwersje aplikacji na Androida śledzone przez Firebase.
FIREBASE_IOS_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone przez Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Konwersje polegające na zakupie w aplikacji na iOS śledzone przez Firebase.
FIREBASE_IOS_CUSTOM Niestandardowe konwersje aplikacji na iOS śledzone przez Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na Androida śledzone za pomocą analityki aplikacji przez firmy zewnętrzne
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na Androida śledzone w ramach analityki aplikacji innych firm
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Konwersje niestandardowe w aplikacjach na Androida śledzone za pomocą analityki aplikacji firmy zewnętrznej
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone za pomocą analityki aplikacji firm zewnętrznych
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na iOS śledzone za pomocą analityki aplikacji firmy zewnętrznej
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Niestandardowe konwersje w aplikacji na iOS śledzone za pomocą analityki aplikacji innych firm
ANDROID_APP_PRE_REGISTRATION Konwersje, które mają miejsce, gdy użytkownik wstępnie zarejestruje aplikację mobilną ze Sklepu Google Play. Tylko do odczytu.
ANDROID_INSTALLS_ALL_OTHER_APPS Konwersje, które śledzą wszystkie pobrania z Google Play, które nie są śledzone przez typ aplikacji. Tylko do odczytu.
FLOODLIGHT_ACTION Aktywność Floodlight zliczająca wizyty na określonej stronie internetowej po zobaczeniu lub kliknięciu jednej z reklam reklamodawcy. Tylko do odczytu.
FLOODLIGHT_TRANSACTION Aktywność Floodlight śledząca liczbę zrealizowanych transakcji sprzedaży lub liczbę kupionych produktów. Może też rejestrować łączną wartość każdej sprzedaży. Tylko do odczytu.
GOOGLE_HOSTED Konwersje, które śledzą działania lokalne produktów i usług Google po interakcji z reklamą. Tylko do odczytu.
LEAD_FORM_SUBMIT Konwersje są rejestrowane, gdy użytkownik przesyła formularz kontaktowy. Tylko do odczytu.
SALESFORCE Konwersje pochodzące z Salesforce. Tylko do odczytu.
SEARCH_ADS_360 Konwersje zaimportowane z danych Floodlight w Search Ads 360. Tylko do odczytu.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL konwersje telefoniczne, które są realizowane w reklamach w kampanii inteligentnej, jeśli nie skonfigurowano śledzenia połączeń telefonicznych, a które są określane przy użyciu kryteriów niestandardowych w kampanii inteligentnej. Tylko do odczytu.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Użytkownik klika element połączenia w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu.
SMART_CAMPAIGN_MAP_DIRECTIONS Użytkownik prosi o wskazówki dojazdu do lokalizacji firmy w Mapach Google. Tylko kampania inteligentna. Tylko do odczytu.
SMART_CAMPAIGN_TRACKED_CALLS Konwersje telefoniczne uzyskiwane w reklamach w kampanii inteligentnej z ustawionymi śledzeniem połączeń i ustawionymi kryteriami niestandardowymi w kampanii inteligentnej. Tylko do odczytu.
STORE_VISITS Konwersje, które mają miejsce, gdy użytkownik odwiedza sklep stacjonarny reklamodawcy. Tylko do odczytu.
WEBPAGE_CODELESS Konwersje utworzone na podstawie zdarzeń w witrynie (np. przesłania formularza lub wczytania strony), które nie korzystają z indywidualnie kodowanych fragmentów kodu zdarzenia. Tylko do odczytu.
UNIVERSAL_ANALYTICS_GOAL Konwersje, które pochodzą z połączonych celów Universal Analytics.
UNIVERSAL_ANALYTICS_TRANSACTION Konwersje, które pochodzą z połączonych transakcji Universal Analytics.
GOOGLE_ANALYTICS_4_CUSTOM Konwersje, które pochodzą z połączonych konwersji zdarzeń niestandardowych Google Analytics 4.
GOOGLE_ANALYTICS_4_PURCHASE Konwersje, które pochodzą z połączonych konwersji polegających na zakupie w Google Analytics 4.

ValueSettings

Ustawienia związane z wartością zdarzeń konwersji powiązanych z tym działaniem powodującym konwersję.

Zapis JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Pola
defaultValue

number

Wartość do użycia, gdy zdarzenia konwersji dla tego działania powodującego konwersję są wysyłane z nieprawidłową, niedozwoloną lub brakującą wartością albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używać wartości domyślnej.
defaultCurrencyCode

string

Kod waluty używany, gdy zdarzenia konwersji w ramach tego działania powodującego konwersję są wysyłane z nieprawidłowym lub brakującym kodem waluty albo gdy to działanie powodujące konwersję jest skonfigurowane tak, aby zawsze używać wartości domyślnej.
alwaysUseDefaultValue

boolean

Określa, czy zamiast kodu wartości i waluty określonych w zdarzeniach konwersji w przypadku tego działania powodującego konwersję używa się kodu wartości domyślnej i kodu waluty domyślnej.

ConversionActionCountingType

Wskazuje sposób zliczania konwersji w przypadku danego działania. Więcej informacji znajdziesz na stronie https://support.google.com/google-ads/answer/3438531.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
ONE_PER_CLICK Licz tylko jedną konwersję na kliknięcie.
MANY_PER_CLICK Zliczanie wszystkich konwersji na kliknięcie.

AttributionModelSettings

Ustawienia związane z modelem atrybucji tego działania powodującego konwersję.

Zapis JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Pola
attributionModel

enum (AttributionModel)

Typ modelu atrybucji w przypadku tego działania powodującego konwersję.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Tylko dane wyjściowe. Stan modelu atrybucji opartej na danych dla działania powodującego konwersję.

AttributionModel

Model atrybucji, który określa, jak przypisać udział w danej konwersji między potencjalnie wiele wcześniejszych interakcji.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
EXTERNAL Wykorzystuje zewnętrzną atrybucję.
GOOGLE_ADS_LAST_CLICK Przypisuje cały udział w konwersji ostatniemu kliknięciu.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Przypisuje cały udział w konwersji pierwszemu kliknięciu na podstawie atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Przypisuje jednakowy udział w konwersji wszystkim kliknięciom, korzystając z atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Na podstawie atrybucji w wyszukiwarce Google przypisuje zdecydowanie większy udział w konwersji ostatnim kliknięciom (okres półtrwania to tydzień).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Na jej podstawie 40% udziału w konwersji jest przypisywane pierwszemu i ostatniemu kliknięciu. Pozostałe 20% jest równomiernie rozkładane pomiędzy wszystkie pozostałe kliknięcia. Korzysta on z atrybucji w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Elastyczny model, który wykorzystuje systemy uczące się, aby określić odpowiedni rozkład udziału w kliknięciach za pomocą atrybucji w wyszukiwarce Google.

DataDrivenModelStatus

Wylicza stany modelu na podstawie danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Używana tylko w przypadku wartości zwracanej. Reprezentuje wartość nieznaną w tej wersji.
AVAILABLE Dostępny jest model oparty na danych.
STALE Model oparty na danych jest nieaktualny. Nie była aktualizowana od co najmniej 7 dni. Nadal jest używana, ale jeśli nie zostanie zaktualizowana w ciągu 30 dni, wygaśnie.
EXPIRED Model oparty na danych wygasł. Nie była aktualizowana od co najmniej 30 dni, więc nie można jej używać. Zwykle dzieje się tak, gdy w ciągu ostatnich 30 dni nie było wymaganej liczby zdarzeń.
NEVER_GENERATED Model oparty na danych nigdy nie został wygenerowany. Najczęściej dzieje się tak w żadnym 30-dniowym okresie.

FirebaseSettings

Ustawienia związane z działaniem powodującym konwersję Firebase.

Zapis JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Pola
propertyId

string (int64 format)

Tylko dane wyjściowe. Identyfikator usługi w Google Analytics, w której wystąpiła konwersja.
propertyName

string

Tylko dane wyjściowe. Nazwa usługi w Google Analytics, do której należy konwersja.
eventName

string

Tylko dane wyjściowe. Nazwa zdarzenia związanego z konwersją Firebase.
projectId

string

Tylko dane wyjściowe. Identyfikator projektu Firebase konwersji.

ThirdPartyAppAnalyticsSettings

Ustawienia związane z działaniem powodującym konwersję w ramach analityki aplikacji zapewnianej przez firmę zewnętrzną.

Zapis JSON 
{
  "providerName": string,
  "eventName": string
}
Pola
providerName

string

Tylko dane wyjściowe. Nazwa zewnętrznego dostawcy analityki aplikacji.
eventName

string

Tylko dane wyjściowe. Nazwa zdarzenia dotyczącego konwersji z zewnętrznej analityki aplikacji.

GoogleAnalytics4Settings

Ustawienia związane z działaniem powodującym konwersję Google Analytics 4.

Zapis JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Pola
eventName

string

Tylko dane wyjściowe. Nazwa zdarzenia GA4.
propertyName

string

Tylko dane wyjściowe. Nazwa usługi w GA4.
propertyId

string (int64 format)

Tylko dane wyjściowe. Identyfikator usługi w GA4.