SearchAds360Row

Una riga restituita dalla query.

Rappresentazione JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Campi
adGroup

object (AdGroup)

Il gruppo di annunci a cui viene fatto riferimento nella query.
adGroupAd

object (AdGroupAd)

L'annuncio a cui viene fatto riferimento nella query.
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

L'etichetta efficace dell'annuncio del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupAdLabel

object (AdGroupAdLabel)

L'etichetta dell'annuncio del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupAsset

object (AdGroupAsset)

L'asset del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupAssetSet

object (AdGroupAssetSet)

Il set di asset del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupAudienceView

object (AdGroupAudienceView)

La visualizzazione del segmento di pubblico del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupBidModifier

object (AdGroupBidModifier)

Il modificatore di offerta a cui viene fatto riferimento nella query.
adGroupCriterion

object (AdGroupCriterion)

Il criterio a cui viene fatto riferimento nella query.
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

L'etichetta effettiva del criterio del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

L'etichetta del criterio del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

L'etichetta effettiva del gruppo di annunci a cui viene fatto riferimento nella query.
adGroupLabel

object (AdGroupLabel)

L'etichetta del gruppo di annunci a cui viene fatto riferimento nella query.
ageRangeView

object (AgeRangeView)

La visualizzazione della fascia d'età a cui fa riferimento la query.
asset

object (Asset)

La risorsa a cui viene fatto riferimento nella query.
assetGroupAsset

object (AssetGroupAsset)

L'asset del gruppo di asset a cui viene fatto riferimento nella query.
assetGroupSignal

object (AssetGroupSignal)

L'indicatore del gruppo di asset a cui viene fatto riferimento nella query.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Il filtro dell'elenco di gruppo degli asset a cui viene fatto riferimento nella query.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

La visualizzazione della combinazione principale del gruppo di asset a cui viene fatto riferimento nella query.
assetGroup

object (AssetGroup)

Il gruppo di asset a cui viene fatto riferimento nella query.
assetSetAsset

object (AssetSetAsset)

L'asset dell'insieme di asset a cui viene fatto riferimento nella query.
assetSet

object (AssetSet)

L'insieme di asset a cui viene fatto riferimento nella query.
biddingStrategy

object (BiddingStrategy)

La strategia di offerta a cui viene fatto riferimento nella query.
campaignBudget

object (CampaignBudget)

Il budget della campagna a cui viene fatto riferimento nella query.
campaign

object (Campaign)

La campagna a cui viene fatto riferimento nella query.
campaignAsset

object (CampaignAsset)

L'asset della campagna a cui viene fatto riferimento nella query.
campaignAssetSet

object (CampaignAssetSet)

Il set di asset della campagna a cui viene fatto riferimento nella query.
campaignAudienceView

object (CampaignAudienceView)

La visualizzazione del pubblico della campagna a cui viene fatto riferimento nella query.
campaignCriterion

object (CampaignCriterion)

Il criterio campagna a cui viene fatto riferimento nella query.
campaignEffectiveLabel

object (CampaignEffectiveLabel)

L'etichetta efficace della campagna a cui viene fatto riferimento nella query.
campaignLabel

object (CampaignLabel)

L'etichetta della campagna a cui viene fatto riferimento nella query.
cartDataSalesView

object (CartDataSalesView)

La visualizzazione delle vendite con dati del carrello a cui viene fatto riferimento nella query.
audience

object (Audience)

Il pubblico a cui viene fatto riferimento nella query.
conversionAction

object (ConversionAction)

L'azione di conversione a cui viene fatto riferimento nella query.
conversionCustomVariable

object (ConversionCustomVariable)

La variabile personalizzata di conversione a cui viene fatto riferimento nella query.
customer

object (Customer)

Il cliente a cui viene fatto riferimento nella query.
customerAsset

object (CustomerAsset)

L'asset del cliente a cui viene fatto riferimento nella query.
customerAssetSet

object (CustomerAssetSet)

Il set di asset del cliente a cui viene fatto riferimento nella query.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

La strategia di offerta accessibile a cui viene fatto riferimento nella query.
customerClient

object (CustomerClient)

Il CustomerClient a cui viene fatto riferimento nella query.
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

La visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca a cui viene fatto riferimento nella query.
genderView

object (GenderView)

La visualizzazione del genere a cui viene fatto riferimento nella query.
geoTargetConstant

object (GeoTargetConstant)

La costante di targeting geografico a cui viene fatto riferimento nella query.
keywordView

object (KeywordView)

La visualizzazione delle parole chiave a cui viene fatto riferimento nella query.
label

object (Label)

L'etichetta a cui viene fatto riferimento nella query.
languageConstant

object (LanguageConstant)

La costante di lingua a cui viene fatto riferimento nella query.
locationView

object (LocationView)

La visualizzazione della posizione a cui viene fatto riferimento nella query.
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

La categoria di offerta del prodotto a cui viene fatto riferimento nella query.
productGroupView

object (ProductGroupView)

La visualizzazione del gruppo di prodotti a cui viene fatto riferimento nella query.
shoppingPerformanceView

object (ShoppingPerformanceView)

La visualizzazione del rendimento di Shopping a cui viene fatto riferimento nella query.
userList

object (UserList)

L'elenco di utenti a cui viene fatto riferimento nella query.
userLocationView

object (UserLocationView)

La visualizzazione della posizione dell'utente a cui viene fatto riferimento nella query.
webpageView

object (WebpageView)

La visualizzazione della pagina web a cui viene fatto riferimento nella query.
visit

object (Visit)

La visita a livello di evento a cui viene fatto riferimento nella query.
conversion

object (Conversion)

La conversione a livello di evento a cui viene fatto riferimento nella query.
metrics

object (Metrics)

Le metriche.
segments

object (Segments)

I segmenti.
customColumns[]

object (Value)

Le colonne personalizzate.

Gruppo di annunci

Un gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Campi
resourceName

string

Il nome della risorsa del gruppo di annunci. I nomi delle risorse del gruppo di annunci hanno il formato:

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

Lo stato del gruppo di annunci.
type

enum (AdGroupType)

Il tipo di gruppo di annunci.
adRotationMode

enum (AdGroupAdRotationMode)

La modalità di rotazione degli annunci del gruppo di annunci.
creationTime

string

Timestamp di creazione di questo gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
targetingSetting

object (TargetingSetting)

Impostazione per le funzionalità correlate al targeting.
labels[]

string

I nomi delle risorse delle etichette associate a questo gruppo di annunci.
effectiveLabels[]

string

I nomi delle risorse delle etichette effettive associate a questo gruppo di annunci. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo gruppo di annunci.
engineId

string

ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza invece "adGroup.id".
startDate

string

Data in cui questo gruppo di annunci inizia a pubblicare annunci. Per impostazione predefinita, il gruppo di annunci inizia ora o alla data di inizio del gruppo di annunci, a seconda di quale data è successiva. Se questo campo è impostato, il gruppo di annunci inizia all'inizio della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway Microsoft Advertising e Facebook.

Formato: AAAA-MM-GG Esempio: 2019-03-14
endDate

string

La data in cui il gruppo di annunci smette di pubblicare annunci. Per impostazione predefinita, il gruppo di annunci termina alla data di fine del gruppo di annunci. Se questo campo è impostato, il gruppo di annunci termina alla fine della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway Microsoft Advertising e Facebook.

Formato: AAAA-MM-GG Esempio: 2019-03-14
languageCode

string

La lingua degli annunci e delle parole chiave in un gruppo di annunci. Questo campo è disponibile solo per gli account Microsoft Advertising. Maggiori dettagli: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questo gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
id

string (int64 format)

L'ID del gruppo di annunci.
name

string

Il nome del gruppo di annunci.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuovi gruppi di annunci.

Deve contenere meno di 255 caratteri UTF-8 a larghezza intera.

Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio.
cpcBidMicros

string (int64 format)

L'offerta CPC (costo per clic) massimo.
engineStatus

enum (AdGroupEngineStatus)

Lo stato del motore per il gruppo di annunci.
finalUrlSuffix

string

Modello di URL per aggiungere parametri all'URL finale.

AdGroupStatus

I possibili stati di un gruppo di annunci.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED Il gruppo di annunci è attivato.
PAUSED Il gruppo di annunci è in pausa.
REMOVED Il gruppo di annunci viene rimosso.

AdGroupType

Enumerazione che elenca i possibili tipi di un gruppo di annunci.

Enum
UNSPECIFIED Il tipo non è stato specificato.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
SEARCH_STANDARD Il tipo di gruppo di annunci predefinito per le campagne sulla rete di ricerca.
DISPLAY_STANDARD Il tipo di gruppo di annunci predefinito per le campagne display.
SHOPPING_PRODUCT_ADS Il tipo di gruppo di annunci per le campagne Shopping che pubblicano annunci prodotto standard.
SHOPPING_SHOWCASE_ADS Il tipo per i gruppi di annunci limitati alla pubblicazione di annunci vetrina o Merchant nei risultati di Shopping.
HOTEL_ADS Il tipo di gruppo di annunci predefinito per le campagne per hotel.
SHOPPING_SMART_ADS Il tipo per i gruppi di annunci nelle campagne Shopping intelligenti.
VIDEO_BUMPER Annunci video in-stream brevi non ignorabili.
VIDEO_TRUE_VIEW_IN_STREAM Annunci video TrueView in-stream (ignorabili).
VIDEO_TRUE_VIEW_IN_DISPLAY Annunci video TrueView in-display.
VIDEO_NON_SKIPPABLE_IN_STREAM Annunci video in-stream non ignorabili.
VIDEO_OUTSTREAM Annunci video outstream.
SEARCH_DYNAMIC_ADS Tipo di gruppo di annunci per i gruppi di annunci dinamici della rete di ricerca.
SHOPPING_COMPARISON_LISTING_ADS Il tipo per i gruppi di annunci nelle campagne Shopping per il confronto.
PROMOTED_HOTEL_ADS Il tipo di gruppo di annunci per i gruppi di annunci per hotel sponsorizzati.
VIDEO_RESPONSIVE Gruppi di annunci video adattabili.
VIDEO_EFFICIENT_REACH Gruppi di annunci con copertura efficace video.
SMART_CAMPAIGN_ADS Tipo di gruppo di annunci per le campagne intelligenti.
TRAVEL_ADS Tipo di gruppo di annunci per le campagne per viaggi.

AdGroupAdRotationMode

Le possibili modalità di rotazione degli annunci di un gruppo di annunci.

Enum
UNSPECIFIED La modalità di rotazione degli annunci non è stata specificata.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
OPTIMIZE Ottimizza gli annunci del gruppo di annunci in base ai clic o alle conversioni.
ROTATE_FOREVER Ruota in modo uniforme per sempre.

AdGroupEngineStatus

Stato del motore del gruppo di annunci.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AD_GROUP_ELIGIBLE

Deprecato. Non utilizzare.
AD_GROUP_EXPIRED Per questo gruppo di annunci non vengono pubblicati annunci perché la data di fine del gruppo di annunci è trascorsa.
AD_GROUP_REMOVED Il gruppo di annunci è stato eliminato.
AD_GROUP_DRAFT Per questo gruppo di annunci non vengono pubblicati annunci perché il gruppo di annunci associato è ancora in bozza.
AD_GROUP_PAUSED Il gruppo di annunci è stato messo in pausa.
AD_GROUP_SERVING Il gruppo di annunci è attivo e attualmente pubblica annunci.
AD_GROUP_SUBMITTED Il gruppo di annunci è stato inviato (stato legacy di Microsoft Bing Ads).
CAMPAIGN_PAUSED Per questo gruppo di annunci non vengono pubblicati annunci perché la campagna è stata messa in pausa.
ACCOUNT_PAUSED Per questo gruppo di annunci non vengono pubblicati annunci perché l'account è stato messo in pausa.

TargetingSetting

Impostazioni delle funzionalità correlate al targeting, a livello di campagna e gruppo di annunci. Per ulteriori dettagli sull'impostazione di targeting, visita la pagina https://support.google.com/google-ads/answer/7365594

Rappresentazione JSON 
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Campi
targetRestrictions[]

object (TargetRestriction)

L'impostazione per dimensione di targeting per limitare la copertura della campagna o del gruppo di annunci.

TargetRestriction

L'elenco delle impostazioni di targeting per dimensione di targeting.

Rappresentazione JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Campi
targetingDimension

enum (TargetingDimension)

La dimensione di targeting a cui si applicano queste impostazioni.
bidOnly

boolean

Indica se limitare la pubblicazione degli annunci solo ai criteri selezionati per questa dimensione di targeting o se scegliere come target tutti i valori per questa dimensione di targeting e mostrare gli annunci in base al targeting in altre dimensioni di targeting. Un valore di true indica che questi criteri applicheranno solo i moltiplicatori di offerta e non influiranno sul targeting. Un valore di false indica che questi criteri limiteranno il targeting e applicheranno i modificatori di offerta.

TargetingDimension

Enumerazione che descrive le possibili dimensioni di targeting.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
KEYWORD Criteri delle parole chiave, ad esempio "crociera su Marte". KEYWORD può essere utilizzata come dimensione di offerta personalizzata. Le parole chiave sono sempre una dimensione di targeting, pertanto non possono essere impostate come dimensione "ALL" di destinazione con TargetRestriction.
AUDIENCE Criteri del segmento di pubblico, che includono elenco utenti, interessi degli utenti, affinità personalizzata e in-market personalizzato.
TOPIC Criteri per argomento per il targeting di categorie di contenuti, ad esempio "category::Animals>Pets". Utilizzati per il targeting display e video.
GENDER Criteri per il targeting per genere.
AGE_RANGE Criteri per il targeting delle fasce d'età.
PLACEMENT Criteri di posizionamento, che includono siti web come "www.fioriinvendita.com", nonché applicazioni mobile, categorie di app mobile, video di YouTube e canali YouTube.
PARENTAL_STATUS Criteri per il targeting per stato parentale.
INCOME_RANGE Criteri per il targeting per fascia di reddito.

AdGroupAd

Un annuncio del gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Campi
resourceName

string

Il nome della risorsa dell'annuncio. I nomi delle risorse annuncio del gruppo di annunci hanno il formato:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

Lo stato dell'annuncio.
ad

object (Ad)

L'annuncio.
creationTime

string

Timestamp di creazione di questo annuncio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
labels[]

string

I nomi delle risorse delle etichette associate a questo annuncio del gruppo di annunci.
effectiveLabels[]

string

I nomi delle risorse delle etichette effettive associate a questo annuncio. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo annuncio.
engineId

string

ID dell'annuncio nell'account motore esterno. Questo campo è solo per l'account Search Ads 360, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per le entità non Search Ads 360, utilizza "adGroupAd.ad.id".
engineStatus

enum (AdGroupAdEngineStatus)

Stato aggiuntivo dell'annuncio nell'account motore esterno. Gli stati possibili (a seconda del tipo di account esterno) includono attivo, idoneo, in attesa di revisione e così via.
lastModifiedTime

string

Data e ora dell'ultima modifica di questo annuncio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".

AdGroupAdStatus

Gli stati possibili di un annuncio del gruppo di annunci.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED L'annuncio del gruppo di annunci è attivato.
PAUSED L'annuncio del gruppo di annunci è in pausa.
REMOVED L'annuncio del gruppo di annunci viene rimosso.

FinalAppUrl

Un URL per il link diretto a un'app per il sistema operativo specificato.

Rappresentazione JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Campi
osType

enum (AppUrlOperatingSystemType)

Il sistema operativo scelto come target da questo URL. Obbligatorio.
url

string

L'URL link diretto all'app. I link diretti specificano una posizione in un'app che corrisponde ai contenuti che vuoi mostrare e devono avere il formato {scheme}://{host_path}. Lo schema identifica l'app da aprire. Per la tua app, puoi utilizzare uno schema personalizzato che inizia con il nome dell'app. L'host e il percorso specificano la posizione univoca nell'app in cui si trovano i tuoi contenuti. Esempio: "exampleapp://productid_1234". Obbligatorio.

AppUrlOperatingSystemType

Sistema operativo

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
IOS Il sistema operativo Apple iOS.
ANDROID Il sistema operativo Android.

AdType

I possibili tipi di annuncio.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
TEXT_AD L'annuncio è un annuncio di testo.
EXPANDED_TEXT_AD L'annuncio è un annuncio di testo espanso.
CALL_ONLY_AD L'annuncio è un annuncio di sola chiamata.
EXPANDED_DYNAMIC_SEARCH_AD L'annuncio è un annuncio dinamico della rete di ricerca espanso.
HOTEL_AD L'annuncio è un annuncio per hotel.
SHOPPING_SMART_AD L'annuncio è un annuncio Shopping intelligente.
SHOPPING_PRODUCT_AD L'annuncio è un annuncio Shopping standard.
VIDEO_AD L'annuncio è un annuncio video.
GMAIL_AD Questo annuncio è un annuncio Gmail.
IMAGE_AD Questo annuncio è un annuncio illustrato.
RESPONSIVE_SEARCH_AD L'annuncio è un annuncio adattabile della rete di ricerca.
LEGACY_RESPONSIVE_DISPLAY_AD L'annuncio è un annuncio display adattabile precedente.
APP_AD L'annuncio è un annuncio per app.
LEGACY_APP_INSTALL_AD L'annuncio è un annuncio per l'installazione di app legacy.
RESPONSIVE_DISPLAY_AD L'annuncio è un annuncio display adattabile.
LOCAL_AD L'annuncio è un annuncio locale.
HTML5_UPLOAD_AD L'annuncio è un annuncio da caricamento display con il tipo di prodotto HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD L'annuncio è un annuncio da caricamento display con uno dei tipi di prodotto DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD L'annuncio è un annuncio di coinvolgimento in app.
SHOPPING_COMPARISON_LISTING_AD L'annuncio è un annuncio scheda di confronto di Shopping.
VIDEO_BUMPER_AD Annuncio video bumper.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annuncio video in-stream non ignorabile.
VIDEO_OUTSTREAM_AD Annuncio video outstream.
VIDEO_TRUEVIEW_DISCOVERY_AD Annuncio video TrueView in-display.
VIDEO_TRUEVIEW_IN_STREAM_AD Annuncio video TrueView in-stream.
VIDEO_RESPONSIVE_AD Annuncio video adattabile.
SMART_CAMPAIGN_AD Annuncio della campagna intelligente.
APP_PRE_REGISTRATION_AD Annuncio di preregistrazione di app universale.
DISCOVERY_MULTI_ASSET_AD Annuncio discovery basato su più asset.
TRAVEL_AD Annuncio di viaggi.
DISCOVERY_VIDEO_RESPONSIVE_AD Annuncio video discovery adattabile.
MULTIMEDIA_AD Annuncio multimediale.

SearchAds360TextAdInfo

Un annuncio di testo Search Ads 360.

Rappresentazione JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Campi
headline

string

Titolo dell'annuncio.
description1

string

La prima riga della descrizione dell'annuncio.
description2

string

La seconda riga della descrizione dell'annuncio.
displayUrl

string

L'URL visualizzato dell'annuncio.
displayMobileUrl

string

L'URL mobile visualizzato dell'annuncio.
adTrackingId

string (int64 format)

L'ID monitoraggio dell'annuncio.

SearchAds360ExpandedTextAdInfo

Un annuncio di testo espanso di Search Ads 360.

Rappresentazione JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campi
headline

string

Titolo dell'annuncio.
headline2

string

Il secondo titolo dell'annuncio.
headline3

string

Il terzo titolo dell'annuncio.
description1

string

La prima riga della descrizione dell'annuncio.
description2

string

La seconda riga della descrizione dell'annuncio.
path1

string

Testo aggiunto all'URL visibile generato automaticamente con un delimitatore.
path2

string

Testo aggiunto a path1 con un delimitatore.
adTrackingId

string (int64 format)

L'ID monitoraggio dell'annuncio.

SearchAds360ResponsiveSearchAdInfo

Un annuncio adattabile della rete di ricerca di Search Ads 360.

Rappresentazione JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco degli asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati da questo elenco.
descriptions[]

object (AdTextAsset)

Elenco degli asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate da questo elenco.
path1

string

Testo aggiunto all'URL visibile generato automaticamente con un delimitatore.
path2

string

Testo aggiunto a path1 con un delimitatore.
adTrackingId

string (int64 format)

L'ID monitoraggio dell'annuncio.

AdTextAsset

Un asset di testo utilizzato all'interno di un annuncio.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Testo dell'asset.

SearchAds360ProductAdInfo

Questo tipo non contiene campi.

Un annuncio prodotto Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Un annuncio dinamico della rete di ricerca espanso.

Rappresentazione JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Campi
description1

string

La prima riga della descrizione dell'annuncio.
description2

string

La seconda riga della descrizione dell'annuncio.
adTrackingId

string (int64 format)

L'ID monitoraggio dell'annuncio.

AdGroupAdEngineStatus

Enumera gli stati motore di AdGroupAd.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AD_GROUP_AD_ELIGIBLE

Deprecato. Non utilizzare.
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: la creatività non è stata approvata.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL mobile in corso di revisione.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: la creatività non è valida su un dispositivo mobile, ma è valida su un computer.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: la creatività è pronta per l'attivazione.
AD_GROUP_AD_NOT_REVIEWED Baidu: la creatività non è stata esaminata.
AD_GROUP_AD_ON_HOLD

Deprecato. Non utilizzare. Utilizzati in precedenza da Gemini
AD_GROUP_AD_PAUSED La creatività è stata messa in pausa.
AD_GROUP_AD_REMOVED La creatività è stata rimossa.
AD_GROUP_AD_PENDING_REVIEW La creatività è in attesa di revisione.
AD_GROUP_AD_UNDER_REVIEW La creatività è in corso di revisione.
AD_GROUP_AD_APPROVED La creatività è stata approvata.
AD_GROUP_AD_DISAPPROVED La creatività non è stata approvata.
AD_GROUP_AD_SERVING La creatività viene pubblicata.
AD_GROUP_AD_ACCOUNT_PAUSED La creatività è stata messa in pausa perché l'account è in pausa.
AD_GROUP_AD_CAMPAIGN_PAUSED La creatività è stata messa in pausa perché la campagna è in pausa.
AD_GROUP_AD_AD_GROUP_PAUSED La creatività è stata messa in pausa perché il gruppo di annunci è in pausa.

AdGroupAdEffectiveLabel

Una relazione tra un annuncio del gruppo di annunci e un'etichetta efficace. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo annuncio del gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta efficace dell'annuncio del gruppo di annunci. I nomi delle risorse delle etichette effettive degli annunci del gruppo di annunci hanno il formato: customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

L'annuncio del gruppo di annunci a cui è associata l'etichetta efficace.
label

string

L'etichetta effettiva assegnata all'annuncio del gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta effettiva.

AdGroupAdLabel

Una relazione tra un annuncio del gruppo di annunci e un'etichetta.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta dell'annuncio del gruppo di annunci. I nomi delle risorse delle etichette degli annunci del gruppo di annunci hanno il formato: customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

L'annuncio del gruppo di annunci a cui è allegata l'etichetta.
label

string

L'etichetta assegnata all'annuncio del gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta.

AdGroupAsset

Un collegamento tra un gruppo di annunci e un asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campi
resourceName

string

Il nome della risorsa dell'asset del gruppo di annunci. I nomi delle risorse AdGroupAsset hanno il seguente formato:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

Obbligatorio. Il gruppo di annunci a cui è collegato l'asset.
asset

string

Obbligatorio. L'asset collegato al gruppo di annunci.
status

enum (AssetLinkStatus)

Stato dell'asset del gruppo di annunci.

AssetLinkStatus

Enumerazione che descrive gli stati di un collegamento della risorsa.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED Il collegamento dell'asset è attivato.
REMOVED Il link all'asset è stato rimosso.
PAUSED Il collegamento dell'asset è in pausa.

AdGroupAssetSet

AdGroupAssetSet è il collegamento tra un gruppo di annunci e un insieme di asset. La creazione di un oggetto AdGroupAssetSet collega un insieme di asset a un gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Campi
resourceName

string

Il nome della risorsa del set di asset del gruppo di annunci. I nomi delle risorse del set di asset del gruppo di annunci hanno il seguente formato:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

Il gruppo di annunci a cui è collegato questo insieme di asset.
assetSet

string

Il set di asset collegato al gruppo di annunci.
status

enum (AssetSetLinkStatus)

Lo stato del set di asset del gruppo di annunci. Sola lettura.

AssetSetLinkStatus

I possibili stati del collegamento tra il set di asset e il relativo contenitore.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
ENABLED Il collegamento tra il gruppo di asset e il relativo contenitore è abilitato.
REMOVED Il collegamento tra il set di asset e il relativo contenitore viene rimosso.

AdGroupAudienceView

Una visualizzazione dei segmenti di pubblico a livello di gruppo di annunci. Include i dati sul rendimento degli annunci delle reti display e YouTube e degli elenchi per il remarketing per gli annunci della rete di ricerca (RLSA), aggregati a livello di segmento di pubblico.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione del segmento di pubblico del gruppo di annunci. I nomi delle risorse delle visualizzazioni dei segmenti di pubblico dei gruppi di annunci hanno il seguente formato:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Rappresenta un modificatore dell'offerta per gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Campi
resourceName

string

Il nome della risorsa del modificatore dell'offerta per gruppo di annunci. I nomi delle risorse dei modificatori dell'offerta per gruppo di annunci hanno il seguente formato:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. L'intervallo è 1.0 - 6.0 per PreferredContent. Utilizza 0 per disattivare un tipo di dispositivo.

Campo unione criterion. Il criterio di questo modificatore dell'offerta per gruppo di annunci.

Obbligatorio nelle operazioni di creazione a partire dalla versione 5. criterion può essere solo uno dei seguenti:
device

object (DeviceInfo)

Un criterio per dispositivo.

DeviceInfo

Un criterio per dispositivo.

Rappresentazione JSON 
{
  "type": enum (Device)
}
Campi
type

enum (Device)

Tipo di dispositivo.

Dispositivo

Elenca i dispositivi Google Ads disponibili per il targeting.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
MOBILE Dispositivi mobili dotati di browser completi.
TABLET Tablet dotati di browser completi.
DESKTOP Computer.
CONNECTED_TV Smart TV e console per videogiochi.
OTHER Altri tipi di dispositivi.

AdGroupCriterion

Un criterio del gruppo di annunci. Il report adGroupCriterion restituisce solo i criteri aggiunti esplicitamente al gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Campi
resourceName

string

Il nome della risorsa del criterio del gruppo di annunci. I nomi delle risorse dei criteri del gruppo di annunci hanno il seguente formato:

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
status

enum (AdGroupCriterionStatus)

Lo stato del criterio.

Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nella UI. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", poiché gli utenti di queste fasce d'età sono idonei a visualizzare gli annunci. Tuttavia, AdGroupCriterion.status mostrerà "rimosso", poiché non è stato aggiunto alcun criterio positivo.
qualityInfo

object (QualityInfo)

Informazioni sulla qualità del criterio.
type

enum (CriterionType)

Il tipo di criterio.
labels[]

string

I nomi delle risorse delle etichette associate a questo criterio del gruppo di annunci.
effectiveLabels[]

string

I nomi delle risorse delle etichette effettive associate a questo criterio del gruppo di annunci. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo criterio del gruppo di annunci.
positionEstimates

object (PositionEstimates)

Stime per le offerte dei criteri in varie posizioni.
finalUrls[]

string

L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.
finalMobileUrls[]

string

L'elenco dei possibili URL mobile finali dopo tutti i reindirizzamenti interdominio.
urlCustomParameters[]

object (CustomParameter)

L'elenco dei mapping utilizzati per sostituire i tag dei parametri personalizzati in un trackingUrlTemplate, finalUrls o mobile_final_urls.
engineId

string

ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è riservato agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza invece "adGroupCriterion.criterion_id".
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
criterionId

string (int64 format)

L'ID del criterio.
adGroup

string

Il gruppo di annunci a cui appartiene il criterio.
negative

boolean

Se scegliere come target (false) o escludere (true) il criterio.

Questo campo è immutabile. Per passare da un criterio positivo a uno negativo, rimuovilo e aggiungilo di nuovo.
bidModifier

number

Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri targetizzabili supporta i modificatori.
cpcBidMicros

string (int64 format)

L'offerta CPC (costo per clic).
effectiveCpcBidMicros

string (int64 format)

L'offerta CPC (costo per clic) effettivo.
engineStatus

enum (AdGroupCriterionEngineStatus)

Lo stato del motore per il criterio del gruppo di annunci.
finalUrlSuffix

string

Modello di URL per aggiungere parametri all'URL finale.
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio.

Campo unione criterion. Il criterio del gruppo di annunci.

Deve essere impostato esattamente un valore. criterion può essere solo uno dei seguenti:
keyword

object (KeywordInfo)

Parola chiave.
listingGroup

object (ListingGroupInfo)

Gruppo di schede.
ageRange

object (AgeRangeInfo)

Fascia d'età.
gender

object (GenderInfo)

Genere.
userList

object (UserListInfo)

Elenco utenti.
webpage

object (WebpageInfo)

Pagina web
location

object (LocationInfo)

Posizione.

AdGroupCriterionStatus

I possibili stati di un AdGroupCriterion.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED Il criterio del gruppo di annunci è attivato.
PAUSED Il criterio del gruppo di annunci è in pausa.
REMOVED Il criterio del gruppo di annunci viene rimosso.

QualityInfo

Un contenitore per le informazioni sulla qualità dei criteri del gruppo di annunci.

Rappresentazione JSON 
{
  "qualityScore": integer
}
Campi
qualityScore

integer

Il punteggio di qualità.

Questo campo potrebbe non essere compilato se Google non dispone di informazioni sufficienti per determinare un valore.

CriterionType

Enumerazione che descrive i possibili tipi di criteri.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
KEYWORD Parola chiave, ad esempio "crociera su Marte".
PLACEMENT Posizionamento, noto anche come sito web, ad esempio "www.flowers4sale.com"
MOBILE_APP_CATEGORY Categorie di app mobile da scegliere come target.
MOBILE_APPLICATION App mobile da scegliere come target.
DEVICE Dispositivi da scegliere come target.
LOCATION Località target.
LISTING_GROUP Gruppi di schede da scegliere come target.
AD_SCHEDULE Pianificazione annunci.
AGE_RANGE Fascia d'età.
GENDER Genere.
INCOME_RANGE Fascia di reddito.
PARENTAL_STATUS Stato parentale.
YOUTUBE_VIDEO Video di YouTube.
YOUTUBE_CHANNEL Canale YouTube.
USER_LIST Elenco utenti.
PROXIMITY Prossimità.
TOPIC Un target per argomento sulla Rete Display (ad esempio "Animali domestici e non").
LISTING_SCOPE Ambito della scheda da scegliere come target.
LANGUAGE Lingua.
IP_BLOCK IpBlock.
CONTENT_LABEL Etichetta contenuti per l'esclusione di categoria.
CARRIER Operatore.
USER_INTEREST Una categoria a cui l'utente è interessato.
WEBPAGE Criterio della pagina web per gli annunci dinamici della rete di ricerca.
OPERATING_SYSTEM_VERSION Versione del sistema operativo.
APP_PAYMENT_MODEL Modello di pagamento delle app.
MOBILE_DEVICE Dispositivo mobile.
CUSTOM_AFFINITY Affinità personalizzata.
CUSTOM_INTENT Personalizzato per intenzione.
LOCATION_GROUP Gruppo di località.
CUSTOM_AUDIENCE Segmento di pubblico personalizzato
COMBINED_AUDIENCE Segmento di pubblico combinato
KEYWORD_THEME Tema delle parole chiave per la campagna intelligente
AUDIENCE Pubblico
LOCAL_SERVICE_ID ID servizio annunci di Servizi locali.
BRAND Brand
BRAND_LIST Elenco dei brand
LIFE_EVENT Evento importante

PositionEstimates

Stime per le offerte dei criteri in varie posizioni.

Rappresentazione JSON 
{
  "topOfPageCpcMicros": string
}
Campi
topOfPageCpcMicros

string (int64 format)

La stima dell'offerta CPC necessaria per visualizzare l'annuncio nella parte superiore della prima pagina dei risultati di ricerca.

AdGroupCriterionEngineStatus

Enumera gli stati del motore AdGroupCriterion.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AD_GROUP_CRITERION_ELIGIBLE

Deprecato. Non utilizzare.
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: offerta o qualità insufficiente per essere visualizzata.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: messa in pausa da Baidu per basso volume di ricerca.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL mobile in corso di revisione.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: la pagina di destinazione non è valida per un dispositivo, mentre lo è per un altro dispositivo.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: la parola chiave è stata creata e messa in pausa dalla gestione account di Baidu e ora è pronta per essere attivata.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: in corso di revisione presso Baidu. Gemini: criterio in corso di revisione.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: criterio da rivedere.
AD_GROUP_CRITERION_ON_HOLD

Deprecato. Non utilizzare. Utilizzati in precedenza da Gemini
AD_GROUP_CRITERION_PENDING_REVIEW Y!J : Criterion pending review
AD_GROUP_CRITERION_PAUSED Il criterio è stato messo in pausa.
AD_GROUP_CRITERION_REMOVED Il criterio è stato rimosso.
AD_GROUP_CRITERION_APPROVED Il criterio è stato approvato.
AD_GROUP_CRITERION_DISAPPROVED Il criterio non è stato approvato.
AD_GROUP_CRITERION_SERVING Il criterio è attivo e in pubblicazione.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Il criterio è in pausa perché l'account è in pausa.

CustomParameter

Una mappatura che può essere utilizzata dai tag di parametri personalizzati in un trackingUrlTemplate, finalUrls o mobile_final_urls.

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string

La chiave corrispondente al nome del tag del parametro.
value

string

Il valore da sostituire.

KeywordInfo

Un criterio parola chiave.

Rappresentazione JSON 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Campi
matchType

enum (KeywordMatchType)

Il tipo di corrispondenza della parola chiave.
text

string

Il testo della parola chiave (al massimo 80 caratteri e 10 parole).

KeywordMatchType

Possibili tipi di corrispondenza delle parole chiave.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
EXACT Corrispondenza esatta.
PHRASE Corrispondenza a frase.
BROAD Corrispondenza generica.

ListingGroupInfo

Un criterio del gruppo di schede.

Rappresentazione JSON 
{
  "type": enum (ListingGroupType)
}
Campi
type

enum (ListingGroupType)

Tipo di gruppo di schede.

ListingGroupType

Il tipo di gruppo di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SUBDIVISION Suddivisione dei prodotti in base a una dimensione dell'elenco. Questi nodi non vengono utilizzati dalla pubblicazione per scegliere come target le voci di elenco, ma servono esclusivamente a definire la struttura dell'albero.
UNIT Unità del gruppo di schede che definisce un'offerta.

AgeRangeInfo

Un criterio fascia d'età.

Rappresentazione JSON 
{
  "type": enum (AgeRangeType)
}
Campi
type

enum (AgeRangeType)

Il tipo di fascia d'età.

AgeRangeType

Il tipo di fasce d'età demografiche (ad esempio, tra i 18 e i 24 anni).

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AGE_RANGE_18_24 Tra i 18 e i 24 anni.
AGE_RANGE_25_34 Tra i 25 e i 34 anni.
AGE_RANGE_35_44 Tra i 35 e i 44 anni.
AGE_RANGE_45_54 Tra i 45 e i 54 anni.
AGE_RANGE_55_64 Tra i 55 e i 64 anni.
AGE_RANGE_65_UP 65 anni e oltre.
AGE_RANGE_UNDETERMINED Fascia d'età indeterminata.

GenderInfo

Un criterio genere.

Rappresentazione JSON 
{
  "type": enum (GenderType)
}
Campi
type

enum (GenderType)

Tipo di genere.

GenderType

Il tipo di genere demografico (ad esempio, femminile).

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
MALE Uomo.
FEMALE Femmina.
UNDETERMINED Genere indeterminato.

UserListInfo

Un criterio Elenco utenti. Rappresenta un elenco utenti definito dall'inserzionista come target.

Rappresentazione JSON 
{
  "userList": string
}
Campi
userList

string

Il nome della risorsa Elenco utenti.

WebpageInfo

Rappresenta un criterio per il targeting delle pagine web del sito web di un inserzionista.

Rappresentazione JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Campi
conditions[]

object (WebpageConditionInfo)

Condizioni o espressioni logiche per il targeting delle pagine web. L'elenco delle condizioni di targeting delle pagine web viene combinato con l'operatore AND quando viene valutato per il targeting. Un elenco vuoto di condizioni indica che tutte le pagine del sito web della campagna sono prese di mira.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.
coveragePercentage

number

Percentuale di copertura dei criteri del sito web. Questa è la percentuale calcolata di copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura viene restituita come 1, indica una copertura del 100%. Questo campo è di sola lettura.
criterionName

string

Il nome del criterio definito da questo parametro. Il valore del nome verrà utilizzato per identificare, ordinare e filtrare i criteri con questo tipo di parametri.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.

WebpageConditionInfo

Espressione logica per il targeting delle pagine web del sito web di un inserzionista.

Rappresentazione JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Campi
operand

enum (WebpageConditionOperand)

Operando della condizione di targeting per pagina web.
operator

enum (WebpageConditionOperator)

Operatore della condizione di targeting per pagina web.
argument

string

Argomento della condizione di targeting per pagina web.

WebpageConditionOperand

L'operando della condizione della pagina web nei criteri della pagina web.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
URL Operando che indica una condizione di targeting dell'URL di una pagina web.
CATEGORY Operando che indica una condizione di targeting per categoria di pagina web.
PAGE_TITLE Operando che indica una condizione di targeting del titolo di una pagina web.
PAGE_CONTENT Operando che indica una condizione di targeting dei contenuti di una pagina web.
CUSTOM_LABEL Operando che indica una condizione di targeting con etichetta personalizzata della pagina web.

WebpageConditionOperator

L'operatore di condizione della pagina web nei criteri della pagina web.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
EQUALS La condizione web dell'argomento è uguale alla condizione web confrontata.
CONTAINS La condizione web dell'argomento fa parte della condizione web confrontata.

LocationInfo

Un criterio di località.

Rappresentazione JSON 
{
  "geoTargetConstant": string
}
Campi
geoTargetConstant

string

Il nome della risorsa costante di targeting geografico.

AdGroupCriterionEffectiveLabel

Una relazione tra un criterio del gruppo di annunci e un'etichetta efficace. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo criterio del gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta effettiva del criterio del gruppo di annunci. I nomi delle risorse delle etichette effettive dei criteri del gruppo di annunci hanno il formato: customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

Il criterio del gruppo di annunci a cui è associata l'etichetta effettiva.
label

string

L'etichetta effettiva assegnata al criterio del gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta effettiva.

AdGroupCriterionLabel

Una relazione tra un criterio del gruppo di annunci e un'etichetta.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta del criterio del gruppo di annunci. I nomi delle risorse delle etichette dei criteri del gruppo di annunci hanno il formato: customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

Il criterio del gruppo di annunci a cui è associata l'etichetta.
label

string

L'etichetta assegnata al criterio del gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta.

AdGroupEffectiveLabel

Una relazione tra un gruppo di annunci e un'etichetta efficace. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questo gruppo di annunci.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta effettiva del gruppo di annunci. I nomi delle risorse delle etichette effettive dei gruppi di annunci hanno il formato: customers/{ownerCustomerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
adGroup

string

Il gruppo di annunci a cui è allegata l'etichetta efficace.
label

string

L'etichetta effettiva assegnata al gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta effettiva.

AdGroupLabel

Una relazione tra un gruppo di annunci e un'etichetta.

Rappresentazione JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Il nome della risorsa dell'etichetta del gruppo di annunci. I nomi delle risorse delle etichette dei gruppi di annunci hanno il seguente formato: customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

Il gruppo di annunci a cui è associata l'etichetta.
label

string

L'etichetta assegnata al gruppo di annunci.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta.

AgeRangeView

Una visualizzazione della fascia d'età.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione della fascia d'età. I nomi delle risorse della visualizzazione della fascia d'età hanno il seguente formato:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Asset

Un asset è una parte di un annuncio che può essere condivisa in più annunci. Può essere un'immagine (ImageAsset), un video (YoutubeVideoAsset) e così via. Gli asset sono immutabili e non possono essere rimossi. Per interrompere la pubblicazione di un asset, rimuovilo dall'entità che lo utilizza.

Rappresentazione JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Campi
resourceName

string

Il nome della risorsa dell'asset. I nomi delle risorse degli asset hanno il seguente formato:

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

Tipo di asset.
finalUrls[]

string

Un elenco dei possibili URL finali dopo tutti i reindirizzamenti cross-domain.
finalMobileUrls[]

string

Un elenco di possibili URL mobile finali dopo tutti i reindirizzamenti cross-domain.
urlCustomParameters[]

object (CustomParameter)

Un elenco di mappature da utilizzare per sostituire i tag dei parametri personalizzati dell'URL in trackingUrlTemplate, finalUrls e/o finalMobileUrls.
status

enum (AssetStatus)

Lo stato della risorsa.
creationTime

string

Il timestamp della creazione di questa risorsa. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questa risorsa. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
id

string (int64 format)

ID della risorsa.
name

string

Nome facoltativo dell'asset.
trackingUrlTemplate

string

Modello di URL per la creazione di un URL di monitoraggio.
finalUrlSuffix

string

Modello di URL per aggiungere parametri agli URL pagina di destinazione pubblicati con il monitoraggio parallelo.
engineStatus

enum (AssetEngineStatus)

Lo stato motore di un asset.
Campo unione asset_data. Il tipo specifico di asset. asset_data può essere solo uno dei seguenti:
youtubeVideoAsset

object (YoutubeVideoAsset)

Un asset video di YouTube.
imageAsset

object (ImageAsset)

Un asset immagine.
textAsset

object (TextAsset)

Un asset di testo.
calloutAsset

object (UnifiedCalloutAsset)

Un asset callout unificato.
pageFeedAsset

object (UnifiedPageFeedAsset)

Un asset del feed di pagine unificato.
mobileAppAsset

object (MobileAppAsset)

Un asset per app mobile.
callAsset

object (UnifiedCallAsset)

Un asset di chiamata unificato.
callToActionAsset

object (CallToActionAsset)

Un asset di invito all'azione.
locationAsset

object (UnifiedLocationAsset)

Un asset posizione unificato.

AssetType

Enumerazione che descrive i possibili tipi di asset.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
YOUTUBE_VIDEO Asset video di YouTube.
MEDIA_BUNDLE Asset bundle multimediale.
IMAGE Asset immagine.
TEXT Asset di testo.
LEAD_FORM Asset modulo per i lead.
BOOK_ON_GOOGLE Asset Prenota su Google.
PROMOTION Asset di promozione.
CALLOUT Asset callout.
STRUCTURED_SNIPPET Asset snippet strutturato.
PAGE_FEED Asset del feed di pagine.
DYNAMIC_EDUCATION Asset didattico dinamico.
MOBILE_APP Asset per app mobile.
HOTEL_CALLOUT Asset callout per hotel.
CALL Asset di chiamata.
PRICE Asset prezzo.
CALL_TO_ACTION Asset di invito all'azione.
DYNAMIC_REAL_ESTATE Asset immobiliare dinamico.
DYNAMIC_CUSTOM Asset personalizzato dinamico.
DYNAMIC_HOTELS_AND_RENTALS Asset per hotel e case vacanze dinamici.
DYNAMIC_FLIGHTS Asset voli dinamici.
DYNAMIC_TRAVEL Asset dinamico per viaggi.
DYNAMIC_LOCAL Asset locale dinamico.
DYNAMIC_JOBS Asset annuncio di testo dinamico per offerte di lavoro.
LOCATION Asset posizione.
HOTEL_PROPERTY Asset proprietà di hotel.

AssetStatus

I possibili stati di un asset.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
ENABLED L'asset è attivato.
REMOVED L'asset viene rimosso.
ARCHIVED L'asset è archiviato.
PENDING_SYSTEM_GENERATED L'asset è stato generato dal sistema ed è in attesa di revisione da parte dell'utente.

AssetEngineStatus

Enumerazione che descrive i possibili stati del motore delle risorse.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SERVING L'asset è attivo.
SERVING_LIMITED L'asset è attivo con limitazioni.
DISAPPROVED L'asset non è stato approvato (non è idoneo).
DISABLED La risorsa non è attiva (in attesa).
REMOVED L'asset è stato rimosso.

YoutubeVideoAsset

Una risorsa di YouTube.

Rappresentazione JSON 
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Campi
youtubeVideoTitle

string

Titolo del video di YouTube.
youtubeVideoId

string

ID video di YouTube. Si tratta del valore della stringa di 11 caratteri utilizzato nell'URL del video di YouTube.

ImageAsset

Un asset immagine.

Rappresentazione JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Campi
mimeType

enum (MimeType)

Tipo MIME dell'asset immagine.
fullSize

object (ImageDimension)

Metadati per questa immagine nelle sue dimensioni originali.
fileSize

string (int64 format)

Dimensioni del file dell'asset immagine in byte.

MimeType

Il tipo MIME

Enum
UNSPECIFIED Il tipo MIME non è stato specificato.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
IMAGE_JPEG Tipo MIME di image/jpeg.
IMAGE_GIF Tipo MIME di immagine/gif.
IMAGE_PNG Tipo MIME di image/png.
FLASH Tipo MIME di application/x-shockwave-flash.
TEXT_HTML Tipo MIME di text/html.
PDF Tipo MIME di application/pdf.
MSWORD Tipo MIME di application/msword.
MSEXCEL Tipo MIME di application/vnd.ms-excel.
RTF Tipo MIME di application/rtf.
AUDIO_WAV Tipo MIME di audio/wav.
AUDIO_MP3 Tipo MIME di audio/mp3.
HTML5_AD_ZIP Tipo MIME di application/x-html5-ad-zip.

ImageDimension

Metadati per un'immagine di una determinata dimensione, originale o ridimensionata.

Rappresentazione JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Campi
heightPixels

string (int64 format)

Altezza dell'immagine.
widthPixels

string (int64 format)

Larghezza dell'immagine.
url

string

Un URL che restituisce l'immagine con questa altezza e larghezza.

TextAsset

Un asset di testo.

Rappresentazione JSON 
{
  "text": string
}
Campi
text

string

Contenuto testuale dell'asset di testo.

UnifiedCalloutAsset

Un asset callout unificato.

Rappresentazione JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Campi
calloutText

string

Il testo del callout. La lunghezza di questa stringa deve essere compresa tra 1 e 25 caratteri inclusi.
startDate

string

Data di inizio in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.
endDate

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, nel formato aaaa-MM-gg.
adScheduleTargets[]

object (AdScheduleInfo)

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali la risorsa può essere pubblicata. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.
useSearcherTimeZone

boolean

Se mostrare l'asset nel fuso orario dell'utente che esegue la ricerca. Valido per Microsoft Ads.

AdScheduleInfo

Rappresenta un criterio di pianificazione degli annunci.

AdSchedule è specificato come giorno della settimana e intervallo di tempo in cui verranno mostrati gli annunci.

Non è possibile aggiungere più di sei pianificazioni degli annunci per lo stesso giorno.

Rappresentazione JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Campi
startMinute

enum (MinuteOfHour)

Minuti dopo l'ora di inizio in cui viene avviata questa pianificazione.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.
endMinute

enum (MinuteOfHour)

Minuti dopo l'ora di fine della pianificazione. La pianificazione esclude il minuto finale.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.
dayOfWeek

enum (DayOfWeek)

Il giorno della settimana a cui si applica la programmazione.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.
startHour

integer

Ora di inizio in formato 24 ore. Questo campo deve essere compreso tra 0 e 23 inclusi.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.
endHour

integer

Ora di fine in formato 24 ore; 24 indica la fine della giornata. Questo campo deve essere compreso tra 0 e 24 inclusi.

Questo campo è obbligatorio per le operazioni CREATE e vietato per le operazioni UPDATE.

MinuteOfHour

Elenca i quarti d'ora. Ad esempio, "QUINDICI"

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
ZERO Zero minuti dopo l'ora.
FIFTEEN Quindici minuti dopo l'ora.
THIRTY Trenta minuti dopo l'ora.
FORTY_FIVE Quarantacinque minuti dopo l'ora.

DayOfWeek

Elenca i giorni della settimana, ad esempio "Lunedì".

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
MONDAY Lunedì.
TUESDAY Martedì.
WEDNESDAY Mercoledì.
THURSDAY Giovedì.
FRIDAY Venerdì.
SATURDAY sabato.
SUNDAY Domenica.

UnifiedSitelinkAsset

Un asset sitelink unificato.

Rappresentazione JSON 
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Campi
linkText

string

Testo visualizzato dell'URL per il sitelink. La lunghezza di questa stringa deve essere compresa tra 1 e 25 caratteri inclusi.
description1

string

La prima riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 caratteri inclusi e deve essere impostata anche description2.
description2

string

Seconda riga della descrizione del sitelink. Se impostata, la lunghezza deve essere compresa tra 1 e 35 inclusi e deve essere impostata anche description1.
startDate

string

Data di inizio in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.
endDate

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, nel formato aaaa-MM-gg.
adScheduleTargets[]

object (AdScheduleInfo)

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali la risorsa può essere pubblicata. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.
trackingId

string (int64 format)

ID utilizzato per il monitoraggio dei clic per l'asset sitelink. Questo è un account Yahoo! Campo solo per il Giappone.
useSearcherTimeZone

boolean

Se mostrare l'asset sitelink nel fuso orario dell'utente che esegue la ricerca. Valido per Microsoft Ads.
mobilePreferred

boolean

Se la preferenza è che l'asset sitelink venga visualizzato sui dispositivi mobili. Valido per Microsoft Ads.

UnifiedPageFeedAsset

Un asset del feed di pagine unificato.

Rappresentazione JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Campi
pageUrl

string

La pagina web che gli inserzionisti vogliono scegliere come target.
labels[]

string

Etichette utilizzate per raggruppare gli URL delle pagine.

MobileAppAsset

Un asset che rappresenta un'app mobile.

Rappresentazione JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
Campi
appId

string

Obbligatorio. Una stringa che identifica in modo univoco un'applicazione mobile. Deve contenere solo l'ID nativo della piattaforma, ad esempio "com.android.ebay" per Android o "12345689" per iOS.
appStore

enum (MobileAppVendor)

Obbligatorio. Lo store che distribuisce questa app specifica.

MobileAppVendor

Il tipo di fornitore di app mobile

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
APPLE_APP_STORE Fornitore dell'app mobile per l'App Store di Apple.
GOOGLE_APP_STORE Fornitore di app mobile per lo store di app Google.

UnifiedCallAsset

Un asset di chiamata unificato.

Rappresentazione JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Campi
countryCode

string

Codice paese di due lettere del numero di telefono. Esempi: "US", "us".
phoneNumber

string

Il numero di telefono non elaborato dell'inserzionista. Esempi: "1234567890", "(123)456-7890"
callConversionReportingState

enum (CallConversionReportingState)

Indica se questo asset di chiamata deve utilizzare la propria impostazione di conversione di chiamata, seguire l'impostazione a livello di account o disattivare la conversione di chiamata.
callConversionAction

string

L'azione di conversione a cui attribuire una conversione di chiamata. Se non impostata, viene utilizzata l'azione di conversione predefinita. Questo campo ha effetto solo se callConversionReportingState è impostato su USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali la risorsa può essere pubblicata. Possono essere presenti al massimo 6 pianificazioni al giorno, 42 in totale.
callOnly

boolean

Se la chiamata mostra solo il numero di telefono senza un link al sito web. Valido per Microsoft Ads.
callTrackingEnabled

boolean

Indica se la chiamata deve essere attivata nel monitoraggio chiamate. Valido per Microsoft Ads.
useSearcherTimeZone

boolean

Se mostrare o meno l'estensione di chiamata nel fuso orario dell'utente della ricerca. Valido per Microsoft Ads.
startDate

string

Data di inizio in cui questa risorsa è effettiva e può iniziare a essere pubblicata, nel formato AAAA-MM-GG.
endDate

string

L'ultima data in cui questa risorsa è efficace e ancora pubblicata, nel formato aaaa-MM-gg.

CallConversionReportingState

Possibili tipi di dati per lo stato di un'azione di conversione di chiamata.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
DISABLED L'azione di conversione di chiamata è disattivata.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION L'azione di conversione di chiamata utilizzerà il tipo di conversione di chiamata impostato a livello di account.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION L'azione di conversione di chiamata utilizzerà il tipo di conversione di chiamata impostato a livello di risorsa (annunci di sola chiamata/estensioni di chiamata).

CallToActionAsset

Un asset di invito all'azione.

Rappresentazione JSON 
{
  "callToAction": enum (CallToActionType)
}
Campi
callToAction

enum (CallToActionType)

Invito all'azione.

CallToActionType

Enumerazione che descrive i possibili tipi di invito all'azione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
LEARN_MORE Il tipo di invito all'azione è Scopri di più.
GET_QUOTE Il tipo di invito all'azione è "Richiedi preventivo".
APPLY_NOW Il tipo di invito all'azione è "Fai domanda ora".
SIGN_UP Il tipo di invito all'azione è la registrazione.
CONTACT_US Il tipo di invito all'azione è Contattaci.
SUBSCRIBE Il tipo di invito all'azione è l'iscrizione.
DOWNLOAD Il tipo di invito all'azione è download.
BOOK_NOW Il tipo di invito all'azione è Prenota ora.
SHOP_NOW Il tipo di invito all'azione è Acquista ora.
BUY_NOW Il tipo di invito all'azione è "Acquista ora".
DONATE_NOW Il tipo di invito all'azione è Dona ora.
ORDER_NOW Il tipo di invito all'azione è Ordina ora.
PLAY_NOW Il tipo di invito all'azione è "Gioca ora".
SEE_MORE Il tipo di invito all'azione è Mostra altro.
START_NOW Il tipo di invito all'azione è Inizia ora.
VISIT_SITE Il tipo di invito all'azione è visita il sito.
WATCH_NOW Il tipo di invito all'azione è Guarda ora.

UnifiedLocationAsset

Un asset posizione unificato.

Rappresentazione JSON 
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Campi
placeId

string

Gli ID luogo identificano in modo univoco un luogo nel database di Google Places e su Google Maps. Questo campo è univoco per un determinato ID cliente e tipo di asset. Per saperne di più sull'ID luogo, visita la pagina https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

L'elenco delle sedi dell'attività commerciale per il cliente. Questo valore viene restituito solo se l'asset posizione viene sincronizzato dall'account Profilo dell'attività. È possibile avere più schede del profilo dell'attività nello stesso account che rimandano allo stesso ID luogo.
locationOwnershipType

enum (LocationOwnershipType)

Il tipo di proprietà della sede. Se il tipo è BUSINESS_OWNER, verrà pubblicato come estensione di località. Se il tipo è AFFILIATE, verrà pubblicata come sede della società consociata.

BusinessProfileLocation

Dati sulla posizione del profilo dell'attività sincronizzati dall'account del profilo dell'attività collegato.

Rappresentazione JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Campi
labels[]

string

Etichetta specificata dall'inserzionista per la sede nell'account Profilo dell'attività. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività.
storeCode

string

Il codice negozio del profilo dell'attività di questa sede. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività.
listingId

string (int64 format)

ID scheda di questa sede del profilo dell'attività. Queste informazioni vengono sincronizzate dall'account Profilo dell'attività collegato.

LocationOwnershipType

Possibili tipi di proprietà di una sede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
BUSINESS_OWNER Proprietario dell'attività della sede(estensione di località legacy).
AFFILIATE Estensione di località dell'affiliato(estensione di località di terze parti).

AssetGroupAsset

AssetGroupAsset è il collegamento tra un asset e un gruppo di asset. L'aggiunta di un AssetGroupAsset collega un asset a un gruppo di asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Campi
resourceName

string

Il nome della risorsa dell'asset del gruppo di asset. Il nome della risorsa asset del gruppo di asset ha il formato:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

Il gruppo di asset a cui è collegato questo asset del gruppo di asset.
asset

string

L'asset a cui è collegato questo asset del gruppo di asset.
fieldType

enum (AssetFieldType)

La descrizione del posizionamento dell'asset all'interno del gruppo di asset. Ad esempio: HEADLINE, YOUTUBE_VIDEO ecc.
status

enum (AssetLinkStatus)

Lo stato del collegamento tra una risorsa e un gruppo di asset.

AssetFieldType

Enumerazione che descrive i possibili posizionamenti di una risorsa.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
HEADLINE L'asset è collegato per essere utilizzato come titolo.
DESCRIPTION L'asset è collegato per essere utilizzato come descrizione.
MANDATORY_AD_TEXT L'asset è collegato per essere utilizzato come testo dell'annuncio obbligatorio.
MARKETING_IMAGE L'asset è collegato per essere utilizzato come immagine di marketing.
MEDIA_BUNDLE L'asset è collegato per essere utilizzato come bundle multimediale.
YOUTUBE_VIDEO La risorsa è collegata per essere utilizzata come video di YouTube.
BOOK_ON_GOOGLE L'asset è collegato per indicare che una campagna per hotel è abilitata per "Prenota su Google".
LEAD_FORM L'asset è collegato per essere utilizzato come estensione modulo per i lead.
PROMOTION L'asset è collegato per essere utilizzato come estensione di promozione.
CALLOUT L'asset è collegato per essere utilizzato come estensione callout.
STRUCTURED_SNIPPET L'asset è collegato per essere utilizzato come estensione snippet strutturato.
MOBILE_APP L'asset è collegato per essere utilizzato come estensione per app mobile.
HOTEL_CALLOUT L'asset è collegato per essere utilizzato come estensione callout per hotel.
CALL L'asset è collegato per essere utilizzato come estensione di chiamata.
PRICE L'asset è collegato per essere utilizzato come estensione di prezzo.
LONG_HEADLINE L'asset è collegato per essere utilizzato come titolo lungo.
BUSINESS_NAME L'asset è collegato per essere utilizzato come nome dell'attività.
SQUARE_MARKETING_IMAGE L'asset è collegato per essere utilizzato come immagine di marketing quadrata.
PORTRAIT_MARKETING_IMAGE L'asset è collegato per essere utilizzato come immagine verticale di marketing.
VIDEO La risorsa è collegata per essere utilizzata come logo non di YouTube.
CALL_TO_ACTION_SELECTION L'asset è collegato per l'utilizzo alla selezione di un invito all'azione.
AD_IMAGE L'asset è collegato per essere utilizzato per selezionare un'immagine dell'annuncio.
HOTEL_PROPERTY L'asset è collegato per essere utilizzato come hotel in una campagna Performance Max per gli obiettivi di viaggio.
LONG_DESCRIPTION L'asset è collegato per essere utilizzato come descrizione lunga.
CALL_TO_ACTION L'asset è collegato per essere utilizzato come invito all'azione.

AssetGroupSignal

AssetGroupSignal rappresenta un indicatore in un gruppo di asset. L'esistenza di un indicatore indica alla campagna Performance Max gli utenti che hanno maggiori probabilità di generare conversioni. Performance Max utilizza l'indicatore per cercare nuovi utenti che dimostrano un interesse simile o superiore al tuo nel trovare conversioni sulla rete di ricerca, sulla Rete Display, sulla rete video e su altri tipi.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Campi
resourceName

string

Il nome della risorsa dell'indicatore del gruppo di asset. Il nome della risorsa dell'indicatore del gruppo di asset ha il formato:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

Il gruppo di asset a cui appartiene questo indicatore del gruppo di asset.
Campo unione signal. L'indicatore del gruppo di asset. signal può essere solo uno dei seguenti:
audience

object (AudienceInfo)

L'indicatore del segmento di pubblico da utilizzare nella campagna Performance Max.

AudienceInfo

Un criterio per i segmenti di pubblico.

Rappresentazione JSON 
{
  "audience": string
}
Campi
audience

string

Nome risorsa pubblico.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter rappresenta un nodo dell'albero dei filtri del gruppo di schede in un gruppo di asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Campi
resourceName

string

Il nome della risorsa del filtro dell'elenco di gruppo degli asset. Il nome della risorsa del filtro dell'elenco di gruppo degli asset ha il formato:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

Il gruppo di asset di cui fa parte questo filtro dell'elenco di gruppo degli asset.
id

string (int64 format)

L'ID di ListingGroupFilter.
type

enum (ListingGroupFilterType)

Tipo di nodo del filtro del gruppo di schede.
vertical

enum (ListingGroupFilterVertical)

La verticale che rappresenta l'albero dei nodi corrente. Tutti i nodi dello stesso albero devono appartenere allo stesso verticale.
caseValue

object (ListingGroupFilterDimension)

Il valore della dimensione con cui questo gruppo di schede perfeziona il gruppo principale. Indefinito per il gruppo root.
parentListingGroupFilter

string

Nome della risorsa della suddivisione del gruppo di schede principale. Null per il nodo del filtro del gruppo di schede principale.
path

object (ListingGroupFilterDimensionPath)

Il percorso delle dimensioni che definiscono questo filtro del gruppo di schede.

ListingGroupFilterType

Il tipo di filtro del gruppo di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SUBDIVISION Suddivisione dei prodotti in base ad alcune dimensioni dell'elenco.
UNIT_INCLUDED Un nodo foglia del filtro del gruppo di schede incluso.
UNIT_EXCLUDED Un nodo foglia del filtro del gruppo di schede escluso.

ListingGroupFilterVertical

Il tipo di verticale del filtro del gruppo di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SHOPPING Rappresenta il verticale Shopping. La verticale è consentita solo nelle campagne Performance Max per la vendita al dettaglio.

ListingGroupFilterDimension

Dimensioni delle schede per il filtro dell'elenco di gruppo degli asset.

Rappresentazione JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Campi
Campo unione dimension. È sempre presente una dimensione di uno dei tipi riportati di seguito. dimension può essere solo uno dei seguenti:
productBiddingCategory

object (ProductBiddingCategory)

Categoria di offerta di un prodotto.
productBrand

object (ProductBrand)

Il brand di un'offerta di prodotto.
productChannel

object (ProductChannel)

Località di un'offerta di prodotto.
productCondition

object (ProductCondition)

Condizione di un'offerta di prodotto.
productCustomAttribute

object (ProductCustomAttribute)

Attributo personalizzato di un'offerta di prodotto.
productItemId

object (ProductItemId)

ID articolo di un'offerta di prodotto.
productType

object (ProductType)

Tipo di offerta di un prodotto.

ProductBiddingCategory

Un elemento di una categoria di offerta a un determinato livello. Le categorie di primo livello si trovano al livello 1, le relative categorie secondarie al livello 2 e così via. Al momento supportiamo fino a 5 livelli. L'utente deve specificare un tipo di dimensione che indichi il livello della categoria. Tutti i casi della stessa suddivisione devono avere lo stesso tipo di dimensione (livello di categoria).

Rappresentazione JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Campi
level

enum (ListingGroupFilterBiddingCategoryLevel)

Indica il livello della categoria nella tassonomia.
id

string (int64 format)

ID della categoria di offerta del prodotto.

Questo ID è equivalente all'ID google_product_category [categoria_prodotto_google] descritto in questo articolo: https://support.google.com/merchants/answer/6324436

ListingGroupFilterBiddingCategoryLevel

Il livello della categoria di offerta del filtro del gruppo di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
LEVEL1 Livello 1.
LEVEL2 Livello 2.
LEVEL3 Livello 3.
LEVEL4 Livello 4.
LEVEL5 Livello 5.

ProductBrand

La marca del prodotto.

Rappresentazione JSON 
{
  "value": string
}
Campi
value

string

Valore stringa del brand del prodotto.

ProductChannel

Località di un'offerta di prodotto.

Rappresentazione JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Campi
channel

enum (ListingGroupFilterProductChannel)

Valore della località.

ListingGroupFilterProductChannel

Enumerazione che descrive la località di un'offerta di prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ONLINE L'articolo viene venduto online.
LOCAL L'articolo viene venduto nei negozi locali.

ProductCondition

Condizione di un'offerta di prodotto.

Rappresentazione JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Campi
condition

enum (ListingGroupFilterProductCondition)

Valore della condizione.

ListingGroupFilterProductCondition

Enumerazione che descrive la condizione di un'offerta di prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
NEW La condizione del prodotto è nuova.
REFURBISHED La condizione del prodotto è ricondizionato.
USED La condizione del prodotto è "Usato".

ProductCustomAttribute

Attributo personalizzato di un'offerta di prodotto.

Rappresentazione JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Campi
index

enum (ListingGroupFilterCustomAttributeIndex)

Indica l'indice dell'attributo personalizzato.
value

string

Valore stringa dell'attributo personalizzato del prodotto.

ListingGroupFilterCustomAttributeIndex

L'indice degli attributi cliente.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
INDEX0 Primo attributo personalizzato del filtro del gruppo di schede.
INDEX1 Secondo attributo personalizzato del filtro del gruppo di schede.
INDEX2 Attributo personalizzato del terzo filtro del gruppo di schede.
INDEX3 Quarto attributo personalizzato del filtro del gruppo di schede.
INDEX4 Quinto attributo personalizzato del filtro del gruppo di schede.

ProductItemId

ID articolo di un'offerta di prodotto.

Rappresentazione JSON 
{
  "value": string
}
Campi
value

string

Valore dell'ID.

ProductType

Tipo di offerta di un prodotto.

Rappresentazione JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Campi
level

enum (ListingGroupFilterProductTypeLevel)

Il livello del tipo.
value

string

Valore del tipo.

ListingGroupFilterProductTypeLevel

Enumerazione che descrive il livello del tipo di offerta di un prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
LEVEL1 Livello 1.
LEVEL2 Livello 2.
LEVEL3 Livello 3.
LEVEL4 Livello 4.
LEVEL5 Livello 5.

ListingGroupFilterDimensionPath

Il percorso che definisce le dimensioni che definiscono un filtro del gruppo di schede.

Rappresentazione JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
Campi
dimensions[]

object (ListingGroupFilterDimension)

Il percorso completo delle dimensioni nella gerarchia dei filtri dei gruppi di schede (escluso il nodo radice) fino a questo filtro del gruppo di schede.

AssetGroupTopCombinationView

Una visualizzazione dell'utilizzo delle migliori combinazioni di asset dei gruppi di asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione della combinazione principale del gruppo di asset. I nomi delle risorse della visualizzazione Combinazione principale del gruppo di asset hanno il formato: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Le principali combinazioni di asset pubblicati insieme.

AssetGroupAssetCombinationData

Dati sulle combinazioni di asset del gruppo di asset

Rappresentazione JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Campi
assetCombinationServedAssets[]

object (AssetUsage)

Asset pubblicati.

AssetUsage

Contiene le informazioni sull'utilizzo dell'asset.

Rappresentazione JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Campi
asset

string

Nome della risorsa dell'asset.
servedAssetFieldType

enum (ServedAssetFieldType)

Il tipo di campo pubblicato dell'asset.

ServedAssetFieldType

I tipi di campi asset possibili.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
HEADLINE_1 L'asset viene utilizzato nel titolo 1.
HEADLINE_2 L'asset viene utilizzato nel titolo 2.
HEADLINE_3 L'asset viene utilizzato nel titolo 3.
DESCRIPTION_1 L'asset viene utilizzato nella descrizione 1.
DESCRIPTION_2 L'asset viene utilizzato nella descrizione 2.
HEADLINE L'asset è stato utilizzato in un titolo. Utilizza questo valore solo se nell'annuncio è presente un solo titolo. In caso contrario, utilizza le enumerazioni HEADLINE_1, HEADLINE_2 o HEADLINE_3.
HEADLINE_IN_PORTRAIT L'asset è stato utilizzato come titolo nell'immagine verticale.
LONG_HEADLINE L'asset è stato utilizzato in un titolo lungo (utilizzato in MultiAssetResponsiveAd).
DESCRIPTION L'asset è stato utilizzato in una descrizione. Utilizza questo valore solo se nell'annuncio è presente una sola descrizione. In caso contrario, utilizza gli enum DESCRIPTION_1 o DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT L'asset è stato utilizzato come descrizione nell'immagine verticale.
BUSINESS_NAME_IN_PORTRAIT L'asset è stato utilizzato come nome dell'attività nell'immagine verticale.
BUSINESS_NAME L'asset è stato utilizzato come nome dell'attività.
MARKETING_IMAGE L'asset è stato utilizzato come immagine di marketing.
MARKETING_IMAGE_IN_PORTRAIT L'asset è stato utilizzato come immagine di marketing in formato verticale.
SQUARE_MARKETING_IMAGE L'asset è stato utilizzato come immagine di marketing quadrata.
PORTRAIT_MARKETING_IMAGE L'asset è stato utilizzato come immagine verticale di marketing.
CALL_TO_ACTION L'asset è stato utilizzato come invito all'azione.
YOU_TUBE_VIDEO L'asset è stato utilizzato come video di YouTube.
CALL Questo asset viene utilizzato come chiamata.
MOBILE_APP Questo asset viene utilizzato come app mobile.
CALLOUT Questo asset viene utilizzato come callout.
STRUCTURED_SNIPPET Questa risorsa viene utilizzata come snippet strutturato.
PRICE Questa risorsa viene utilizzata come prezzo.
PROMOTION Questa risorsa viene utilizzata come promozione.
AD_IMAGE Questo asset viene utilizzato come immagine.
LEAD_FORM L'asset viene utilizzato come modulo per i lead.
DESCRIPTION_PREFIX L'asset viene utilizzato come prefisso della descrizione.

AssetGroup

Un gruppo di asset. AssetGroupAsset viene utilizzato per collegare un asset al gruppo di asset. AssetGroupSignal viene utilizzato per associare un indicatore a un gruppo di asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Campi
resourceName

string

Il nome della risorsa del gruppo di asset. I nomi delle risorse del gruppo di asset hanno il formato:

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

L'ID del gruppo di asset.
campaign

string

La campagna a cui è associato questo gruppo di asset. L'asset collegato al gruppo di asset.
name

string

Obbligatorio. Il nome del gruppo di asset. Obbligatorio. Deve avere una lunghezza minima di 1 e una lunghezza massima di 128. Deve essere univoco in una campagna.
finalUrls[]

string

Un elenco di URL finali dopo tutti i reindirizzamenti cross-domain. In Performance Max, per impostazione predefinita, gli URL sono idonei all'espansione, a meno che non venga disattivata.
finalMobileUrls[]

string

Un elenco di URL mobile finali dopo tutti i reindirizzamenti cross-domain. In Performance Max, per impostazione predefinita, gli URL sono idonei all'espansione, a meno che non venga disattivata.
status

enum (AssetGroupStatus)

Lo stato del gruppo di asset.
path1

string

La prima parte del testo che potrebbe essere aggiunta all'URL visualizzato nell'annuncio.
path2

string

Seconda parte del testo che potrebbe essere aggiunto all'URL visualizzato nell'annuncio. Questo campo può essere impostato solo quando è impostato path1.
adStrength

enum (AdStrength)

Efficacia dell'annuncio complessiva di questo gruppo di asset.

AssetGroupStatus

I possibili stati di un gruppo di asset.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione.
ENABLED Il gruppo di asset è attivato.
PAUSED Il gruppo di asset è in pausa.
REMOVED Il gruppo di asset viene rimosso.

AdStrength

Enumerazione che elenca le possibili efficacie dell'annuncio.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
PENDING L'efficacia dell'annuncio è attualmente in attesa.
NO_ADS Impossibile generare annunci.
POOR Efficacia scarsa.
AVERAGE Intensità media.
GOOD Buona forza.
EXCELLENT Ottima forza.

AssetSetAsset

AssetSetAsset è il collegamento tra una risorsa e un insieme di asset. L'aggiunta di un AssetSetAsset collega un asset a un insieme di asset.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Campi
resourceName

string

Il nome della risorsa dell'asset dell'insieme di asset. I nomi delle risorse degli asset dei set di asset hanno il formato:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

L'insieme di asset a cui è collegato questo asset dell'insieme.
asset

string

L'asset a cui è collegato questo asset dell'insieme.
status

enum (AssetSetAssetStatus)

Lo stato dell'asset dell'insieme. Sola lettura.

AssetSetAssetStatus

Gli stati possibili di un asset dell'insieme.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
ENABLED L'asset dell'insieme di asset è attivato.
REMOVED L'asset del set di asset viene rimosso.

AssetSet

Un insieme di asset che rappresenta una raccolta di asset. Utilizza AssetSetAsset per collegare un asset all'insieme di asset.

Rappresentazione JSON 
{
  "id": string,
  "resourceName": string
}
Campi
id

string (int64 format)

L'ID del set di asset.
resourceName

string

Il nome della risorsa del set di asset. I nomi delle risorse dei set di asset hanno il seguente formato:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Una strategia di offerta.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Campi
resourceName

string

Il nome della risorsa della strategia di offerta. I nomi delle risorse della strategia di offerta hanno il seguente formato:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

Lo stato della strategia di offerta.

Questo campo è di sola lettura.
type

enum (BiddingStrategyType)

Il tipo di strategia di offerta. Crea una strategia di offerta impostando lo schema di offerta.

Questo campo è di sola lettura.
currencyCode

string

La valuta utilizzata dalla strategia di offerta (codice ISO 4217 di tre lettere).

Per le strategie di offerta nei clienti amministratore, questa valuta può essere impostata al momento della creazione e viene impostata per impostazione predefinita sulla valuta del cliente amministratore. Per i clienti associati a un account di pubblicazione, questo campo non può essere impostato; tutte le strategie in un cliente associato a un account di pubblicazione utilizzano implicitamente la valuta del cliente associato a un account di pubblicazione. In tutti i casi, il campo effectiveCurrencyCode restituisce la valuta utilizzata dalla strategia.
id

string (int64 format)

L'ID della strategia di offerta.
name

string

Il nome della strategia di offerta. Tutte le strategie di offerta all'interno di un account devono avere un nome distinto.

La lunghezza di questa stringa deve essere compresa tra 1 e 255 byte inclusi in UTF-8 (tagliata).
effectiveCurrencyCode

string

La valuta utilizzata dalla strategia di offerta (codice ISO 4217 di tre lettere).

Per le strategie di offerta nei clienti amministratore, questa è la valuta impostata dall'inserzionista al momento della creazione della strategia. Per i clienti, questo è il currencyCode del cliente.

Le metriche della strategia di offerta sono riportate in questa valuta.

Questo campo è di sola lettura.
campaignCount

string (int64 format)

Il numero di campagne associate a questa strategia di offerta.

Questo campo è di sola lettura.
nonRemovedCampaignCount

string (int64 format)

Il numero di campagne non rimosse associate a questa strategia di offerta.

Questo campo è di sola lettura.

Campo unione scheme. Lo schema di offerta.

È possibile impostarne solo uno. scheme può essere solo uno dei seguenti:
enhancedCpc

object (EnhancedCpc)

Una strategia di offerta che aumenta le offerte per i clic che sembrano avere maggiori probabilità di generare una conversione e le riduce per i clic che sembrano avere minori probabilità.
maximizeConversionValue

object (MaximizeConversionValue)

Una strategia di offerta automatica che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.
maximizeConversions

object (MaximizeConversions)

Una strategia di offerta automatica che ti aiuta a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget.
targetCpa

object (TargetCpa)

Una strategia di offerta che imposta le offerte in modo da generare il maggior numero possibile di conversioni al costo per acquisizione (CPA) target da te impostato.
targetImpressionShare

object (TargetImpressionShare)

Una strategia di offerta che esegue automaticamente l'ottimizzazione in base a una percentuale di impressioni scelta.
targetOutrankShare

object (TargetOutrankShare)

Una strategia di offerta che imposta le offerte in base alla frazione target di aste in cui l'inserzionista deve superare in ranking un concorrente specifico. Campo obsoleto. La creazione di una nuova strategia di offerta con questo campo o l'associazione di strategie di offerta con questo campo a una campagna non andrà a buon fine. Sono consentite le modifiche alle strategie in cui questo schema è già compilato.
targetRoas

object (TargetRoas)

Una strategia di offerta che ti aiuta a massimizzare le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
targetSpend

object (TargetSpend)

Una strategia di offerta che imposta le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget.

BiddingStrategyStatus

I possibili stati di una strategia di offerta.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED La strategia di offerta è attivata.
REMOVED La strategia di offerta viene rimossa.

BiddingStrategyType

Enumerazione che descrive i possibili tipi di strategia di offerta.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
COMMISSION Commissione è una strategia di offerta automatica in cui l'inserzionista paga una determinata parte del valore di conversione.
ENHANCED_CPC Il CPC ottimizzato è una strategia di offerta che aumenta le offerte per i clic che sembrano avere maggiori probabilità di generare una conversione e le riduce per i clic che sembrano avere meno probabilità di generare una conversione.
INVALID Utilizzato solo per il valore restituito. Indica che una campagna non ha una strategia di offerta. Ciò impedisce la pubblicazione della campagna. Ad esempio, una campagna può essere collegata a una strategia di offerta dell'account amministratore e l'account di pubblicazione viene successivamente scollegato dall'account amministratore. In questo caso, la campagna verrà automaticamente scollegata dalla strategia di offerta del gestore ora inaccessibile e passerà al tipo di strategia di offerta NON VALIDA.
MANUAL_CPA Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta per azione specificata dall'inserzionista.
MANUAL_CPC Offerte manuali basate sui clic in cui l'utente paga per clic.
MANUAL_CPM Offerte manuali basate sulle impressioni in cui l'utente paga per mille impressioni.
MANUAL_CPV Una strategia di offerta che paga un importo configurabile per ogni visualizzazione del video.
MAXIMIZE_CONVERSIONS Una strategia di offerta che massimizza automaticamente il numero di conversioni in base a un budget giornaliero.
MAXIMIZE_CONVERSION_VALUE Una strategia di offerta automatica che imposta automaticamente le offerte in modo da massimizzare le entrate nei limiti di spesa del budget.
PAGE_ONE_PROMOTED Schema di offerta Promozione nella prima pagina, che imposta le offerte CPC max per indirizzare le impressioni nella prima pagina o negli spazi Promozione nella prima pagina su google.com. Questo valore enum è ritirato.
PERCENT_CPC Il CPC percentuale è una strategia di offerta in cui le offerte sono una frazione del prezzo pubblicizzato di un bene o servizio.
TARGET_CPA Il CPA target è una strategia di offerta automatica che imposta le offerte in modo da generare il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato.
TARGET_CPM Il CPM target è una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero possibile di impressioni al costo per mille impressioni (CPM) target che hai impostato.
TARGET_IMPRESSION_SHARE Una strategia di offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga mostrata nella parte superiore della prima pagina (o in un'altra posizione target).
TARGET_OUTRANK_SHARE Quota superamento target è una strategia di offerta automatica che imposta le offerte in base alla frazione target di aste in cui l'inserzionista deve superare un concorrente specifico. Questo valore enum è obsoleto.
TARGET_ROAS Il ROAS target è una strategia di offerta automatica che ti aiuta a massimizzare le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
TARGET_SPEND Spesa target è una strategia di offerta automatica che imposta le offerte in modo da farti ottenere il maggior numero possibile di clic in base al tuo budget.

EnhancedCpc

Questo tipo non contiene campi.

Una strategia di offerta automatica che aumenta le offerte per i clic che sembrano avere maggiori probabilità di generare una conversione e le diminuisce per i clic che sembrano avere minori probabilità.

Questa strategia di offerta è deprecata e non può più essere creata. Utilizza ManualCpc con enhancedCpcEnabled impostato su true per una funzionalità equivalente.

MaximizeConversionValue

Una strategia di offerta automatica che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.

Rappresentazione JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Campi
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.
cpcBidFloorMicros

string (int64 format)

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.
targetRoas

number

L'opzione Ritorno sulla spesa pubblicitaria target (ROAS target). Se impostata, la strategia di offerta massimizza le entrate mantenendo una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non essere in grado di spendere l'intero budget. Se il ROAS target non è impostato, la strategia di offerta cercherà di raggiungere il ROAS più alto possibile per il budget.

MaximizeConversions

Una strategia di offerta automatica che ti aiuta a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget.

Rappresentazione JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Campi
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.
cpcBidFloorMicros

string (int64 format)

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Modificabile solo per le strategie di offerta di portafoglio.
targetCpaMicros

string (int64 format)

L'opzione Costo per azione (CPA) target. È l'importo medio che vuoi spendere per azione di conversione specificato in micro unità della valuta della strategia di offerta. Se impostata, la strategia di offerta genererà il maggior numero possibile di conversioni a un costo per azione target pari o inferiore a quello impostato. Se il CPA target non è impostato, la strategia di offerta cercherà di raggiungere il CPA più basso possibile in base al budget.

TargetCpa

Una strategia che imposta offerte automatiche in modo da generare il maggior numero possibile di conversioni al costo per acquisizione (CPA) target da te impostato.

Rappresentazione JSON 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Campi
targetCpaMicros

string (int64 format)

CPA target medio. Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account.
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Questa impostazione deve essere configurata solo per le strategie di offerta di portafoglio.
cpcBidFloorMicros

string (int64 format)

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Questa impostazione deve essere configurata solo per le strategie di offerta di portafoglio.

TargetImpressionShare

Una strategia di offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga mostrata nella parte superiore della prima pagina (o in un'altra posizione target).

Rappresentazione JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Campi
location

enum (TargetImpressionShareLocation)

La posizione di destinazione nella pagina dei risultati di ricerca.
locationFractionMicros

string (int64 format)

La frazione scelta di annunci da mostrare nella località di destinazione in microsecondi. Ad esempio, 1% equivale a 10.000.
cpcBidCeilingMicros

string (int64 format)

L'offerta CPC più alta che il sistema di offerta automatica è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo e specificato nei microformati locali.

TargetImpressionShareLocation

Enumerazione che descrive i possibili obiettivi.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ANYWHERE_ON_PAGE Qualsiasi posizione sulla pagina web.
TOP_OF_PAGE Contenitore superiore degli annunci.
ABSOLUTE_TOP_OF_PAGE Area superiore nel contenitore superiore degli annunci.

TargetOutrankShare

Una strategia di offerta automatica che imposta le offerte in base alla frazione target di aste in cui l'inserzionista deve superare in ranking un concorrente specifico. Questa strategia è stata ritirata.

Rappresentazione JSON 
{
  "cpcBidCeilingMicros": string
}
Campi
cpcBidCeilingMicros

string (Int64Value format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.

TargetRoas

Una strategia di offerta automatica che ti aiuta a massimizzare le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.

Rappresentazione JSON 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Campi
targetRoas

number

Obbligatorio. Le entrate scelte (in base ai dati sulle conversioni) per unità di spesa. Il valore deve essere compreso tra 0,01 e 1000,0 inclusi.
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Questa impostazione deve essere configurata solo per le strategie di offerta di portafoglio.
cpcBidFloorMicros

string (int64 format)

Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Questa impostazione deve essere configurata solo per le strategie di offerta di portafoglio.

TargetSpend

Una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget.

Rappresentazione JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Campi
targetSpendMicros
(deprecated)

string (int64 format)

Ritirato: la spesa target in base alla quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere il valore inferiore tra questo e l'importo di spesa di limitazione naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per maggiori dettagli, visita la pagina https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.

CampaignBudget

Un budget della campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Campi
resourceName

string

Il nome della risorsa del budget della campagna. I nomi delle risorse del budget della campagna hanno il seguente formato:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

Il metodo di pubblicazione che determina la velocità con cui viene speso il budget della campagna.

Se non specificato in un'operazione di creazione, il valore predefinito è STANDARD.
period

enum (BudgetPeriod)

Periodo durante il quale spendere il budget. Se non specificato, il valore predefinito è DAILY.
amountMicros

string (int64 format)

L'importo del budget, nella valuta locale dell'account. L'importo è specificato in micro, dove un milione equivale a un'unità di valuta. La spesa mensile è limitata a 30,4 volte questo importo.

BudgetDeliveryMethod

Possibili metodi di pubblicazione di un budget.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
STANDARD Il server del budget limiterà la pubblicazione in modo uniforme per l'intero periodo di tempo.
ACCELERATED Il server del budget non limiterà la pubblicazione e gli annunci verranno pubblicati il più rapidamente possibile.

BudgetPeriod

Periodo possibile di un budget.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
DAILY Budget giornaliero.
FIXED_DAILY Budget giornaliero fisso.
CUSTOM_PERIOD Il budget personalizzato può essere utilizzato con total_amount per specificare il limite di budget totale.

Campagna

Una campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Campi
resourceName

string

Il nome della risorsa della campagna. I nomi delle risorse della campagna hanno il seguente formato:

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

Lo stato della campagna.

Quando viene aggiunta una nuova campagna, lo stato predefinito è ABILITATO.
servingStatus

enum (CampaignServingStatus)

Lo stato di pubblicazione degli annunci della campagna.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Lo stato del sistema della strategia di offerta della campagna.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

Lo stato di ottimizzazione della pubblicazione degli annunci della campagna.
advertisingChannelType

enum (AdvertisingChannelType)

Il target di pubblicazione principale per gli annunci all'interno della campagna. Le opzioni di targeting possono essere perfezionate in networkSettings.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne.

Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

Raffinamento facoltativo di advertisingChannelType. Deve essere un sottotipo valido del tipo di canale principale.

Può essere impostato solo durante la creazione delle campagne. Una volta creata la campagna, il campo non può essere modificato.
urlCustomParameters[]

object (CustomParameter)

L'elenco dei mapping utilizzati per sostituire i tag dei parametri personalizzati in un trackingUrlTemplate, finalUrls o mobile_final_urls.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la rete Ad Exchange.
networkSettings

object (NetworkSettings)

Le impostazioni di rete per la campagna.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA).
shoppingSetting

object (ShoppingSetting)

L'impostazione per controllare le campagne Shopping.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

L'impostazione per il geotargeting degli annunci.
effectiveLabels[]

string

I nomi delle risorse delle etichette effettive associate a questa campagna. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questa campagna.
labels[]

string

I nomi delle risorse delle etichette associate a questa campagna.
biddingStrategyType

enum (BiddingStrategyType)

Il tipo di strategia di offerta.

Una strategia di offerta può essere creata impostando lo schema di offerta per creare una strategia di offerta standard o il campo biddingStrategy per creare una strategia di offerta di portafoglio.

Questo campo è di sola lettura.
accessibleBiddingStrategy

string

Nome della risorsa AccessibleBiddingStrategy, una visualizzazione di sola lettura degli attributi senza limitazioni della strategia di offerta di portafoglio collegata identificata da "biddingStrategy". Vuoto, se la campagna non utilizza una strategia di portafoglio. Gli attributi della strategia senza limitazioni sono disponibili per tutti i clienti con cui la strategia è condivisa e vengono letti dalla risorsa AccessibleBiddingStrategy. Al contrario, gli attributi con limitazioni sono disponibili solo per il cliente proprietario della strategia e i suoi gestori. Gli attributi con limitazioni possono essere letti solo dalla risorsa BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

Un elenco che limita la frequenza con cui ogni utente vedrà gli annunci di questa campagna.
selectiveOptimization

object (SelectiveOptimization)

Impostazione di ottimizzazione selettiva per questa campagna, che include un insieme di azioni di conversione per cui ottimizzare la campagna. Questa funzionalità si applica solo alle campagne per app che utilizzano MULTI_CHANNEL come AdvertisingChannelType e APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT come AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

Impostazione dell'obiettivo di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.
trackingSetting

object (TrackingSetting)

Impostazioni a livello di campagna per le informazioni di monitoraggio.
engineId

string

ID della campagna nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza invece "campaign.id".
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

I tipi di campi asset da escludere da questa campagna. I link asset con questi tipi di campi non verranno ereditati da questa campagna dal livello superiore.
createTime

string

Il timestamp di creazione di questa campagna. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss". createTime verrà ritirato nella v1. Utilizza invece creationTime.
creationTime

string

Il timestamp di creazione di questa campagna. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questa campagna. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
feedTypes[]

enum (AssetSetType)

Tipi di feed collegati direttamente a questa campagna.
id

string (int64 format)

L'ID della campagna.
name

string

Il nome della campagna.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuove campagne.

Non deve contenere caratteri null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio.
campaignBudget

string

Il nome della risorsa del budget della campagna.
startDate

string

La data di inizio della campagna nel fuso orario del cliente nel formato AAAA-MM-GG.
endDate

string

L'ultimo giorno della campagna nel fuso orario del cliente nel formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 30/12/2037, il che significa che la campagna verrà pubblicata a tempo indeterminato. Per impostare una campagna esistente in modo che venga pubblicata a tempo indeterminato, imposta questo campo su 2037-12-30.
finalUrlSuffix

string

Suffisso utilizzato per aggiungere parametri di query alle pagine di destinazione pubblicate con il monitoraggio parallelo.
urlExpansionOptOut

boolean

Rappresenta la disattivazione dell'espansione dell'URL a URL più mirati. Se l'espansione è disattivata (true), vengono presi di mira solo gli URL finali nel gruppo di asset o gli URL specificati nei feed di dati aziendali o di Google Merchant Center dell'inserzionista. Se è attivata (false), verrà scelto come target l'intero dominio. Questo campo può essere impostato solo per le campagne Performance Max, dove il valore predefinito è false.

Campo unione campaign_bidding_strategy. La strategia di offerta per la campagna.

Deve essere di portafoglio (creata tramite il servizio BiddingStrategy) o standard, ovvero incorporata nella campagna. campaign_bidding_strategy può essere solo uno dei seguenti:
biddingStrategy

string

Il nome risorsa della strategia di offerta di portafoglio utilizzata dalla campagna.
manualCpa

object (ManualCpa)

Strategia di offerta CPA manuale standard. Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta per azione specificata dall'inserzionista. Supportato solo per le campagne Servizi locali.
manualCpc

object (ManualCpc)

Strategia di offerta CPC manuale standard. Offerta manuale basata sui clic in cui l'utente paga per clic.
manualCpm

object (ManualCpm)

Strategia di offerta CPM manuale standard. Offerta manuale basata sulle impressioni in cui l'utente paga per mille impressioni.
maximizeConversions

object (MaximizeConversions)

Strategia di offerta standard Massimizza le conversioni che massimizza automaticamente il numero di conversioni entro i limiti di spesa del budget.
maximizeConversionValue

object (MaximizeConversionValue)

Strategia di offerta standard Massimizza il valore di conversione che imposta automaticamente le offerte per massimizzare le entrate entro i limiti di spesa del budget.
targetCpa

object (TargetCpa)

Strategia di offerta basata sul CPA target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target che hai definito.
targetImpressionShare

object (TargetImpressionShare)

Strategia di offerta basata sulla quota impressioni target. Una strategia di offerta automatica che imposta le offerte in modo da raggiungere una percentuale di impressioni scelta.
targetRoas

object (TargetRoas)

Strategia di offerta ROAS target standard che massimizza automaticamente le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
targetSpend

object (TargetSpend)

Strategia di offerta Spesa target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget.
percentCpc

object (PercentCpc)

Strategia di offerta basata sul CPC percentuale standard in cui le offerte sono una frazione del prezzo pubblicizzato per alcuni beni o servizi.
targetCpm

object (TargetCpm)

Una strategia di offerta che ottimizza automaticamente il costo per mille impressioni.

CampaignStatus

Possibili stati di una campagna.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED La campagna è attiva e può pubblicare annunci.
PAUSED La campagna è stata messa in pausa dall'utente.
REMOVED La campagna è stata rimossa.

CampaignServingStatus

Possibili stati di pubblicazione di una campagna.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
SERVING Pubblicazione in corso.
NONE Nessuno.
ENDED Terminato.
PENDING In attesa.
SUSPENDED Sospeso.

BiddingStrategySystemStatus

I possibili stati del sistema di una BiddingStrategy.

Enum
UNSPECIFIED Indica che si è verificato un errore imprevisto, ad esempio non è stato trovato alcun tipo di strategia di offerta o alcuna informazione sullo stato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED La strategia di offerta è attiva e AdWords non è in grado di individuare problemi specifici nella strategia.
LEARNING_NEW La strategia di offerta è in fase di apprendimento perché è stata creata o riattivata di recente.
LEARNING_SETTING_CHANGE La strategia di offerta è in fase di apprendimento a causa di una recente modifica delle impostazioni.
LEARNING_BUDGET_CHANGE La strategia di offerta è in fase di apprendimento a causa di una recente modifica del budget.
LEARNING_COMPOSITION_CHANGE La strategia di offerta è in fase di apprendimento a causa della recente modifica del numero di campagne, gruppi di annunci o parole chiave ad essa associati.
LEARNING_CONVERSION_TYPE_CHANGE La strategia di offerta dipende dai report sulle conversioni e il cliente ha modificato di recente i tipi di conversione pertinenti per la strategia di offerta.
LEARNING_CONVERSION_SETTING_CHANGE La strategia di offerta dipende dai report sulle conversioni e il cliente ha modificato di recente le impostazioni di conversione.
LIMITED_BY_CPC_BID_CEILING La strategia di offerta è limitata dal limite massimo di offerta.
LIMITED_BY_CPC_BID_FLOOR La strategia di offerta è limitata dal prezzo di riserva.
LIMITED_BY_DATA La strategia di offerta è limitata perché nelle ultime settimane non è stato generato traffico di conversione sufficiente.
LIMITED_BY_BUDGET Una parte significativa delle parole chiave in questa strategia di offerta è limitata dal budget.
LIMITED_BY_LOW_PRIORITY_SPEND La strategia di offerta non può raggiungere la spesa target perché la spesa è stata declassata.
LIMITED_BY_LOW_QUALITY Una parte significativa delle parole chiave in questa strategia di offerta ha un punteggio di qualità basso.
LIMITED_BY_INVENTORY La strategia di offerta non può spendere completamente il budget a causa del targeting ristretto.
MISCONFIGURED_ZERO_ELIGIBILITY Monitoraggio delle conversioni mancante (nessun ping presente) e/o elenchi per il remarketing per SSC.
MISCONFIGURED_CONVERSION_TYPES La strategia di offerta dipende dai report sulle conversioni e il cliente non dispone di tipi di conversione che potrebbero essere segnalati in base a questa strategia.
MISCONFIGURED_CONVERSION_SETTINGS La strategia di offerta dipende dai report sulle conversioni e le impostazioni di conversione del cliente non sono configurate correttamente.
MISCONFIGURED_SHARED_BUDGET Esistono campagne esterne alla strategia di offerta che condividono i budget con le campagne incluse nella strategia.
MISCONFIGURED_STRATEGY_TYPE La campagna ha un tipo di strategia non valido e non viene pubblicata.
PAUSED La strategia di offerta non è attiva. Non sono associate campagne, gruppi di annunci o parole chiave attivi alla strategia di offerta. Oppure non sono presenti budget attivi collegati alla strategia di offerta.
UNAVAILABLE Al momento questa strategia di offerta non supporta i report sullo stato.
MULTIPLE_LEARNING Durante il periodo in questione, per questa strategia di offerta sono stati registrati più stati di sistema LEARNING_*.
MULTIPLE_LIMITED Durante il periodo in questione, per questa strategia di offerta sono stati rilevati più stati del sistema LIMITATO_*.
MULTIPLE_MISCONFIGURED Durante il periodo in questione, per questa strategia di offerta sono stati rilevati più stati del sistema MISCONFIGURED_*.
MULTIPLE Durante il periodo in questione, questa strategia di offerta ha avuto più stati del sistema.

AdServingOptimizationStatus

Enumerazione che descrive i possibili stati di pubblicazione.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
OPTIMIZE La pubblicazione degli annunci viene ottimizzata in base al CTR della campagna.
CONVERSION_OPTIMIZE La pubblicazione degli annunci viene ottimizzata in base a CTR * Conversione per la campagna. Se la campagna non utilizza la strategia di offerta Ottimizza le conversioni, verrà impostata per impostazione predefinita su OTTIMIZZATA.
ROTATE Gli annunci vengono ruotati in modo uniforme per 90 giorni, poi vengono ottimizzati per i clic.
ROTATE_INDEFINITELY Mostra gli annunci con rendimento più scarso in modo più uniforme insieme ad annunci con rendimento più elevato e non ottimizzare.
UNAVAILABLE Lo stato dell'ottimizzazione della pubblicazione di annunci non è disponibile.

AdvertisingChannelType

Enumerazione che descrive i vari tipi di canali pubblicitari.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SEARCH Rete di ricerca. Include campagne display in bundle e Search+.
DISPLAY Solo Rete Display di Google.
SHOPPING Le campagne Shopping vengono pubblicate sulla proprietà Shopping e nei risultati di ricerca di google.com.
HOTEL Campagne Hotel Ads.
VIDEO Campagne video.
MULTI_CHANNEL Campagne per app e campagne per app per incrementare il coinvolgimento, pubblicate su più canali.
LOCAL Campagne di annunci locali.
SMART Campagne intelligenti.
PERFORMANCE_MAX Campagne Performance Max.
LOCAL_SERVICES Campagne Servizi locali.
DISCOVERY Campagne discovery.
TRAVEL Campagne per viaggi.
SOCIAL Campagne social.

AdvertisingChannelSubType

Enumerazione che descrive i diversi sottotipi di canali.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo come valore restituito. Rappresenta il valore sconosciuto in questa versione.
SEARCH_MOBILE_APP Campagne per app mobile per la rete di ricerca.
DISPLAY_MOBILE_APP Campagne per app mobile per la rete display.
SEARCH_EXPRESS Campagne AdWords Express per la rete di ricerca.
DISPLAY_EXPRESS Campagne AdWords Express per il display.
SHOPPING_SMART_ADS Campagne Shopping intelligenti.
DISPLAY_GMAIL_AD Campagne pubblicitarie Gmail.
DISPLAY_SMART_CAMPAIGN Campagne display Smart. Non è possibile creare nuove campagne di questo sottotipo.
VIDEO_OUTSTREAM Campagne video outstream.
VIDEO_ACTION Campagne video TrueView for Action.
VIDEO_NON_SKIPPABLE Campagne video con annunci video non ignorabili.
APP_CAMPAIGN Campagna per app che ti consente di promuovere facilmente la tua app Android o iOS sulle principali proprietà di Google, tra cui Ricerca, Google Play, YouTube e la Rete Display di Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campagna per app per il coinvolgimento, incentrata sull'aumento del coinvolgimento con l'app in diverse delle principali proprietà di Google, tra cui Ricerca, YouTube e la Rete Display di Google.
LOCAL_CAMPAIGN Campagne specializzate per la pubblicità locale.
SHOPPING_COMPARISON_LISTING_ADS Campagne per il confronto di Shopping.
SMART_CAMPAIGN Campagne intelligenti standard.
VIDEO_SEQUENCE Campagne video con annunci video in sequenza.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campagna per app per la preregistrazione, specializzata nella pubblicità della preregistrazione di app mobile, che ha come target più canali pubblicitari su Google Play, YouTube e la Rete Display.
VIDEO_REACH_TARGET_FREQUENCY Campagna di copertura video con strategia di offerta basata sulla frequenza target.
TRAVEL_ACTIVITIES Campagne per attività di viaggio.
SOCIAL_FACEBOOK_TRACKING_ONLY Il monitoraggio di Facebook riguarda solo le campagne social.

RealTimeBiddingSetting

Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la rete Ad Exchange.

Rappresentazione JSON 
{
  "optIn": boolean
}
Campi
optIn

boolean

Indica se la campagna è attivata per le offerte in tempo reale.

NetworkSettings

Le impostazioni di rete per la campagna.

Rappresentazione JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
Campi
targetSearchNetwork

boolean

Se gli annunci verranno pubblicati sui siti partner della rete di ricerca di Google (richiede che anche targetGoogleSearch sia true).
targetContentNetwork

boolean

Se gli annunci verranno pubblicati nei posizionamenti specificati sulla Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.
targetPartnerSearchNetwork

boolean

Se gli annunci verranno pubblicati sulla rete dei partner di Google. Questa opzione è disponibile solo per alcuni account partner Google selezionati.

DynamicSearchAdsSetting

L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA).

Rappresentazione JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
Campi
domainName

string

Obbligatorio. Il nome di dominio internet rappresentato da questa impostazione, ad esempio "google.com" o "www.google.com".
languageCode

string

Obbligatorio. Il codice lingua che specifica la lingua del dominio, ad esempio "en".
useSuppliedUrlsOnly

boolean

Indica se la campagna utilizza esclusivamente URL forniti dall'inserzionista.

ShoppingSetting

L'impostazione per le campagne Shopping. Definisce l'insieme di prodotti che possono essere pubblicizzati dalla campagna e il modo in cui questa campagna interagisce con le altre campagne Shopping.

Rappresentazione JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Campi
feedLabel

string

Etichetta del feed dei prodotti da includere nella campagna. È possibile impostare solo feedLabel o salesCountry. Se utilizzato al posto di salesCountry, il campo feedLabel accetta i codici paese nello stesso formato, ad esempio "XX". Altrimenti, può essere qualsiasi stringa utilizzata per l'etichetta del feed in Google Merchant Center.
useVehicleInventory

boolean

Se scegliere come target l'inventario delle schede di veicoli.
merchantId

string (int64 format)

ID dell'account Merchant Center. Questo campo è obbligatorio per le operazioni di creazione. Questo campo è immutabile per le campagne Shopping.
salesCountry

string

Il paese di vendita dei prodotti da includere nella campagna.
campaignPriority

integer

Priorità della campagna. Le campagne con priorità numericamente più alte hanno la precedenza su quelle con priorità più basse. Questo campo è obbligatorio per le campagne Shopping, con valori compresi tra 0 e 2 inclusi. Questo campo è facoltativo per le campagne Shopping intelligenti, ma deve essere uguale a 3 se impostato.
enableLocal

boolean

Se includere i prodotti locali.

GeoTargetTypeSetting

Rappresenta una raccolta di impostazioni relative al geotargeting degli annunci.

Rappresentazione JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Campi
positiveGeoTargetType

enum (PositiveGeoTargetType)

L'impostazione utilizzata per il geotargeting positivo in questa campagna specifica.
negativeGeoTargetType

enum (NegativeGeoTargetType)

L'impostazione utilizzata per il geotargeting negativo in questa campagna specifica.

PositiveGeoTargetType

I possibili tipi di target geografici positivi.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
PRESENCE_OR_INTEREST Specifica che un annuncio viene attivato se l'utente si trova nelle località scelte come target dall'inserzionista o mostra interesse per queste località.
SEARCH_INTEREST Specifica che un annuncio viene attivato se l'utente cerca le località di targeting dell'inserzionista. Può essere utilizzato solo con le campagne sulla rete di ricerca e Shopping standard.
PRESENCE Specifica che un annuncio viene attivato se l'utente si trova o si trova regolarmente nelle località target dell'inserzionista.

NegativeGeoTargetType

I possibili tipi di target geografici negativi.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
PRESENCE_OR_INTEREST Specifica che un utente non visualizza l'annuncio se si trova nelle località escluse dell'inserzionista o mostra interesse per queste località.
PRESENCE Specifica che un utente viene escluso dalla visualizzazione dell'annuncio se si trova nelle località escluse dell'inserzionista.

FrequencyCapEntry

Questo tipo non contiene campi.

Una regola che specifica il numero massimo di volte in cui un annuncio (o un insieme di annunci) può essere mostrato a un utente in un determinato periodo di tempo.

SelectiveOptimization

Impostazione di ottimizzazione selettiva per questa campagna, che include un insieme di azioni di conversione per cui ottimizzare la campagna. Questa funzionalità si applica solo alle campagne per app che utilizzano MULTI_CHANNEL come AdvertisingChannelType e APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT come AdvertisingChannelSubType.

Rappresentazione JSON 
{
  "conversionActions": [
    string
  ]
}
Campi
conversionActions[]

string

Il set selezionato di nomi delle risorse per le azioni di conversione per l'ottimizzazione di questa campagna.

OptimizationGoalSetting

Impostazione dell'obiettivo di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.

Rappresentazione JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Campi
optimizationGoalTypes[]

enum (OptimizationGoalType)

L'elenco dei tipi di obiettivi di ottimizzazione.

OptimizationGoalType

Il tipo di obiettivo di ottimizzazione

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo come valore restituito. Rappresenta il valore sconosciuto in questa versione.
CALL_CLICKS Ottimizza per i clic sulle chiamate. Le conversioni da clic sulla chiamata si verificano quando gli utenti selezionano "Chiama" per contattare un negozio dopo aver visualizzato un annuncio.
DRIVING_DIRECTIONS Ottimizza per le indicazioni stradali. Le conversioni da indicazioni stradali si verificano quando gli utenti selezionano "Indicazioni stradali" per raggiungere un negozio dopo aver visualizzato un annuncio.
APP_PRE_REGISTRATION Ottimizza per la preregistrazione. Le conversioni da preregistrazione sono il numero di registrazioni alla preregistrazione per ricevere una notifica quando l'app viene rilasciata.

TrackingSetting

Impostazioni a livello di campagna per le informazioni di monitoraggio.

Rappresentazione JSON 
{
  "trackingUrl": string
}
Campi
trackingUrl

string

L'URL utilizzato per il monitoraggio dinamico.

AssetSetType

Possibili tipi di un set di asset.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
PAGE_FEED Set di asset della pagina.
DYNAMIC_EDUCATION Set di asset didattici dinamici.
MERCHANT_CENTER_FEED Set di asset di Google Merchant Center.
DYNAMIC_REAL_ESTATE Insieme di asset immobiliari dinamici.
DYNAMIC_CUSTOM Set di asset personalizzati dinamici.
DYNAMIC_HOTELS_AND_RENTALS Set di asset dinamici per hotel e case vacanze.
DYNAMIC_FLIGHTS Insieme di asset per annunci di testo dinamici per voli.
DYNAMIC_TRAVEL Insieme di asset dinamici per viaggi.
DYNAMIC_LOCAL Set di asset locali dinamici.
DYNAMIC_JOBS Set di asset annuncio di testo dinamico per offerte di lavoro.
LOCATION_SYNC Set di asset a livello di sincronizzazione delle località.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Set di asset gruppo di sedi del profilo dell'attività.
CHAIN_DYNAMIC_LOCATION_GROUP Set di asset gruppo di località della catena che può essere utilizzato sia per le sedi di proprietà che per le sedi affiliate.
STATIC_LOCATION_GROUP Set di asset gruppo di località statico che può essere utilizzato sia per le sedi di proprietà che per le sedi affiliate.
HOTEL_PROPERTY Set di asset di hotel utilizzato per collegare un feed di hotel alle campagne Performance Max per gli obiettivi di viaggio.
TRAVEL_FEED Tipo di set di asset del feed di viaggi. Può rappresentare un feed di hotel o un feed di Cose da fare (attività).

ManualCpa

Questo tipo non contiene campi.

Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta per azione specificata dall'inserzionista.

ManualCpc

Offerta manuale basata sui clic in cui l'utente paga per clic.

Rappresentazione JSON 
{
  "enhancedCpcEnabled": boolean
}
Campi
enhancedCpcEnabled

boolean

Indica se le offerte devono essere migliorate in base ai dati dello Strumento per ottimizzare le conversioni.

ManualCpm

Questo tipo non contiene campi.

Offerta manuale basata sulle impressioni in cui l'utente paga per mille impressioni.

PercentCpc

Una strategia di offerta in cui le offerte sono una frazione del prezzo pubblicizzato per un prodotto o servizio.

Rappresentazione JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Campi
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Questo è un campo facoltativo inserito dall'inserzionista e specificato nei microformati locali. Nota: un valore pari a zero viene interpretato nello stesso modo di bid_ceiling non definito.
enhancedCpcEnabled

boolean

Aumenta o diminuisce l'offerta per ogni asta, a seconda della probabilità di conversione. Le singole offerte possono superare cpcBidCeilingMicros, ma l'importo medio dell'offerta per una campagna non deve superarlo.

TargetCpm

Questo tipo non contiene campi.

Il CPM (costo per mille impressioni) target è una strategia di offerta automatica che imposta le offerte in modo da ottimizzare il rendimento in base al CPM target che hai impostato.

CampaignAsset

Un collegamento tra una campagna e una risorsa.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Campi
resourceName

string

Il nome della risorsa dell'asset della campagna. I nomi delle risorse CampaignAsset hanno il seguente formato:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

Stato dell'asset della campagna.
campaign

string

La campagna a cui è collegato l'asset.
asset

string

L'asset collegato alla campagna.

CampaignAssetSet

CampaignAssetSet è il collegamento tra una campagna e un set di asset. L'aggiunta di un CampaignAssetSet collega un set di asset a una campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Campi
resourceName

string

Il nome della risorsa del set di asset della campagna. I nomi delle risorse degli asset dei set di asset hanno il formato:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

La campagna a cui è collegato questo insieme di asset.
assetSet

string

Il set di asset collegato alla campagna.
status

enum (AssetSetLinkStatus)

Lo stato dell'asset del set di asset della campagna. Sola lettura.

CampaignAudienceView

Una visualizzazione del segmento di pubblico della campagna. Include i dati sul rendimento degli annunci della rete di ricerca, della Rete Display e della rete YouTube, nonché degli elenchi per il remarketing per gli annunci della rete di ricerca (RLSA), aggregati per campagna e criterio del segmento di pubblico. Questa visualizzazione include solo i segmenti di pubblico collegati a livello di campagna.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome risorsa della visualizzazione del segmento di pubblico della campagna. I nomi delle risorse della visualizzazione del pubblico della campagna hanno il seguente formato:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Un criterio campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Campi
resourceName

string

Il nome della risorsa del criterio campagna. I nomi delle risorse dei criteri della campagna hanno il formato:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

Il nome visualizzato del criterio.

Questo campo viene ignorato per le mutazioni.
type

enum (CriterionType)

Il tipo di criterio.
status

enum (CampaignCriterionStatus)

Lo stato del criterio.
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questo criterio della campagna. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
criterionId

string (int64 format)

L'ID del criterio.

Questo campo viene ignorato durante la mutazione.
bidModifier

number

Il modificatore per le offerte quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri targetizzabili supporta i modificatori. Utilizza 0 per disattivare un tipo di dispositivo.
negative

boolean

Se scegliere come target (false) o escludere (true) il criterio.

Campo unione criterion. Il criterio campagna.

Deve essere impostato esattamente un valore. criterion può essere solo uno dei seguenti:
keyword

object (KeywordInfo)

Parola chiave.
location

object (LocationInfo)

Posizione.
device

object (DeviceInfo)

Dispositivo.
ageRange

object (AgeRangeInfo)

Fascia d'età.
gender

object (GenderInfo)

Genere.
userList

object (UserListInfo)

Elenco utenti.
language

object (LanguageInfo)

Lingua.
webpage

object (WebpageInfo)

Pagina web.
locationGroup

object (LocationGroupInfo)

Gruppo di località

CampaignCriterionStatus

I possibili stati di un CampaignCriterion.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED Il criterio campagna è attivato.
PAUSED Il criterio campagna è in pausa.
REMOVED Il criterio della campagna viene rimosso.

LanguageInfo

Un criterio linguistico.

Rappresentazione JSON 
{
  "languageConstant": string
}
Campi
languageConstant

string

Il nome della risorsa costante della lingua.

LocationGroupInfo

Un raggio intorno a un elenco di località specificate tramite un feed.

Rappresentazione JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Campi
geoTargetConstants[]

string

Costante o costanti di targeting geografico che limitano l'ambito dell'area geografica all'interno del feed. Al momento è consentita una sola costante di targeting geografico.
radiusUnits

enum (LocationGroupRadiusUnits)

Unità del raggio. Per le costanti di targeting geografico sono supportati miglia e metri. Per i set di elementi del feed sono supportati i millimetri e i metri. Questo campo è obbligatorio e deve essere impostato nelle operazioni CREATE.
feedItemSets[]

string

FeedItemSets i cui FeedItems sono scelti come target. Se vengono specificati più ID, vengono scelti come target tutti gli elementi che compaiono in almeno un insieme. Questo campo non può essere utilizzato con geoTargetConstants. Questo campo è facoltativo e può essere impostato solo nelle operazioni CREATE.
radius

string (int64 format)

Distanza in unità che specifica il raggio intorno alle località target. Questo campo è obbligatorio e deve essere impostato nelle operazioni CREATE.

LocationGroupRadiusUnits

L'unità di distanza del raggio nel gruppo di località (ad esempio, MILES)

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
METERS Metri
MILES Miglia
MILLI_MILES Milli Miles

CampaignEffectiveLabel

Rappresenta una relazione tra una campagna e un'etichetta efficace. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente a questa campagna.

Rappresentazione JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Nome della risorsa. I nomi delle risorse CampaignEffectivelabel hanno il formato: customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

La campagna a cui è associata l'etichetta efficace.
label

string

L'etichetta effettiva assegnata alla campagna.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta effettiva.

CampaignLabel

Rappresenta una relazione tra una campagna e un'etichetta.

Rappresentazione JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
Campi
resourceName

string

Nome della risorsa. I nomi delle risorse delle etichette delle campagne hanno il seguente formato: customers/{ownerCustomerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

La campagna a cui è associata l'etichetta.
label

string

L'etichetta assegnata alla campagna.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario dell'etichetta.

CartDataSalesView

Visualizzazione delle vendite dei dati del carrello.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione Vendite dati del carrello. I nomi delle risorse della visualizzazione delle vendite dei dati del carrello hanno il formato: customers/{customerId}/cartDataSalesView

Pubblico

Il segmento di pubblico è un'opzione di targeting efficace che permette di abbinare vari attributi pertinenti, ad esempio dati demografici dettagliati e affinità, per creare segmenti di pubblico che rappresentano sezioni dei segmenti target.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Campi
resourceName

string

Il nome risorsa del segmento di pubblico. I nomi dei segmenti di pubblico hanno il seguente formato:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

ID del segmento di pubblico.
name

string

Obbligatorio. Nome del segmento di pubblico. Deve essere univoco in tutti i segmenti di pubblico. Deve avere una lunghezza minima di 1 e una lunghezza massima di 255.
description

string

Descrizione di questo segmento di pubblico.

ConversionAction

Un'azione di conversione.

Rappresentazione JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Campi
resourceName

string

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

string

Timestamp della creazione dell'attività Floodlight, formattato in ISO 8601.
status

enum (ConversionActionStatus)

Lo stato di questa azione di conversione per l'accumulo di eventi di conversione.
type

enum (ConversionActionType)

Il tipo di questa azione di conversione.
category

enum (ConversionActionCategory)

La categoria di conversioni riportate per questa azione di conversione.
valueSettings

object (ValueSettings)

Impostazioni relative al valore per gli eventi di conversione associati a questa azione di conversione.
attributionModelSettings

object (AttributionModelSettings)

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

object (FloodlightSettings)

Impostazioni Floodlight per i tipi di conversione Floodlight.
id

string (int64 format)

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 primaryForGoal di un'azione di conversione è false, l'azione di conversione non è offertabile per tutte le campagne, indipendentemente dall'obiettivo di conversione del cliente o della campagna. Tuttavia, gli obiettivi di conversione personalizzati non rispettano primaryForGoal, quindi se una campagna ha un obiettivo di conversione personalizzato configurato con un'azione di conversione primaryForGoal = false, questa azione di conversione è comunque disponibile per le offerte. Per impostazione predefinita, primaryForGoal è true se non è impostato. Nella versione 9, primaryForGoal può essere impostato su false solo dopo la creazione tramite un 'operazione di "aggiornamento" perché non è dichiarato come facoltativo.
ownerCustomer

string

Il nome della risorsa del cliente proprietario dell'azione di conversione o null se si tratta di un'azione di conversione definita dal sistema.
includeInClientAccountConversionsMetric

boolean

Indica se questa azione di conversione deve essere inclusa nella metrica "clientAccountConversions".
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.
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 il 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 il 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 su un dispositivo mobile fa clic su un numero di telefono.
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 la 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 in 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 in base ai caricamenti dei dati proprietari o di terze parti del commerciante. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di caricamento diretto delle vendite in negozio.
STORE_SALES Conversione delle vendite in negozio in base ai caricamenti dei dati proprietari o di terze parti del commerciante e/o agli acquisti in negozio effettuati con carte di circuiti di pagamento. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di vendite in negozio. Sola lettura.
FIREBASE_ANDROID_FIRST_OPEN Conversioni di prime aperture di app per Android monitorate tramite Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversioni di acquisti in-app di app per Android monitorate tramite Firebase.
FIREBASE_ANDROID_CUSTOM Conversioni personalizzate di app per Android monitorate tramite Firebase.
FIREBASE_IOS_FIRST_OPEN Conversioni di prima apertura di app per iOS monitorate tramite Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversioni di acquisti in-app di app per iOS monitorate tramite Firebase.
FIREBASE_IOS_CUSTOM Conversioni personalizzate di app per iOS monitorate tramite Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversioni da prima apertura di app per Android monitorate tramite l'analisi di app di terze parti.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversioni da acquisto in-app di app per Android monitorate tramite l'analisi di app di terze parti.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversioni personalizzate da app per Android monitorate tramite l'analisi dati delle app di terze parti.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversioni da prima apertura di app per iOS monitorate tramite l'analisi di app di terze parti.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversioni da acquisto in-app di app per iOS monitorate tramite l'analisi di app di terze parti.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversioni personalizzate da app per iOS monitorate tramite l'analisi dati delle app di terze parti.
ANDROID_APP_PRE_REGISTRATION Conversioni che si verificano quando un utente esegue 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 non monitorati da un tipo specifico per l'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. Può anche acquisire il valore totale di ogni vendita. Sola lettura.
GOOGLE_HOSTED Conversioni che monitorano le azioni locali da 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

Ritirata: l'integrazione di Salesforce verrà ritirata e sostituita da un metodo migliore per importare le conversioni da Salesforce. - vedi https://support.google.com/google-ads/answer/14728349
SEARCH_ADS_360 Conversioni importate dai dati Floodlight di Search Ads 360. Sola lettura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversioni da chiamate che si verificano negli annunci delle campagne intelligenti senza configurazione del monitoraggio delle chiamate, utilizzando criteri personalizzati delle campagne intelligenti. 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 il monitoraggio delle chiamate configurato, utilizzando criteri personalizzati delle campagne intelligenti. Sola lettura.
STORE_VISITS Conversioni che si verificano quando un utente visita un negozio al dettaglio dell'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 di eventi codificati individualmente. Sola lettura.
UNIVERSAL_ANALYTICS_GOAL Conversioni derivanti dagli obiettivi Universal Analytics collegati.
UNIVERSAL_ANALYTICS_TRANSACTION Conversioni derivanti da transazioni Universal Analytics collegate.
GOOGLE_ANALYTICS_4_CUSTOM Conversioni derivanti dalle conversioni di eventi personalizzati di Google Analytics 4 collegati.
GOOGLE_ANALYTICS_4_PURCHASE Conversioni derivanti dalle conversioni di acquisto di Google Analytics 4 collegate.

ConversionActionCategory

La categoria di conversioni associate a un ConversionAction.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
DEFAULT Categoria predefinita.
PAGE_VIEW Utente che visita una pagina.
PURCHASE Evento di acquisto, vendita o "ordine effettuato".
SIGNUP Azione utente di registrazione.
LEAD Azione di generazione di lead.
DOWNLOAD Azione di download del software (come per un'app).
ADD_TO_CART L'aggiunta di articoli a un carrello o a una lista degli acquisti sul sito di un inserzionista.
BEGIN_CHECKOUT Quando qualcuno inizia il flusso di pagamento sul sito di un inserzionista.
SUBSCRIBE_PAID L'inizio di un abbonamento a pagamento per un prodotto o servizio.
PHONE_CALL_LEAD Una chiamata per indicare l'interesse per l'offerta di un inserzionista.
IMPORTED_LEAD Una conversione di lead importata da una sorgente esterna in Google Ads.
SUBMIT_LEAD_FORM L'invio di un modulo sul sito di un inserzionista che indica l'interesse dell'attività.
BOOK_APPOINTMENT Una prenotazione di un appuntamento con l'attività di un inserzionista.
REQUEST_QUOTE Una richiesta di preventivo o stima del prezzo.
GET_DIRECTIONS Una ricerca della sede dell'attività di un inserzionista con l'intenzione di visitarla.
OUTBOUND_CLICK Un clic sul sito di un partner dell'inserzionista.
CONTACT Una chiamata, un SMS, un'email, una chat o un altro tipo di contatto con un inserzionista.
ENGAGEMENT Un evento di coinvolgimento del sito web, ad esempio un lungo tempo sul sito o un obiettivo intelligente di Google Analytics (GA). Destinato all'utilizzo per le importazioni di obiettivi GA, Firebase e GA Gold.
STORE_VISIT Una visita alla sede fisica di un negozio.
STORE_SALE Una vendita effettuata in un negozio fisico.
QUALIFIED_LEAD Una conversione da lead importata da una fonte esterna in Google Ads, che è stata ulteriormente qualificata dall'inserzionista (team di marketing/vendite). Nel percorso dal lead alla vendita, gli inserzionisti ottengono i lead, poi agiscono contattando il consumatore. Se il consumatore è interessato e potrebbe finire per acquistare il prodotto, l'inserzionista contrassegna questi lead come "lead qualificati".
CONVERTED_LEAD Una conversione dei lead importata da un'origine esterna in Google Ads, che ha completato un'ulteriore fase scelta come definita dall'inserzionista di generazione di lead.

ValueSettings

Impostazioni relative al valore per gli eventi di conversione associati a questa azione di conversione.

Rappresentazione JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
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 questa 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 questa azione di conversione è configurata per utilizzare sempre il valore predefinito.
alwaysUseDefaultValue

boolean

Controlla se il valore predefinito e il codice valuta predefinito vengono utilizzati al posto del valore e del codice valuta specificati negli eventi di conversione per questa azione di conversione.

AttributionModelSettings

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

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

enum (AttributionModel)

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

enum (DataDrivenModelStatus)

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 il 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 Ricerca Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attribuisce il merito di una conversione equamente a tutti i suoi clic utilizzando l'attribuzione della Ricerca Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attribuisce un merito esponenzialmente maggiore per una conversione ai clic più recenti utilizzando l'attribuzione della Ricerca Google (l'emivita è di una settimana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribuisce il 40% del merito di una conversione al primo e all'ultimo clic. Il 20% rimanente viene distribuito equamente tra tutti gli altri clic. Questa funzionalità utilizza 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 rete di ricerca di Google.

DataDrivenModelStatus

Enumera gli stati del modello basato sui dati.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
AVAILABLE Il modello basato sui dati è disponibile.
STALE Il modello basato sui dati non è aggiornato. Non è stato 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 è stato aggiornato da almeno 30 giorni e non può essere utilizzato. Il più delle volte questo accade perché non è stato raggiunto il numero richiesto di eventi in un periodo recente di 30 giorni.
NEVER_GENERATED Il modello basato sui dati non è mai stato generato. Il più delle volte questo accade perché non è mai stato raggiunto il numero richiesto di eventi in un periodo di 30 giorni.

FloodlightSettings

Impostazioni relative a un'azione di conversione Floodlight.

Rappresentazione JSON 
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Campi
activityGroupTag

string

Stringa utilizzata per identificare un gruppo attività Floodlight durante la generazione di report sulle conversioni.
activityTag

string

Stringa utilizzata per identificare un'attività Floodlight durante la generazione di report sulle conversioni.
activityId

string (int64 format)

ID dell'attività Floodlight in DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Una variabile personalizzata di conversione. Consulta la sezione "Informazioni su metriche e dimensioni Floodlight personalizzate nel nuovo Search Ads 360" all'indirizzo https://support.google.com/sa360/answer/13567857

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Campi
resourceName

string

Il nome della risorsa della variabile personalizzata di conversione. I nomi delle risorse delle variabili personalizzate di conversione hanno il formato:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

L'ID della variabile personalizzata di conversione.
name

string

Obbligatorio. Il nome della variabile personalizzata di conversione. Il nome deve essere univoco. La lunghezza massima del nome è di 100 caratteri. Non devono esserci spazi aggiuntivi prima e dopo.
tag

string

Obbligatorio. Il tag della variabile personalizzata di conversione. Il tag deve essere univoco e composto da un carattere "u" seguito direttamente da un numero inferiore o uguale a 100. Ad esempio: "u4".
status

enum (ConversionCustomVariableStatus)

Lo stato della variabile personalizzata di conversione per l'accumulo di eventi di conversione.
ownerCustomer

string

Il nome risorsa del cliente proprietario della variabile personalizzata di conversione.
family

enum (ConversionCustomVariableFamily)

Famiglia della variabile personalizzata di conversione.
cardinality

enum (ConversionCustomVariableCardinality)

Cardinalità della variabile personalizzata di conversione.
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Campi per le variabili personalizzate di conversione Floodlight di Search Ads 360.
customColumnIds[]

string (int64 format)

Gli ID delle colonne personalizzate che utilizzano questa variabile personalizzata di conversione.

ConversionCustomVariableStatus

Possibili stati di una variabile personalizzata di conversione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ACTIVATION_NEEDED

La variabile personalizzata di conversione è in attesa di attivazione e non accumulerà statistiche finché non verrà impostata su ATTIVATA.

Questo stato non può essere utilizzato nelle richieste CREATE e UPDATE.
ENABLED La variabile personalizzata di conversione è attivata e accumulerà statistiche.
PAUSED La variabile personalizzata di conversione è in pausa e non accumulerà statistiche finché non verrà impostata di nuovo su ATTIVATA.

ConversionCustomVariableFamily

Famiglia di una variabile personalizzata di conversione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
STANDARD La variabile personalizzata di conversione standard. I clienti devono attivarlo prima dell'utilizzo.
FLOODLIGHT La variabile personalizzata di conversione importata da una variabile Floodlight personalizzata.

ConversionCustomVariableCardinality

Cardinalità di una variabile personalizzata di conversione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
BELOW_ALL_LIMITS La variabile personalizzata di conversione ha una cardinalità inferiore a tutti i limiti. La variabile può essere utilizzata per la segmentazione e le statistiche possono essere accumulate per i nuovi valori se la variabile è abilitata.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT La variabile personalizzata di conversione ha una cardinalità che supera il limite di segmentazione, ma non il limite delle statistiche. La segmentazione verrà disattivata, ma le statistiche possono essere accumulate per i nuovi valori se la variabile è abilitata.
APPROACHES_STATS_LIMIT La variabile personalizzata di conversione ha superato i limiti di segmentazione e si sta avvicinando ai limiti delle statistiche (> 90%). La segmentazione verrà disattivata, ma le statistiche possono essere accumulate per i nuovi valori se la variabile è abilitata.
EXCEEDS_STATS_LIMIT La variabile personalizzata di conversione ha superato sia i limiti di segmentazione sia quelli delle statistiche. La segmentazione verrà disattivata e le statistiche per le variabili attivate possono essere accumulate solo se i valori esistenti non aumentano ulteriormente la cardinalità della variabile.

FloodlightConversionCustomVariableInfo

Informazioni sulle variabili personalizzate di conversione Floodlight di Search Ads 360.

Rappresentazione JSON 
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Campi
floodlightVariableType

enum (FloodlightVariableType)

Tipo di variabile Floodlight definito in Search Ads 360.
floodlightVariableDataType

enum (FloodlightVariableDataType)

Tipo di dati della variabile Floodlight definito in Search Ads 360.

FloodlightVariableType

Tipo di variabile Floodlight, come definito in Search Ads 360. Per saperne di più, visita la pagina https://support.google.com/searchads/answer/4397154?hl=en.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
DIMENSION Tipo di variabile Floodlight della dimensione.
METRIC Tipo di variabile Floodlight metrica.
UNSET Il tipo di variabile Floodlight non è impostato.

FloodlightVariableDataType

Il tipo di dati della variabile Floodlight, come definito in Search Ads 360. Per saperne di più, visita la pagina https://support.google.com/searchads/answer/4397154?hl=en.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
NUMBER Rappresenta una variabile Floodlight di tipo "Numero". Questa variabile può essere assegnata a variabili Floodlight di tipo DIMENSIONE o METRICA.
STRING Rappresenta una variabile Floodlight di tipo "Stringa". Questa variabile può essere assegnata a variabili Floodlight di tipo DIMENSIONE.

Cliente

Un cliente.

Rappresentazione JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Campi
resourceName

string

Il nome risorsa del cliente. I nomi delle risorse cliente hanno il seguente formato:

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

Impostazione del monitoraggio delle conversioni per un cliente.
accountType

enum (AccountType)

Tipo di account motore, ad esempio Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track e così via.
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Impostazione di DoubleClick Campaign Manager (DCM) per un cliente amministratore.
accountStatus

enum (AccountStatus)

Stato dell'account, ad esempio Attivato, In pausa, Rimosso e così via.
lastModifiedTime

string

La data e l'ora dell'ultima modifica di questo cliente. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
engineId

string

ID dell'account nell'account motore esterno.
status

enum (CustomerStatus)

Lo stato del cliente.
creationTime

string

Il timestamp di creazione di questo cliente. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
managerId

string (int64 format)

L'ID cliente dell'amministratore. Un valore pari a 0 indica che il cliente non ha un amministratore SA360.
managerDescriptiveName

string

Il nome descrittivo del gestore.
subManagerId

string (int64 format)

L'ID cliente dell'amministratore secondario. Un valore pari a 0 indica che il cliente non ha un amministratore secondario SA360.
subManagerDescriptiveName

string

Il nome descrittivo dell'amministratore secondario.
associateManagerId

string (int64 format)

L'ID cliente dell'amministratore associato. Un valore pari a 0 indica che il cliente non ha un amministratore associato SA360.
associateManagerDescriptiveName

string

Il nome descrittivo dell'amministratore associato.
accountLevel

enum (AccountLevelType)

Il livello di account del cliente: amministratore, amministratore secondario, amministratore associato, account di servizio.
id

string (int64 format)

L'ID del cliente.
descriptiveName

string

Nome descrittivo facoltativo e non univoco del cliente.
currencyCode

string

La valuta in cui opera l'account. È supportato un sottoinsieme dei codici valuta dello standard ISO 4217.
timeZone

string

L'ID del fuso orario locale del cliente.
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio dai parametri.
finalUrlSuffix

string

Il modello di URL per aggiungere parametri all'URL finale.
autoTaggingEnabled

boolean

Indica se il tagging automatico è attivato per il cliente.
manager

boolean

Indica se il cliente è un amministratore.

ConversionTrackingSetting

Un insieme di impostazioni a livello di cliente relative al monitoraggio delle conversioni di Search Ads 360.

Rappresentazione JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Campi
acceptedCustomerDataTerms

boolean

Indica se il cliente ha accettato i termini relativi ai dati dei clienti. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'account amministratore. Questo campo è di sola lettura. Per ulteriori informazioni, visita la pagina https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

Stato del monitoraggio delle conversioni. Indica se il cliente utilizza il monitoraggio delle conversioni e chi è il proprietario del monitoraggio delle conversioni di questo cliente. Se questo cliente utilizza il monitoraggio delle conversioni su più account, il valore restituito varia in base al login-customer-id della richiesta.
enhancedConversionsForLeadsEnabled

boolean

Se il cliente ha attivato le conversioni avanzate per i lead. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'account amministratore. Questo campo è di sola lettura.
googleAdsConversionCustomer

string

Il nome risorsa del cliente in cui vengono create e gestite le conversioni. Questo campo è di sola lettura.
conversionTrackingId

string (int64 format)

L'ID monitoraggio delle conversioni utilizzato per questo account. Questo ID non indica se il cliente utilizza il monitoraggio delle conversioni (lo fa conversionTrackingStatus). Questo campo è di sola lettura.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

L'ID monitoraggio delle conversioni dell'amministratore del cliente. Viene impostato quando il cliente ha attivato il monitoraggio delle conversioni e sostituisce conversionTrackingId. Questo campo può essere gestito solo tramite la UI di Google Ads. Questo campo è di sola lettura.
crossAccountConversionTrackingId

string (int64 format)

L'ID monitoraggio delle conversioni dell'amministratore del cliente. Questo valore viene impostato quando il cliente attiva il monitoraggio delle conversioni su più account e sostituisce conversionTrackingId.

ConversionTrackingStatus

Stato del monitoraggio delle conversioni del cliente.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
NOT_CONVERSION_TRACKED Il cliente non utilizza il monitoraggio delle conversioni.
CONVERSION_TRACKING_MANAGED_BY_SELF Le azioni di conversione vengono create e gestite da questo cliente.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Le azioni di conversione vengono create e gestite dall'amministratore specificato in login-customer-id della richiesta.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Le azioni di conversione vengono create e gestite da un amministratore diverso dal cliente o dall'amministratore specificato in login-customer-id della richiesta.

AccountType

Possibili tipi di account motore.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
BAIDU Account Baidu.
ENGINE_TRACK Account di monitoraggio motori.
FACEBOOK Account Facebook.
FACEBOOK_GATEWAY Account Facebook gestito tramite gateway.
GOOGLE_ADS Account Google Ads.
MICROSOFT Account Microsoft Advertising.
SEARCH_ADS_360 Account amministratore Search Ads 360.
YAHOO_JAPAN Account Yahoo Japan.

DoubleClickCampaignManagerSetting

Impostazione di DoubleClick Campaign Manager (DCM) per un cliente amministratore.

Rappresentazione JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Campi
advertiserId

string (int64 format)

ID dell'inserzionista Campaign Manager associato a questo cliente.
networkId

string (int64 format)

L'ID della rete Campaign Manager associata a questo cliente.
timeZone

string

Fuso orario della rete Campaign Manager associata a questo cliente nel formato del database dei fusi orari IANA, ad esempio America/New_York.

AccountStatus

Stati possibili di un account.

Enum
UNSPECIFIED Valore predefinito.
UNKNOWN Valore sconosciuto.
ENABLED L'account è in grado di pubblicare annunci.
PAUSED L'account è stato disattivato dall'utente.
SUSPENDED L'account viene disattivato da una procedura interna.
REMOVED L'account è disattivato in modo irrevocabile.
DRAFT L'account è ancora in fase di configurazione, non è ancora ATTIVO.

CustomerStatus

Possibili stati di un cliente.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED Indica un account attivo in grado di pubblicare annunci.
CANCELED Indica un account annullato che non può pubblicare annunci. Può essere riattivato da un utente amministratore.
SUSPENDED Indica un account sospeso che non può pubblicare annunci. Può essere attivato solo dall'Assistenza Google.
CLOSED Indica un account chiuso che non può pubblicare annunci. Anche l'account di test avrà lo stato CHIUSO. Lo stato è definitivo e non può essere riaperto.

AccountLevelType

Enumerazione che descrive i possibili livelli di account.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
CLIENT_ACCOUNT_FACEBOOK Account cliente (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Account cliente (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Account cliente (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Account cliente (Yahoo Japan)
CLIENT_ACCOUNT_ENGINE_TRACK Account cliente (monitoraggio motori)
MANAGER Amministratore di primo livello.
SUB_MANAGER Amministratore secondario.
ASSOCIATE_MANAGER Dirigente associato.

CustomerAsset

Un collegamento tra un cliente e una risorsa.

Rappresentazione JSON 
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Campi
resourceName

string

Il nome risorsa dell'asset del cliente. I nomi delle risorse CustomerAsset hanno il seguente formato:

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

Obbligatorio. L'asset collegato al cliente.
status

enum (AssetLinkStatus)

Stato dell'asset del cliente.

CustomerAssetSet

CustomerAssetSet è il collegamento tra un cliente e un insieme di asset. L'aggiunta di un CustomerAssetSet collega un asset set a un cliente.

Rappresentazione JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Campi
resourceName

string

Il nome risorsa del set di asset del cliente. I nomi delle risorse degli asset dei set di asset hanno il formato:

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

Il gruppo di asset collegato al cliente.
customer

string

Il cliente a cui è collegato questo insieme di asset.
status

enum (AssetSetLinkStatus)

Lo stato dell'asset dell'insieme di asset del cliente. Sola lettura.

AccessibleBiddingStrategy

Rappresenta una visualizzazione delle strategie di offerta di proprietà del cliente e condivise con lui.

A differenza di BiddingStrategy, questa risorsa include le strategie di proprietà degli amministratori del cliente e condivise con questo cliente, oltre a quelle di proprietà di questo cliente. Questa risorsa non fornisce metriche ed espone solo un sottoinsieme limitato degli attributi BiddingStrategy.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Campi
resourceName

string

Il nome della risorsa della strategia di offerta accessibile. I nomi delle risorse AccessibleBiddingStrategy hanno il seguente formato:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

L'ID della strategia di offerta.
name

string

Il nome della strategia di offerta.
type

enum (BiddingStrategyType)

Il tipo di strategia di offerta.
ownerCustomerId

string (int64 format)

L'ID del cliente proprietario della strategia di offerta.
ownerDescriptiveName

string

descriptiveName del cliente proprietario della strategia di offerta.

Campo unione scheme. Lo schema di offerta.

È possibile impostarne solo uno. scheme può essere solo uno dei seguenti:
maximizeConversionValue

object (MaximizeConversionValue)

Una strategia di offerta automatica che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.
maximizeConversions

object (MaximizeConversions)

Una strategia di offerta automatica che ti aiuta a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget.
targetCpa

object (TargetCpa)

Una strategia di offerta che imposta le offerte in modo da generare il maggior numero possibile di conversioni al costo per acquisizione (CPA) target da te impostato.
targetImpressionShare

object (TargetImpressionShare)

Una strategia di offerta che esegue automaticamente l'ottimizzazione in base a una percentuale di impressioni scelta.
targetRoas

object (TargetRoas)

Una strategia di offerta che ti aiuta a massimizzare le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
targetSpend

object (TargetSpend)

Una strategia di offerta che imposta le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget.

MaximizeConversionValue

Una strategia di offerta automatica che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.

Rappresentazione JSON 
{
  "targetRoas": number
}
Campi
targetRoas

number

L'opzione Ritorno sulla spesa pubblicitaria target (ROAS target). Se impostata, la strategia di offerta massimizza le entrate mantenendo una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non essere in grado di spendere l'intero budget. Se il ROAS target non è impostato, la strategia di offerta cercherà di raggiungere il ROAS più alto possibile per il budget.

MaximizeConversions

Una strategia di offerta automatica che ti aiuta a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget.

Rappresentazione JSON 
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Campi
targetCpa

string (int64 format)

L'opzione Costo per acquisizione (CPA) target. Si tratta dell'importo medio che vorresti spendere per acquisizione.
targetCpaMicros

string (int64 format)

L'opzione Costo per acquisizione (CPA) target. Si tratta dell'importo medio che vorresti spendere per acquisizione.

TargetCpa

Una strategia che imposta offerte automatiche in modo da generare il maggior numero possibile di conversioni al costo per acquisizione (CPA) target da te impostato.

Rappresentazione JSON 
{
  "targetCpaMicros": string
}
Campi
targetCpaMicros

string (int64 format)

CPA target medio. Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account.

TargetImpressionShare

Una strategia di offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga mostrata nella parte superiore della prima pagina (o in un'altra posizione target).

Rappresentazione JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Campi
location

enum (TargetImpressionShareLocation)

La posizione di destinazione nella pagina dei risultati di ricerca.
locationFractionMicros

string (int64 format)

La frazione scelta di annunci da mostrare nella località di destinazione in microsecondi. Ad esempio, 1% equivale a 10.000.
cpcBidCeilingMicros

string (int64 format)

L'offerta CPC più alta che il sistema di offerta automatica è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo e specificato nei microformati locali.

TargetRoas

Una strategia di offerta automatica che ti aiuta a massimizzare le entrate mantenendo una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.

Rappresentazione JSON 
{
  "targetRoas": number
}
Campi
targetRoas

number

Le entrate scelte (in base ai dati sulle conversioni) per unità di spesa.

TargetSpend

Una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget.

Rappresentazione JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Campi
targetSpendMicros
(deprecated)

string (int64 format)

La spesa target in base alla quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere il valore inferiore tra questo e l'importo di spesa di limitazione naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per maggiori dettagli, visita la pagina https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia.

ManagerLinkStatus

Possibili stati di un collegamento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ACTIVE Indica la relazione attualmente in vigore
INACTIVE Indica la relazione terminata
PENDING Indica che la relazione è stata richiesta dal gestore, ma il cliente non l'ha ancora accettata.
REFUSED Il rapporto è stato richiesto dall'amministratore, ma il cliente ha rifiutato.
CANCELED Indica che la relazione è stata richiesta dall'amministratore, ma è stata annullata.

CustomerClient

Un collegamento tra il cliente specificato e un cliente client. CustomerClients esistono solo per i clienti amministratore. Sono inclusi tutti i clienti diretti e indiretti, nonché il gestore stesso.

Rappresentazione JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Campi
resourceName

string

Il nome risorsa del client cliente. I nomi delle risorse CustomerClient hanno il formato: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

I nomi delle risorse delle etichette di proprietà del cliente richiedente applicate al cliente. I nomi delle risorse delle etichette hanno il seguente formato:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

Lo stato del cliente cliente. Sola lettura.
clientCustomer

string

Il nome risorsa del cliente-cliente collegato al cliente specificato. Sola lettura.
hidden

boolean

Specifica se si tratta di un account nascosto.

Sola lettura.
level

string (int64 format)

Distanza tra il cliente e il client specificati. Per il collegamento automatico, il valore del livello sarà 0. Sola lettura.
timeZone

string

Rappresentazione della stringa Common Locale Data Repository (CLDR) del fuso orario del client, ad esempio America/Los_Angeles. Sola lettura.
testAccount

boolean

Indica se il cliente è un account di prova. Sola lettura.
manager

boolean

Indica se il cliente è un amministratore. Sola lettura.
descriptiveName

string

Nome descrittivo del client. Sola lettura.
currencyCode

string

Codice valuta (ad esempio, "USD", "EUR") per il cliente. Sola lettura.
id

string (int64 format)

L'ID del cliente cliente. Sola lettura.

DynamicSearchAdsSearchTermView

Una visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca.

Rappresentazione JSON 
{
  "resourceName": string,
  "landingPage": string
}
Campi
resourceName

string

Il nome risorsa della visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca. I nomi delle risorse della visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca hanno il formato:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

L'URL pagina di destinazione dell'impressione selezionato dinamicamente.

Questo campo è di sola lettura.

GenderView

Una visualizzazione del genere. La risorsa genderView riflette lo stato di pubblicazione effettivo, anziché i criteri aggiunti. Un gruppo di annunci senza criteri di genere viene mostrato per impostazione predefinita a tutti i generi, quindi tutti i generi vengono visualizzati in genderView con le statistiche.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione del genere. I nomi delle risorse della visualizzazione Genere hanno il seguente formato:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Una costante di targeting geografico.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Campi
resourceName

string

Il nome della risorsa della costante di targeting geografico. I nomi delle risorse costanti di targeting geografico hanno il seguente formato:

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

Stato costante del target geografico.
id

string (int64 format)

L'ID della costante di targeting geografico.
name

string

Nome inglese costante del targeting geografico.
countryCode

string

Il codice paese ISO-3166-1 alpha-2 associato al target.
targetType

string

Tipo di target costante di targeting geografico.
canonicalName

string

Il nome inglese completo, composto dal nome della destinazione e da quello del paese e della società madre.
parentGeoTarget

string

Il nome della risorsa della costante di geotargeting padre. I nomi delle risorse costanti di targeting geografico hanno il seguente formato:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

I possibili stati di una costante di targeting geografico.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore di sola risposta.
ENABLED La costante di targeting geografico è valida.
REMOVAL_PLANNED La costante di targeting geografico è obsoleta e verrà rimossa.

KeywordView

Una visualizzazione delle parole chiave.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome risorsa della visualizzazione delle parole chiave. I nomi delle risorse della visualizzazione delle parole chiave hanno il seguente formato:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Etichetta

Un'etichetta.

Rappresentazione JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Campi
resourceName

string

Nome della risorsa. I nomi delle risorse delle etichette hanno il formato: customers/{ownerCustomerId}/labels/{label_id}
status

enum (LabelStatus)

Stato dell'etichetta. Sola lettura.
textLabel

object (TextLabel)

Un tipo di etichetta che mostra il testo su uno sfondo colorato.
id

string (int64 format)

ID dell'etichetta. Sola lettura.
name

string

Il nome dell'etichetta.

Questo campo è obbligatorio e non deve essere vuoto quando crei una nuova etichetta.

La lunghezza di questa stringa deve essere compresa tra 1 e 80 caratteri inclusi.

LabelStatus

Stati possibili di un'etichetta.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED L'etichetta è attivata.
REMOVED L'etichetta viene rimossa.

TextLabel

Un tipo di etichetta che mostra il testo su uno sfondo colorato.

Rappresentazione JSON 
{
  "backgroundColor": string,
  "description": string
}
Campi
backgroundColor

string

Colore di sfondo dell'etichetta in formato esadecimale. Questa stringa deve corrispondere all'espressione regolare "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". Nota: il colore di sfondo potrebbe non essere visibile per gli account amministratore.
description

string

Una breve descrizione dell'etichetta. La lunghezza non deve superare i 200 caratteri.

LanguageConstant

Una lingua.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Campi
resourceName

string

Il nome della risorsa della costante di lingua. I nomi delle risorse costanti di lingua hanno il seguente formato:

languageConstants/{criterionId}
id

string (int64 format)

L'ID della costante di lingua.
code

string

Il codice della lingua, ad esempio "en_US", "en_AU", "es", "fr" e così via.
name

string

Il nome completo della lingua in inglese, ad esempio "English (US)", "Spanish" e così via.
targetable

boolean

Indica se la lingua può essere impostata come target.

LocationView

Una visualizzazione delle località riepiloga il rendimento delle campagne in base a un criterio di località.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione della località. I nomi delle risorse della visualizzazione della località hanno il seguente formato:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Una categoria di offerta per i prodotti.

Rappresentazione JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Campi
resourceName

string

Il nome risorsa della categoria di offerta del prodotto. I nomi delle risorse delle categorie di offerta dei prodotti hanno il seguente formato:

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

Livello della categoria di offerta del prodotto.
status

enum (ProductBiddingCategoryStatus)

Stato della categoria di offerta del prodotto.
id

string (int64 format)

ID della categoria di offerta del prodotto.

Questo ID è equivalente all'ID google_product_category [categoria_prodotto_google] descritto in questo articolo: https://support.google.com/merchants/answer/6324436.
countryCode

string

Codice paese di due lettere maiuscole della categoria di offerta del prodotto.
productBiddingCategoryConstantParent

string

Nome della risorsa della categoria di offerta del prodotto principale.
languageCode

string

Codice lingua della categoria di offerta del prodotto.
localizedName

string

Visualizza il valore della categoria di offerta del prodotto localizzato in base a languageCode.

ProductBiddingCategoryLevel

Enumerazione che descrive il livello della categoria di offerta del prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
LEVEL1 Livello 1.
LEVEL2 Livello 2.
LEVEL3 Livello 3.
LEVEL4 Livello 4.
LEVEL5 Livello 5.

ProductBiddingCategoryStatus

Enumerazione che descrive lo stato della categoria di offerta del prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ACTIVE La categoria è attiva e può essere utilizzata per le offerte.
OBSOLETE La categoria è obsoleta. Utilizzato solo a scopo di report.

ProductGroupView

Una visualizzazione dei gruppi di prodotti.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione del gruppo di prodotti. I nomi delle risorse di visualizzazione dei gruppi di prodotti hanno il seguente formato:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Visualizzazione del rendimento di Shopping. Fornisce statistiche sulle campagne Shopping aggregate a diversi livelli di dimensione del prodotto. I valori delle dimensioni dei prodotti di Merchant Center, come brand, categoria, attributi personalizzati, condizione del prodotto e tipo di prodotto, rifletteranno lo stato di ogni dimensione alla data e all'ora in cui è stato registrato l'evento corrispondente.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione del rendimento di Shopping. I nomi delle risorse della visualizzazione del rendimento di Shopping hanno il seguente formato: customers/{customerId}/shoppingPerformanceView

UserList

Un elenco di utenti. Si tratta di un elenco di utenti a cui un cliente può indirizzare il targeting.

Rappresentazione JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Campi
resourceName

string

Il nome risorsa dell'elenco utenti. I nomi delle risorse degli elenchi di utenti hanno il seguente formato:

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

Il tipo di elenco.

Questo campo è di sola lettura.
id

string (int64 format)

ID dell'elenco di utenti.
name

string

Nome di questo elenco di utenti. A seconda del valore di access_reason, il nome dell'elenco utenti potrebbe non essere univoco (ad esempio, se access_reason=SHARED)

UserListType

Enum contenente i possibili tipi di elenchi utenti.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
REMARKETING Elenco utenti rappresentato come una raccolta di tipi di conversione.
LOGICAL UserList rappresentato come una combinazione di altri elenchi di utenti/interessi.
EXTERNAL_REMARKETING Elenco utenti creato nella piattaforma Google Ad Manager.
RULE_BASED UserList associato a una regola.
SIMILAR UserList con utenti simili a quelli di un altro UserList.
CRM_BASED UserList di dati CRM proprietari forniti dall'inserzionista sotto forma di email o altri formati.

UserLocationView

Una visualizzazione della posizione degli utenti.

La visualizzazione Posizione utente include tutte le metriche aggregate a livello di paese, una riga per paese. Mostra le metriche nella località fisica effettiva dell'utente in base alla località target o non scelta come target. Se vengono utilizzati altri campi di segmento, potresti ottenere più di una riga per paese.

Rappresentazione JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Campi
resourceName

string

Il nome risorsa della visualizzazione della posizione utente. I nomi delle risorse della visualizzazione UserLocation hanno il formato:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

ID criterio per il paese.
targetingLocation

boolean

Indica se il targeting è stato impostato sulla località.

WebpageView

Visualizzazione di una pagina web.

Rappresentazione JSON 
{
  "resourceName": string
}
Campi
resourceName

string

Il nome della risorsa della visualizzazione della pagina web. I nomi delle risorse di visualizzazione di pagine web hanno il formato:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Visita

Una visita.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campi
resourceName

string

Il nome della risorsa della visita. I nomi delle risorse di visita hanno il seguente formato:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

L'ID della visita.
criterionId

string (int64 format)

ID parola chiave di Search Ads 360. Un valore pari a 0 indica che la parola chiave non è attribuita.
merchantId

string (int64 format)

L'ID account inventario Search Ads 360 contenente il prodotto su cui è stato fatto clic. Search Ads 360 genera questo ID quando colleghi un account inventario in Search Ads 360.
adId

string (int64 format)

ID annuncio. Un valore pari a 0 indica che l'annuncio non è attribuito.
clickId

string

Una stringa univoca per ogni visita che viene trasmessa alla pagina di destinazione come parametro URL ID clic.
visitDateTime

string

Il timestamp dell'evento di visita. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
productId

string

L'ID del prodotto su cui è stato fatto clic.
productChannel

enum (ProductChannel)

Il canale di vendita del prodotto su cui è stato fatto clic: online o locale.
productLanguageCode

string

La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto.
productStoreId

string

Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.
productCountryCode

string

Il paese (formato ISO-3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic.
assetId

string (int64 format)

ID dell'asset con cui è stata eseguita un'interazione durante l'evento di visita.
assetFieldType

enum (AssetFieldType)

Tipo di campo asset dell'evento di visita.

ProductChannel

Enumerazione che descrive la località di un'offerta di prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ONLINE L'articolo viene venduto online.
LOCAL L'articolo viene venduto nei negozi locali.

Conversione

Una conversione.

Rappresentazione JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Campi
resourceName

string

Il nome della risorsa della conversione. I nomi delle risorse di conversione hanno il seguente formato:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

L'ID della conversione
criterionId

string (int64 format)

ID criterio Search Ads 360. Un valore pari a 0 indica che il criterio non è attribuito.
merchantId

string (int64 format)

L'ID account inventario Search Ads 360 contenente il prodotto su cui è stato fatto clic. Search Ads 360 genera questo ID quando colleghi un account inventario in Search Ads 360.
adId

string (int64 format)

ID annuncio. Un valore pari a 0 indica che l'annuncio non è attribuito.
clickId

string

Una stringa univoca, per la visita a cui è attribuita la conversione, che viene trasmessa alla pagina di destinazione come parametro URL ID clic.
visitId

string (int64 format)

L'ID visita di Search Ads 360 a cui è attribuita la conversione.
advertiserConversionId

string

Per le conversioni offline, si tratta di un ID fornito dagli inserzionisti. Se un inserzionista non specifica un ID, Search Ads 360 ne genera uno. Per le conversioni online, questo valore è uguale alla colonna id o alla colonna floodlightOrderId, a seconda delle istruzioni Floodlight dell'inserzionista.
productId

string

L'ID del prodotto su cui è stato fatto clic.
productChannel

enum (ProductChannel)

Il canale di vendita del prodotto su cui è stato fatto clic: online o locale.
productLanguageCode

string

La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto.
productStoreId

string

Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.
productCountryCode

string

Il paese (formato ISO 3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic.
attributionType

enum (AttributionType)

A cosa è attribuita la conversione: visita o parola chiave + annuncio.
conversionDateTime

string

Il timestamp dell'evento di conversione.
conversionLastModifiedDateTime

string

Il timestamp dell'ultima modifica della conversione.
conversionVisitDateTime

string

Il timestamp della visita a cui è attribuita la conversione.
conversionQuantity

string (int64 format)

La quantità di articoli registrati dalla conversione, determinata dal parametro URL qty. L'inserzionista è responsabile del riempimento dinamico del parametro (ad esempio, il numero di articoli venduti nella conversione), altrimenti il valore predefinito è 1.
conversionRevenueMicros

string (int64 format)

Le entrate aggiustate in micro per l'evento di conversione. Sarà sempre nella valuta dell'account di pubblicazione.
floodlightOriginalRevenue

string (int64 format)

Le entrate originali e invariate associate all'evento Floodlight (nella valuta del report corrente), prima delle modifiche alle istruzioni sulla valuta Floodlight.
floodlightOrderId

string

L'ID ordine Floodlight fornito dall'inserzionista per la conversione.
status

enum (ConversionStatus)

Lo stato della conversione, ovvero ATTIVATO o RIMOSSO.
assetId

string (int64 format)

ID dell'asset con cui è stata eseguita un'interazione durante l'evento di conversione.
assetFieldType

enum (AssetFieldType)

Tipo di campo dell'asset dell'evento di conversione.

AttributionType

Tipo di attribuzione delle conversioni in Search Ads 360

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
VISIT La conversione viene attribuita a una visita.
CRITERION_AD La conversione viene attribuita a una coppia di criteri e annuncio.

ConversionStatus

Stati possibili di una conversione.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
ENABLED La conversione è abilitata.
REMOVED La conversione è stata rimossa.

Metriche

Dati delle metriche.

Rappresentazione JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Campi
allConversionsValueByConversionDate

number

Il valore di tutte le conversioni. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.
allConversionsByConversionDate

number

Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di includeInConversionsMetric. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.
conversionCustomMetrics[]

object (Value)

Le metriche personalizzate di conversione.
conversionsValueByConversionDate

number

La somma del valore delle conversioni per cui è possibile fare offerte in base alla data di conversione. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione.
conversionsByConversionDate

number

La somma delle conversioni per data di conversione per i tipi di conversione per cui è possibile fare offerte. Può essere frazionario a causa del modello di attribuzione. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione.
historicalCreativeQualityScore

enum (QualityScoreBucket)

Il punteggio di qualità storico della creatività.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

La qualità della cronologia dell'esperienza sulla pagina di destinazione.
historicalSearchPredictedCtr

enum (QualityScoreBucket)

La percentuale di clic (CTR) prevista per la ricerca storica.
interactionEventTypes[]

enum (InteractionEventType)

I tipi di interazioni a pagamento e senza costi.
rawEventConversionMetrics[]

object (Value)

Le metriche di conversione degli eventi non elaborati.
absoluteTopImpressionPercentage

number

La quota impressioni superiore assoluta sulla rete di ricerca è la percentuale di impressioni degli annunci della rete di ricerca pubblicati nella posizione più in evidenza nei risultati di ricerca.
allConversionsFromInteractionsRate

number

Tutte le conversioni dalle interazioni (anziché le conversioni view-through) divise per il numero di interazioni con l'annuncio.
allConversionsValue

number

Il valore di tutte le conversioni.
allConversions

number

Il numero totale di conversioni. Sono incluse tutte le conversioni, indipendentemente dal valore di includeInConversionsMetric.
allConversionsValuePerCost

number

Il valore di tutte le conversioni diviso per il costo totale delle interazioni con l'annuncio, ad esempio i clic per gli annunci di testo o le visualizzazioni per gli annunci video.
allConversionsFromClickToCall

number

Il numero di volte in cui gli utenti hanno fatto clic sul pulsante "Chiama" per chiamare un negozio durante o dopo aver fatto clic su un annuncio. Questo numero non indica se le chiamate sono andate a buon fine né la relativa durata.

Questa metrica si applica solo agli elementi dei feed.
allConversionsFromDirections

number

Il numero di volte in cui gli utenti hanno fatto clic sul pulsante "Indicazioni stradali" per raggiungere un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
allConversionsFromInteractionsValuePerInteraction

number

Il valore di tutte le conversioni dalle interazioni diviso per il numero totale di interazioni.
allConversionsFromMenu

number

Il numero di volte in cui gli utenti hanno fatto clic su un link per visualizzare il menu di un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
allConversionsFromOrder

number

Il numero di volte in cui gli utenti hanno effettuato un ordine in un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
allConversionsFromOtherEngagement

number

Il numero di altre conversioni (ad esempio la pubblicazione di una recensione o il salvataggio della posizione di un negozio) che si sono verificate dopo che gli utenti hanno fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
allConversionsFromStoreVisit

number

Numero stimato di volte in cui gli utenti hanno visitato un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
visits

number

Clic che Search Ads 360 ha registrato e inoltrato correttamente a una pagina di destinazione dell'inserzionista.
allConversionsFromStoreWebsite

number

Il numero di volte in cui gli utenti sono stati indirizzati all'URL di un negozio dopo aver fatto clic su un annuncio.

Questa metrica si applica solo agli elementi dei feed.
averageCost

number

L'importo medio che paghi per ogni interazione. Questo importo corrisponde al costo totale dei tuoi annunci diviso per il numero totale di interazioni.
averageCpc

number

Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
averageCpm

number

Costo per mille impressioni (CPM) medio. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks

string (int64 format)

Il numero di clic.
contentBudgetLostImpressionShare

number

La percentuale stimata di volte in cui il tuo annuncio era idoneo alla pubblicazione sulla Rete Display, ma non è stato pubblicato perché il budget era troppo basso. Nota: la quota impressioni perse a causa del budget dei contenuti viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
contentImpressionShare

number

Indica il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni dei contenuti viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.
contentRankLostImpressionShare

number

La percentuale stimata di impressioni sulla Rete Display che i tuoi annunci non hanno ricevuto a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse a causa del ranking dei contenuti viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
conversionsFromInteractionsRate

number

Media delle conversioni per cui è possibile fare offerte (dall'interazione) per interazione idonea alla conversione. Indica la frequenza media con cui un'interazione con l'annuncio genera una conversione per cui è possibile fare offerte.
clientAccountConversionsValue

number

Il valore delle conversioni dell'account cliente. Sono incluse solo le azioni di conversione per le quali l'attributo includeInClientAccountConversionsMetric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.
conversionsValuePerCost

number

Il valore della conversione per cui è possibile fare offerte diviso per il costo totale delle interazioni idonee alla conversione.
conversionsFromInteractionsValuePerInteraction

number

Il valore delle conversioni generate dalle interazioni diviso per il numero di interazioni con l'annuncio. Include solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.
clientAccountConversions

number

Il numero di conversioni dell'account cliente. Sono incluse solo le azioni di conversione per le quali l'attributo includeInClientAccountConversionsMetric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.
costMicros

string (int64 format)

Somma dei costi per clic (CPC) e costo per mille impressioni (CPM) durante questo periodo. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

Il costo delle interazioni con l'annuncio diviso per tutte le conversioni.
costPerConversion

number

Costo medio idoneo alla conversione per conversione offertabile.
costPerCurrentModelAttributedConversion

number

Il costo delle interazioni con l'annuncio diviso per le conversioni attribuite al modello corrente. Include solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.
crossDeviceConversions

number

Conversioni che si verificano quando un cliente fa clic su un annuncio su un dispositivo e poi esegue una conversione su un altro dispositivo o browser. Le conversioni cross-device sono già incluse in allConversions.
crossDeviceConversionsByConversionDate

number

Il numero di conversioni cross-device per data di conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.
crossDeviceConversionsValue

number

La somma del valore delle conversioni cross-device.
crossDeviceConversionsValueByConversionDate

number

La somma del valore delle conversioni cross-device per data di conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.
ctr

number

Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni).
conversions

number

Il numero di conversioni. Include solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi le offerte basate sulle conversioni, le strategie di offerta verranno ottimizzate per queste conversioni.
conversionsValue

number

La somma dei valori di conversione per le conversioni incluse nel campo "Conversioni". Questa metrica è utile solo se hai inserito un valore per le azioni di conversione.
averageQualityScore

number

Il punteggio di qualità medio.
historicalQualityScore

string (int64 format)

La cronologia del punteggio di qualità.
impressions

string (int64 format)

Conteggio della frequenza con cui il tuo annuncio è stato pubblicato su una pagina dei risultati di ricerca o su un sito web della rete Google.
interactionRate

number

La frequenza con cui gli utenti interagiscono con il tuo annuncio dopo che viene mostrato loro. Il numero di interazioni diviso per il numero di volte in cui l'annuncio viene pubblicato.
interactions

string (int64 format)

Il numero di interazioni. Un'interazione è l'azione principale dell'utente associata a un formato dell'annuncio, come i clic per gli annunci di testo e Shopping, le visualizzazioni per gli annunci video e così via.
invalidClickRate

number

La percentuale di clic esclusi dal numero totale di clic (clic filtrati + non filtrati) durante il periodo del report.
invalidClicks

string (int64 format)

Numero di clic che Google considera illegittimi e per i quali non ti addebita alcun costo.
generalInvalidClickRate

number

La percentuale di clic che sono stati esclusi dal numero totale di clic (clic filtrati + non filtrati) perché sono clic non validi generici. Si tratta di clic che Google considera illegali e che vengono rilevati tramite metodi di filtro di routine (ad es. traffico non valido noto dei data center, bot e spider o altri crawler, pattern irregolari e così via). Non ti viene addebitato alcun costo per questi clic, che non influiscono sulle statistiche dell'account. Per informazioni dettagliate, consulta la pagina di assistenza all'indirizzo https://support.google.com/campaignmanager/answer/6076504.
generalInvalidClicks

string (int64 format)

Numero di clic non validi generici. Si tratta di un sottoinsieme di clic non validi rilevati tramite metodi di filtro di routine (ad es. traffico non valido noto dei data center, bot e spider o altri crawler, pattern irregolari e così via). Non ti viene addebitato alcun costo per questi clic, che non influiscono sulle statistiche dell'account. Per informazioni dettagliate, consulta la pagina di assistenza all'indirizzo https://support.google.com/campaignmanager/answer/6076504.
mobileFriendlyClicksPercentage

number

La percentuale di clic da dispositivo mobile che conducono a una pagina ottimizzata per il mobile.
searchAbsoluteTopImpressionShare

number

La percentuale di impressioni degli annunci Shopping o della rete di ricerca del cliente pubblicati nella posizione più in evidenza di Shopping. Per informazioni dettagliate, visita la pagina https://support.google.com/sa360/answer/9566729. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.
searchBudgetLostAbsoluteTopImpressionShare

number

Il numero che stima la frequenza con cui il tuo annuncio non è stato il primo tra gli annunci nella parte superiore della pagina nei risultati di ricerca a causa di un budget insufficiente. Nota: la quota impressioni superiore assoluta persa sulla rete di ricerca (budget) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchBudgetLostImpressionShare

number

La percentuale stimata di volte in cui il tuo annuncio era idoneo alla pubblicazione sulla rete di ricerca, ma non è stato pubblicato perché il budget era troppo basso. Nota: la quota impressioni perse (budget) sulla rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchBudgetLostTopImpressionShare

number

Il numero che stima la frequenza con cui il tuo annuncio non è stato pubblicato in una posizione adiacente ai primi risultati di ricerca organica a causa di un budget ridotto. Nota: la quota impressioni superiore persa sulla rete di ricerca (budget) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchClickShare

number

Il numero di clic ricevuti sulla rete di ricerca diviso per il numero stimato di clic che avresti potuto ricevere. Nota: la quota clic di ricerca viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.
searchExactMatchImpressionShare

number

Le impressioni ricevute divise per il numero stimato di impressioni che avresti potuto ricevere sulla rete di ricerca per termini di ricerca esattamente corrispondenti alle tue parole chiave (o varianti simili delle tue parole chiave), indipendentemente dai tipi di corrispondenza delle parole chiave. Nota: la quota impressioni con corrispondenza esatta sulla rete di ricerca viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.
searchImpressionShare

number

Mostra il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ottenere. Nota: la quota impressioni sulla rete di ricerca viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.
searchRankLostAbsoluteTopImpressionShare

number

Il numero che stima la frequenza con cui il tuo annuncio non è stato il primo tra gli annunci nella parte superiore della pagina nei risultati di ricerca a causa di un ranking dell'annuncio basso. Nota: la quota impressioni superiore assoluta persa a causa del ranking nella rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchRankLostImpressionShare

number

La percentuale stimata di impressioni sulla rete di ricerca che i tuoi annunci non hanno ricevuto a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse a causa del ranking nella rete di ricerca viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchRankLostTopImpressionShare

number

Il numero che stima la frequenza con cui il tuo annuncio non è stato pubblicato in una posizione adiacente ai primi risultati di ricerca organica a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni superiore persa sulla rete di ricerca (ranking) viene riportata nell'intervallo da 0 a 0,9. Qualsiasi valore superiore a 0,9 viene segnalato come 0,9001.
searchTopImpressionShare

number

Le impressioni che hai ricevuto tra gli annunci nella parte superiore della pagina rispetto al numero stimato di impressioni che avresti potuto ricevere tra gli annunci nella parte superiore della pagina. Nota: la quota impressioni superiore sulla rete di ricerca viene riportata nell'intervallo da 0,1 a 1. Qualsiasi valore inferiore a 0,1 viene segnalato come 0,0999.

In genere, gli annunci nella parte superiore della pagina si trovano sopra i primi risultati organici, anche se per determinate query possono apparire sotto questi risultati.
topImpressionPercentage

number

La percentuale di impressioni degli annunci pubblicate in una posizione adiacente ai primi risultati di ricerca organica.
valuePerAllConversions

number

Il valore di tutte le conversioni diviso per il numero di tutte le conversioni.
valuePerAllConversionsByConversionDate

number

Il valore di tutte le conversioni diviso per il numero di tutte le conversioni. Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611.
valuePerConversion

number

Il valore della conversione per cui è possibile fare offerte diviso per il numero di conversioni per cui è possibile fare offerte. Mostra il valore medio di ciascuna conversione per cui è possibile fare offerte.
valuePerConversionsByConversionDate

number

Valore delle conversioni per cui è possibile fare offerte in base alla data di conversione diviso per le conversioni per cui è possibile fare offerte in base alla data di conversione. Mostra il valore medio di ciascuna conversione per cui è possibile fare offerte (in base alla data di conversione). Quando questa colonna viene selezionata con la data, i valori nella colonna della data indicano la data di conversione.
clientAccountViewThroughConversions

string (int64 format)

Il numero totale di conversioni view-through. Si verificano quando un cliente visualizza un annuncio illustrato o rich media e poi completa una conversione sul tuo sito senza interagire (ad esempio, fare clic) con un altro annuncio.
clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Il costo del venduto da cross-sell (CDV) dell'account cliente è il costo totale dei prodotti venduti come risultato della pubblicità di un altro prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Il costo del venduto da cross-sell è il costo totale dei prodotti venduti che non sono stati pubblicizzati. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da cross-sell per questo ordine è pari a 5 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

Il costo del venduto da cross-sell (CDV) è il costo totale dei prodotti venduti come risultato della pubblicità di un altro prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Il costo del venduto da cross-sell è il costo totale dei prodotti venduti che non sono stati pubblicizzati. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da cross-sell per questo ordine è pari a 5 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

Il profitto lordo da cross-sell dell'account cliente è il profitto generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso, meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Il profitto lordo da cross-sell è costituito dalle entrate generate dal cross-sell attribuito ai tuoi annunci meno il costo del venduto. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. La camicia ha un prezzo di 20 $ e un valore per il costo del venduto pari a 5 $. Il profitto lordo da cross-sell di questo ordine è di 15 $ (20 $ - 5 $). Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

Il profitto lordo da cross-sell è il profitto generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso, meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Il profitto lordo da cross-sell è costituito dalle entrate generate dal cross-sell attribuito ai tuoi annunci meno il costo del venduto. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. La camicia ha un prezzo di 20 $ e un valore per il costo del venduto pari a 5 $. Il profitto lordo da cross-sell di questo ordine è di 15 $ (20 $ - 5 $). Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

Le entrate da cross-sell dell'account cliente sono l'importo totale generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Le entrate da cross-sell corrispondono al valore totale generato dal cross-sell attribuito ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da cross-sell di questo ordine sono pari a 20 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

Le entrate da cross-sell corrispondono all'importo totale generato dai prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Le entrate da cross-sell corrispondono al valore totale generato dal cross-sell attribuito ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da cross-sell di questo ordine sono pari a 20 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

Le unità vendute da cross-sell dell'account cliente indicano il numero totale di prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Le unità vendute da cross-sell indicano il numero totale di prodotti venduti da cross-sell di tutti gli ordini attribuiti ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità vendute da cross-sell in questo ordine sono pari a 2. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.
crossSellUnitsSold

number

Le unità vendute da cross-sell indicano il numero totale di prodotti venduti come risultato della pubblicità di un prodotto diverso. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, si parla di cross-sell. Le unità vendute da cross-sell indicano il numero totale di prodotti venduti da cross-sell di tutti gli ordini attribuiti ai tuoi annunci. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità vendute da cross-sell in questo ordine sono pari a 2. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Il costo del venduto da lead (CDV) dell'account cliente è il costo totale dei prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione è associato a un prodotto (vedi Annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il costo di questi prodotti viene conteggiato nel costo del venduto da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da lead per questo ordine è pari a 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

Il costo del venduto da lead (CDV) è il costo totale dei prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione è associato a un prodotto (vedi Annunci Shopping), questo prodotto viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il costo di questi prodotti viene conteggiato nel costo del venduto da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un valore per il costo del venduto pari a 3 € e la camicia ha un valore per il costo del venduto pari a 5 €. Il costo del venduto da lead per questo ordine è pari a 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

Il profitto lordo da lead dell'account cliente è il profitto generato dai prodotti venduti come risultato della pubblicità dello stesso prodotto meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il profitto lordo da lead corrisponde alle entrate generate da queste vendite meno il costo del venduto il costo di questi prodotti. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e ha un valore per il costo del venduto pari a 3 €. Il profitto lordo da lead di questo ordine è 7 € = 10 € - 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadGrossProfitMicros

string (int64 format)

Il profitto lordo da lead è il profitto generato dai prodotti venduti come risultato della pubblicità dello stesso prodotto meno il costo del venduto (CDV). Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il profitto lordo da lead corrisponde alle entrate generate da queste vendite meno il costo del venduto il costo di questi prodotti. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e ha un valore per il costo del venduto pari a 3 €. Il profitto lordo da lead di questo ordine è 7 € = 10 € - 3 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

Le entrate da lead dell'account cliente sono l'importo totale ricavato dai prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il valore totale ricavato dalle vendite di questi prodotti viene visualizzato nelle entrate da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da lead di questo ordine sono pari a 10 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadRevenueMicros

string (int64 format)

Le entrate da lead sono l'importo totale ricavato dai prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il valore totale ricavato dalle vendite di questi prodotti viene visualizzato nelle entrate da lead. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello e una camicia. Il cappello ha un prezzo di 10 € e la camicia di 20 €. Le entrate da lead di questo ordine sono pari a 10 €. Questa metrica è disponibile solo se registri le conversioni con dati del carrello. Questa metrica è un valore monetario e viene restituita nella valuta del cliente per impostazione predefinita. Consulta il parametro metrics_currency all'indirizzo https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

Le unità lead vendute dell'account cliente sono il numero totale di prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il numero totale di questi prodotti viene visualizzato nelle unità lead vendute. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità lead vendute in questo ordine sono pari a 1. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.
leadUnitsSold

number

Le unità lead vendute sono il numero totale di prodotti venduti come risultato della pubblicità dello stesso prodotto. Come funziona: registri le conversioni con dati del carrello per gli acquisti completati sul tuo sito web. Se l'annuncio con cui è stata eseguita l'interazione prima dell'acquisto è associato a un prodotto (vedi Annunci Shopping), questo prodotto è considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine che il cliente effettua è un prodotto venduto. Se i prodotti pubblicizzati e venduti corrispondono, il numero totale di questi prodotti viene visualizzato nelle unità lead vendute. Esempio: un utente ha fatto clic su un annuncio Shopping per un cappello, poi ha acquistato quel cappello, una camicia e una giacca. Le unità lead vendute in questo ordine sono pari a 1. Questa metrica è disponibile solo se registri le conversioni con dati del carrello.
uniqueUsers

string (int64 format)

Il numero di utenti unici che hanno visualizzato il tuo annuncio durante il periodo di tempo richiesto. Questa metrica non può essere aggregata e può essere richiesta solo per intervalli di date di 92 giorni o meno. Questa metrica è disponibile per i seguenti tipi di campagne: display, video, discovery e per app.
averageImpressionFrequencyPerUser

number

Il numero medio di volte in cui un utente unico ha visualizzato il tuo annuncio durante il periodo di tempo richiesto. Questa metrica non può essere aggregata e può essere richiesta solo per intervalli di date di 92 giorni o meno. Questa metrica è disponibile per i seguenti tipi di campagne: display, video, discovery e per app.

Valore

Un contenitore di dati generico.

Rappresentazione JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Campi
Campo unione value. Un valore. value può essere solo uno dei seguenti:
booleanValue

boolean

Un valore booleano.
int64Value

string (int64 format)

Un int64.
floatValue

number

Un galleggiante.
doubleValue

number

Un double.
stringValue

string

Una stringa.

QualityScoreBucket

Enumerazione che elenca i possibili bucket del punteggio di qualità.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
BELOW_AVERAGE La qualità della creatività è inferiore alla media.
AVERAGE La qualità della creatività è nella media.
ABOVE_AVERAGE La qualità della creatività è superiore alla media.

InteractionEventType

Enumerazione che descrive i possibili tipi di interazioni a pagamento e senza costi.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
CLICK Fai clic su Vai al sito. Nella maggior parte dei casi, questa interazione porta a una posizione esterna, di solito la pagina di destinazione dell'inserzionista. Questo è anche l'InteractionEventType predefinito per gli eventi di clic.
ENGAGEMENT L'intenzione espressa dall'utente di interagire con l'annuncio in loco.
VIDEO_VIEW L'utente ha visualizzato un annuncio video.
NONE InteractionEventType predefinito per gli eventi di conversione degli annunci. Viene utilizzato quando una riga di conversione dell'annuncio NON indica che le interazioni senza costi (ad esempio le conversioni dell'annuncio) devono essere "promosse" e registrate come parte delle metriche principali. Si tratta semplicemente di altre conversioni (annunci).

Segmenti

Campi solo segmento.

Rappresentazione JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Campi
adNetworkType

enum (AdNetworkType)

Tipo di rete pubblicitaria.
conversionActionCategory

enum (ConversionActionCategory)

Categoria azione di conversione.
conversionCustomDimensions[]

object (Value)

Le dimensioni personalizzate di conversione.
dayOfWeek

enum (DayOfWeek)

Giorno della settimana, ad esempio LUNEDÌ.
device

enum (Device)

Il dispositivo a cui si applicano le metriche.
keyword

object (Keyword)

Criterio parola chiave.
productChannel

enum (ProductChannel)

Canale del prodotto.
productChannelExclusivity

enum (ProductChannelExclusivity)

Esclusività del canale del prodotto.
productCondition

enum (ProductCondition)

Condizioni del prodotto.
productSoldCondition

enum (ProductCondition)

Condizione del prodotto venduto.
rawEventConversionDimensions[]

object (Value)

Le dimensioni di conversione degli eventi non elaborati.
conversionAction

string

Nome della risorsa dell'azione di conversione.
conversionActionName

string

Nome azione di conversione.
date

string

Data a cui si applicano le metriche. Formato aaaa-MM-gg, ad esempio 2018-04-17.
geoTargetCity

string

Nome della risorsa della costante di targeting geografico che rappresenta una città.
geoTargetCountry

string

Nome risorsa della costante di targeting geografico che rappresenta un paese.
geoTargetMetro

string

Nome risorsa della costante di targeting geografico che rappresenta una città.
geoTargetRegion

string

Nome della risorsa della costante di targeting geografico che rappresenta una regione.
hour

integer

L'ora del giorno come numero compreso tra 0 e 23, inclusi.
month

string

Mese rappresentato dalla data del primo giorno di un mese. Formattata come aaaa-MM-gg.
productBiddingCategoryLevel1

string

Categoria di offerta (livello 1) del prodotto.
productBiddingCategoryLevel2

string

Categoria di offerta (2° livello) del prodotto.
productBiddingCategoryLevel3

string

Categoria di offerta (livello 3) del prodotto.
productBiddingCategoryLevel4

string

Categoria di offerta (livello 4) del prodotto.
productBiddingCategoryLevel5

string

Categoria di offerta (livello 5) del prodotto.
productBrand

string

La marca del prodotto.
productCountry

string

Nome della risorsa della costante di targeting geografico per il paese di vendita del prodotto.
productCustomAttribute0

string

Attributo personalizzato 0 del prodotto.
productCustomAttribute1

string

Attributo personalizzato 1 del prodotto.
productCustomAttribute2

string

Attributo personalizzato 2 del prodotto.
productCustomAttribute3

string

Attributo personalizzato 3 del prodotto.
productCustomAttribute4

string

Attributo personalizzato 4 del prodotto.
productItemId

string

ID articolo del prodotto.
productLanguage

string

Nome della risorsa della costante di lingua per la lingua del prodotto.
productSoldBiddingCategoryLevel1

string

Categoria di offerta (livello 1) del prodotto venduto.
productSoldBiddingCategoryLevel2

string

Categoria di offerta (livello 2) del prodotto venduto.
productSoldBiddingCategoryLevel3

string

Categoria di offerta (livello 3) del prodotto venduto.
productSoldBiddingCategoryLevel4

string

Categoria di offerta (livello 4) del prodotto venduto.
productSoldBiddingCategoryLevel5

string

Categoria di offerta (livello 5) del prodotto venduto.
productSoldBrand

string

Marca del prodotto venduto.
productSoldCustomAttribute0

string

Attributo personalizzato 0 del prodotto venduto.
productSoldCustomAttribute1

string

Attributo personalizzato 1 del prodotto venduto.
productSoldCustomAttribute2

string

Attributo personalizzato 2 del prodotto venduto.
productSoldCustomAttribute3

string

Attributo personalizzato 3 del prodotto venduto.
productSoldCustomAttribute4

string

Attributo personalizzato 4 del prodotto venduto.
productSoldItemId

string

L'ID articolo del prodotto venduto.
productSoldTitle

string

Titolo del prodotto venduto.
productSoldTypeL1

string

Tipo (livello 1) di prodotto venduto.
productSoldTypeL2

string

Tipo (livello 2) del prodotto venduto.
productSoldTypeL3

string

Tipo (livello 3) del prodotto venduto.
productSoldTypeL4

string

Tipo (livello 4) di prodotto venduto.
productSoldTypeL5

string

Tipo (livello 5) del prodotto venduto.
productStoreId

string

ID negozio del prodotto.
productTitle

string

Titolo del prodotto.
productTypeL1

string

Tipo (livello 1) di prodotto.
productTypeL2

string

Tipo (2° livello) di prodotto.
productTypeL3

string

Tipo (3° livello) di prodotto.
productTypeL4

string

Tipo (4° livello) di prodotto.
productTypeL5

string

Tipo (livello 5) di prodotto.
quarter

string

Il trimestre rappresentato dalla data del primo giorno di un trimestre. Utilizza l'anno solare per i trimestri, ad esempio il secondo trimestre del 2018 inizia il 1° aprile 2018. Formattata come aaaa-MM-gg.
week

string

Settimana definita da lunedì a domenica e rappresentata dalla data di lunedì. Formattata come aaaa-MM-gg.
year

integer

Anno, formattato come aaaa.
assetInteractionTarget

object (AssetInteractionTarget)

Utilizzato solo con le metriche CustomerAsset, CampaignAsset e AdGroupAsset. Indica se le metriche di interazione si sono verificate sull'asset stesso o su un altro asset o unità pubblicitaria. Le interazioni (ad esempio, i clic) vengono conteggiate in tutte le parti dell'annuncio pubblicato (ad esempio, l'annuncio stesso e altri componenti come i sitelink) quando vengono pubblicati insieme. Quando interactionOnThisAsset è true, significa che le interazioni riguardano questo asset specifico. Quando interactionOnThisAsset è false, significa che le interazioni non riguardano questo asset specifico, ma altre parti dell'annuncio pubblicato con cui viene pubblicato questo asset.

AdNetworkType

Elenca i tipi di rete Google Ads.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
SEARCH Ricerca con Google.
SEARCH_PARTNERS Partner di ricerca.
CONTENT Rete Display.
YOUTUBE_WATCH Video di YouTube
MIXED Su più reti.

Parola chiave

Un segmento di criteri parola chiave.

Rappresentazione JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Campi
info

object (KeywordInfo)

Informazioni sulle parole chiave.
adGroupCriterion

string

Il nome della risorsa AdGroupCriterion.

ProductChannelExclusivity

Enumerazione che descrive la disponibilità di un'offerta di prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
SINGLE_CHANNEL L'articolo viene venduto solo tramite un canale, ovvero negozi locali o online, come indicato da ProductChannel.
MULTI_CHANNEL L'articolo viene abbinato alla sua controparte nei negozi online o locali, il che indica che è disponibile per l'acquisto in entrambi i canali ShoppingProductChannels.

ProductCondition

Enumerazione che descrive la condizione di un'offerta di prodotto.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione.
OLD La condizione del prodotto è usata.
NEW La condizione del prodotto è nuova.
REFURBISHED La condizione del prodotto è ricondizionato.
USED La condizione del prodotto è "Usato".

AssetInteractionTarget

Un segmento AssetInteractionTarget.

Rappresentazione JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Campi
asset

string

Il nome della risorsa asset.
interactionOnThisAsset

boolean

Utilizzato solo con le metriche CustomerAsset, CampaignAsset e AdGroupAsset. Indica se le metriche di interazione si sono verificate sull'asset stesso o su un altro asset o unità pubblicitaria.