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 correlate al modello di attribuzione di questa azione di conversione.
`tagSnippets[]`	`object (TagSnippet)` Solo output. Gli snippet utilizzati per il monitoraggio delle 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 principale ForGoal 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. Pertanto, se una campagna ha un obiettivo di conversione personalizzato configurato con un'azione di conversione primariaForGoal = false, l'azione di conversione sarà comunque disponibile. Per impostazione predefinita, primaryForGoal sarà true se non impostato. Nella versione V9, il valoreprimaryForGoal può essere impostato su false solo dopo la creazione tramite un'operazione di aggiornamento, poiché non è stato dichiarato come facoltativo.
`ownerCustomer`	`string` Solo output. Il nome della risorsa del cliente proprietario dell'azione di conversione oppure nullo 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 es. 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 oltre 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 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 delle 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 effettuati utilizzando carte di 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 acquisti in-app di app per Android monitorate attraverso Firebase.
`FIREBASE_ANDROID_CUSTOM`	Conversioni personalizzate per app per Android monitorate attraverso Firebase.
`FIREBASE_IOS_FIRST_OPEN`	Conversioni prima apertura di app per iOS monitorate tramite Firebase.
`FIREBASE_IOS_IN_APP_PURCHASE`	Conversioni di acquisti in-app per app per iOS monitorate tramite Firebase.
`FIREBASE_IOS_CUSTOM`	Conversioni personalizzate per app per iOS monitorate attraverso Firebase.
`THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN`	Conversioni prima apertura di 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 per 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 acquisti in-app di app per iOS monitorate tramite Analytics per app di terze parti.
`THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM`	Conversioni personalizzate per app per iOS monitorate tramite Analytics per app di terze parti.
`ANDROID_APP_PRE_REGISTRATION`	Conversioni che si verificano quando un utente preregistra 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 sono 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`	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 sugli annunci della campagna intelligente con configurazione del monitoraggio delle chiamate, utilizzando i criteri personalizzati della campagna intelligente. 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 dagli obiettivi Universal Analytics collegati.
`UNIVERSAL_ANALYTICS_TRANSACTION`	Conversioni provenienti dalle transazioni di Universal Analytics collegate.
`GOOGLE_ANALYTICS_4_CUSTOM`	Conversioni provenienti dalle 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 in modo da 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 in modo da utilizzare sempre il valore predefinito.
`alwaysUseDefaultValue`	`boolean` Consente di stabilire se utilizzare il valore e il codice valuta predefiniti 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 in modo da 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 in modo da utilizzare sempre il valore predefinito.

alwaysUseDefaultValue

boolean

Consente di stabilire se utilizzare il valore e il codice valuta predefiniti 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`	Conta una sola conversione per clic.
`MANY_PER_CLICK`	Conteggia tutte le conversioni per clic.

AttributionModelSettings

Impostazioni correlate 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 di 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 il merito di una conversione equamente tra tutti i suoi clic utilizzando l'attribuzione della rete di ricerca di Google.
`GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY`	Attribuisce un merito esponenziale per una conversione ai clic più recenti utilizzando l'attribuzione della Ricerca Google (l'emivita è di 1 settimana).
`GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED`	Attribuisce il 40% del merito di una conversione al primo e all'ultimo clic. Il restante 20% viene distribuito uniformemente tra tutti gli altri clic. In questo modo 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 del modello basato sui dati.

Enum
`UNSPECIFIED`	Non specificato.
`UNKNOWN`	Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
`AVAILABLE`	Il modello basato sui dati è disponibile.
`STALE`	Il modello basato sui dati è inattivo. Non viene aggiornato da almeno 7 giorni. È ancora in uso, ma diventerà scaduto 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é il numero di eventi non è stato raggiunto negli ultimi 30 giorni.
`NEVER_GENERATED`	Il modello basato sui dati non è mai stato generato. Di solito questo accade perché il numero di eventi richiesto non è mai stato così elevato in un periodo di 30 giorni.

FirebaseSettings

Impostazioni relative 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 relative a un'azione di conversione per l'analisi dati delle 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.