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

Niezmienne. 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)

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

enum (ConversionOrigin)

Tylko dane wyjściowe. Źródło konwersji tego działania powodującego 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 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 dla typów konwersji innych firm.
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 mainForGoal działania powodującego konwersję ma wartość Fałsz, w przypadku działania powodującego konwersję nie można ustalać stawki w żadnych kampaniach, niezależnie od celu konwersji klienta czy celu konwersji kampanii. Niestandardowe cele konwersji nie uwzględniają jednak ustawień mainForGoal, więc jeśli w kampanii masz niestandardowy cel konwersji skonfigurowany z ustawieniem primaryForGoal = false działanie powodujące konwersję, to działanie powodujące konwersję nadal można ustalać stawki. Jeśli nie zostanie ustawiony, zasada mainForGoal ma domyślnie wartość true (prawda). W wersji 9 właściwość primaryForGoal można ustawić na wartość false tylko po utworzeniu za pomocą operacji „update”, ponieważ nie jest ona zadeklarowana jako opcjonalna.
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ę powinno być uwzględniane w danych „Konwersje”.
clickThroughLookbackWindowDays

string (int64 format)

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

string (int64 format)

Maksymalna liczba dni, która może upłynąć między wyświetleniem a konwersją bez interakcji.
phoneCallDurationSeconds

string (int64 format)

Czas trwania połączenia telefonicznego w sekundach, po którym należy rejestrować konwersję w przypadku 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ę w aplikacji.

ConversionActionStatus

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

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. 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 Służy tylko do zwracania wartości. 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, do których dochodzi, 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 za pomocą płatności na Androida.
UPLOAD_CALLS Konwersje telefoniczne śledzone przez reklamodawcę i przesyłane
UPLOAD_CLICKS Konwersje, które są śledzone przez reklamodawcę i przesyłane z przypisanymi kliknięciami.
WEBPAGE Konwersje występujące na stronie internetowej.
WEBSITE_CALL Konwersje, do których dochodzi, gdy użytkownik zadzwoni pod dynamicznie wygenerowany numer telefonu z witryny reklamodawcy.
STORE_SALES_DIRECT_UPLOAD Konwersje polegające na sprzedaży w sklepie stacjonarnym dokonywane na podstawie przesłanych danych własnych sprzedawców lub innej firmy. Tylko klienci z listy dozwolonych mogą korzystać z typów przesyłania bezpośredniego typu „Sprzedaż w sklepie”.
STORE_SALES Konwersje polegające na sprzedaży w sklepie stacjonarnym oparte na przesłanych danych własnych lub danych sprzedawców zewnętrznych lub zakupach w sklepie z wykorzystaniem kart pochodzących z sieci płatności. 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 w aplikacji na Androida ś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 firmy zewnętrznej
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Niestandardowe konwersje aplikacji na Androida śledzone za pomocą analityki aplikacji przez firmy zewnętrzne
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Konwersje polegające na pierwszym uruchomieniu aplikacji na iOS śledzone za pomocą analityki aplikacji przez firmy zewnętrzne
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Konwersje polegające na zakupie aplikacji na iOS w aplikacji ś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 przez firmy zewnętrzne
ANDROID_APP_PRE_REGISTRATION Konwersje, które mają miejsce, gdy użytkownik wstępnie zarejestruje aplikację mobilną w Sklepie 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 konkretnej stronie internetowej po obejrzeniu lub kliknięciu jednej z reklam reklamodawcy. Tylko do odczytu.
FLOODLIGHT_TRANSACTION Aktywność Floodlight, która śledzi 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 pochodzące z produktów i usług Google po interakcji z reklamą. Tylko do odczytu.
LEAD_FORM_SUBMIT Konwersje są rejestrowane po przesłaniu przez użytkownika formularza kontaktowego. 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 mają miejsce w reklamach w kampanii inteligentnej bez skonfigurowanego śledzenia połączeń, z wykorzystaniem kryteriów niestandardowych w kampanii inteligentnej. Tylko do odczytu.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL Użytkownik klika w Mapach Google element umożliwiający połączenie. 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, do których dochodzi w reklamach w kampanii inteligentnej, z konfiguracją śledzenia połączeń telefonicznych i wykorzystaniem kryteriów niestandardowych w kampanii inteligentnej. Tylko do odczytu.
STORE_VISITS Konwersje, które mają miejsce, gdy użytkownik odwiedza sklep reklamodawcy. Tylko do odczytu.
WEBPAGE_CODELESS Konwersje tworzone na podstawie zdarzeń w witrynie (np. przesłania formularzy lub wczytania strony), które nie korzystają z pojedynczo zakodowanego fragmentu 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ść używana, gdy zdarzenia konwersji powiązane z tym działaniem powodującym 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 powiązane z tym działaniem powodującym 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 wartości i kodu waluty określonych w zdarzeniach konwersji w przypadku tego działania powodującego konwersję ma być używana wartość domyślna i kod waluty domyślnej.

ConversionActionCountingType

Wskazuje sposób zliczania konwersji dla 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 Służy tylko do zwracania wartości. 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 tego działania powodującego konwersję.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Tylko dane wyjściowe. Stan modelu atrybucji opartej na danych w działaniu powodującym konwersję.

AttributionModel

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

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. 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 jednakowo 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 ostatniemu kliknięciu (okres półtrwania to tydzień).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Przypisuje 40% udziału w konwersji pierwszemu i ostatniemu kliknięciu. Pozostałe 20% jest równomiernie rozkładane pomiędzy wszystkie pozostałe kliknięcia. Wykorzystuje ono atrybucję w wyszukiwarce Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Elastyczny model, który wykorzystuje systemy uczące się, aby określać odpowiedni udział kliknięć w konwersji za pomocą atrybucji w wyszukiwarce Google.

DataDrivenModelStatus

Wylicza stany modeli na podstawie danych.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Służy tylko do zwracania wartości. Reprezentuje wartość nieznaną w tej wersji.
AVAILABLE Dostępny jest model oparty na danych.
STALE Model na podstawie danych jest nieaktualny. Nie była aktualizowana od co najmniej 7 dni. Adres jest nadal używany, ale utraci ważność, jeśli nie zostanie zaktualizowany w ciągu 30 dni.
EXPIRED Model oparty na danych wygasł. Nie była aktualizowana od co najmniej 30 dni i nie można jej używać. Dzieje się tak najczęściej dlatego, że w ciągu ostatnich 30 dni nie została osiągnięta wymagana liczba zdarzeń.
NEVER_GENERATED Model oparty na danych nigdy nie został wygenerowany. Dzieje się tak najczęściej dlatego, że w żadnym 30-dniowym okresie nigdy nie została osiągnięta wymagana liczba zdarzeń.

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, której dotyczy konwersja.
propertyName

string

Tylko dane wyjściowe. Nazwa usługi w Google Analytics dla konwersji.
eventName

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji 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 zewnętrzną firmę.

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 konwersji w ramach 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.