Attenzione: stai visualizzando la documentazione per l'interfaccia REST dell'API. La maggior parte delle nostre librerie client ufficiali utilizza gRPC. Per informazioni dettagliate, consulta la Introduzione a REST.

Questa pagina è stata tradotta dall'API Cloud Translation.

ConversionAction

Rappresentazione JSON
ConversionActionStatus
ConversionActionType
ValueSettings
- Rappresentazione JSON
ConversionActionCountingType
AttributionModelSettings
- Rappresentazione JSON
AttributionModel
DataDrivenModelStatus
FirebaseSettings
- Rappresentazione JSON
ThirdPartyAppAnalyticsSettings
- Rappresentazione JSON
GoogleAnalytics4Settings
- Rappresentazione JSON

Un'azione di conversione.

Rappresentazione JSON

Rappresentazione 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 }

{
  "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
}

Campi
`resourceName`	`string` Immutabile. Il nome della risorsa dell'azione di conversione. I nomi delle risorse delle azioni di conversione hanno il seguente formato: `customers/{customerId}/conversionActions/{conversion_action_id}`
`status`	`enum (ConversionActionStatus)` Lo stato di questa azione di conversione per l'accumulo degli eventi di conversione.
`type`	`enum (ConversionActionType)` Immutabile. Il tipo di questa azione di conversione.
`origin`	`enum (ConversionOrigin)` Solo output. L'origine della conversione di questa azione di conversione.
`category`	`enum (ConversionActionCategory)` La categoria delle conversioni registrate per questa azione di conversione.
`valueSettings`	`object (ValueSettings)` Impostazioni correlate al valore degli eventi di conversione associati a questa azione di conversione.
`countingType`	`enum (ConversionActionCountingType)` Come conteggiare gli eventi di conversione per l'azione di conversione.
`attributionModelSettings`	`object (AttributionModelSettings)` Impostazioni relative al modello di attribuzione di questa azione di conversione.
`tagSnippets[]`	`object (TagSnippet)` Solo output. Gli snippet utilizzati per monitorare le conversioni.
`mobileAppVendor`	`enum (MobileAppVendor)` Solo output. Fornitore di app mobile per un'azione di conversione da app.
`firebaseSettings`	`object (FirebaseSettings)` Solo output. Impostazioni di Firebase per i tipi di conversione Firebase.
`thirdPartyAppAnalyticsSettings`	`object (ThirdPartyAppAnalyticsSettings)` Solo output. Impostazioni di Analytics per app di terze parti per i tipi di conversione di terze parti.
`googleAnalytics4Settings`	`object (GoogleAnalytics4Settings)` Solo output. Impostazioni di Google Analytics 4 per i tipi di conversione di Google Analytics 4.
`id`	`string (int64 format)` Solo output. L'ID dell'azione di conversione.
`name`	`string` Il nome dell'azione di conversione. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove azioni di conversione.
`primaryForGoal`	`boolean` Se il bit mainForGoal di un'azione di conversione è false, l'azione di conversione non è disponibile per tutte le campagne, indipendentemente dall'obiettivo di conversione del cliente o dall'obiettivo di conversione della campagna. Tuttavia, gli obiettivi di conversione personalizzati non rispettano mainForGoal, quindi se una campagna ha un obiettivo di conversione personalizzato configurato con un'azione di conversione mainForGoal = false, quell'azione di conversione è ancora disponibile. Per impostazione predefinita, il valore di mainForGoal è true se non è impostato. Nella versione V9, il valore mainForGoal può essere impostato su false solo dopo la creazione tramite un'operazione di aggiornamento perché non è stato dichiarato come facoltativo.
`ownerCustomer`	`string` Solo output. Il nome della risorsa del cliente del proprietario dell'azione di conversione oppure null se si tratta di un'azione di conversione definita dal sistema.
`includeInConversionsMetric`	`boolean` Indica se questa azione di conversione deve essere inclusa nella metrica "conversioni".
`clickThroughLookbackWindowDays`	`string (int64 format)` Il numero massimo di giorni che possono trascorrere tra un'interazione, ad esempio un clic, e un evento di conversione.
`viewThroughLookbackWindowDays`	`string (int64 format)` Il numero massimo di giorni che possono trascorrere tra un'impressione e una conversione senza un'interazione.
`phoneCallDurationSeconds`	`string (int64 format)` La durata della chiamata in secondi dopo la quale deve essere registrata una conversione per questa azione di conversione. Il valore deve essere compreso tra 0 e 10.000 inclusi.
`appId`	`string` ID app per un'azione di conversione da app.

ConversionActionStatus

Possibili stati di un'azione di conversione.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`ENABLED`	Le conversioni verranno registrate.
`REMOVED`	Le conversioni non verranno registrate.
`HIDDEN`	Le conversioni non verranno registrate e l'azione di conversione non verrà visualizzata nell'interfaccia utente.

ConversionActionType

Possibili tipi di azione di conversione.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`AD_CALL`	Conversioni che si verificano quando un utente fa clic sull'estensione di chiamata di un annuncio.
`CLICK_TO_CALL`	Conversioni che si verificano quando un utente fa clic su un numero di telefono da un dispositivo mobile.
`GOOGLE_PLAY_DOWNLOAD`	Conversioni che si verificano quando un utente scarica un'app mobile dal Google Play Store.
`GOOGLE_PLAY_IN_APP_PURCHASE`	Conversioni che si verificano quando un utente effettua un acquisto in un'app tramite fatturazione di Android.
`UPLOAD_CALLS`	Conversioni di chiamata monitorate dall'inserzionista e caricate.
`UPLOAD_CLICKS`	Conversioni monitorate dall'inserzionista e caricate con i clic attribuiti.
`WEBPAGE`	Conversioni che si verificano su una pagina web.
`WEBSITE_CALL`	Conversioni che si verificano quando un utente chiama un numero di telefono generato dinamicamente dal sito web di un inserzionista.
`STORE_SALES_DIRECT_UPLOAD`	Conversione per le vendite in negozio basata sui caricamenti di dati dei commercianti proprietari o di terze parti. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di caricamento diretto per le vendite in negozio.
`STORE_SALES`	Conversione delle vendite in negozio basata sui caricamenti di dati dei commercianti proprietari o di terze parti e/o sugli acquisti in negozio utilizzando le carte delle reti di pagamento. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di vendite in negozio. Sola lettura.
`FIREBASE_ANDROID_FIRST_OPEN`	Conversioni prima apertura di app per Android monitorate tramite Firebase.
`FIREBASE_ANDROID_IN_APP_PURCHASE`	Conversioni di acquisto in-app di app per Android monitorate tramite Firebase.
`FIREBASE_ANDROID_CUSTOM`	Conversioni personalizzate delle app per Android monitorate tramite Firebase.
`FIREBASE_IOS_FIRST_OPEN`	Conversioni prima apertura di app per iOS monitorate tramite Firebase.
`FIREBASE_IOS_IN_APP_PURCHASE`	Conversioni di acquisto in-app per app per iOS monitorate tramite Firebase.
`FIREBASE_IOS_CUSTOM`	Conversioni personalizzate delle app per iOS monitorate tramite Firebase.
`THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN`	Conversioni prima apertura dell'app per Android monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE`	Conversioni di acquisto in-app di app per Android monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM`	Conversioni personalizzate delle app per Android monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN`	Conversioni prima apertura di app per iOS monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE`	Conversioni di acquisto in app per iOS monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM`	Conversioni personalizzate di app per iOS monitorate tramite Analytics per app di terze parti.
`ANDROID_APP_PRE_REGISTRATION`	Conversioni che si verificano quando un utente effettua la preregistrazione di un'app mobile dal Google Play Store. Sola lettura.
`ANDROID_INSTALLS_ALL_OTHER_APPS`	Conversioni che monitorano tutti i download da Google Play che non vengono monitorati da un tipo specifico di app. Sola lettura.
`FLOODLIGHT_ACTION`	Attività Floodlight che conteggia il numero di volte in cui gli utenti hanno visitato una determinata pagina web dopo aver visualizzato o fatto clic su uno degli annunci di un inserzionista. Sola lettura.
`FLOODLIGHT_TRANSACTION`	Attività Floodlight che monitora il numero di vendite effettuate o il numero di articoli acquistati. Consente anche di acquisire il valore totale di ogni vendita. Sola lettura.
`GOOGLE_HOSTED`	Conversioni che monitorano le azioni locali relative a prodotti e servizi Google dopo l'interazione con un annuncio. Sola lettura.
`LEAD_FORM_SUBMIT`	Conversioni registrate quando un utente invia un modulo per i lead. Sola lettura.
`SALESFORCE`	Le conversioni provenienti da Salesforce. Sola lettura.
`SEARCH_ADS_360`	Conversioni importate dai dati Floodlight di Search Ads 360. Sola lettura.
`SMART_CAMPAIGN_AD_CLICKS_TO_CALL`	Conversioni di chiamata che si verificano negli annunci della campagna intelligente senza configurazione del monitoraggio delle chiamate utilizzando i criteri personalizzati della campagna intelligente. Sola lettura.
`SMART_CAMPAIGN_MAP_CLICKS_TO_CALL`	L'utente fa clic su un elemento di chiamata in Google Maps. Solo campagna intelligente. Sola lettura.
`SMART_CAMPAIGN_MAP_DIRECTIONS`	L'utente richiede indicazioni stradali per raggiungere la sede di un'attività in Google Maps. Solo campagna intelligente. Sola lettura.
`SMART_CAMPAIGN_TRACKED_CALLS`	Conversioni di chiamata che si verificano negli annunci delle campagne intelligenti con monitoraggio delle chiamate configurato utilizzando i criteri personalizzati delle campagne intelligenti. Sola lettura.
`STORE_VISITS`	Conversioni che si verificano quando un utente visita il negozio di vendita al dettaglio di un inserzionista. Sola lettura.
`WEBPAGE_CODELESS`	Conversioni create da eventi del sito web, ad esempio invii di moduli o caricamenti di pagine, che non utilizzano snippet evento codificati singolarmente. Sola lettura.
`UNIVERSAL_ANALYTICS_GOAL`	Conversioni provenienti da obiettivi Universal Analytics collegati.
`UNIVERSAL_ANALYTICS_TRANSACTION`	Conversioni provenienti da transazioni Universal Analytics collegate.
`GOOGLE_ANALYTICS_4_CUSTOM`	Conversioni provenienti da conversioni di eventi personalizzati Google Analytics 4 collegate.
`GOOGLE_ANALYTICS_4_PURCHASE`	Conversioni provenienti dalle conversioni di acquisto di Google Analytics 4 collegate.

ValueSettings

Impostazioni correlate al valore degli eventi di conversione associati a questa azione di conversione.

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

Campi

Campi
`defaultValue`	`number` Il valore da utilizzare quando gli eventi di conversione per questa azione di conversione vengono inviati con un valore non valido, non consentito o mancante oppure quando l'azione di conversione è configurata per utilizzare sempre il valore predefinito.
`defaultCurrencyCode`	`string` Il codice valuta da utilizzare quando gli eventi di conversione per questa azione di conversione vengono inviati con un codice valuta non valido o mancante oppure quando l'azione di conversione è configurata per utilizzare sempre il valore predefinito.
`alwaysUseDefaultValue`	`boolean` Consente di stabilire se utilizzare il valore predefinito e il codice valuta predefinito al posto del valore e del codice valuta specificati negli eventi di conversione per questa azione di conversione.

defaultValue

number

Il valore da utilizzare quando gli eventi di conversione per questa azione di conversione vengono inviati con un valore non valido, non consentito o mancante oppure quando l'azione di conversione è configurata per utilizzare sempre il valore predefinito.

defaultCurrencyCode

string

Il codice valuta da utilizzare quando gli eventi di conversione per questa azione di conversione vengono inviati con un codice valuta non valido o mancante oppure quando l'azione di conversione è configurata per utilizzare sempre il valore predefinito.

alwaysUseDefaultValue

boolean

Consente di stabilire se utilizzare il valore predefinito e il codice valuta predefinito al posto del valore e del codice valuta specificati negli eventi di conversione per questa azione di conversione.

ConversionActionCountingType

Indica come verranno conteggiate le conversioni per questa azione. Per ulteriori informazioni, consulta la pagina https://support.google.com/google-ads/answer/3438531.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`ONE_PER_CLICK`	Conteggia una sola conversione per clic.
`MANY_PER_CLICK`	Conteggia tutte le conversioni per clic.

AttributionModelSettings

Impostazioni relative al modello di attribuzione di questa azione di conversione.

Rappresentazione JSON
{ "attributionModel": enum (`AttributionModel`), "dataDrivenModelStatus": enum (`DataDrivenModelStatus`) }

Campi

Campi
`attributionModel`	`enum (AttributionModel)` Il tipo di modello di attribuzione di questa azione di conversione.
`dataDrivenModelStatus`	`enum (DataDrivenModelStatus)` Solo output. Lo stato del modello di attribuzione basata sui dati per l'azione di conversione.

attributionModel

enum (AttributionModel)

Il tipo di modello di attribuzione di questa azione di conversione.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

Solo output. Lo stato del modello di attribuzione basata sui dati per l'azione di conversione.

AttributionModel

Il modello di attribuzione che descrive come distribuire il merito per una determinata conversione tra potenzialmente molte interazioni precedenti.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`EXTERNAL`	Utilizza l'attribuzione esterna.
`GOOGLE_ADS_LAST_CLICK`	Attribuisce tutto il merito di una conversione all'ultimo clic.
`GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK`	Attribuisce tutto il merito di una conversione al primo clic utilizzando l'attribuzione della rete di ricerca di Google.
`GOOGLE_SEARCH_ATTRIBUTION_LINEAR`	Attribuisce equamente il merito di una conversione a tutti i clic utilizzando l'attribuzione della rete di ricerca di Google.
`GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY`	Attribuisce un merito esponenzialmente più elevato ai clic più recenti per una conversione utilizzando l'attribuzione della rete di ricerca di Google (il tempo di dimezzamento è di 1 settimana).
`GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED`	Attribuisce il 40% del merito di una conversione ai primi e agli ultimi clic. Il restante 20% viene distribuito uniformemente tra tutti gli altri clic. Viene utilizzata l'attribuzione della Ricerca Google.
`GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN`	Modello flessibile che utilizza il machine learning per determinare la distribuzione appropriata del merito tra i clic utilizzando l'attribuzione della Ricerca Google.

DataDrivenModelStatus

Enumera gli stati dei modelli basati sui dati.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`AVAILABLE`	È disponibile il modello basato sui dati.
`STALE`	Il modello basato sui dati è inattivo. Non viene aggiornato da almeno 7 giorni. È ancora in uso, ma scadrà se non viene aggiornato per 30 giorni.
`EXPIRED`	Il modello basato sui dati è scaduto. Non viene aggiornato da almeno 30 giorni e non può essere utilizzato. In genere questo accade perché negli ultimi 30 giorni non è stato effettuato il numero di eventi richiesto.
`NEVER_GENERATED`	Il modello basato sui dati non è mai stato generato. Più comunemente, questo accade perché non è mai stato registrato il numero richiesto di eventi in un periodo di 30 giorni.

FirebaseSettings

Impostazioni correlate a un'azione di conversione Firebase.

Rappresentazione JSON
{ "propertyId": string, "propertyName": string, "eventName": string, "projectId": string }

Campi
`propertyId`	`string (int64 format)` Solo output. L'ID proprietà GA della conversione.
`propertyName`	`string` Solo output. Il nome della proprietà GA della conversione.
`eventName`	`string` Solo output. Il nome dell'evento di una conversione Firebase.
`projectId`	`string` Solo output. L'ID progetto Firebase della conversione.

ThirdPartyAppAnalyticsSettings

Impostazioni correlate a un'azione di conversione dell'analisi dell'app di terze parti.

Rappresentazione JSON
{ "providerName": string, "eventName": string }

Campi

Campi
`providerName`	`string` Solo output. Nome del provider di analisi dati delle app di terze parti.
`eventName`	`string` Solo output. Il nome dell'evento di una conversione dell'analisi dell'app di terze parti.

providerName

string

Solo output. Nome del provider di analisi dati delle app di terze parti.

eventName

string

Solo output. Il nome dell'evento di una conversione dell'analisi dell'app di terze parti.

GoogleAnalytics4Settings

Impostazioni correlate a un'azione di conversione di Google Analytics 4.

Rappresentazione JSON
{ "eventName": string, "propertyName": string, "propertyId": string }

Campi

Campi
`eventName`	`string` Solo output. Il nome dell'evento GA 4.
`propertyName`	`string` Solo output. Il nome della proprietà GA 4.
`propertyId`	`string (int64 format)` Solo output. L'ID della proprietà GA 4.

eventName

string

Solo output. Il nome dell'evento GA 4.

propertyName

string

Solo output. Il nome della proprietà GA 4.

propertyId

string (int64 format)

Solo output. L'ID della proprietà GA 4.