- Rappresentazione JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Annuncio
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Dispositivo
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- Risorsa
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- Campagna
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- Pubblico
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Cliente
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Etichetta
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- Visita
- ProductChannel
- Conversione
- AttributionType
- ConversionStatus
- Metriche
- Conveniente
- QualityScoreBucket
- InteractionEventType
- Segmenti
- AdNetworkType
- Parola chiave
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
Una riga restituita dalla query.
Rappresentazione JSON |
---|
{ "adGroup": { object ( |
Campi | |
---|---|
adGroup |
Il gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupAd |
L'annuncio a cui viene fatto riferimento nella query. |
adGroupAdLabel |
L'etichetta dell'annuncio del gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupAsset |
L'asset del gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupAssetSet |
L'insieme di asset del gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupAudienceView |
La visualizzazione del segmento di pubblico del gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupBidModifier |
Modificatore di offerta a cui viene fatto riferimento nella query. |
adGroupCriterion |
Il criterio a cui viene fatto riferimento nella query. |
adGroupCriterionLabel |
L'etichetta del criterio del gruppo di annunci a cui viene fatto riferimento nella query. |
adGroupLabel |
L'etichetta del gruppo di annunci a cui viene fatto riferimento nella query. |
ageRangeView |
La visualizzazione della fascia d'età a cui viene fatto riferimento nella query. |
asset |
L'asset a cui viene fatto riferimento nella query. |
assetGroupAsset |
L'asset del gruppo di asset a cui viene fatto riferimento nella query. |
assetGroupSignal |
L'indicatore dei gruppi di asset a cui viene fatto riferimento nella query. |
assetGroupListingGroupFilter |
Il filtro del gruppo di schede del gruppo di asset a cui viene fatto riferimento nella query. |
assetGroupTopCombinationView |
La visualizzazione della combinazione di asset del gruppo di asset a cui viene fatto riferimento nella query. |
assetGroup |
Il gruppo di asset a cui viene fatto riferimento nella query. |
assetSetAsset |
L'asset set di asset a cui viene fatto riferimento nella query. |
assetSet |
Il set di asset a cui viene fatto riferimento nella query. |
biddingStrategy |
La strategia di offerta a cui viene fatto riferimento nella query. |
campaignBudget |
Il budget della campagna a cui viene fatto riferimento nella query. |
campaign |
La campagna a cui viene fatto riferimento nella query. |
campaignAsset |
L'asset della campagna a cui viene fatto riferimento nella query. |
campaignAssetSet |
Il set di asset della campagna a cui viene fatto riferimento nella query. |
campaignAudienceView |
La visualizzazione del pubblico della campagna a cui viene fatto riferimento nella query. |
campaignCriterion |
Il criterio della campagna a cui viene fatto riferimento nella query. |
campaignLabel |
L'etichetta della campagna a cui viene fatto riferimento nella query. |
cartDataSalesView |
La vista delle vendite dei dati del carrello a cui viene fatto riferimento nella query. |
audience |
Il segmento di pubblico a cui viene fatto riferimento nella query. |
conversionAction |
L'azione di conversione a cui viene fatto riferimento nella query. |
conversionCustomVariable |
La variabile personalizzata di conversione a cui viene fatto riferimento nella query. |
customer |
Il cliente indicato nella query. |
customerAsset |
L'asset del cliente a cui viene fatto riferimento nella query. |
customerAssetSet |
Il set di asset del cliente a cui viene fatto riferimento nella query. |
accessibleBiddingStrategy |
La strategia di offerta accessibile a cui viene fatto riferimento nella query. |
customerManagerLink |
Il CustomerManagerLink a cui viene fatto riferimento nella query. |
customerClient |
Il CustomerClient a cui viene fatto riferimento nella query. |
dynamicSearchAdsSearchTermView |
La visualizzazione del termine di ricerca degli annunci dinamici della rete di ricerca a cui viene fatto riferimento nella query. |
genderView |
La visualizzazione del genere a cui viene fatto riferimento nella query. |
geoTargetConstant |
La costante del target geografico a cui viene fatto riferimento nella query. |
keywordView |
La visualizzazione delle parole chiave a cui viene fatto riferimento nella query. |
label |
L'etichetta a cui viene fatto riferimento nella query. |
languageConstant |
La costante linguistica a cui viene fatto riferimento nella query. |
locationView |
La vista della località a cui viene fatto riferimento nella query. |
productBiddingCategoryConstant |
La categoria di offerte per i prodotti a cui viene fatto riferimento nella query. |
productGroupView |
La vista del gruppo di prodotti a cui viene fatto riferimento nella query. |
shoppingPerformanceView |
La visualizzazione del rendimento di Shopping a cui viene fatto riferimento nella query. |
userList |
L'elenco di utenti a cui viene fatto riferimento nella query. |
webpageView |
La visualizzazione della pagina web a cui viene fatto riferimento nella query. |
visit |
La visita a livello di evento a cui viene fatto riferimento nella query. |
conversion |
La conversione a livello di evento a cui viene fatto riferimento nella query. |
metrics |
Le metriche. |
segments |
I segmenti. |
customColumns[] |
Le colonne personalizzate. |
Gruppo di annunci
Un gruppo di annunci.
Rappresentazione JSON |
---|
{ "resourceName": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa del gruppo di annunci. I nomi delle risorse dei gruppi di annunci hanno il seguente formato:
|
status |
Lo stato del gruppo di annunci. |
type |
Il tipo di gruppo di annunci. |
adRotationMode |
La modalità di rotazione annunci del gruppo di annunci. |
creationTime |
Il timestamp di creazione di questo gruppo di annunci. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
targetingSetting |
Impostazione per il targeting di funzionalità correlate. |
labels[] |
I nomi delle risorse delle etichette associate a questo gruppo di annunci. |
engineId |
ID del gruppo di annunci nell'account motore esterno. Questo campo è destinato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza "adGroup.id" . |
startDate |
Data in cui questo gruppo di annunci inizia a pubblicare annunci. Per impostazione predefinita, il gruppo di annunci inizia ora o alla sua data di inizio, a seconda dell'evento che si verifica per ultimo. Se questo campo viene impostato, il gruppo di annunci inizia all'inizio della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway di Microsoft Advertising e Facebook. Formato: AAAA-MM-GG Esempio: 2019-03-14 |
endDate |
Data in cui termina la pubblicazione degli annunci nel gruppo di annunci. Per impostazione predefinita, il gruppo di annunci termina alla relativa data di fine. Se questo campo viene impostato, il gruppo di annunci termina alla fine della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway di Microsoft Advertising e Facebook. Formato: AAAA-MM-GG Esempio: 2019-03-14 |
languageCode |
La lingua degli annunci e delle parole chiave di un gruppo di annunci. Questo campo è disponibile solo per gli account Microsoft Advertising. Ulteriori dettagli: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
lastModifiedTime |
La data e l'ora dell'ultima modifica del gruppo di annunci. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
id |
L'ID del gruppo di annunci. |
name |
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 nulli (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorni a capo (punto di codice 0xD). |
cpcBidMicros |
L'offerta CPC (costo per clic) massimo. |
engineStatus |
Stato motore per gruppo di annunci. |
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 è stato rimosso. |
AdGroupType
Elenco enum dei 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 di prodotto standard. |
SHOPPING_SHOWCASE_ADS |
Il tipo per i gruppi di annunci che possono pubblicare solo annunci vetrina o di commercianti nei risultati di Google 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 in-stream TrueView (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 gruppi di annunci dinamici della rete di ricerca. |
SHOPPING_COMPARISON_LISTING_ADS |
Il tipo per i gruppi di annunci nelle campagne per il confronto di Shopping. |
PROMOTED_HOTEL_ADS |
Il tipo di gruppo di annunci per i gruppi di annunci per hotel sponsorizzati. |
VIDEO_RESPONSIVE |
Gruppi di annunci adattabili video. |
VIDEO_EFFICIENT_REACH |
Gruppi di annunci con copertura efficace per i 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 annunci non è stata specificata. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta. |
OPTIMIZE |
Ottimizza gli annunci dei gruppi di annunci in base ai clic o alle conversioni. |
ROTATE_FOREVER |
Ruota in modo uniforme all'infinito. |
AdGroupEngineStatus
Stato del motore del gruppo di annunci.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
AD_GROUP_ELIGIBLE |
Deprecato. Non utilizzare. |
AD_GROUP_EXPIRED |
Nessun annuncio viene pubblicato per questo gruppo di annunci perché la data di fine del gruppo è trascorsa. |
AD_GROUP_REMOVED |
Il gruppo di annunci è stato eliminato. |
AD_GROUP_DRAFT |
Nessun annuncio viene pubblicato per questo gruppo di annunci perché il gruppo di annunci associato è ancora in forma di bozza. |
AD_GROUP_PAUSED |
Il gruppo di annunci è stato messo in pausa. |
AD_GROUP_SERVING |
Il gruppo di annunci è attivo e al momento pubblica annunci. |
AD_GROUP_SUBMITTED |
Il gruppo di annunci è stato inviato (stato precedente di Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
Nessun annuncio viene pubblicato per questo gruppo di annunci perché la campagna è stata messa in pausa. |
ACCOUNT_PAUSED |
Nessun annuncio viene pubblicato per questo gruppo di annunci perché l'account è stato messo in pausa. |
TargetingSetting
Impostazioni per le funzionalità correlate al targeting, a livello di campagna e di gruppo di annunci. Per ulteriori informazioni sull'impostazione di targeting, consulta la pagina https://support.google.com/google-ads/answer/7365594
Rappresentazione JSON |
---|
{
"targetRestrictions": [
{
object ( |
Campi | |
---|---|
targetRestrictions[] |
L'impostazione della dimensione per targeting per limitare la copertura della campagna o del gruppo di annunci. |
TargetRestriction
L'elenco di impostazioni di targeting per dimensione di targeting.
Rappresentazione JSON |
---|
{
"targetingDimension": enum ( |
Campi | |
---|---|
targetingDimension |
La dimensione di targeting a cui si applicano queste impostazioni. |
bidOnly |
Indica se limitare la pubblicazione degli annunci solo in base 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. Il valore |
TargetingDimension
Enum che descrive le possibili dimensioni di targeting.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 target su "TUTTE" con TargetRestriction. |
AUDIENCE |
Criteri del segmento di pubblico, che includono elenco utenti, interesse degli utenti, affinità personalizzata e personalizzato in-market. |
TOPIC |
Criteri argomenti per il targeting di categorie di contenuti, ad esempio "category::Animals>Animali domestici" Utilizzato per il targeting video e display. |
GENDER |
Criteri per il targeting del genere. |
AGE_RANGE |
Criteri per il targeting delle fasce d'età. |
PLACEMENT |
Criteri di posizionamento, che comprendono siti web quali "www.flowers4sale.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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'annuncio. I nomi delle risorse di annunci dei gruppi di annunci hanno il seguente formato:
|
status |
Lo stato dell'annuncio. |
ad |
L'annuncio. |
creationTime |
Il timestamp di creazione di questo annuncio del gruppo di annunci. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
labels[] |
I nomi delle risorse delle etichette associate all'annuncio di questo gruppo di annunci. |
engineId |
ID dell'annuncio nell'account motore esterno. Questo campo è destinato solo agli 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 |
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 |
La data e l'ora dell'ultima modifica dell'annuncio del gruppo di annunci. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
AdGroupAdStatus
I possibili stati di un annuncio del gruppo di annunci.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
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 è stato rimosso. |
Annuncio
Un annuncio.
Rappresentazione JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'annuncio. I nomi delle risorse pubblicitarie hanno il seguente formato:
|
finalUrls[] |
L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio. |
type |
Il tipo di annuncio. |
id |
L'ID dell'annuncio. |
displayUrl |
L'URL che appare nella descrizione dell'annuncio per alcuni formati. |
name |
Il nome dell'annuncio. Viene utilizzato solo per poter identificare l'annuncio. Non deve essere univoco e non influisce sull'annuncio pubblicato. Il campo Nome è attualmente supportato solo per DisplayUploadAd, Image Ad, ShoppingComparisonListingAd e Video Ad. |
Campo unione ad_data . Dettagli pertinenti al tipo di annuncio. È necessario impostare esattamente un valore. ad_data può essere solo uno dei seguenti: |
|
textAd |
Dettagli relativi a un annuncio di testo. |
expandedTextAd |
Dettagli relativi a un annuncio di testo espanso. |
responsiveSearchAd |
Dettagli relativi a un annuncio adattabile della rete di ricerca. |
productAd |
Dettagli relativi a un annuncio di prodotto. |
expandedDynamicSearchAd |
Dettagli relativi a un annuncio dinamico della rete di ricerca espanso. |
AdType
I possibili tipi di annunci.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
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 è 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 è un annuncio Gmail. |
IMAGE_AD |
Questo annuncio è un annuncio illustrato. |
RESPONSIVE_SEARCH_AD |
Si tratta di un annuncio adattabile della rete di ricerca. |
LEGACY_RESPONSIVE_DISPLAY_AD |
L'annuncio è un annuncio display adattabile legacy. |
APP_AD |
L'annuncio è un annuncio per app. |
LEGACY_APP_INSTALL_AD |
L'annuncio è un annuncio legacy per l'installazione di app. |
RESPONSIVE_DISPLAY_AD |
L'annuncio è un annuncio display adattabile. |
LOCAL_AD |
L'annuncio è un annuncio locale. |
HTML5_UPLOAD_AD |
L'annuncio è un annuncio display da caricamento con tipo di prodotto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
L'annuncio è un annuncio display caricato 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 per il confronto di Shopping. |
VIDEO_BUMPER_AD |
Annuncio bumper video. |
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 adattabile video. |
SMART_CAMPAIGN_AD |
Annuncio di una campagna intelligente. |
APP_PRE_REGISTRATION_AD |
Annuncio di preregistrazione di app universale. |
DISCOVERY_MULTI_ASSET_AD |
Annuncio discovery con più asset. |
DISCOVERY_CAROUSEL_AD |
Annuncio carosello discovery. |
TRAVEL_AD |
Annuncio di viaggio. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Annuncio adattabile video discovery. |
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 |
Titolo dell'annuncio. |
description1 |
La prima riga della descrizione dell'annuncio. |
description2 |
La seconda riga della descrizione dell'annuncio. |
displayUrl |
L'URL visualizzato dell'annuncio. |
displayMobileUrl |
L'URL mobile visualizzato dell'annuncio. |
adTrackingId |
L'ID di 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 |
Titolo dell'annuncio. |
headline2 |
Il secondo titolo dell'annuncio. |
headline3 |
Il terzo titolo dell'annuncio. |
description1 |
La prima riga della descrizione dell'annuncio. |
description2 |
La seconda riga della descrizione dell'annuncio. |
path1 |
Testo aggiunto all'URL visibile generato automaticamente con un delimitatore. |
path2 |
Testo aggiunto al percorso 1 con un delimitatore. |
adTrackingId |
L'ID di monitoraggio dell'annuncio. |
SearchAds360ResponsiveSearchAdInfo
Un annuncio adattabile della rete di ricerca Search Ads 360.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco degli asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli vengono selezionati dall'elenco. |
descriptions[] |
Elenco degli asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni vengono selezionate dall'elenco. |
path1 |
Testo aggiunto all'URL visibile generato automaticamente con un delimitatore. |
path2 |
Testo aggiunto al percorso 1 con un delimitatore. |
adTrackingId |
L'ID di monitoraggio dell'annuncio. |
AdTextAsset
Un asset di testo utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "text": string } |
Campi | |
---|---|
text |
Testo dell'asset. |
SearchAds360ProductAdInfo
Questo tipo non contiene campi.
Un annuncio di prodotto Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
Un annuncio dinamico della rete di ricerca espanso.
Rappresentazione JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Campi | |
---|---|
description1 |
La prima riga della descrizione dell'annuncio. |
description2 |
La seconda riga della descrizione dell'annuncio. |
adTrackingId |
L'ID di monitoraggio dell'annuncio. |
AdGroupAdEngineStatus
Indica gli stati del motore Gruppo di annunci.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 sul dispositivo mobile, ma è valida sul computer. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: la creatività è pronta per l'attivazione. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: creatività non 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. |
AdGroupAdLabel
Una relazione tra l'annuncio di un gruppo di annunci e un'etichetta.
Rappresentazione JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'etichetta annuncio del gruppo di annunci. I nomi delle risorse delle etichette annuncio del gruppo di annunci hanno il formato: |
adGroupAd |
L'annuncio del gruppo di annunci a cui è allegata l'etichetta. |
label |
L'etichetta assegnata all'annuncio del gruppo di annunci. |
AdGroupAsset
Un collegamento tra un gruppo di annunci e un asset.
Rappresentazione JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset del gruppo di annunci. I nomi delle risorse degli asset gruppo di annunci hanno il formato:
|
adGroup |
Obbligatorio. Il gruppo di annunci a cui è collegato l'asset. |
asset |
Obbligatorio. L'asset collegato al gruppo di annunci. |
status |
Stato dell'asset del gruppo di annunci. |
AssetLinkStatus
Enum che descrive gli stati del collegamento di una risorsa.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ENABLED |
Il collegamento agli asset è attivato. |
REMOVED |
Il link all'asset è stato rimosso. |
PAUSED |
Il link all'asset è in pausa. |
AdGroupAssetSet
Gruppo di annunciAssetSet è il collegamento tra un gruppo di annunci e un insieme di asset. La creazione di un gruppo di annunciAssetSet collega un insieme di asset a un gruppo di annunci.
Rappresentazione JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'insieme di asset del gruppo di annunci. I nomi delle risorse del set di asset del gruppo di annunci hanno il seguente formato:
|
adGroup |
Il gruppo di annunci a cui è collegato questo insieme di asset. |
assetSet |
L'insieme di asset collegato al gruppo di annunci. |
status |
Lo stato dell'insieme di asset del gruppo di annunci. Sola lettura. |
AssetSetLinkStatus
I possibili stati del collegamento tra l'insieme 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 l'insieme di asset e il relativo contenitore è abilitato. |
REMOVED |
Il collegamento tra l'insieme di asset e il relativo contenitore viene rimosso. |
AdGroupAudienceView
Una visualizzazione del segmento di pubblico del gruppo di annunci. Include i dati sul rendimento di interessi ed elenchi per il remarketing per gli annunci della Rete Display e della rete YouTube ed elenchi per il remarketing per gli annunci della rete di ricerca (RLSA), aggregati a livello di pubblico.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione del segmento di pubblico del gruppo di annunci. I nomi delle risorse di visualizzazione del pubblico del gruppo di annunci hanno il seguente formato:
|
AdGroupBidModifier
Rappresenta un modificatore di offerta per gruppo di annunci.
Rappresentazione JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Campi | |
---|---|
resourceName |
Il nome della risorsa del modificatore di offerta per gruppo di annunci. I nomi delle risorse del modificatore di offerta per gruppo di annunci hanno il seguente formato:
|
bidModifier |
Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso tra 0,1 e 10,0. L'intervallo è 1,0-6,0 per PreferredContent. Utilizza 0 per disattivare un tipo di dispositivo. |
Campo unione Obbligatorio nelle operazioni di creazione a partire dalla V5. |
|
device |
Un criterio dispositivo. |
DeviceInfo
Un criterio dispositivo.
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type |
Tipo di dispositivo. |
Dispositivo
Indica 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 che sono stati aggiunti esplicitamente al gruppo di annunci.
Rappresentazione JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Il nome risorsa del criterio del gruppo di annunci. I nomi delle risorse per il criterio del gruppo di annunci hanno il seguente formato:
|
creationTime |
Il timestamp di creazione di questo criterio del gruppo di annunci. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
status |
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 ulteriori informazioni che influiscono sull'idoneità di un criterio all'esecuzione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere mostrato come abilitato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate a utenti di tutte le fasce d'età, salvo escluse. L'interfaccia utente mostrerà ogni fascia d'età come "attivata", in quanto è idonea a visualizzare gli annunci. ma groupCriterion.status mostrerà "rimosso", dato che non è stato aggiunto alcun criterio positivo. |
qualityInfo |
Informazioni sulla qualità del criterio. |
type |
Il tipo di criterio. |
labels[] |
I nomi delle risorse delle etichette associate a questo criterio del gruppo di annunci. |
positionEstimates |
Stime per le offerte per criterio in varie posizioni. |
finalUrls[] |
L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio. |
engineId |
ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è destinato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza "adGroupCriterion.criterion_id" . |
lastModifiedTime |
La data e l'ora dell'ultima modifica di questo criterio del gruppo di annunci. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
criterionId |
L'ID del criterio. |
adGroup |
Il gruppo di annunci a cui appartiene il criterio. |
negative |
Indica se scegliere come target ( Questo campo è immutabile. Per cambiare un criterio da positivo a negativo, rimuovilo e poi riaggiungilo. |
bidModifier |
Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso tra 0,1 e 10,0. La maggior parte dei tipi di criteri disponibili per il targeting supporta i modificatori. |
cpcBidMicros |
L'offerta CPC (costo per clic). |
effectiveCpcBidMicros |
L'offerta CPC (costo per clic) effettivo. |
engineStatus |
Lo stato motore per il criterio gruppo di annunci. |
finalUrlSuffix |
Modello di URL per l'aggiunta di parametri all'URL finale. |
trackingUrlTemplate |
Il modello di URL per la creazione di un URL di monitoraggio. |
Campo unione Deve essere impostato in modo esatto. |
|
keyword |
Parola chiave. |
listingGroup |
Gruppo di schede. |
ageRange |
Fascia d'età. |
gender |
Genere. |
userList |
Elenco utenti. |
webpage |
Pagina web |
location |
Posizione. |
AdGroupCriterionStatus
I possibili stati di un criterio del gruppo di annunci.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
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 è stato rimosso. |
QualityInfo
Un contenitore per le informazioni sulla qualità del criterio del gruppo di annunci.
Rappresentazione JSON |
---|
{ "qualityScore": integer } |
Campi | |
---|---|
qualityScore |
Il punteggio di qualità. Questo campo potrebbe non essere compilato se Google non dispone di informazioni sufficienti per determinare un valore. |
CriterionType
Enum che descrive i possibili tipi di criteri.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 |
Applicazioni mobile da scegliere come target. |
DEVICE |
Dispositivi da scegliere come target. |
LOCATION |
Località da scegliere come 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 e animali domestici"). |
LISTING_SCOPE |
Ambito della scheda da scegliere come target. |
LANGUAGE |
Lingua. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
Etichetta contenuti per l'esclusione di categorie. |
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 della campagna intelligente |
AUDIENCE |
Pubblico |
LOCAL_SERVICE_ID |
ID servizio di annunci di Servizi locali. |
BRAND |
Brand |
BRAND_LIST |
Elenco di brand |
LIFE_EVENT |
Evento importante |
PositionEstimates
Stime per le offerte per criterio in varie posizioni.
Rappresentazione JSON |
---|
{ "topOfPageCpcMicros": string } |
Campi | |
---|---|
topOfPageCpcMicros |
La stima dell'offerta CPC necessaria per la pubblicazione dell'annuncio nella parte superiore della prima pagina dei risultati di ricerca. |
AdGroupCriterionEngineStatus
Enumera gli stati del motore Criteri del gruppo di annunci.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
AD_GROUP_CRITERION_ELIGIBLE |
Deprecato. Non utilizzare. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: offerta o qualità troppo bassa per essere visualizzata. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: offerta o qualità troppo bassa per i dispositivi mobili, ma idonea alla visualizzazione su computer. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: offerta o qualità troppo bassa per i dispositivi desktop, ma idonea alla visualizzazione sui dispositivi mobili. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: offerta o qualità troppo bassa per essere visualizzata. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: messo in pausa da Baidu a causa di un volume di ricerca basso. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: URL mobile in corso di revisione. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: la pagina di destinazione di un dispositivo non è valida, mentre quella dell'altro dispositivo lo è. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: la parola chiave è stata creata e messa in pausa dalla gestione account di Baidu ed è ora pronta per essere attivata. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: in corso di revisione da parte di 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 : criterio in attesa di revisione |
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 è stato messo in pausa perché l'account è stato messo in pausa. |
KeywordInfo
Un criterio di parola chiave.
Rappresentazione JSON |
---|
{
"matchType": enum ( |
Campi | |
---|---|
matchType |
Il tipo di corrispondenza della parola chiave. |
text |
Il testo della parola chiave (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 un valore sconosciuto in questa versione. |
EXACT |
Corrispondenza esatta. |
PHRASE |
Corrispondenza a frase. |
BROAD |
Corrispondenza generica. |
ListingGroupInfo
Un criterio di gruppo di elenchi.
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type |
Tipo di gruppo di schede. |
ListingGroupType
Il tipo di gruppo di schede.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
SUBDIVISION |
Suddivisione dei prodotti in base a una dimensione della scheda. Questi nodi non vengono utilizzati per il targeting delle voci di elenco, ma servono solo a definire la struttura dell'albero. |
UNIT |
Unità del gruppo di schede che definisce un'offerta. |
AgeRangeInfo
Un criterio della fascia di età.
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type |
Tipo di fascia d'età. |
AgeRangeType
Il tipo di fasce d'età demografiche (ad es. tra 18 e 24 anni).
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
AGE_RANGE_18_24 |
Di età compresa tra 18 e 24 anni. |
AGE_RANGE_25_34 |
Di età compresa tra 25 e 34 anni. |
AGE_RANGE_35_44 |
Di età compresa tra 35 e 44 anni. |
AGE_RANGE_45_54 |
Di età compresa tra 45 e 54 anni. |
AGE_RANGE_55_64 |
Di età compresa tra 55 e 64 anni. |
AGE_RANGE_65_UP |
A partire da 65 anni. |
AGE_RANGE_UNDETERMINED |
Fascia d'età indeterminata. |
GenderInfo
Un criterio relativo al genere.
Rappresentazione JSON |
---|
{
"type": enum ( |
Campi | |
---|---|
type |
Tipo di genere. |
GenderType
Il tipo di dati demografici di genere (ad es. donna).
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
MALE |
Uomo. |
FEMALE |
Donna. |
UNDETERMINED |
Genere indeterminato. |
UserListInfo
Un criterio dell'elenco utenti. Rappresenta un elenco di utenti definito dall'inserzionista target.
Rappresentazione JSON |
---|
{ "userList": string } |
Campi | |
---|---|
userList |
Il nome della risorsa Elenco utenti. |
WebpageInfo
Rappresenta un criterio per il targeting di pagine web del sito web di un inserzionista.
Rappresentazione JSON |
---|
{
"conditions": [
{
object ( |
Campi | |
---|---|
conditions[] |
Condizioni, o espressioni logiche, per il targeting di pagine web. L'elenco di condizioni di targeting di pagine web viene unito insieme quando viene valutato per il targeting. Un elenco di condizioni vuoto indica che tutte le pagine del sito web della campagna sono state scelte come target. Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni UPDATE. |
coveragePercentage |
Percentuale di copertura dei criteri del sito web. La percentuale calcolata della 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, se la copertura restituisce 1, significa che ha una copertura del 100%. Questo campo è di sola lettura. |
criterionName |
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 ed è vietato per le operazioni UPDATE. |
WebpageConditionInfo
Espressione logica per il targeting di pagine web del sito web di un inserzionista.
Rappresentazione JSON |
---|
{ "operand": enum ( |
Campi | |
---|---|
operand |
Operando della condizione di targeting della pagina web. |
operator |
Operatore della condizione di targeting della pagina web. |
argument |
Argomento della condizione di targeting della pagina web. |
WebpageConditionOperand
L'operando della condizione della pagina web nel criterio della pagina web.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
URL |
Operando che indica una condizione di targeting per l'URL di una pagina web. |
CATEGORY |
Operando che indica una condizione di targeting per categoria di pagina web. |
PAGE_TITLE |
Operando che indica la condizione di targeting del titolo di una pagina web. |
PAGE_CONTENT |
Operando che indica una condizione di targeting dei contenuti della pagina web. |
CUSTOM_LABEL |
Operando che indica una condizione di targeting per etichetta personalizzata di una pagina web. |
WebpageConditionOperator
Operatore di condizione della pagina web nel criterio della pagina web.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 |
Il nome della risorsa costante del target geografico. |
AdGroupCriterionLabel
Una relazione tra un criterio del gruppo di annunci e un'etichetta.
Rappresentazione JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'etichetta del criterio del gruppo di annunci. I nomi delle risorse dell'etichetta del criterio del gruppo di annunci sono nel formato: |
adGroupCriterion |
Il criterio del gruppo di annunci a cui è associata l'etichetta. |
label |
L'etichetta assegnata al criterio del gruppo di annunci. |
AdGroupLabel
Una relazione tra un gruppo di annunci e un'etichetta.
Rappresentazione JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'etichetta del gruppo di annunci. I nomi delle risorse dell'etichetta del gruppo di annunci sono nel formato: |
adGroup |
Il gruppo di annunci a cui è allegata l'etichetta. |
label |
L'etichetta assegnata al gruppo di annunci. |
AgeRangeView
Una visualizzazione per fascia d'età.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione della fascia d'età. I nomi delle risorse della visualizzazione della fascia di età hanno il seguente formato:
|
Asset
L'asset è una parte di un annuncio che può essere condivisa tra 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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset. I nomi delle risorse degli asset hanno il seguente formato:
|
type |
Tipo di risorsa. |
finalUrls[] |
Un elenco di possibili URL finali dopo tutti i reindirizzamenti interdominio. |
status |
Lo stato dell'asset. |
creationTime |
Timestamp della creazione dell'asset. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
lastModifiedTime |
La data e l'ora dell'ultima modifica dell'asset. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
id |
ID della risorsa. |
name |
Nome facoltativo dell'asset. |
trackingUrlTemplate |
Modello di URL per creare un URL di monitoraggio. |
engineStatus |
Lo stato motore di un asset. |
Campo unione asset_data . Il tipo specifico di risorsa. asset_data può essere solo uno dei seguenti: |
|
youtubeVideoAsset |
Una risorsa video di YouTube. |
imageAsset |
Un asset immagine. |
textAsset |
Un asset di testo. |
calloutAsset |
Un asset callout unificato. |
sitelinkAsset |
Un asset sitelink unificato. |
pageFeedAsset |
Un asset del feed di pagine unificato. |
mobileAppAsset |
Un asset per app mobile. |
callAsset |
Un asset di chiamata unificato. |
callToActionAsset |
Un asset di invito all'azione. |
locationAsset |
Un asset posizione unificato. |
AssetType
Enum che descrive i possibili tipi di asset.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
YOUTUBE_VIDEO |
File 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. |
SITELINK |
Asset sitelink. |
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 dinamico per hotel e affitti. |
DYNAMIC_FLIGHTS |
Asset voli dinamici. |
DISCOVERY_CAROUSEL_CARD |
Asset della scheda carosello discovery. |
DYNAMIC_TRAVEL |
Asset di viaggio dinamico. |
DYNAMIC_LOCAL |
Asset locale dinamico. |
DYNAMIC_JOBS |
Asset di lavoro dinamico. |
LOCATION |
Asset posizione. |
HOTEL_PROPERTY |
Asset hotel. |
AssetStatus
I possibili stati di una risorsa.
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 è generato dal sistema in attesa di revisione da parte dell'utente. |
AssetEngineStatus
ID successivo = 11
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
SERVING |
La risorsa è attiva. |
SERVING_LIMITED |
La risorsa è con limitazioni attive. |
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 |
Titolo del video di YouTube. |
youtubeVideoId |
ID video di YouTube. Si tratta del valore di stringa di 11 caratteri utilizzato nell'URL del video di YouTube. |
ImageAsset
Un asset immagine.
Rappresentazione JSON |
---|
{ "mimeType": enum ( |
Campi | |
---|---|
mimeType |
Tipo MIME dell'asset immagine. |
fullSize |
I metadati per questa immagine nelle loro dimensioni originali. |
fileSize |
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 immagine/png. |
FLASH |
Tipo MIME di application/x-shockwave-flash. |
TEXT_HTML |
Tipo MIME di text/html. |
PDF |
Tipo MIME applicazione/pdf. |
MSWORD |
Tipo MIME di applicazione/msword. |
MSEXCEL |
Tipo MIME di application/vnd.ms-excel. |
RTF |
Tipo MIME applicazione/rtf. |
AUDIO_WAV |
Tipo MIME audio/wav. |
AUDIO_MP3 |
Tipo MIME di audio/mp3. |
HTML5_AD_ZIP |
Tipo MIME di application/x-html5-ad-zip. |
ImageDimension
Metadati relativi a un'immagine di una determinata dimensione, originale o ridimensionata.
Rappresentazione JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Campi | |
---|---|
heightPixels |
Altezza dell'immagine. |
widthPixels |
Larghezza dell'immagine. |
url |
Un URL che restituisce l'immagine con questa altezza e questa larghezza. |
TextAsset
Un asset di testo.
Rappresentazione JSON |
---|
{ "text": string } |
Campi | |
---|---|
text |
Contenuti testuali dell'asset di testo. |
UnifiedCalloutAsset
Un asset callout unificato.
Rappresentazione JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Campi | |
---|---|
calloutText |
Il testo del callout. La lunghezza di questa stringa deve essere compresa tra 1 e 25 inclusi. |
startDate |
Data di inizio della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg. |
endDate |
Data dell'ultima data di validità dell'asset e ancora in pubblicazione, nel formato aaaa-MM-gg. |
adScheduleTargets[] |
Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale. |
useSearcherTimeZone |
Indica se mostrare l'asset nel fuso orario dell'utente della ricerca. Si applica a Microsoft Ads. |
AdScheduleInfo
Rappresenta un criterio AdSchedule.
La pianificazione annunci viene indicata come il giorno della settimana e l'intervallo di tempo entro il quale verranno pubblicati gli annunci.
Non è possibile aggiungere più di sei AdSchedules per lo stesso giorno.
Rappresentazione JSON |
---|
{ "startMinute": enum ( |
Campi | |
---|---|
startMinute |
Minuti dopo l'ora di inizio in cui inizia la programmazione. Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni UPDATE. |
endMinute |
Minuti dopo l'ora di fine in cui termina la pianificazione. Il programma non include il minuto di fine. Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni UPDATE. |
dayOfWeek |
Giorno della settimana a cui si applica la pianificazione. Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni UPDATE. |
startHour |
Ora di inizio in formato 24 ore. Questo campo deve essere compreso tra 0 e 23 inclusi. Questo campo è obbligatorio per le operazioni CREATE ed è vietato per le operazioni UPDATE. |
endHour |
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 ed è vietato per le operazioni UPDATE. |
MinuteOfHour
Enumerazioni di quarti d'ora. Ad esempio, "QUINDI"
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
Enumera 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 ( |
Campi | |
---|---|
linkText |
Testo visualizzato dell'URL per il sitelink. La lunghezza di questa stringa deve essere compresa tra 1 e 25 inclusi. |
description1 |
Prima riga della descrizione del sitelink. Se impostato, la lunghezza deve essere compresa tra 1 e 35 (incluso) e deve essere impostata anche la descrizione2. |
description2 |
Seconda riga della descrizione del sitelink. Se impostato, la lunghezza deve essere compresa tra 1 e 35 (incluso) e deve essere impostata anche la descrizione1. |
startDate |
Data di inizio della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg. |
endDate |
Data dell'ultima data di validità dell'asset e ancora in pubblicazione, nel formato aaaa-MM-gg. |
adScheduleTargets[] |
Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale. |
trackingId |
ID utilizzato per monitorare i clic per l'asset sitelink. Questo è un account motore Yahoo! Japan. |
useSearcherTimeZone |
Indica se mostrare l'asset sitelink nel fuso orario dell'utente della ricerca. Si applica a Microsoft Ads. |
mobilePreferred |
Se la preferenza è che l'asset sitelink venga visualizzato sui dispositivi mobili. Si applica a Microsoft Ads. |
UnifiedPageFeedAsset
Un asset di un feed di pagine unificato.
Rappresentazione JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Campi | |
---|---|
pageUrl |
La pagina web che gli inserzionisti vogliono scegliere come target. |
labels[] |
Etichette utilizzate per raggruppare gli URL delle pagine. |
MobileAppAsset
Un asset che rappresenta un'app mobile.
Rappresentazione JSON |
---|
{
"appId": string,
"appStore": enum ( |
Campi | |
---|---|
appId |
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 |
Obbligatorio. Lo store che distribuisce l'app specifica. |
MobileAppVendor
Il tipo di fornitore di app mobile
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
APPLE_APP_STORE |
Fornitore di app mobile per App Store di Apple. |
GOOGLE_APP_STORE |
Fornitore di app mobile per Google App Store. |
UnifiedCallAsset
Un asset di chiamata unificato.
Rappresentazione JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Campi | |
---|---|
countryCode |
Il codice paese di due lettere del numero di telefono. Esempi: "US", "us". |
phoneNumber |
Il numero di telefono non elaborato dell'inserzionista. Esempi: "1234567890", "(123)456-7890" |
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 |
L'azione di conversione a cui attribuire una conversione di chiamata. Se il criterio non viene configurato, viene utilizzata l'azione di conversione predefinita. Questo campo ha effetto solo se callConversionReportingState è impostato su USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
Elenco di pianificazioni non sovrapposte che specificano tutti gli intervalli di tempo per i quali l'asset può essere pubblicato. Ci possono essere un massimo di 6 programmazioni al giorno, 42 in totale. |
callOnly |
Indica se nella chiamata viene mostrato solo il numero di telefono senza un link al sito web. Si applica a Microsoft Ads. |
callTrackingEnabled |
Indica se la chiamata deve essere abilitata per il monitoraggio delle chiamate. Si applica a Microsoft Ads. |
useSearcherTimeZone |
Indica se mostrare l'estensione di chiamata nel fuso orario dell'utente della rete di ricerca. Si applica a Microsoft Ads. |
startDate |
Data di inizio della data in cui l'asset diventa effettivo e può iniziare la pubblicazione, nel formato aaaa-MM-gg. |
endDate |
Data dell'ultima data di validità dell'asset e ancora in pubblicazione, nel formato aaaa-MM-gg. |
CallConversionReportingState
Possibili tipi di dati per uno stato dell'azione di conversione di chiamata.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 ( |
Campi | |
---|---|
callToAction |
Invito all'azione. |
CallToActionType
Enum che descrive i possibili tipi di invito all'azione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 è applicato ora. |
SIGN_UP |
Il tipo di invito all'azione è "Registrati". |
CONTACT_US |
Il tipo di invito all'azione è Contattaci. |
SUBSCRIBE |
Il tipo di invito all'azione è "Iscriviti". |
DOWNLOAD |
Il tipo di invito all'azione è il 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 è "Fai una donazione". |
ORDER_NOW |
L'invito all'azione è ora "Ordina". |
PLAY_NOW |
Il tipo di invito all'azione è in riproduzione 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 ( |
Campi | |
---|---|
placeId |
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[] |
L'elenco delle sedi dell'attività commerciale del cliente. Verrà visualizzato solo se l'asset posizione viene sincronizzato dall'account Profilo dell'attività. È possibile avere più schede di Profilo dell'attività nello stesso account che puntano allo stesso ID luogo. |
locationOwnershipType |
Il tipo di proprietà della sede. Se il tipo è BUSINESS_OWNER, verrà pubblicato come estensione di località. Se il tipo è AFFILIATE, verrà pubblicato come sede della società consociata. |
BusinessProfileLocation
Dati della sede del profilo dell'attività sincronizzati dall'account Profilo dell'attività collegato.
Rappresentazione JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Campi | |
---|---|
labels[] |
Etichetta specificata dall'inserzionista per la sede nell'account Profilo dell'attività. Questo valore viene sincronizzato dall'account Profilo dell'attività. |
storeCode |
Codice negozio del profilo dell'attività di questa sede. Questo valore viene sincronizzato dall'account Profilo dell'attività. |
listingId |
ID scheda di questa sede del profilo dell'attività. Questa azione viene sincronizzata dall'account del profilo dell'attività collegato. |
LocationOwnershipType
Possibili tipi di proprietà di una sede.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
BUSINESS_OWNER |
Proprietario dell'attività commerciale(estensione di località precedente - LE). |
AFFILIATE |
Località della società consociata(estensione di località di terze parti - ALE). |
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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset del gruppo di asset. Il nome della risorsa di asset del gruppo di asset è nel formato:
|
assetGroup |
Il gruppo di asset collegato a questo asset del gruppo di asset. |
asset |
L'asset collegato da questo asset del gruppo di asset. |
fieldType |
La descrizione del posizionamento dell'asset all'interno del gruppo di asset. Ad esempio: HEADLINE, YOUTUBE_VIDEO ecc. |
status |
Lo stato del collegamento tra un asset e un gruppo di asset. |
AssetFieldType
Enum che descrive i possibili posizionamenti di una risorsa.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 poter essere utilizzata come video di YouTube. |
BOOK_ON_GOOGLE |
L'asset è collegato per indicare che una campagna per hotel è "Prenota su Google" in un bucket in cui è abilitato il controllo delle versioni. |
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. |
SITELINK |
L'asset è collegato per essere utilizzato come sitelink. |
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 di marketing verticale. |
LOGO |
L'asset è collegato per essere utilizzato come logo. |
LANDSCAPE_LOGO |
L'asset è collegato per essere utilizzato come logo orizzontale. |
VIDEO |
La risorsa è collegata per poter essere utilizzata come logo non di YouTube. |
CALL_TO_ACTION_SELECTION |
L'asset è collegato e può essere utilizzato per selezionare un invito all'azione. |
AD_IMAGE |
L'asset è collegato e può essere utilizzato per selezionare un'immagine annuncio. |
BUSINESS_LOGO |
L'asset è collegato per essere utilizzato come logo dell'attività. |
HOTEL_PROPERTY |
L'asset è collegato per essere utilizzato come proprietà di hotel in una campagna Performance Max per gli obiettivi di viaggio. |
DISCOVERY_CAROUSEL_CARD |
L'asset è collegato per essere utilizzato come scheda carosello discovery. |
AssetGroupSignal
AssetGroupSignal rappresenta un indicatore in un gruppo di asset. L'esistenza di un indicatore indica alla campagna Performance Max chi ha maggiori probabilità di effettuare una conversione. Performance Max utilizza l'indicatore per cercare nuovi utenti che dimostrano un interesse simile o superiore al tuo per trovare conversioni sulla rete di ricerca, sulla Rete Display, sulla rete video e su altri canali.
Rappresentazione JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'indicatore del gruppo di asset. Il nome della risorsa di indicatore del gruppo di asset è nel seguente formato:
|
assetGroup |
Il gruppo di asset a cui appartiene questo indicatore. |
Campo unione signal . L'indicatore del gruppo di asset. signal può essere solo uno dei seguenti: |
|
audience |
L'indicatore sul pubblico che deve essere utilizzato dalla campagna Performance Max. |
AudienceInfo
Un criterio del segmento di pubblico.
Rappresentazione JSON |
---|
{ "audience": string } |
Campi | |
---|---|
audience |
Il nome della risorsa Audience. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter rappresenta un nodo ad albero del filtro dei gruppi di schede in un gruppo di asset.
Rappresentazione JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa del filtro del gruppo di schede in un gruppo di asset. Il nome della risorsa del filtro di gruppo di asset nel gruppo di asset è nel seguente formato:
|
assetGroup |
Il gruppo di asset di cui fa parte questo filtro di gruppo di schede. |
id |
L'ID di ListingsGroupFilter. |
type |
Tipo di un nodo del filtro del gruppo di schede. |
vertical |
La verticale rappresentata dalla struttura ad albero dei nodi corrente. Tutti i nodi dello stesso albero devono appartenere alla stessa verticale. |
caseValue |
Valore della dimensione con cui questo gruppo di schede perfeziona il livello principale. Non definito per il gruppo principale. |
parentListingGroupFilter |
Nome risorsa della suddivisione del gruppo di schede principale. Null per il nodo del filtro del gruppo di schede principali. |
path |
Il percorso delle dimensioni che definisce 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 un valore sconosciuto in questa versione. |
SUBDIVISION |
Suddivisione dei prodotti in base ad alcune dimensioni delle schede. |
UNIT_INCLUDED |
Un nodo foglia con filtro del gruppo di schede incluso. |
UNIT_EXCLUDED |
Un nodo foglia con 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 un valore sconosciuto in questa versione. |
SHOPPING |
Rappresenta il verticale degli acquisti. Il verticale è consentito solo nelle campagne Performance Max per la vendita al dettaglio. |
ListingGroupFilterDimension
Dimensioni della scheda per il filtro del gruppo di schede del gruppo di asset.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione dimension . Una dimensione di uno dei tipi seguenti è sempre presente. dimension può essere solo uno dei seguenti: |
|
productBiddingCategory |
Categoria di offerta di un prodotto. |
productBrand |
Il brand di un'offerta di prodotto. |
productChannel |
Località dell'offerta di un prodotto. |
productCondition |
Condizione di un'offerta di prodotto. |
productCustomAttribute |
Attributo personalizzato dell'offerta di un prodotto. |
productItemId |
ID articolo di un'offerta di prodotto. |
productType |
Il tipo di offerta di un prodotto. |
ProductBiddingCategory
Un elemento di una categoria di offerta a un determinato livello. Le categorie di primo livello sono al livello 1, i loro figli al livello 2 e così via. Attualmente supportiamo fino a 5 livelli. L'utente deve specificare un tipo di dimensione che indichi il livello della categoria. Tutti i casi relativi alla stessa suddivisione devono avere lo stesso tipo di dimensione (livello di categoria).
Rappresentazione JSON |
---|
{
"level": enum ( |
Campi | |
---|---|
level |
Indica il livello della categoria nella tassonomia. |
id |
ID della categoria di offerta per il prodotto. Questo ID equivale all'ID google_product_category come 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 un valore sconosciuto in questa versione. |
LEVEL1 |
Livello 1. |
LEVEL2 |
Livello 2. |
LEVEL3 |
Livello 3. |
LEVEL4 |
Livello 4. |
LEVEL5 |
Livello 5. |
ProductBrand
Brand del prodotto.
Rappresentazione JSON |
---|
{ "value": string } |
Campi | |
---|---|
value |
Valore della stringa della marca del prodotto. |
ProductChannel
Località dell'offerta di un prodotto.
Rappresentazione JSON |
---|
{
"channel": enum ( |
Campi | |
---|---|
channel |
Valore della località. |
ListingGroupFilterProductChannel
Enum che descrive la località di un'offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 ( |
Campi | |
---|---|
condition |
Valore della condizione. |
ListingGroupFilterProductCondition
Enum che descrive la condizione di un'offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
NEW |
La condizione del prodotto è nuovo. |
REFURBISHED |
La condizione del prodotto è ricondizionato. |
USED |
La condizione del prodotto è "usato". |
ProductCustomAttribute
Attributo personalizzato dell'offerta di un prodotto.
Rappresentazione JSON |
---|
{
"index": enum ( |
Campi | |
---|---|
index |
Indica l'indice dell'attributo personalizzato. |
value |
Valore stringa dell'attributo personalizzato del prodotto. |
ListingGroupFilterCustomAttributeIndex
L'indice degli attributi dei clienti.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
INDEX0 |
Attributo personalizzato del primo filtro del gruppo di schede. |
INDEX1 |
Attributo personalizzato del secondo filtro del gruppo di schede. |
INDEX2 |
Terzo attributo personalizzato del 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 |
Valore dell'ID. |
ProductType
Il tipo di offerta di un prodotto.
Rappresentazione JSON |
---|
{
"level": enum ( |
Campi | |
---|---|
level |
Livello del tipo. |
value |
Valore del tipo. |
ListingGroupFilterProductTypeLevel
Enum che descrive il livello del tipo di offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 definisce un filtro del gruppo di schede.
Rappresentazione JSON |
---|
{
"dimensions": [
{
object ( |
Campi | |
---|---|
dimensions[] |
Il percorso completo delle dimensioni tramite la gerarchia del filtro del gruppo di schede (escluso il nodo principale) a questo filtro del gruppo di schede. |
AssetGroupTopCombinationView
Una panoramica sull'utilizzo della combinazione di asset annuncio del gruppo di annunci.
Rappresentazione JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione combinazione superiore del gruppo di asset. I nomi delle risorse della visualizzazione combinazione superiore di AssetGroup sono nel formato: ""customers/{customerId}/assetGroupTopCombineViews/{asset_group_id}~{asset_combination_category}" |
assetGroupTopCombinations[] |
Le migliori combinazioni di asset pubblicati insieme. |
AssetGroupAssetCombinationData
Dati sulla combinazione di asset del gruppo di asset
Rappresentazione JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Campi | |
---|---|
assetCombinationServedAssets[] |
Asset pubblicati. |
AssetUsage
Contiene le informazioni di utilizzo della risorsa.
Rappresentazione JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Campi | |
---|---|
asset |
Nome risorsa dell'asset. |
servedAssetFieldType |
Il tipo di campo pubblicato dell'asset. |
ServedAssetFieldType
I possibili tipi di campi degli asset.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
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 questa opzione solo se l'annuncio contiene un solo titolo. Altrimenti, 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 MultiAssetAdattatore). |
DESCRIPTION |
L'asset è stato utilizzato in una descrizione. Da utilizzare solo se l'annuncio contiene una sola descrizione. Altrimenti, utilizza le enumerazioni 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 un'immagine verticale. |
SQUARE_MARKETING_IMAGE |
L'asset è stato utilizzato come immagine di marketing quadrata. |
PORTRAIT_MARKETING_IMAGE |
L'asset è stato utilizzato come immagine di marketing verticale. |
LOGO |
L'asset è stato utilizzato come logo. |
LANDSCAPE_LOGO |
L'asset è stato utilizzato come logo orizzontale. |
CALL_TO_ACTION |
L'asset è stato utilizzato come invito all'azione. |
YOU_TUBE_VIDEO |
La risorsa è stata utilizzata come video di YouTube. |
SITELINK |
Questo asset viene utilizzato come sitelink. |
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 |
Questo asset viene utilizzato come snippet strutturato. |
PRICE |
Questo asset viene utilizzato come prezzo. |
PROMOTION |
Questo asset viene utilizzato come promozione. |
AD_IMAGE |
Questo asset viene utilizzato come immagine. |
LEAD_FORM |
L'asset viene utilizzato come modulo per i lead. |
BUSINESS_LOGO |
L'asset viene utilizzato come logo dell'attività. |
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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa del gruppo di asset. I nomi delle risorse dei gruppi di asset hanno il seguente formato:
|
id |
L'ID del gruppo di asset. |
campaign |
La campagna a cui è associato questo gruppo di asset. L'asset collegato al gruppo di asset. |
name |
Obbligatorio. Nome del gruppo di asset. Obbligatorio. Deve avere una lunghezza minima di 1 e una lunghezza massima di 128. Deve essere univoco all'interno di una campagna. |
finalUrls[] |
Un elenco di URL finali dopo tutti i reindirizzamenti interdominio. Per impostazione predefinita, in Performance Max gli URL sono idonei all'espansione, a meno che non siano disattivati. |
finalMobileUrls[] |
Un elenco di URL mobile finali dopo tutti i reindirizzamenti interdominio. Per impostazione predefinita, in Performance Max gli URL sono idonei all'espansione, a meno che non siano disattivati. |
status |
Lo stato del gruppo di asset. |
path1 |
Prima parte di testo che potrebbe apparire aggiunta all'URL visualizzato nell'annuncio. |
path2 |
Seconda parte del testo che potrebbe essere aggiunta all'URL visualizzato nell'annuncio. Questo campo può essere impostato solo se è impostato il percorso 1. |
adStrength |
Efficacia complessiva dell'annuncio 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 è stato rimosso. |
AdStrength
Enum che elenca le possibili efficacia dell'annuncio.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
PENDING |
L'efficacia dell'annuncio è attualmente in attesa. |
NO_ADS |
Non è stato possibile generare annunci. |
POOR |
Intensità scarsa. |
AVERAGE |
Forza media. |
GOOD |
Forza buona. |
EXCELLENT |
Forza eccellente. |
AssetSetAsset
AssetSetAsset è il collegamento tra un asset 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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset del set di asset. I nomi delle risorse degli asset del set di asset hanno il seguente formato:
|
assetSet |
L'insieme di asset a cui si collega l'asset. |
asset |
La risorsa a cui si collega l'asset dell'insieme. |
status |
Lo stato dell'asset del set di asset. Sola lettura. |
AssetSetAssetStatus
I possibili stati di un insieme di 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 del set di asset è attivato. |
REMOVED |
L'asset del set di asset è stato rimosso. |
AssetSet
Un insieme di asset che rappresenta una raccolta di asset. Utilizza AssetSetAsset per collegare un asset al set di asset.
Rappresentazione JSON |
---|
{ "id": string, "resourceName": string } |
Campi | |
---|---|
id |
L'ID del set di asset. |
resourceName |
Il nome della risorsa del set di asset. I nomi delle risorse del set di asset hanno il seguente formato:
|
BiddingStrategy
Una strategia di offerta.
Rappresentazione JSON |
---|
{ "resourceName": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della strategia di offerta. I nomi delle risorse della strategia di offerta hanno il seguente formato:
|
status |
Lo stato della strategia di offerta. Questo campo è di sola lettura. |
type |
Il tipo di strategia di offerta. Crea una strategia di offerta impostando lo schema di offerta. Questo campo è di sola lettura. |
currencyCode |
La valuta utilizzata dalla strategia di offerta (codice ISO 4217 a tre lettere). Per le strategie di offerta nei clienti amministratore, questa valuta può essere impostata al momento della creazione e viene impostata come predefinita sulla valuta del cliente amministratore. Questo campo non può essere impostato per i clienti che forniscono servizi. tutte le strategie di un cliente che gestisce il servizio utilizzano implicitamente la valuta di quest'ultimo. In tutti i casi, il campo activeCurrencyCode restituisce la valuta utilizzata dalla strategia. |
id |
L'ID della strategia di offerta. |
name |
Il nome della strategia di offerta. Tutte le strategie di offerta all'interno di un account devono avere nomi univoci. La lunghezza di questa stringa deve essere compresa tra 1 e 255, inclusi, in byte UTF-8 (tagliata). |
effectiveCurrencyCode |
La valuta utilizzata dalla strategia di offerta (codice ISO 4217 a tre lettere). Per le strategie di offerta nei clienti amministratore, si tratta della valuta impostata dall'inserzionista al momento della creazione della strategia. Per fornire servizi ai clienti, è il valore currencyCode del cliente. Le metriche della strategia di offerta sono riportate in questa valuta. Questo campo è di sola lettura. |
campaignCount |
Il numero di campagne associate a questa strategia di offerta. Questo campo è di sola lettura. |
nonRemovedCampaignCount |
Il numero di campagne non rimosse associate a questa strategia di offerta. Questo campo è di sola lettura. |
Campo unione È possibile impostarne solo uno. |
|
enhancedCpc |
Una strategia di offerta che aumenta le offerte per i clic che hanno maggiori probabilità di generare una conversione e le riduce per i clic dove sembrano meno probabili. |
maximizeConversionValue |
Una strategia di offerta automatica per aiutarti a ottenere il massimo valore di conversione per le tue campagne entro i limiti di spesa del budget. |
maximizeConversions |
Una strategia di offerta automatica per aiutarti a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget. |
targetCpa |
Una strategia di offerta che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato. |
targetImpressionShare |
Una strategia di offerta che esegue automaticamente l'ottimizzazione in base a una determinata percentuale di impressioni. |
targetOutrankShare |
Strategia di offerta che imposta le offerte in base alla frazione target delle aste in cui l'inserzionista deve superare un determinato concorrente. Campo obsoleto. La creazione di una nuova strategia di offerta con questo campo o il collegamento di strategie di offerta con questo campo a una campagna non riuscirà. Sono consentite le modifiche alle strategie che hanno già completato questo schema. |
targetRoas |
Una strategia di offerta che ti aiuta a massimizzare le entrate a una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico. |
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 |
Nessun valore specificato. |
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
Enum che descrive i possibili tipi di strategia di offerta.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
COMMISSION |
Le commissioni sono 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 hanno maggiori probabilità di generare una conversione e le riduce per i clic dove sembrano meno probabili. |
INVALID |
Utilizzato solo per il valore restituito. Indica che una campagna non ha una strategia di offerta. Questo impedisce la pubblicazione della campagna. Ad esempio, una campagna potrebbe essere collegata a una strategia di offerta del gestore clienti e l'account di pubblicazione viene successivamente scollegato dall'account amministratore. In questo caso, la campagna verrà automaticamente scollegata dalla strategia di offerta dell'account amministratore, 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 |
Offerta manuale basata sui clic in cui l'utente paga per ogni clic. |
MANUAL_CPM |
Offerta manuale basata sulle impressioni in cui l'utente paga per mille impressioni. |
MANUAL_CPV |
Una strategia di offerta che paga un importo configurabile per visualizzazione di 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 per massimizzare le entrate entro i limiti di spesa del budget. |
PAGE_ONE_PROMOTED |
Schema di offerta sponsorizzata prima pagina, che imposta le offerte CPC massimo per avere come target le impressioni nella prima pagina o nelle aree promosse per la prima pagina su google.com. Questo valore enum è obsoleto. |
PERCENT_CPC |
Il CPC percentuale è la strategia di offerta in cui le offerte rappresentano una frazione del prezzo pubblicizzato per alcuni beni o servizi. |
TARGET_CPA |
Il CPA target è una strategia di offerta automatica che imposta le offerte in modo da ottenere 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 da te impostato. |
TARGET_IMPRESSION_SHARE |
Una strategia di offerta automatica che imposta le offerte in modo da mostrare una determinata percentuale di annunci della rete di ricerca 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 delle aste in cui l'inserzionista deve superare un determinato concorrente. Questo valore enum è obsoleto. |
TARGET_ROAS |
Il ROAS target è una strategia di offerta automatica che ti aiuta a massimizzare le entrate a una media di un ritorno sulla spesa media (ROAS) target specifico. |
TARGET_SPEND |
Spesa target è una strategia di offerta automatica che imposta le offerte in modo da 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 hanno maggiori probabilità di generare una conversione e le riduce per i clic dove sembrano meno probabili.
Questa strategia di offerta è stata ritirata e non può più essere creata. Utilizza ManualCpc con AdvancedCpcEnabled impostato su true per la funzionalità equivalente.
MaximizeConversionValue
Una strategia di offerta automatica per aiutarti a ottenere il massimo valore di conversione per le tue campagne entro i limiti di spesa del budget.
Rappresentazione JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Campi | |
---|---|
cpcBidCeilingMicros |
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 |
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 |
L'opzione del ritorno sulla spesa pubblicitaria (ROAS) target. Se impostata, la strategia di offerta massimizzerà le entrate calcolando una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non riuscire a 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 per aiutarti 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 |
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 |
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 |
L'opzione costo per azione (CPA) target. L'importo medio che vuoi spendere per ogni azione di conversione specificato in micro unità della valuta della strategia di offerta. Se impostata, la strategia di offerta otterrà il maggior numero possibile di conversioni nei limiti del costo per azione target. Se il CPA target non è impostato, la strategia di offerta cercherà di ottenere il CPA più basso possibile in base al budget. |
TargetCpa
Una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato.
Rappresentazione JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campi | |
---|---|
targetCpaMicros |
CPA target medio. Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account. |
cpcBidCeilingMicros |
Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio. |
cpcBidFloorMicros |
Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio. |
TargetRoas
Una strategia di offerta automatica che ti aiuta a massimizzare le entrate calcolando la media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
Rappresentazione JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Campi | |
---|---|
targetRoas |
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 |
Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato solo per le strategie di offerta di portafoglio. |
cpcBidFloorMicros |
Limite di offerta minimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. Deve essere impostato 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 |
Obsoleto: il target di spesa in base al quale massimizzare i clic. Un offerente di spesa target cercherà di spendere il minor valore tra questo valore o l'importo della spesa limitata naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per informazioni dettagliate, visita la pagina https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
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
Il budget di una campagna.
Rappresentazione JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Campi | |
---|---|
resourceName |
Il nome risorsa del budget della campagna. I nomi delle risorse budget della campagna hanno il seguente formato:
|
deliveryMethod |
Il metodo di pubblicazione che determina la percentuale di spesa del budget della campagna. Se non specificato in un'operazione di creazione, il valore predefinito è STANDARD. |
period |
Periodo durante il quale spendere il budget. Se non specificato, il valore predefinito è DAILY. |
amountMicros |
L'importo del budget nella valuta locale dell'account. L'importo è specificato in micro, dove un milione è equivalente 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 un valore sconosciuto in questa versione. |
STANDARD |
Il server del budget limiterà la pubblicazione in modo uniforme durante l'intero periodo di tempo. |
ACCELERATED |
Il server del budget non limiterà la pubblicazione e gli annunci verranno pubblicati il più rapidamente possibile. |
BudgetPeriod
Possibile periodo di un budget.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 per tutta la durata. |
Campagna
Una campagna.
Rappresentazione JSON |
---|
{ "resourceName": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della campagna. I nomi delle risorse della campagna sono nel formato:
|
status |
Lo stato della campagna. Quando viene aggiunta una nuova campagna, lo stato predefinito è ATTIVATO. |
servingStatus |
Lo stato di pubblicazione degli annunci della campagna. |
biddingStrategySystemStatus |
Lo stato del sistema della strategia di offerta della campagna. |
adServingOptimizationStatus |
Lo stato di ottimizzazione della pubblicazione di annunci della campagna. |
advertisingChannelType |
Il target di pubblicazione principale per gli annunci all'interno della campagna. Le opzioni di targeting possono essere perfezionate in Questo campo è obbligatorio e non deve essere vuoto quando si creano nuove campagne. Può essere impostato solo durante la creazione di campagne. Dopo aver creato la campagna, il campo non può essere modificato. |
advertisingChannelSubType |
Perfezionamento facoltativo a Può essere impostato solo durante la creazione di campagne. Dopo aver creato la campagna, il campo non può essere modificato. |
urlCustomParameters[] |
L'elenco di mappature utilizzate per sostituire i tag di parametri personalizzati in |
realTimeBiddingSetting |
Impostazioni per le offerte in tempo reale, una funzionalità disponibile solo per le campagne che hanno come target la rete Ad Exchange. |
networkSettings |
Le impostazioni della rete per la campagna. |
dynamicSearchAdsSetting |
L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA). |
shoppingSetting |
L'impostazione per il controllo delle campagne Shopping. |
geoTargetTypeSetting |
L'impostazione per il targeting geografico degli annunci. |
labels[] |
I nomi delle risorse delle etichette associate a questa campagna. |
biddingStrategyType |
Il tipo di strategia di offerta. È possibile creare una strategia di offerta impostando lo schema di offerta per creare una strategia di offerta standard oppure il campo Questo campo è di sola lettura. |
accessibleBiddingStrategy |
Nome della risorsa di AccessibleBiddingStrategy, una visualizzazione di sola lettura degli attributi senza restrizioni della strategia di offerta di portafoglio associata identificata da "BiddingStrategy". Vuota se la campagna non utilizza una strategia di portafoglio. Gli attributi di strategia senza limitazioni sono disponibili per tutti i clienti con i quali 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 limitati possono essere letti solo dalla risorsa BiddingStrategy. |
frequencyCaps[] |
Un elenco che limita la frequenza con cui ogni utente visualizza gli annunci di questa campagna. |
selectiveOptimization |
Impostazione di ottimizzazione selettiva per questa campagna, che include un insieme di azioni di conversione in base alle quali 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 |
Impostazione degli obiettivi di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione. |
trackingSetting |
Impostazioni a livello di campagna per le informazioni sul monitoraggio. |
engineId |
ID della campagna nell'account motore esterno. Questo campo è destinato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza "campaign.id" . |
excludedParentAssetFieldTypes[] |
I tipi di campi degli asset che devono essere esclusi da questa campagna. I link agli asset con questi tipi di campi non verranno ereditati da questa campagna dal livello superiore. |
createTime |
Il timestamp di creazione della campagna. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. Il campo createTime verrà deprecato nella versione 1. Usa CreationTime. |
creationTime |
Il timestamp di creazione della campagna. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
lastModifiedTime |
La data e l'ora dell'ultima modifica della campagna. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
id |
L'ID della campagna. |
name |
Il nome della campagna. Questo campo è obbligatorio e non deve essere vuoto quando si creano nuove campagne. Non deve contenere caratteri nulli (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorni a capo (punto di codice 0xD). |
trackingUrlTemplate |
Il modello di URL per la creazione di un URL di monitoraggio. |
campaignBudget |
Il budget della campagna. |
startDate |
La data di inizio della campagna nel fuso orario del cliente, in formato AAAA-MM-GG. |
endDate |
L'ultimo giorno della campagna nel fuso orario del cliente in formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 30/12/2037, a indicare che la campagna sarà pubblicata a tempo indeterminato. Per impostare una campagna esistente in modo che venga eseguita a tempo indeterminato, imposta questo campo su 30/12/2037. |
finalUrlSuffix |
Suffisso utilizzato per aggiungere parametri di query alle pagine di destinazione pubblicate con il monitoraggio parallelo. |
urlExpansionOptOut |
Rappresenta la disattivazione dell'espansione dell'URL per URL più mirati. Se questa opzione è disattivata (true), vengono scelti come target solo gli URL finali nel gruppo di asset o gli URL specificati nel Google Merchant Center dell'inserzionista o nei feed di dati aziendali. Se questa opzione è attivata (false), verrà scelto come target l'intero dominio. Questo campo può essere impostato solo per le campagne Performance Max, in cui il valore predefinito è false. |
Campo unione Deve essere un portafoglio (creato tramite il servizio BiddingStrategy) o standard incorporato nella campagna. |
|
biddingStrategy |
Strategia di offerta di portafoglio utilizzata dalla campagna. |
manualCpa |
Strategia di offerta manuale basata su CPA standard. Strategia di offerta manuale che consente all'inserzionista di impostare l'offerta per azione specificata dall'inserzionista. Supportata solo per le campagne di Servizi locali. |
manualCpc |
Strategia di offerta manuale standard basata su CPC. Offerta manuale basata sui clic in cui l'utente paga per ogni clic. |
manualCpm |
Strategia di offerta manuale basata su CPM standard. Offerta manuale basata sulle impressioni in cui l'utente paga per mille impressioni. |
maximizeConversions |
Strategia di offerta standard Massimizza le conversioni che massimizza automaticamente il numero di conversioni entro i limiti di spesa del budget. |
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 |
Strategia di offerta basata su CPA target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato. |
targetImpressionShare |
Strategia di offerta Quota impressioni target. Una strategia di offerta automatica che imposta le offerte in modo da raggiungere una determinata percentuale di impressioni. |
targetRoas |
Strategia di offerta basata sul ROAS target standard che massimizza automaticamente le entrate con una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico. |
targetSpend |
Strategia di offerta basata sulla spesa target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero possibile di clic in base al tuo budget. |
percentCpc |
Strategia di offerta CPC percentuale standard in cui le offerte rappresentano una frazione del prezzo pubblicizzato per un prodotto o un servizio. |
targetCpm |
Una strategia di offerta che ottimizza automaticamente il costo per mille impressioni. |
CampaignStatus
Stati possibili di una campagna.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 |
Nessun valore specificato. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta. |
SERVING |
Pubblicazione. |
NONE |
Nessuno. |
ENDED |
Terminata. |
PENDING |
In attesa. |
SUSPENDED |
Sospeso. |
BiddingStrategySystemStatus
I possibili stati di sistema di una strategia di offerta.
Enum | |
---|---|
UNSPECIFIED |
Segnali che indicano che si è verificato un errore imprevisto, ad esempio che non è stato trovato alcun tipo di strategia di offerta o non sono state trovate informazioni sullo stato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 all'impostazione. |
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 di una recente modifica nel numero di campagne, gruppi di annunci o parole chiave associati. |
LEARNING_CONVERSION_TYPE_CHANGE |
La strategia di offerta dipende dai report sulle conversioni e dal cliente ha modificato di recente i tipi di conversione pertinenti alla strategia di offerta. |
LEARNING_CONVERSION_SETTING_CHANGE |
La strategia di offerta dipende dai report sulle conversioni e il cliente ha modificato di recente le proprie impostazioni di conversione. |
LIMITED_BY_CPC_BID_CEILING |
La strategia di offerta è limitata dal limite di offerta massimo. |
LIMITED_BY_CPC_BID_FLOOR |
La strategia di offerta è limitata dal suo prezzo minimo di offerta. |
LIMITED_BY_DATA |
La strategia di offerta è limitata perché il traffico di conversioni nelle ultime settimane non è stato sufficiente. |
LIMITED_BY_BUDGET |
Una frazione significativa di 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 sua spesa è stata ridotta. |
LIMITED_BY_LOW_QUALITY |
Una parte significativa delle parole chiave in questa strategia di offerta presenta un punteggio di qualità basso. |
LIMITED_BY_INVENTORY |
La strategia di offerta non può esaurire il budget a causa di un 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 al cliente mancano i tipi di conversione che potrebbero essere registrati 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. Alla strategia di offerta non sono associati campagne, gruppi di annunci o parole chiave attivi. Oppure non ci sono 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 erano presenti più stati di sistema LEARNING_* per questa strategia di offerta. |
MULTIPLE_LIMITED |
Durante il periodo in questione erano presenti più stati di sistema LIMITED_* per questa strategia di offerta. |
MULTIPLE_MISCONFIGURED |
Durante il periodo in questione erano presenti più stati di sistema MISCONFIGURED_* per questa strategia di offerta. |
MULTIPLE |
Durante il periodo in questione erano presenti più stati del sistema per questa strategia di offerta. |
AdServingOptimizationStatus
Enum che descrive i possibili stati di pubblicazione.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta. |
OPTIMIZE |
La pubblicazione degli annunci è ottimizzata in base al CTR della campagna. |
CONVERSION_OPTIMIZE |
La pubblicazione degli annunci è ottimizzata in base al CTR * Conversione della campagna. Se la campagna non è inclusa nella strategia di offerta dello Strumento per ottimizzare le conversioni, il valore predefinito sarà OTTIMIZZATO. |
ROTATE |
Gli annunci vengono ruotati in modo uniforme per 90 giorni e poi 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 di ottimizzazione della pubblicazione di annunci non è disponibile. |
AdvertisingChannelType
Enum che descrive i vari tipi di canali pubblicitari.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
SEARCH |
Rete di ricerca. Sono incluse le campagne display in bundle e le campagne sulla rete di ricerca+. |
DISPLAY |
Solo Rete Display di Google. |
SHOPPING |
Le campagne Shopping vengono pubblicate nella 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 di Servizi locali. |
DISCOVERY |
campagne discovery. |
TRAVEL |
Campagne per viaggi. |
SOCIAL |
Campagne social. |
AdvertisingChannelSubType
Enum che descrive i diversi sottotipi di canali.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo come valore restituito. Rappresenta un 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 ricerca. |
DISPLAY_EXPRESS |
Campagne AdWords Express per la Rete Display. |
SHOPPING_SMART_ADS |
Campagne Shopping intelligenti. |
DISPLAY_GMAIL_AD |
Campagne pubblicitarie Gmail. |
DISPLAY_SMART_CAMPAIGN |
Campagne display Smart. Impossibile 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 per 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 incrementare il coinvolgimento orientata a favorire il ricoinvolgimento con l'app su diverse delle principali proprietà di Google, tra cui la rete di 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 di preregistrazione per app, specializzata per la 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 la strategia di offerta basata sulla frequenza target. |
TRAVEL_ACTIVITIES |
Campagne per attività di viaggio. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
Facebook monitora solo le campagne social. |
CustomParameter
Una mappatura che può essere utilizzata dai tag dei parametri personalizzati in trackingUrlTemplate
, finalUrls
o mobile_final_urls
.
Rappresentazione JSON |
---|
{ "key": string, "value": string } |
Campi | |
---|---|
key |
La chiave corrispondente al nome del tag parametro. |
value |
Il valore da sostituire. |
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 |
Se per la campagna sono state attivate le offerte in tempo reale. |
NetworkSettings
Le impostazioni della rete per la campagna.
Rappresentazione JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Campi | |
---|---|
targetGoogleSearch |
Se gli annunci verranno pubblicati con i risultati di ricerca di google.com. |
targetSearchNetwork |
Indica se gli annunci verranno pubblicati sui siti partner della rete di ricerca di Google (richiede che anche |
targetContentNetwork |
Se gli annunci saranno pubblicati in posizionamenti specificati nella Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento. |
targetPartnerSearchNetwork |
Se gli annunci saranno pubblicati sulla rete dei partner di Google. Questa opzione è disponibile solo per alcuni Account partner di Google. |
DynamicSearchAdsSetting
L'impostazione per controllare gli annunci dinamici della rete di ricerca (DSA).
Rappresentazione JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Campi | |
---|---|
domainName |
Obbligatorio. Il nome di dominio internet rappresentato da questa impostazione, ad esempio "google.com" o "www.google.com". |
languageCode |
Obbligatorio. Il codice della lingua che specifica la lingua del dominio, ad esempio "en". |
useSuppliedUrlsOnly |
Indica se la campagna utilizza esclusivamente URL forniti dall'inserzionista. |
ShoppingSetting
L'impostazione per le campagne Shopping. Definisce l'universo dei prodotti che possono essere pubblicizzati dalla campagna e il modo in cui questa interagisce con le altre campagne Shopping.
Rappresentazione JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Campi | |
---|---|
feedLabel |
Etichetta del feed dei prodotti da includere nella campagna. Puoi impostare solo un valore tra feedLabel o SalesCountry. Se utilizzato al posto di venditeCountry, il campo feedLabel accetta i codici paese nello stesso formato, ad esempio: "XX". In caso contrario, può essere qualsiasi stringa utilizzata per l'etichetta del feed in Google Merchant Center. |
useVehicleInventory |
Indica se scegliere come target l'inventario delle schede di veicoli. |
merchantId |
ID dell'account Merchant Center. Questo campo è obbligatorio per le operazioni di creazione. Questo campo non è modificabile per le campagne Shopping. |
salesCountry |
Paese di vendita dei prodotti da includere nella campagna. |
campaignPriority |
Priorità della campagna. Le campagne con priorità numericamente più elevate 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 |
Indica se includere prodotti locali. |
GeoTargetTypeSetting
Rappresenta una raccolta di impostazioni relative al targeting geografico degli annunci.
Rappresentazione JSON |
---|
{ "positiveGeoTargetType": enum ( |
Campi | |
---|---|
positiveGeoTargetType |
L'impostazione utilizzata per il targeting geografico positivo in questa particolare campagna. |
negativeGeoTargetType |
L'impostazione utilizzata per il targeting geografico escluso in questa particolare campagna. |
PositiveGeoTargetType
I possibili tipi di targeting geografico 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à target dell'inserzionista o mostra interesse per esse. |
SEARCH_INTEREST |
Specifica che un annuncio viene attivato se l'utente cerca le località target dell'inserzionista. Questa opzione può essere utilizzata solo con le campagne sulla rete di ricerca e Shopping standard. |
PRESENCE |
Specifica che un annuncio viene attivato se l'utente si trova nelle località target dell'inserzionista o le visitano regolarmente. |
NegativeGeoTargetType
I possibili tipi di targeting geografico esclusi.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Il valore è sconosciuto in questa versione. |
PRESENCE_OR_INTEREST |
Specifica che un utente non può visualizzare l'annuncio se si trova nelle località escluse dell'inserzionista o se mostra interesse per esse. |
PRESENCE |
Specifica che un utente non può visualizzare l'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 una serie 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 in base alle quali 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[] |
L'insieme selezionato di azioni di conversione per ottimizzare questa campagna. |
OptimizationGoalSetting
Impostazione degli obiettivi di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.
Rappresentazione JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Campi | |
---|---|
optimizationGoalTypes[] |
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 un valore sconosciuto in questa versione. |
CALL_CLICKS |
Ottimizza per i clic per chiamata. Le conversioni generate dai clic per chiamata sono le volte in cui gli utenti hanno selezionato "Chiama" contattare un negozio dopo aver visualizzato un annuncio. |
DRIVING_DIRECTIONS |
Ottimizza per le indicazioni stradali. Le conversioni delle indicazioni stradali corrispondono al numero di volte in cui gli utenti hanno selezionato "Indicazioni stradali" per raggiungere un negozio dopo aver visualizzato un annuncio. |
APP_PRE_REGISTRATION |
Ottimizza per la preregistrazione. Le conversioni di preregistrazione corrispondono al numero di registrazioni di preregistrazione per ricevere una notifica quando viene rilasciata l'app. |
TrackingSetting
Impostazioni a livello di campagna per le informazioni sul monitoraggio.
Rappresentazione JSON |
---|
{ "trackingUrl": string } |
Campi | |
---|---|
trackingUrl |
L'URL utilizzato per il monitoraggio dinamico. |
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 ogni clic.
Rappresentazione JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Campi | |
---|---|
enhancedCpcEnabled |
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 rappresentano una frazione del prezzo pubblicizzato per un prodotto o servizio.
Rappresentazione JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Campi | |
---|---|
cpcBidCeilingMicros |
Limite di offerta massimo che può essere impostato dalla strategia di offerta. Si tratta di un campo facoltativo inserito dall'inserzionista e specificato in micro locali. Nota: un valore pari a zero viene interpretato come se avessi un valore bid_headline indefinito. |
enhancedCpcEnabled |
Aumenta o diminuisce l'offerta per ogni asta a seconda della probabilità di conversione. Le singole offerte possono superare cpcBidCeilingMicros, al contrario dell'importo medio dell'offerta per una campagna. |
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 impostato.
CampaignAsset
Un collegamento tra una campagna e una risorsa.
Rappresentazione JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset della campagna. I nomi delle risorse CampaignAsset sono nel formato:
|
status |
Stato dell'asset della campagna. |
campaign |
La campagna a cui è collegato l'asset. |
asset |
L'asset collegato alla campagna. |
CampaignAssetSet
CampaignAssetSet è il collegamento tra una campagna e un insieme di asset. L'aggiunta di un CampaignAssetSet collega un insieme di asset a una campagna.
Rappresentazione JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa del set di asset della campagna. I nomi delle risorse degli asset del set di asset hanno il seguente formato:
|
campaign |
La campagna a cui è collegato questo set di asset. |
assetSet |
Il set di asset collegato alla campagna. |
status |
Lo stato dell'asset set di asset della campagna. Sola lettura. |
CampaignAudienceView
Una visualizzazione del pubblico della campagna. Include i dati sul rendimento di interessi ed elenchi per il remarketing per gli annunci della Rete Display e della rete YouTube ed elenchi per il remarketing per gli annunci della rete di ricerca (RLSA), aggregati per campagna e criterio di pubblico. Questa visualizzazione include solo i segmenti di pubblico associati a livello di campagna.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione del pubblico della campagna. I nomi delle risorse di visualizzazione del pubblico della campagna hanno il seguente formato:
|
CampaignCriterion
Un criterio della campagna.
Rappresentazione JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Campi | |
---|---|
resourceName |
Il nome risorsa del criterio della campagna. I nomi delle risorse dei criteri della campagna hanno il seguente formato:
|
displayName |
Il nome visualizzato del criterio. Questo campo viene ignorato per le modifiche. |
type |
Il tipo di criterio. |
status |
Lo stato del criterio. |
lastModifiedTime |
La data e l'ora dell'ultima modifica di questo criterio della campagna. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
criterionId |
L'ID del criterio. Questo campo viene ignorato durante la modifica. |
bidModifier |
Il modificatore delle offerte quando il criterio corrisponde. Il modificatore deve essere compreso tra 0,1 e 10,0. La maggior parte dei tipi di criteri disponibili per il targeting supporta i modificatori. Utilizza 0 per disattivare un tipo di dispositivo. |
negative |
Indica se scegliere come target ( |
Campo unione Deve essere impostato in modo esatto. |
|
keyword |
Parola chiave. |
location |
Posizione. |
device |
Dispositivo. |
ageRange |
Fascia d'età. |
gender |
Genere. |
userList |
Elenco utenti. |
language |
Lingua. |
webpage |
Pagina web. |
locationGroup |
Gruppo di località |
CampaignCriterionStatus
I possibili stati di un criterio CampaignCriterion.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta. |
ENABLED |
Il criterio della campagna è attivato. |
PAUSED |
Il criterio della campagna è in pausa. |
REMOVED |
Il criterio della campagna è stato rimosso. |
LanguageInfo
Un criterio linguistico.
Rappresentazione JSON |
---|
{ "languageConstant": string } |
Campi | |
---|---|
languageConstant |
Il nome della risorsa della costante di lingua. |
LocationGroupInfo
Un raggio intorno a un elenco di località specificate tramite un feed.
Rappresentazione JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Campi | |
---|---|
geoTargetConstants[] |
Costante o più costanti del targeting geografico che limitano l'ambito dell'area geografica all'interno del feed. Al momento è consentita una sola costante di targeting geografico. |
radiusUnits |
Unità del raggio. Miglia e metri sono supportati per le costanti del targeting geografico. Per gli insiemi di elementi del feed sono supportati i millisecondi e i metri. Questo campo è obbligatorio e deve essere impostato nelle operazioni CREATE. |
feedItemSets[] |
FeedItemSet i cui FeedItems sono scelti come target. Se vengono specificati più ID, vengono scelti come target tutti gli elementi presenti in almeno un insieme. Questo campo non può essere utilizzato con geoTargetConstants. Questa opzione è facoltativa e può essere impostata solo nelle operazioni CREATE. |
radius |
Distanza in unità che specifica il raggio intorno alle località target. Questo campo è obbligatorio e deve essere impostato nelle operazioni CREATE. |
LocationGroupRadiusUnits
L'unità della distanza raggio nel gruppo di località, ad esempio MILES
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
METERS |
Metri |
MILES |
Miglia |
MILLI_MILES |
Milli-miglia |
CampaignLabel
Rappresenta una relazione tra una campagna e un'etichetta.
Rappresentazione JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
Campi | |
---|---|
resourceName |
Nome della risorsa. I nomi delle risorse dell'etichetta campagna hanno il formato: |
campaign |
La campagna a cui è associata l'etichetta. |
label |
L'etichetta assegnata alla campagna. |
CartDataSalesView
Visualizzazione vendite dati del carrello.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della vista Vendite dati del carrello. I nomi delle risorse della vista vendite dei dati del carrello hanno il formato: |
Pubblico
Il pubblico è un'opzione di targeting efficace che ti consente di incrociare diversi attributi di segmenti, come dati demografici dettagliati e affinità, per creare segmenti di pubblico che rappresentano sezioni dei tuoi segmenti target.
Rappresentazione JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa del segmento di pubblico. I nomi dei segmenti di pubblico hanno il seguente formato:
|
id |
ID del segmento di pubblico. |
name |
Obbligatorio. Nome del segmento di pubblico. Deve essere univoco per tutti i segmenti di pubblico. Deve avere una lunghezza minima di 1 e una lunghezza massima di 255. |
description |
Descrizione di questo segmento di pubblico. |
ConversionAction
Un'azione di conversione.
Rappresentazione JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'azione di conversione. I nomi delle risorse di azione di conversione hanno il formato:
|
creationTime |
Timestamp della creazione dell'attività Floodlight, formattato in ISO 8601. |
status |
Lo stato di questa azione di conversione per l'accumulo degli eventi di conversione. |
type |
Il tipo di questa azione di conversione. |
category |
La categoria di conversioni registrate per questa azione di conversione. |
valueSettings |
Impostazioni relative al valore degli eventi di conversione associati a questa azione di conversione. |
attributionModelSettings |
Impostazioni relative al modello di attribuzione di questa azione di conversione. |
floodlightSettings |
Impostazioni Floodlight per i tipi di conversione Floodlight. |
id |
L'ID dell'azione di conversione. |
name |
Il nome dell'azione di conversione. Questo campo è obbligatorio e non deve essere vuoto quando crei nuove azioni di conversione. |
primaryForGoal |
Se la parte primaria per l'obiettivo di un'azione di conversione è falsa, l'azione di conversione non è disponibile per tutte le campagne, indipendentemente dall'obiettivo di conversione del cliente o dall'obiettivo di conversione della campagna. Tuttavia, gli obiettivi di conversione personalizzati non rispettano l'obiettivo principale. Pertanto, se una campagna ha un obiettivo di conversione personalizzato configurato con un'azione di conversione primaria perObiettivo = falsa, l'azione di conversione sarà comunque disponibile. Per impostazione predefinita, il valore primario per l'obiettivo principale è true se non è impostato. Nella V9, l'elemento primarioForGoal può essere impostato su false solo dopo la creazione tramite un "aggiornamento" perché non è dichiarata come facoltativa. |
ownerCustomer |
Il nome della risorsa del cliente proprietario dell'azione di conversione oppure nullo se si tratta di un'azione di conversione definita dal sistema. |
includeInClientAccountConversionsMetric |
Indica se questa azione di conversione deve essere inclusa in "clientAccountConversions" in un file di dati. |
includeInConversionsMetric |
Indica se questa azione di conversione deve essere inclusa nelle "conversioni" in un file di dati. |
clickThroughLookbackWindowDays |
Il numero massimo di giorni che possono trascorrere tra un'interazione (ad esempio un clic) e un evento di conversione. |
appId |
ID app per un'azione di conversione da app. |
ConversionActionStatus
Possibili stati di un'azione di conversione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ENABLED |
Le conversioni verranno registrate. |
REMOVED |
Le conversioni non verranno registrate. |
HIDDEN |
Le conversioni non verranno registrate e l'azione di conversione non verrà visualizzata nell'interfaccia utente. |
ConversionActionType
I tipi possibili di un'azione di conversione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
AD_CALL |
Conversioni che si verificano quando un utente fa clic sull'estensione di chiamata di un annuncio. |
CLICK_TO_CALL |
Conversioni che si verificano quando un utente fa clic su un numero di telefono da un dispositivo mobile. |
GOOGLE_PLAY_DOWNLOAD |
Conversioni che si verificano quando un utente scarica un'app mobile dal Google Play Store. |
GOOGLE_PLAY_IN_APP_PURCHASE |
Conversioni che si verificano quando un utente effettua un acquisto in un'app tramite la fatturazione di Android. |
UPLOAD_CALLS |
Conversioni di chiamata monitorate dall'inserzionista e caricate. |
UPLOAD_CLICKS |
Conversioni monitorate dall'inserzionista e caricate con i clic attribuiti. |
WEBPAGE |
Conversioni che si verificano su una pagina web. |
WEBSITE_CALL |
Conversioni che si verificano quando un utente chiama un numero di telefono generato dinamicamente dal sito web di un inserzionista. |
STORE_SALES_DIRECT_UPLOAD |
Conversione delle vendite in negozio basata sui caricamenti di dati di commercianti proprietari o di terze parti. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di caricamento diretto per le vendite in negozio. |
STORE_SALES |
Conversione delle vendite in negozio basata sui caricamenti di dati di commercianti proprietari o di terze parti e/o sugli acquisti in negozio utilizzando carte delle reti di pagamento. Solo i clienti inclusi nella lista consentita possono utilizzare i tipi di vendite in negozio. Sola lettura. |
FIREBASE_ANDROID_FIRST_OPEN |
Conversioni relative alla prima apertura di app per Android monitorate tramite Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Conversioni di acquisto in-app da app per Android monitorate tramite Firebase. |
FIREBASE_ANDROID_CUSTOM |
Conversioni personalizzate di app per Android monitorate tramite Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Conversioni prima apertura di app per iOS monitorate tramite Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Conversioni di acquisto in-app da 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 prima apertura delle app per Android monitorate tramite Analytics per app di terze parti. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Conversioni di acquisto in-app da app per Android monitorate tramite Analytics per app di terze parti. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Conversioni personalizzate delle app per Android monitorate tramite Analytics per app di terze parti. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Conversioni prima apertura delle app per iOS monitorate tramite Analytics per app di terze parti. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Conversioni di acquisto in-app da app per iOS monitorate tramite Analytics per app di terze parti. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Conversioni personalizzate delle app per iOS monitorate tramite Analytics per app di terze parti. |
ANDROID_APP_PRE_REGISTRATION |
Conversioni che si verificano quando un utente preregistra un'app mobile dal Google Play Store. Sola lettura. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
Conversioni che monitorano tutti i download di Google Play che non sono monitorate da un tipo specifico di app. Sola lettura. |
FLOODLIGHT_ACTION |
L'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 tiene traccia del numero di vendite effettuate o del numero di articoli acquistati. Consente inoltre di acquisire il valore totale di ogni vendita. Sola lettura. |
GOOGLE_HOSTED |
Conversioni che monitorano le azioni locali dai prodotti e servizi Google dopo l'interazione con un annuncio. Sola lettura. |
LEAD_FORM_SUBMIT |
Conversioni registrate quando un utente invia un modulo per i lead. Sola lettura. |
SALESFORCE |
Conversioni provenienti da Salesforce. Sola lettura. |
SEARCH_ADS_360 |
Conversioni importate dai dati Floodlight di Search Ads 360. Sola lettura. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
Conversioni di chiamata che si verificano negli annunci delle campagne intelligenti senza configurazione del monitoraggio delle chiamate, utilizzando i 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 le indicazioni stradali per raggiungere la sede dell'attività commerciale in Google Maps. Solo campagna intelligente. Sola lettura. |
SMART_CAMPAIGN_TRACKED_CALLS |
Conversioni di chiamata che si verificano negli annunci delle campagne intelligenti con monitoraggio delle chiamate configurato, utilizzando i criteri personalizzati delle campagne intelligenti. Sola lettura. |
STORE_VISITS |
Conversioni che si verificano quando un utente visita il negozio al dettaglio di un inserzionista. Sola lettura. |
WEBPAGE_CODELESS |
Conversioni create da eventi del sito web (come invii di moduli o caricamenti di pagine) che non utilizzano snippet evento codificati individualmente. Sola lettura. |
UNIVERSAL_ANALYTICS_GOAL |
Conversioni provenienti da obiettivi Universal Analytics collegati. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Conversioni provenienti dalle transazioni di Universal Analytics collegate. |
GOOGLE_ANALYTICS_4_CUSTOM |
Conversioni provenienti dalle conversioni degli eventi personalizzati di Google Analytics 4 collegate. |
GOOGLE_ANALYTICS_4_PURCHASE |
Conversioni provenienti dalle conversioni di acquisto di Google Analytics 4 collegate. |
ConversionActionCategory
La categoria di conversioni associate a un'azione di conversione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
DEFAULT |
Categoria predefinita. |
PAGE_VIEW |
Utente che visita una pagina. |
PURCHASE |
Acquisto, vendite o "ordine effettuato" . |
SIGNUP |
Azione dell'utente di registrazione. |
LEAD |
Azione di generazione di lead. |
DOWNLOAD |
Azione di download di software (come nel caso di un'app). |
ADD_TO_CART |
L'aggiunta di articoli a un carrello o a una borsa 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 a un prodotto o servizio. |
PHONE_CALL_LEAD |
Una chiamata per indicare l'interesse nei confronti dell'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 per indicare un interesse commerciale. |
BOOK_APPOINTMENT |
La prenotazione di un appuntamento con l'attività di un inserzionista. |
REQUEST_QUOTE |
Una richiesta di preventivo o preventivo. |
GET_DIRECTIONS |
Una ricerca della sede dell'attività commerciale di un inserzionista che ha intenzione di visitarla. |
OUTBOUND_CLICK |
Un clic sul sito di un partner inserzionista. |
CONTACT |
Chiamata, SMS, email, chat o altro tipo di contatto con un inserzionista. |
ENGAGEMENT |
Un evento di coinvolgimento sul sito web, ad esempio una lunga durata del sito o un obiettivo intelligente di Google Analytics (GA). Da utilizzare per le importazioni di obiettivi Oro di GA, Firebase e GA. |
STORE_VISIT |
Una visita a un negozio fisico. |
STORE_SALE |
Una vendita che si verifica in un negozio fisico. |
QUALIFIED_LEAD |
Una conversione di lead importata da una sorgente esterna in Google Ads e che è stata ulteriormente qualificata dall'inserzionista (team di marketing/vendita). Nel percorso dal lead alla vendita, gli inserzionisti ottengono lead e poi agiscono raggiungendo il consumatore. Se il consumatore è interessato e potrebbe finire per acquistare il suo prodotto, l'inserzionista contrassegna questi lead come "lead qualificati". |
CONVERTED_LEAD |
Una conversione di lead importata da una sorgente esterna in Google Ads e che ha ulteriormente completato una fase scelta come definita dall'inserzionista di generazione di lead. |
ValueSettings
Impostazioni relative al valore degli eventi di conversione associati a questa azione di conversione.
Rappresentazione JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Campi | |
---|---|
defaultValue |
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 |
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 |
Consente di stabilire se utilizzare il valore e il codice valuta predefiniti al posto del valore e del codice valuta specificati negli eventi di conversione per questa azione di conversione. |
AttributionModelSettings
Impostazioni relative al modello di attribuzione di questa azione di conversione.
Rappresentazione JSON |
---|
{ "attributionModel": enum ( |
Campi | |
---|---|
attributionModel |
Il tipo di modello di attribuzione di questa azione di conversione. |
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 credito per una determinata conversione tra potenzialmente molte interazioni precedenti.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
EXTERNAL |
Utilizza l'attribuzione esterna. |
GOOGLE_ADS_LAST_CLICK |
Attribuisce tutto il merito di una conversione all'ultimo clic. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Attribuisce tutto il merito di una conversione al primo clic utilizzando l'attribuzione della Ricerca Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Attribuisce il merito di una conversione equamente tra tutti i clic utilizzando l'attribuzione della Ricerca Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Attribuisce un merito esponenziale maggiore per una conversione ai clic più recenti utilizzando l'attribuzione della Ricerca Google (il tempo di dimezzamento è 1 settimana). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Attribuisce il 40% del merito di una conversione al primo e all'ultimo clic. Il restante 20% viene distribuito uniformemente tra tutti gli altri clic. che 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 Ricerca Google. |
DataDrivenModelStatus
Enumera gli stati dei modelli basati sui dati.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
AVAILABLE |
Il modello basato sui dati è disponibile. |
STALE |
Il modello basato sui dati non è aggiornato. Non viene aggiornato da almeno 7 giorni. È ancora in uso, ma diventerà scaduto se non viene aggiornato per 30 giorni. |
EXPIRED |
Il modello basato sui dati è scaduto. Non è stato aggiornato per almeno 30 giorni e non può essere utilizzato. Il più delle volte questo accade perché negli ultimi 30 giorni non è stato registrato il numero di eventi richiesto. |
NEVER_GENERATED |
Il modello basato sui dati non è mai stato generato. Il più delle volte, il motivo è che non c'è mai stato il numero di eventi richiesto 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 |
Stringa utilizzata per identificare un gruppo attività Floodlight durante la generazione di report sulle conversioni. |
activityTag |
Stringa utilizzata per identificare un'attività Floodlight durante la generazione di report sulle conversioni. |
activityId |
ID dell'attività Floodlight in DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Una variabile personalizzata di conversione. Consulta "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 ( |
Campi | |
---|---|
resourceName |
Il nome risorsa della variabile personalizzata di conversione. I nomi delle risorse delle variabili personalizzate per le conversioni hanno il formato:
|
id |
L'ID della variabile personalizzata di conversione. |
name |
Obbligatorio. Il nome della variabile personalizzata di conversione. Il nome deve essere univoco. La lunghezza massima del nome è 100 caratteri. Non devono esserci spazi aggiuntivi prima e dopo. |
tag |
Obbligatorio. Il tag della variabile personalizzata di conversione. Il tag deve essere univoco ed essere composto da una "u" carattere immediatamente seguito da un numero minore di ormequal a 100. Ad esempio: "u4". |
status |
Lo stato della variabile personalizzata di conversione per l'accumulo degli eventi di conversione. |
ownerCustomer |
Il nome della risorsa del cliente proprietario della variabile personalizzata di conversione. |
family |
Famiglia della variabile personalizzata di conversione. |
cardinality |
Cardinalità della variabile personalizzata di conversione. |
floodlightConversionCustomVariableInfo |
Campi per le variabili personalizzate di conversione Floodlight di Search Ads 360. |
customColumnIds[] |
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 un 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 ABILITATA. 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 nuovamente su ABILITATA. |
ConversionCustomVariableFamily
Famiglia di una variabile personalizzata di conversione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
STANDARD |
La variabile personalizzata di conversione standard. I clienti devono effettuare l'attivazione prima dell'uso. |
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 un valore sconosciuto in questa versione. |
BELOW_ALL_LIMITS |
La variabile personalizzata di conversione ha una cardinalità al di sotto di tutti i limiti. La variabile può essere utilizzata per la segmentazione e, se la variabile è abilitata, possono accumulare statistiche per nuovi valori. |
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 di statistiche. La segmentazione viene disattivata, ma possono essere registrate statistiche per nuovi valori se la variabile è attivata. |
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 viene disattivata, ma possono essere registrate statistiche per nuovi valori se la variabile è attivata. |
EXCEEDS_STATS_LIMIT |
La variabile personalizzata di conversione ha superato i limiti di segmentazione e i limiti delle statistiche. La segmentazione viene disattivata e le statistiche per le variabili attivate possono accumularsi 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 ( |
Campi | |
---|---|
floodlightVariableType |
Tipo di variabile Floodlight definito in Search Ads 360. |
floodlightVariableDataType |
Tipo di dati della variabile Floodlight definito in Search Ads 360. |
FloodlightVariableType
Tipo di variabile Floodlight, come definito in Search Ads 360. Per ulteriori informazioni, consulta la pagina https://support.google.com/searchads/answer/4397154?hl=en.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
DIMENSION |
Tipo di variabile Floodlight 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 ulteriori informazioni, consulta la pagina https://support.google.com/searchads/answer/4397154?hl=en.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
NUMBER |
Rappresenta una variabile Floodlight di tipo "Numero" di testo. Questa variabile può essere assegnata a variabili Floodlight di tipo DIMENSION o METRIC. |
STRING |
Rappresenta una variabile Floodlight di "String" di testo. Questa variabile può essere assegnata a variabili Floodlight di tipo DIMENSION. |
Cliente
Un cliente.
Rappresentazione JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Campi | |
---|---|
resourceName |
Il nome risorsa del cliente. I nomi delle risorse dei clienti hanno il seguente formato:
|
conversionTrackingSetting |
Impostazione del monitoraggio delle conversioni per un cliente. |
accountType |
Tipo di account motore, ad esempio Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track e così via. |
doubleClickCampaignManagerSetting |
Impostazione di DoubleClick Campaign Manager (DCM) per un cliente amministratore. |
accountStatus |
Stato dell'account, ad esempio Attivato, In pausa, Rimosso e così via. |
lastModifiedTime |
La data e l'ora dell'ultima modifica del cliente. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato. |
engineId |
ID dell'account nell'account motore esterno. |
status |
Lo stato del cliente. |
creationTime |
Il timestamp della creazione del cliente. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
id |
L'ID del cliente. |
descriptiveName |
Nome descrittivo facoltativo e non univoco del cliente. |
currencyCode |
La valuta in cui opera l'account. È supportato un sottoinsieme dei codici valuta dello standard ISO 4217. |
timeZone |
L'ID fuso orario locale del cliente. |
trackingUrlTemplate |
Il modello di URL per la creazione di un URL di monitoraggio a partire dai parametri. |
finalUrlSuffix |
Il modello di URL per l'aggiunta di parametri all'URL finale. |
autoTaggingEnabled |
Indica se il tagging automatico è attivato per il cliente. |
manager |
Se il cliente è un gestore. |
ConversionTrackingSetting
Una raccolta di impostazioni a livello di cliente relative al monitoraggio delle conversioni di Search Ads 360.
Rappresentazione JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Campi | |
---|---|
acceptedCustomerDataTerms |
Se il cliente ha accettato i termini per i dati dei clienti. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'amministratore. Questo campo è di sola lettura. Per ulteriori informazioni, consulta la pagina https://support.google.com/adspolicy/answer/7475709. |
conversionTrackingStatus |
Stato del monitoraggio delle conversioni. Indica se il cliente utilizza il monitoraggio delle conversioni e chi è il proprietario del monitoraggio delle conversioni. Se questo cliente utilizza il monitoraggio delle conversioni su più account, il valore restituito varierà in base alla metrica |
enhancedConversionsForLeadsEnabled |
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'amministratore. Questo campo è di sola lettura. |
googleAdsConversionCustomer |
Il nome della risorsa del cliente in cui vengono create e gestite le conversioni. Questo campo è di sola lettura. |
conversionTrackingId |
L'ID monitoraggio delle conversioni utilizzato per questo account. Questo ID non indica se il cliente utilizza il monitoraggio delle conversioni (conversionTrackingStatus). Questo campo è di sola lettura. |
googleAdsCrossAccountConversionTrackingId |
L'ID di monitoraggio delle conversioni del gestore del cliente. Questo valore viene impostato quando il cliente attiva il monitoraggio delle conversioni e sostituisce il valore di ConversionTrackingId. Questo campo può essere gestito solo tramite l'interfaccia utente di Google Ads. Questo campo è di sola lettura. |
crossAccountConversionTrackingId |
L'ID di monitoraggio delle conversioni del gestore del cliente. Questo parametro viene impostato quando il cliente attiva il monitoraggio delle conversioni su più account e sostituisce il valore di ConversionTrackingId. |
ConversionTrackingStatus
Stato del monitoraggio delle conversioni del cliente.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
NOT_CONVERSION_TRACKED |
Il cliente non utilizza alcun 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 dal gestore 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 dal gestore specificato nell'login-customer-id della richiesta. |
AccountType
Possibili tipi di account motore.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 |
Yahoo Japan. |
DoubleClickCampaignManagerSetting
Impostazione di DoubleClick Campaign Manager (DCM) per un cliente amministratore.
Rappresentazione JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Campi | |
---|---|
advertiserId |
ID dell'inserzionista Campaign Manager associato a questo cliente. |
networkId |
ID della rete Campaign Manager associata a questo cliente. |
timeZone |
Fuso orario della rete Campaign Manager associata a questo cliente nel formato di database del fuso orario IANA, ad esempio America/New_York. |
AccountStatus
Possibili stati di un account.
Enum | |
---|---|
UNSPECIFIED |
Valore predefinito. |
UNKNOWN |
Valore sconosciuto. |
ENABLED |
L'account è in grado di pubblicare annunci. |
PAUSED |
L'account viene disattivato dall'utente. |
SUSPENDED |
L'account è stato disattivato da un processo interno. |
REMOVED |
L'account viene disattivato irrevocabilmente. |
DRAFT |
L'account è ancora in fase di configurazione, ma non è ancora ATTIVATO. |
CustomerStatus
Possibili stati di un cliente.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ENABLED |
Indica un account attivo in grado di pubblicare annunci. |
CANCELED |
Indica un account cancellato che non è in grado di pubblicare annunci. Può essere riattivato da un utente amministratore. |
SUSPENDED |
Indica che un account sospeso non è in grado di pubblicare annunci. Può essere attivato solo dall'Assistenza Google. |
CLOSED |
Indica che un account chiuso non è in grado di pubblicare annunci. Anche l'account di prova avrà lo stato CHIUSO. Lo stato è permanente e non può essere riaperto. |
CustomerAsset
Un collegamento tra un cliente e un asset.
Rappresentazione JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'asset del cliente. I nomi delle risorse CustomerAsset hanno il formato:
|
asset |
Obbligatorio. L'asset collegato al cliente. |
status |
Stato dell'asset del cliente. |
CustomerAssetSet
CustomerAssetSet è il collegamento tra un cliente e un insieme di asset. L'aggiunta di un CustomerAssetSet collega un insieme di asset a un cliente.
Rappresentazione JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'insieme di asset del cliente. I nomi delle risorse degli asset del set di asset hanno il seguente formato:
|
assetSet |
Il set di asset collegato al cliente. |
customer |
Il cliente a cui è collegato questo set di asset. |
status |
Lo stato dell'asset del set 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 strategie di proprietà dei gestori del cliente e condivise con questo cliente, oltre alle strategie di proprietà di questo cliente. Questa risorsa non fornisce metriche ed espone solo un sottoinsieme limitato di attributi BiddingStrategy.
Rappresentazione JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della strategia di offerta accessibile. I nomi delle risorse AccessibleBiddingStrategy hanno il formato:
|
id |
L'ID della strategia di offerta. |
name |
Il nome della strategia di offerta. |
type |
Il tipo di strategia di offerta. |
ownerCustomerId |
L'ID del cliente proprietario della strategia di offerta. |
ownerDescriptiveName |
descrittivoName del cliente proprietario della strategia di offerta. |
Campo unione È possibile impostarne solo uno. |
|
maximizeConversionValue |
Una strategia di offerta automatica per aiutarti a ottenere il massimo valore di conversione per le tue campagne entro i limiti di spesa del budget. |
maximizeConversions |
Una strategia di offerta automatica per aiutarti a ottenere il maggior numero possibile di conversioni per le tue campagne entro i limiti di spesa del budget. |
targetCpa |
Una strategia di offerta che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato. |
targetImpressionShare |
Una strategia di offerta che esegue automaticamente l'ottimizzazione in base a una determinata percentuale di impressioni. |
targetRoas |
Una strategia di offerta che ti aiuta a massimizzare le entrate a una media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico. |
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 per aiutarti a ottenere il massimo valore di conversione per le tue campagne entro i limiti di spesa del budget.
Rappresentazione JSON |
---|
{ "targetRoas": number } |
Campi | |
---|---|
targetRoas |
L'opzione del ritorno sulla spesa pubblicitaria (ROAS) target. Se impostata, la strategia di offerta massimizzerà le entrate calcolando una media del ritorno sulla spesa pubblicitaria target. Se il ROAS target è elevato, la strategia di offerta potrebbe non riuscire a 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 per aiutarti 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 |
L'opzione costo per acquisizione (CPA) target. L'importo medio che intendi spendere per ogni acquisizione. |
targetCpaMicros |
L'opzione costo per acquisizione (CPA) target. L'importo medio che intendi spendere per ogni acquisizione. |
TargetCpa
Una strategia di offerta automatica che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target da te impostato.
Rappresentazione JSON |
---|
{ "targetCpaMicros": string } |
Campi | |
---|---|
targetCpaMicros |
CPA target medio. Questo target deve essere maggiore o uguale all'unità fatturabile minima in base alla valuta dell'account. |
TargetRoas
Una strategia di offerta automatica che ti aiuta a massimizzare le entrate calcolando la media di un ritorno sulla spesa pubblicitaria (ROAS) target specifico.
Rappresentazione JSON |
---|
{ "targetRoas": number } |
Campi | |
---|---|
targetRoas |
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 |
Il target di spesa in base al quale massimizzare i clic. Un offerente di spesa target cercherà di spendere il minor valore tra questo valore o l'importo della spesa limitata naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è obsoleto e non deve più essere utilizzato. Per informazioni dettagliate, visita la pagina https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
Limite di offerta massimo che può essere impostato dalla strategia di offerta. Il limite si applica a tutte le parole chiave gestite dalla strategia. |
CustomerManagerLink
Rappresenta la relazione di collegamento tra cliente e gestore clienti.
Rappresentazione JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Nome della risorsa. I nomi delle risorse CustomerManagerLink sono nel formato: |
status |
Stato del collegamento tra il cliente e il gestore. |
managerCustomer |
Il cliente amministratore collegato al cliente. |
managerLinkId |
ID del link gestore clienti. Questo campo è di sola lettura. |
startTime |
Timestamp della creazione di CustomerManagerLink. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
ManagerLinkStatus
Stati possibili di un collegamento.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ACTIVE |
Indica la relazione effettiva in corso |
INACTIVE |
Indica la risoluzione del rapporto |
PENDING |
Indica che la relazione è stata richiesta dal gestore, ma il cliente non ha ancora accettato. |
REFUSED |
La relazione è stata richiesta dal gestore, ma il cliente ha rifiutato. |
CANCELED |
Indica che la relazione è stata richiesta dall'amministratore, ma l'amministratore l'ha annullata. |
CustomerClient
Un collegamento tra il cliente specificato e un cliente cliente. I Clienti Cliente 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 ( |
Campi | |
---|---|
resourceName |
Il nome risorsa del client del cliente. I nomi delle risorse CustomerClient hanno il seguente formato: |
appliedLabels[] |
I nomi delle risorse delle etichette di proprietà del cliente che ha inviato la richiesta e applicate al cliente stesso. I nomi delle risorse delle etichette hanno il formato:
|
status |
Lo stato del cliente. Sola lettura. |
clientCustomer |
Il nome della risorsa del cliente-cliente collegato al cliente specificato. Sola lettura. |
level |
Distanza tra il cliente specificato e il cliente. Per il link alla pagina corrente, il valore del livello sarà 0. Sola lettura. |
timeZone |
Rappresentazione di stringa CLDR (Common Locale Data Repository) del fuso orario del client, ad esempio America/Los_Angeles. Sola lettura. |
testAccount |
Indica se il cliente è un account di prova. Sola lettura. |
manager |
Indica se il cliente è un gestore. Sola lettura. |
descriptiveName |
Nome descrittivo del client. Sola lettura. |
currencyCode |
Codice valuta (ad es. "USD", "EUR") del cliente. Sola lettura. |
id |
L'ID del 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 |
Il nome della risorsa della visualizzazione del termine 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:
|
landingPage |
L'URL pagina di destinazione dell'impressione selezionato dinamicamente. Questo campo è di sola lettura. |
GenderView
Una visualizzazione genere. La risorsa genderView riflette lo stato di pubblicazione effettivo anziché i criteri aggiunti. Un gruppo di annunci privo di criteri relativi al genere viene mostrato per impostazione predefinita a tutti i generi; pertanto, tutti questi ultimi vengono visualizzati in genderView con le statistiche.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della vista genere. I nomi delle risorse della vista genere hanno il seguente formato:
|
GeoTargetConstant
Una costante per il targeting geografico.
Rappresentazione JSON |
---|
{
"resourceName": string,
"status": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della costante del targeting geografico. I nomi delle risorse costanti del targeting geografico hanno il seguente formato:
|
status |
Stato costante del targeting geografico. |
id |
L'ID della costante del target geografico. |
name |
Nome inglese costante del targeting geografico. |
countryCode |
Il codice paese ISO-3166-1 alpha-2 associato al target. |
targetType |
Tipo di costante target del targeting geografico. |
canonicalName |
Il nome completo in inglese, composto dal nome del destinatario e da quello dell'entità principale e del paese. |
parentGeoTarget |
Il nome della risorsa della costante del target geografico padre. I nomi delle risorse costanti del targeting geografico hanno il seguente formato:
|
GeoTargetConstantStatus
I possibili stati di una costante di targeting geografico.
Enum | |
---|---|
UNSPECIFIED |
Nessun valore specificato. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta. |
ENABLED |
La costante del target geografico è valida. |
REMOVAL_PLANNED |
La costante del target geografico è obsoleta e verrà rimossa. |
KeywordView
Una visualizzazione per parole chiave.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione delle parole chiave. I nomi delle risorse della vista parole chiave hanno il formato:
|
Etichetta
Un'etichetta.
Rappresentazione JSON |
---|
{ "resourceName": string, "status": enum ( |
Campi | |
---|---|
resourceName |
Nome della risorsa. I nomi delle risorse delle etichette hanno il formato: |
status |
Stato dell'etichetta. Sola lettura. |
textLabel |
Un tipo di etichetta che mostra testo su uno sfondo colorato. |
id |
ID dell'etichetta. Sola lettura. |
name |
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 inclusi. |
LabelStatus
Possibili stati di un'etichetta.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ENABLED |
L'etichetta è attivata. |
REMOVED |
L'etichetta è stata rimossa. |
TextLabel
Un tipo di etichetta che mostra testo su uno sfondo colorato.
Rappresentazione JSON |
---|
{ "backgroundColor": string, "description": string } |
Campi | |
---|---|
backgroundColor |
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 |
Una breve descrizione dell'etichetta. La lunghezza non deve essere superiore a 200 caratteri. |
LanguageConstant
Una lingua.
Rappresentazione JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della costante linguistica. I nomi delle risorse delle costanti del linguaggio hanno il seguente formato:
|
id |
L'ID della costante linguistica. |
code |
Il codice della lingua, ad esempio "en_US", "en_AU", "es", "fr" e così via. |
name |
Il nome completo della lingua in inglese, ad esempio "Inglese (USA)", "Spagnolo" e così via. |
targetable |
Indica se la lingua può essere scelta come target. |
LocationView
Una visualizzazione della località riassume il rendimento delle campagne in base a un criterio relativo alla località.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della vista località. I nomi delle risorse della vista località hanno il formato:
|
ProductBiddingCategoryConstant
Una categoria di offerte per i prodotti.
Rappresentazione JSON |
---|
{ "resourceName": string, "level": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della categoria di offerte per i prodotti. I nomi delle risorse delle categorie di offerte per i prodotti hanno il formato:
|
level |
Livello della categoria di offerta del prodotto. |
status |
Stato della categoria di offerta per il prodotto. |
id |
ID della categoria di offerta per il prodotto. Questo ID equivale all'ID google_product_category come descritto in questo articolo: https://support.google.com/merchants/answer/6324436. |
countryCode |
Codice del paese a due lettere maiuscole della categoria di offerta per il prodotto. |
productBiddingCategoryConstantParent |
Nome della risorsa della categoria principale di offerte dei prodotti. |
languageCode |
Codice lingua della categoria di offerte per i prodotti. |
localizedName |
Valore visualizzato della categoria di offerte per i prodotti localizzata in base a languageCode. |
ProductBiddingCategoryLevel
Enum che descrive il livello della categoria di offerta per i prodotti.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
LEVEL1 |
Livello 1. |
LEVEL2 |
Livello 2. |
LEVEL3 |
Livello 3. |
LEVEL4 |
Livello 4. |
LEVEL5 |
Livello 5. |
ProductBiddingCategoryStatus
Enum che descrive lo stato della categoria di offerta per i prodotti.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ACTIVE |
La categoria è attiva e può essere utilizzata per le offerte. |
OBSOLETE |
La categoria è obsoleta. Utilizzato solo per la generazione di report. |
ProductGroupView
Una visualizzazione del gruppo di prodotti.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione del gruppo di prodotti. I nomi delle risorse della vista gruppo di prodotti hanno il seguente formato:
|
ShoppingPerformanceView
Visualizzazione del rendimento di Shopping. Fornisce statistiche sulle campagne Shopping aggregate a diversi livelli di dimensione 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 a partire dalla data e dall'ora in cui è stato registrato l'evento corrispondente.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione del rendimento di Shopping. I nomi delle risorse per la visualizzazione del rendimento di Shopping hanno il formato: |
UserList
Un elenco di utenti. Si tratta di un elenco di utenti che un cliente può scegliere come target.
Rappresentazione JSON |
---|
{
"resourceName": string,
"type": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa dell'elenco di utenti. I nomi delle risorse dell'elenco utenti hanno il seguente formato:
|
type |
Tipo di questo elenco. Questo campo è di sola lettura. |
id |
ID dell'elenco di utenti. |
name |
Nome di questo elenco di utenti. A seconda del suo 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 di utenti.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
REMARKETING |
Elenco utenti rappresentato come una raccolta di tipi di conversione. |
LOGICAL |
Elenco utenti rappresentato come una combinazione di altri elenchi/interessi di utenti. |
EXTERNAL_REMARKETING |
Elenco utenti creato nella piattaforma Google Ad Manager. |
RULE_BASED |
Elenco utenti associato a una regola. |
SIMILAR |
Elenco utenti con utenti simili a quelli di un altro elenco utenti. |
CRM_BASED |
Elenco utenti di dati CRM di prima parte forniti dall'inserzionista sotto forma di email o altri formati. |
WebpageView
Una visualizzazione di pagina web.
Rappresentazione JSON |
---|
{ "resourceName": string } |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visualizzazione della pagina web. I nomi delle risorse di visualizzazione di pagine web hanno il formato:
|
Visita
Una visita.
Rappresentazione JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della visita. I nomi delle risorse delle visite hanno il seguente formato:
|
id |
L'ID della visita. |
criterionId |
ID parola chiave di Search Ads 360. Il valore 0 indica che la parola chiave non è attribuita. |
merchantId |
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 |
ID annuncio. Il valore 0 indica che l'annuncio non è attribuito. |
clickId |
Una stringa univoca per ogni visita che viene passata alla pagina di destinazione come parametro URL click id. |
visitDateTime |
Il timestamp della visita. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato. |
productId |
L'ID del prodotto su cui è stato fatto clic. |
productChannel |
Il canale di vendita del prodotto su cui è stato fatto clic: online o locale. |
productLanguageCode |
La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto. |
productStoreId |
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 |
Il paese (formato ISO-3166) registrato per il feed di inventario contenente il prodotto su cui è stato fatto clic. |
assetId |
ID dell'asset con cui è stata eseguita l'interazione durante l'evento visita. |
assetFieldType |
Tipo di campo asset dell'evento visita. |
ProductChannel
Enum che descrive la località di un'offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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 ( |
Campi | |
---|---|
resourceName |
Il nome della risorsa della conversione. I nomi delle risorse di conversione hanno il formato:
|
id |
L'ID della conversione |
criterionId |
ID criterio Search Ads 360. Il valore 0 indica che il criterio non è attribuito. |
merchantId |
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 |
ID annuncio. Il valore 0 indica che l'annuncio non è attribuito. |
clickId |
Una stringa univoca per la visita a cui è attribuita la conversione, che viene passata alla pagina di destinazione come parametro URL clickid. |
visitId |
L'ID visita di Search Ads 360 a cui è attribuita la conversione. |
advertiserConversionId |
Per le conversioni offline, si tratta di un ID fornito dagli inserzionisti. Se un inserzionista non specifica un ID di questo tipo, 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 |
L'ID del prodotto su cui è stato fatto clic. |
productChannel |
Il canale di vendita del prodotto su cui è stato fatto clic: online o locale. |
productLanguageCode |
La lingua (ISO-639-1) impostata per il feed di Merchant Center contenente i dati sul prodotto. |
productStoreId |
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 |
Il paese (formato ISO-3166) registrato per il feed di inventario contenente il prodotto su cui è stato fatto clic. |
attributionType |
A cosa viene attribuita la conversione: visita o Parola chiave+annuncio. |
conversionDateTime |
Il timestamp dell'evento di conversione. |
conversionLastModifiedDateTime |
Il timestamp dell'ultima modifica della conversione. |
conversionVisitDateTime |
Il timestamp della visita a cui è attribuita la conversione. |
conversionQuantity |
La quantità di articoli registrati dalla conversione, in base a quanto determinato dal parametro qty url. L'inserzionista è responsabile della compilazione dinamica del parametro (ad es. il numero di elementi venduti nella conversione), altrimenti il valore predefinito sarà 1. |
conversionRevenueMicros |
Le entrate aggiustate in micro per l'evento di conversione. Sarà sempre nella valuta dell'account di pubblicazione. |
floodlightOriginalRevenue |
Le entrate originali e invariate associate all'evento Floodlight (nella valuta del report corrente), prima delle modifiche dell'istruzione della valuta Floodlight. |
floodlightOrderId |
L'ID ordine Floodlight fornito dall'inserzionista per la conversione. |
status |
Lo stato della conversione (ATTIVATA o RIMOSSO). |
assetId |
ID dell'asset con cui è stata eseguita l'interazione durante l'evento di conversione. |
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 un valore sconosciuto in questa versione. |
VISIT |
La conversione viene attribuita a una visita. |
CRITERION_AD |
La conversione viene attribuita a un criterio e a una coppia di annunci. |
ConversionStatus
Possibili stati di una conversione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
ENABLED |
La conversione è attivata. |
REMOVED |
La conversione è stata rimossa. |
Metriche
Dati delle metriche.
Rappresentazione JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Campi | |
---|---|
allConversionsValueByConversionDate |
Il valore di tutte le conversioni. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
Il numero totale di conversioni. Sono incluse tutte le conversioni indipendentemente dal valore di includeInConversionsMetric. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
Le metriche personalizzate per le conversioni. |
conversionsValueByConversionDate |
La somma dei valori delle conversioni disponibili per data di conversione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. |
conversionsByConversionDate |
La somma delle conversioni in base alla data di conversione per i tipi di conversione disponibili. Può essere frazionario a causa della creazione di modelli di attribuzione. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. |
historicalCreativeQualityScore |
Il punteggio di qualità storico della creatività. |
historicalLandingPageQualityScore |
La qualità dell'esperienza storica sulla pagina di destinazione. |
historicalSearchPredictedCtr |
La percentuale di clic (CTR) prevista dalla ricerca storica. |
interactionEventTypes[] |
I tipi di interazioni senza costi e a pagamento. |
rawEventConversionMetrics[] |
Le metriche non elaborate di conversione degli eventi. |
absoluteTopImpressionPercentage |
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 |
Tutte le conversioni generate dalle interazioni (anziché le conversioni view-through) divise per il numero di interazioni con l'annuncio. |
allConversionsValue |
Il valore di tutte le conversioni. |
allConversions |
Il numero totale di conversioni. Sono incluse tutte le conversioni indipendentemente dal valore di includeInConversionsMetric. |
allConversionsValuePerCost |
Il valore di tutte le conversioni diviso per il costo totale delle interazioni con l'annuncio, ad esempio clic per gli annunci di testo o visualizzazioni per gli annunci video. |
allConversionsFromClickToCall |
Il numero di volte in cui gli utenti hanno fatto clic su "Chiama" per chiamare un negozio durante o dopo aver fatto clic su un annuncio. Questo numero non indica se le chiamate sono state connesse o meno, né la loro durata. Questa metrica si applica solo agli elementi del feed. |
allConversionsFromDirections |
Il numero di volte in cui gli utenti hanno fatto clic su "Indicazioni stradali" per accedere a un negozio dopo aver fatto clic su un annuncio. Questa metrica si applica solo agli elementi del feed. |
allConversionsFromInteractionsValuePerInteraction |
Il valore di tutte le conversioni da interazioni diviso per il numero totale di interazioni. |
allConversionsFromMenu |
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 del feed. |
allConversionsFromOrder |
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 del feed. |
allConversionsFromOtherEngagement |
Il numero di altre conversioni (ad es. 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 del feed. |
allConversionsFromStoreVisit |
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 del feed. |
visits |
Clic registrati correttamente da Search Ads 360 che sono stati inoltrati alla pagina di destinazione di un inserzionista. |
allConversionsFromStoreWebsite |
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 del feed. |
averageCost |
L'importo medio pagato per ogni interazione. Questo importo corrisponde al costo totale dei tuoi annunci diviso per il numero totale di interazioni. |
averageCpc |
Il costo totale di tutti i clic diviso per il numero totale di clic ricevuti. Questa metrica è un valore monetario e viene restituito 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 |
Costo per mille impressioni (CPM) medio Questa metrica è un valore monetario e viene restituito 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 |
Il numero di clic. |
contentBudgetLostImpressionShare |
La percentuale stimata di volte in cui il tuo annuncio era idoneo per essere pubblicato sulla Rete Display, ma non è stato pubblicato a causa del budget troppo basso. Nota: la quota impressioni perse nel budget dei contenuti è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
contentImpressionShare |
Indica il numero di impressioni ricevute sulla Rete Display diviso per il numero stimato di impressioni che avresti potuto ricevere. Nota: la quota impressioni sulla rete di contenuti è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999. |
contentRankLostImpressionShare |
La percentuale stimata di impressioni che gli annunci non hanno ricevuto sulla Rete Display a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse per il ranking dei contenuti è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
conversionsFromInteractionsRate |
Media delle conversioni disponibili (dall'interazione) per interazione idonea alla conversione. Mostra la frequenza media con cui un'interazione con un annuncio genera una conversione disponibile. |
clientAccountConversionsValue |
Il valore delle conversioni dell'account cliente. Sono incluse solo le azioni di conversione per cui l'attributo includeInClientAccountConversionsMetric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni. |
conversionsValuePerCost |
Il valore della conversione disponibile diviso per il costo totale delle interazioni idonee per la conversione. |
conversionsFromInteractionsValuePerInteraction |
Il valore delle conversioni da interazioni diviso per il numero di interazioni con l'annuncio. Sono incluse solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni. |
clientAccountConversions |
Il numero di conversioni dell'account cliente. Sono incluse solo le azioni di conversione per cui l'attributo includeInClientAccountConversionsMetric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni. |
costMicros |
La somma del costo per clic (CPC) e del costo per mille impressioni (CPM) durante questo periodo. Questa metrica è un valore monetario e viene restituito 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 |
Il costo delle interazioni con l'annuncio diviso per tutte le conversioni. |
costPerConversion |
Costo medio idoneo alla conversione per conversione disponibile. |
costPerCurrentModelAttributedConversion |
Il costo delle interazioni con l'annuncio diviso per il numero di conversioni attribuite al modello corrente. Sono incluse solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni. |
crossDeviceConversions |
Conversioni generate da quando un cliente fa clic su un annuncio su un dispositivo e poi effettua una conversione su un dispositivo o browser diverso. Le conversioni cross-device sono già incluse in allConversions. |
crossDeviceConversionsValue |
La somma del valore delle conversioni cross-device. |
ctr |
Il numero di clic ricevuti dall'annuncio (clic) diviso per il numero di volte in cui l'annuncio viene visualizzato (impressioni). |
conversions |
Il numero di conversioni. Sono incluse solo le azioni di conversione per cui l'attributo includeInConversionsMetric è impostato su true. Se utilizzi l'offerta basata sulle conversioni, le strategie di offerta verranno ottimizzate per ottenere queste conversioni. |
conversionsValue |
La somma dei valori delle conversioni incluse nelle "conversioni" . Questa metrica è utile solo se hai inserito un valore per le azioni di conversione. |
averageQualityScore |
Il punteggio di qualità medio. |
historicalQualityScore |
Il punteggio di qualità storico. |
impressions |
Conteggio della frequenza di pubblicazione dell'annuncio su una pagina dei risultati di ricerca o su un sito web della Rete Google. |
interactionRate |
Frequenza con cui gli utenti interagiscono con un annuncio dopo averlo visualizzato. Il numero di interazioni diviso per il numero di volte in cui l'annuncio viene pubblicato. |
interactions |
Il numero di interazioni. L'interazione è l'azione principale dell'utente associata a un formato dell'annuncio: clic per annunci di testo e Shopping, visualizzazioni per annunci video e così via. |
invalidClickRate |
La percentuale di clic filtrati ed esclusi dal numero totale di clic (clic filtrati + non filtrati) durante il periodo del report. |
invalidClicks |
Numero di clic che Google considera illegali e per i quali non addebita alcun costo. |
mobileFriendlyClicksPercentage |
La percentuale di clic da dispositivo mobile che indirizzano a una pagina ottimizzata per il mobile. |
searchAbsoluteTopImpressionShare |
La percentuale di impressioni degli annunci Shopping o della rete di ricerca del cliente mostrati 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 riportato come 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare |
Il numero che indica la frequenza con cui il tuo annuncio non è stato il primo annuncio tra gli annunci nella parte superiore della pagina nei risultati di ricerca a causa di un budget ridotto. Nota: la quota impressioni superiore assoluta persa del budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchBudgetLostImpressionShare |
La percentuale stimata di volte in cui il tuo annuncio era idoneo per essere pubblicato sulla rete di ricerca, ma non è stato pubblicato a causa del budget troppo basso. Nota: la quota impressioni perse del budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchBudgetLostTopImpressionShare |
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 del budget sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchClickShare |
Il numero di clic ricevuti sulla rete di ricerca diviso per il numero stimato di clic che avresti potuto ricevere. Nota: la quota clic ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999. |
searchExactMatchImpressionShare |
Il numero di impressioni ricevute diviso per il numero stimato di impressioni che avresti potuto ricevere sulla rete di ricerca per i termini di ricerca esattamente corrispondenti alle tue parole chiave (o varianti simili della parola chiave), indipendentemente dai tipi di corrispondenza delle parole chiave. Nota: la quota impressioni con corrispondenza esatta sulla rete di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999. |
searchImpressionShare |
Indica il numero di impressioni ricevute sulla rete di ricerca diviso per il numero stimato di impressioni che avresti potuto ricevere. Nota: la quota impressioni sulla rete di ricerca è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato come 0,0999. |
searchRankLostAbsoluteTopImpressionShare |
Il numero che indica 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 scadente. Nota: la quota impressioni superiore assoluta persa per il ranking sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchRankLostImpressionShare |
La percentuale stimata di impressioni che gli annunci non hanno ricevuto sulla rete di ricerca a causa di un ranking dell'annuncio scadente. Nota: la quota impressioni perse per il ranking sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchRankLostTopImpressionShare |
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 per il ranking sulla rete di ricerca è compresa tra 0 e 0,9. Qualsiasi valore superiore a 0,9 viene riportato come 0,9001. |
searchTopImpressionShare |
Le impressioni ricevute 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 è compresa tra 0,1 e 1. Qualsiasi valore inferiore a 0,1 viene riportato 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 |
La percentuale di impressioni degli annunci pubblicate in una posizione adiacente ai primi risultati di ricerca organica. |
valuePerAllConversions |
Il valore di tutte le conversioni diviso per il numero di tutte le conversioni. |
valuePerAllConversionsByConversionDate |
Il valore di tutte le conversioni diviso per il numero di tutte le conversioni. Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. I dettagli per le colonne by_conversion_date sono disponibili all'indirizzo https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
Il valore della conversione disponibile per le offerte diviso per il numero di conversioni su cui non è possibile fare offerte. Mostra il valore medio di ciascuna conversione disponibile. |
valuePerConversionsByConversionDate |
Valore delle conversioni disponibili per la data di conversione diviso per le conversioni disponibili per la data di conversione. Mostra il valore medio di ciascuna conversione disponibile (per data di conversione). Se questa colonna è selezionata con la data, i valori nella colonna della data indicano la data della conversione. |
clientAccountViewThroughConversions |
Il numero totale di conversioni view-through. Questi casi si verificano quando un cliente visualizza un annuncio illustrato o rich media e successivamente completa una conversione sul tuo sito senza interagire con un altro annuncio, ad esempio facendo clic su di esso. |
clientAccountCrossSellCostOfGoodsSoldMicros |
Il costo del venduto da cross-sell dell'account cliente (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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'acquisto è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
Le entrate da cross-sell dell'account cliente sono l'importo totale ricavato 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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 restituito 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 |
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 viene considerato pubblicizzato. Qualsiasi prodotto incluso nell'ordine effettuato dal cliente è un prodotto venduto. Se questi prodotti non corrispondono, questo è considerato un 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 |
Il costo del venduto da lead per account cliente (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 restituito 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 |
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 restituito 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 |
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 viene 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 restituito 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 |
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 viene 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 restituito 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 |
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 viene 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 restituito 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 |
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 viene 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 restituito 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 |
Le unità lead vendute per l'account cliente indicano 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 viene 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 |
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 viene 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. |
Valore
Un contenitore di dati generico.
Rappresentazione JSON |
---|
{ // Union field |
Campi | |
---|---|
Campo unione value . Un valore. value può essere solo uno dei seguenti: |
|
booleanValue |
Un valore booleano. |
int64Value |
Un int64. |
floatValue |
Un galleggiante. |
doubleValue |
Un doppio. |
stringValue |
Una stringa. |
QualityScoreBucket
Elenco enum dei possibili bucket per il punteggio di qualità.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un 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
Enum che descrive i possibili tipi di interazioni pagabili e senza costi.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
CLICK |
Fai clic per andare al sito. Nella maggior parte dei casi, questa interazione porta a una località esterna, in genere la pagina di destinazione dell'inserzionista. Questo è anche il valore InteractionEventType predefinito per gli eventi di clic. |
ENGAGEMENT |
L'intenzione espressa dell'utente di interagire con l'annuncio in loco. |
VIDEO_VIEW |
L'utente ha visualizzato un annuncio video. |
NONE |
Il valore 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 riportati come parte delle metriche principali. Si tratta semplicemente di altre conversioni (annunci). |
Segmenti
Campi Solo segmenti.
Rappresentazione JSON |
---|
{ "adNetworkType": enum ( |
Campi | |
---|---|
adNetworkType |
Tipo di rete pubblicitaria. |
conversionActionCategory |
Categoria dell'azione di conversione. |
conversionCustomDimensions[] |
Le dimensioni personalizzate della conversione. |
dayOfWeek |
Giorno della settimana, ad esempio LONDAY. |
device |
Dispositivo a cui vengono applicate le metriche. |
keyword |
Criterio parola chiave. |
productChannel |
Canale del prodotto. |
productChannelExclusivity |
Esclusività del canale del prodotto. |
productCondition |
Condizione del prodotto. |
productSoldCondition |
Condizione del prodotto venduto. |
rawEventConversionDimensions[] |
Le dimensioni di conversione degli eventi non elaborati. |
conversionAction |
Nome della risorsa dell'azione di conversione. |
conversionActionName |
Nome azione di conversione. |
date |
Data a cui vengono applicate le metriche. formato aaaa-MM-gg, ad esempio 2018-04-17. |
geoTargetCity |
Nome della risorsa della costante del target geografico che rappresenta una città. |
geoTargetCountry |
Nome della risorsa della costante del target geografico che rappresenta un paese. |
geoTargetMetro |
Nome della risorsa della costante del target geografico che rappresenta un'area metropolitana. |
geoTargetRegion |
Nome della risorsa della costante del target geografico che rappresenta una regione. |
hour |
Ora del giorno espressa con un numero compreso tra 0 e 23 inclusi. |
month |
Mese come rappresentato dalla data del primo giorno di un mese. Formattato come aaaa-MM-gg. |
productBiddingCategoryLevel1 |
Categoria di offerta (livello 1) del prodotto. |
productBiddingCategoryLevel2 |
Categoria di offerta (livello 2) del prodotto. |
productBiddingCategoryLevel3 |
Categoria di offerta (livello 3) del prodotto. |
productBiddingCategoryLevel4 |
Categoria di offerta (livello 4) del prodotto. |
productBiddingCategoryLevel5 |
Categoria di offerta (livello 5) del prodotto. |
productBrand |
Brand del prodotto. |
productCountry |
Nome della risorsa della costante del target geografico per il paese di vendita del prodotto. |
productCustomAttribute0 |
Attributo personalizzato 0 del prodotto. |
productCustomAttribute1 |
Attributo personalizzato 1 del prodotto. |
productCustomAttribute2 |
Attributo personalizzato 2 del prodotto. |
productCustomAttribute3 |
Attributo personalizzato 3 del prodotto. |
productCustomAttribute4 |
Attributo personalizzato 4 del prodotto. |
productItemId |
ID articolo del prodotto. |
productLanguage |
Nome della risorsa della costante linguistica per la lingua del prodotto. |
productSoldBiddingCategoryLevel1 |
Categoria di offerta (livello 1) del prodotto venduto. |
productSoldBiddingCategoryLevel2 |
Categoria di offerta (livello 2) del prodotto venduto. |
productSoldBiddingCategoryLevel3 |
Categoria di offerta (livello 3) del prodotto venduto. |
productSoldBiddingCategoryLevel4 |
Categoria di offerta (livello 4) del prodotto venduto. |
productSoldBiddingCategoryLevel5 |
Categoria di offerta (livello 5) del prodotto venduto. |
productSoldBrand |
Brand del prodotto venduto. |
productSoldCustomAttribute0 |
Attributo personalizzato 0 del prodotto venduto. |
productSoldCustomAttribute1 |
Attributo personalizzato 1 del prodotto venduto. |
productSoldCustomAttribute2 |
Attributo personalizzato 2 del prodotto venduto. |
productSoldCustomAttribute3 |
Attributo personalizzato 3 del prodotto venduto. |
productSoldCustomAttribute4 |
Attributo personalizzato 4 del prodotto venduto. |
productSoldItemId |
ID articolo del prodotto venduto. |
productSoldTitle |
Il titolo del prodotto venduto. |
productSoldTypeL1 |
Tipo (livello 1) del prodotto venduto. |
productSoldTypeL2 |
Tipo (livello 2) di prodotto venduto. |
productSoldTypeL3 |
Tipo (livello 3) di prodotto venduto. |
productSoldTypeL4 |
Tipo (livello 4) di prodotto venduto. |
productSoldTypeL5 |
Tipo (livello 5) di prodotto venduto. |
productStoreId |
ID negozio del prodotto. |
productTitle |
Titolo del prodotto. |
productTypeL1 |
Tipo (livello 1) del prodotto. |
productTypeL2 |
Tipo (livello 2) del prodotto. |
productTypeL3 |
Tipo (livello 3) del prodotto. |
productTypeL4 |
Tipo (livello 4) del prodotto. |
productTypeL5 |
Tipo (livello 5) del prodotto. |
quarter |
Trimestre come rappresentato dalla data del primo giorno di un trimestre. Utilizza l'anno solare per i trimestri; ad esempio, il secondo trimestre del 2018 inizia l'1/04/2018. Formattato come aaaa-MM-gg. |
week |
Settimana come definita da lunedì a domenica ed è rappresentata dalla data di lunedì. Formattato come aaaa-MM-gg. |
year |
Anno, con formato aaaa. |
assetInteractionTarget |
Utilizzato solo con le metriche AssetClient, Asset Campagna e Asset gruppo di annunci. Indica se le metriche di interazione si sono verificate sull'asset stesso oppure su un altro asset o un'unità pubblicitaria diverso. 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 contemporaneamente. Quando l'interazione OnThisAsset è true, significa che le interazioni avvengono su questo asset specifico, mentre quando l'interazione è false significa che le interazioni non avvengono su questo asset specifico, ma su altre parti dell'annuncio pubblicato con cui viene pubblicato questo asset. |
AdNetworkType
Enumera 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_SEARCH |
Ricerca di YouTube. |
YOUTUBE_WATCH |
Video di YouTube |
MIXED |
Su più reti. |
Parola chiave
Un segmento Criterio parola chiave.
Rappresentazione JSON |
---|
{
"info": {
object ( |
Campi | |
---|---|
info |
Informazioni sulla parola chiave. |
adGroupCriterion |
Il nome della risorsa Criteri di gruppo di annunci. |
ProductChannelExclusivity
Enum che descrive la disponibilità di un'offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
SINGLE_CHANNEL |
L'articolo viene venduto attraverso un solo canale, negozi locali oppure online, come indicato dal suo ProductChannel. |
MULTI_CHANNEL |
L'articolo viene abbinato ai suoi negozi online o locali, il che indica che è disponibile per l'acquisto in entrambi i canali ShoppingProduct. |
ProductCondition
Enum che descrive la condizione di un'offerta di prodotto.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione. |
OLD |
La condizione del prodotto è datata. |
NEW |
La condizione del prodotto è nuovo. |
REFURBISHED |
La condizione del prodotto è ricondizionato. |
USED |
La condizione del prodotto è "usato". |
AssetInteractionTarget
Un segmento AssetInteractionTarget.
Rappresentazione JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Campi | |
---|---|
asset |
Il nome della risorsa dell'asset. |
interactionOnThisAsset |
Utilizzato solo con le metriche AssetClient, Asset Campagna e Asset gruppo di annunci. Indica se le metriche di interazione si sono verificate sull'asset stesso oppure su un altro asset o un'unità pubblicitaria diverso. |