Package google.ads.searchads360.v0.resources

Indice

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.

Campi
resource_name

string

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

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

L'ID della strategia di offerta.

name

string

Il nome della strategia di offerta.

type

BiddingStrategyType

Il tipo di strategia di offerta.

owner_customer_id

int64

L'ID del cliente proprietario della strategia di offerta.

owner_descriptive_name

string

descrittivo_name del cliente proprietario della strategia di offerta.

Campo unione scheme. Lo schema di offerta.

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

maximize_conversion_value

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.

maximize_conversions

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.

target_cpa

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.

target_impression_share

TargetImpressionShare

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

target_roas

TargetRoas

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

target_spend

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.

Campi
target_roas

double

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.

Campi
target_cpa

int64

L'opzione costo per acquisizione (CPA) target. L'importo medio che intendi spendere per ogni acquisizione.

target_cpa_micros

int64

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.

Campi
target_cpa_micros

int64

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

TargetImpressionShare

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

Campi
location

TargetImpressionShareLocation

La località target nella pagina dei risultati di ricerca.

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

L'offerta CPC più alta che il sistema delle offerte automatiche è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che imposta il tetto massimo e viene specificato in micro locali.

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.

Campi
target_roas

double

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.

Campi
target_spend_micros
(deprecated)

int64

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.

cpc_bid_ceiling_micros

int64

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

Un annuncio.

Campi
resource_name

string

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

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

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

type

AdType

Il tipo di annuncio.

id

int64

L'ID dell'annuncio.

display_url

string

L'URL che appare nella descrizione dell'annuncio per alcuni formati.

name

string

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:
text_ad

SearchAds360TextAdInfo

Dettagli relativi a un annuncio di testo.

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Dettagli relativi a un annuncio di testo espanso.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Dettagli relativi a un annuncio adattabile della rete di ricerca.

product_ad

SearchAds360ProductAdInfo

Dettagli relativi a un annuncio di prodotto.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Dettagli relativi a un annuncio dinamico della rete di ricerca espanso.

Gruppo di annunci

Un gruppo di annunci.

Campi
resource_name

string

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

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

Lo stato del gruppo di annunci.

type

AdGroupType

Il tipo di gruppo di annunci.

ad_rotation_mode

AdGroupAdRotationMode

La modalità di rotazione annunci del gruppo di annunci.

creation_time

string

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.

targeting_setting

TargetingSetting

Impostazione per il targeting di funzionalità correlate.

labels[]

string

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

engine_id

string

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 "ad_group.id" .

start_date

string

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

end_date

string

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

language_code

string

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

last_modified_time

string

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

int64

L'ID del gruppo di annunci.

name

string

Il nome del gruppo di annunci.

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

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

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

cpc_bid_micros

int64

L'offerta CPC (costo per clic) massimo.

engine_status

AdGroupEngineStatus

Stato motore per gruppo di annunci.

AdGroupAd

Un annuncio del gruppo di annunci.

Campi
resource_name

string

Il nome della risorsa dell'annuncio. I nomi delle risorse di annunci dei gruppi di annunci hanno il seguente formato:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

Lo stato dell'annuncio.

ad

Ad

L'annuncio.

creation_time

string

Il timestamp di creazione di questo ad_group_ad. La data è indicata nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss" formato.

labels[]

string

I nomi delle risorse delle etichette associate all'annuncio di questo gruppo di annunci.

engine_id

string

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 un'entità non Search Ads 360, utilizza "ad_group_ad.ad.id" .

engine_status

AdGroupAdEngineStatus

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

last_modified_time

string

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.

AdGroupAdLabel

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

Campi
resource_name

string

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: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

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

label

string

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

AdGroupAsset

Un collegamento tra un gruppo di annunci e un asset.

Campi
resource_name

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

string

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

asset

string

Obbligatorio. L'asset collegato al gruppo di annunci.

status

AssetLinkStatus

Stato dell'asset del gruppo di annunci.

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.

Campi
resource_name

string

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:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

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

asset_set

string

L'insieme di asset collegato al gruppo di annunci.

status

AssetSetLinkStatus

Lo stato dell'insieme di asset del gruppo di annunci. Sola lettura.

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.

Campi
resource_name

string

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:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

Rappresenta un modificatore di offerta per gruppo di annunci.

Campi
resource_name

string

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:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

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 criterion. Il criterio di questo modificatore di offerta per gruppo di annunci.

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

device

DeviceInfo

Un criterio dispositivo.

AdGroupCriterion

Un criterio del gruppo di annunci. Il report criteri_gruppo_annunci restituisce solo i criteri che sono stati aggiunti esplicitamente al gruppo di annunci.

Campi
resource_name

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

string

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

AdGroupCriterionStatus

Lo stato del criterio.

Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere 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.

quality_info

QualityInfo

Informazioni sulla qualità del criterio.

type

CriterionType

Il tipo di criterio.

labels[]

string

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

position_estimates

PositionEstimates

Stime per le offerte per criterio in varie posizioni.

final_urls[]

string

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

engine_id

string

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 "ad_group_criterion.criterion_id" .

last_modified_time

string

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.

criterion_id

int64

L'ID del criterio.

ad_group

string

Il gruppo di annunci a cui appartiene il criterio.

negative

bool

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

Questo campo è immutabile. Per cambiare un criterio da positivo a negativo, rimuovilo e poi riaggiungilo.

bid_modifier

double

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.

cpc_bid_micros

int64

L'offerta CPC (costo per clic).

effective_cpc_bid_micros

int64

L'offerta CPC (costo per clic) effettivo.

engine_status

AdGroupCriterionEngineStatus

Lo stato motore per il criterio gruppo di annunci.

final_url_suffix

string

Modello di URL per l'aggiunta di parametri all'URL finale.

tracking_url_template

string

Il modello di URL per la creazione di un URL di monitoraggio.

Campo unione criterion. Il criterio del gruppo di annunci.

Deve essere impostato in modo esatto. criterion può essere solo uno dei seguenti:

keyword

KeywordInfo

Parola chiave.

listing_group

ListingGroupInfo

Gruppo di schede.

age_range

AgeRangeInfo

Fascia d'età.

gender

GenderInfo

Genere.

user_list

UserListInfo

Elenco utenti.

webpage

WebpageInfo

Pagina web

location

LocationInfo

Posizione.

PositionEstimates

Stime per le offerte per criterio in varie posizioni.

Campi
top_of_page_cpc_micros

int64

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

QualityInfo

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

Campi
quality_score

int32

Il punteggio di qualità.

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

AdGroupCriterionLabel

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

Campi
resource_name

string

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: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

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

label

string

L'etichetta assegnata al criterio del gruppo di annunci.

AdGroupLabel

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

Campi
resource_name

string

Il nome della risorsa dell'etichetta del gruppo di annunci. I nomi delle risorse dell'etichetta del gruppo di annunci sono nel formato: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

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

label

string

L'etichetta assegnata al gruppo di annunci.

AgeRangeView

Una visualizzazione per fascia d'età.

Campi
resource_name

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

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.

Campi
resource_name

string

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

customers/{customer_id}/assets/{asset_id}

type

AssetType

Tipo di risorsa.

final_urls[]

string

Un elenco di possibili URL finali dopo tutti i reindirizzamenti interdominio.

status

AssetStatus

Lo stato dell'asset.

creation_time

string

Timestamp della creazione dell'asset. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato.

last_modified_time

string

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

int64

ID della risorsa.

name

string

Nome facoltativo dell'asset.

tracking_url_template

string

Modello di URL per creare un URL di monitoraggio.

engine_status

AssetEngineStatus

Lo stato motore di un asset.

Campo unione asset_data. Il tipo specifico di risorsa. asset_data può essere solo uno dei seguenti:
youtube_video_asset

YoutubeVideoAsset

Una risorsa video di YouTube.

image_asset

ImageAsset

Un asset immagine.

text_asset

TextAsset

Un asset di testo.

callout_asset

UnifiedCalloutAsset

Un asset callout unificato.

page_feed_asset

UnifiedPageFeedAsset

Un asset del feed di pagine unificato.

mobile_app_asset

MobileAppAsset

Un asset per app mobile.

call_asset

UnifiedCallAsset

Un asset di chiamata unificato.

call_to_action_asset

CallToActionAsset

Un asset di invito all'azione.

location_asset

UnifiedLocationAsset

Un asset posizione unificato.

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.

Campi
resource_name

string

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

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

L'ID del gruppo di asset.

campaign

string

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

name

string

Obbligatorio. 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.

final_urls[]

string

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.

final_mobile_urls[]

string

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

AssetGroupStatus

Lo stato del gruppo di asset.

path1

string

Prima parte del testo che potrebbe apparire aggiunta all'URL visualizzato nell'annuncio.

path2

string

Seconda parte del testo che potrebbe essere aggiunta all'URL visualizzato nell'annuncio. Questo campo può essere impostato solo se è impostato il percorso 1.

ad_strength

AdStrength

Efficacia complessiva dell'annuncio di questo gruppo di asset.

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.

Campi
resource_name

string

Il nome della risorsa dell'asset del gruppo di asset. Il nome della risorsa di asset del gruppo di asset è nel formato:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

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

asset

string

L'asset collegato da questo asset del gruppo di asset.

field_type

AssetFieldType

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

status

AssetLinkStatus

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

AssetGroupAssetCombinationData

Dati sulla combinazione di asset del gruppo di asset

Campi
asset_combination_served_assets[]

AssetUsage

Asset pubblicati.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter rappresenta un nodo ad albero del filtro dei gruppi di schede in un gruppo di asset.

Campi
resource_name

string

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:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_group

string

Il gruppo di asset di cui fa parte questo filtro di gruppo di schede.

id

int64

L'ID di ListingsGroupFilter.

type

ListingGroupFilterType

Tipo di un nodo del filtro del gruppo di schede.

vertical

ListingGroupFilterVertical

La verticale rappresentata dalla struttura ad albero dei nodi corrente. Tutti i nodi dello stesso albero devono appartenere alla stessa verticale.

case_value

ListingGroupFilterDimension

Valore della dimensione con cui questo gruppo di schede perfeziona il relativo elemento principale. Non definito per il gruppo principale.

parent_listing_group_filter

string

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

path

ListingGroupFilterDimensionPath

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

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.

Campi
resource_name

string

Il nome della risorsa dell'indicatore del gruppo di asset. Il nome della risorsa di indicatore del gruppo di asset è nel seguente formato:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_group

string

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

AudienceInfo

L'indicatore sul pubblico che deve essere utilizzato dalla campagna Performance Max.

AssetGroupTopCombinationView

Una panoramica sull'utilizzo della combinazione di asset annuncio del gruppo di annunci.

Campi
resource_name

string

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/{customer_id}/assetGroupTopCombineViews/{asset_group_id}~{asset_combination_category}"

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Le migliori combinazioni di asset pubblicati insieme.

AssetSet

Un insieme di asset che rappresenta una raccolta di asset. Utilizza AssetSetAsset per collegare un asset al set di asset.

Campi
id

int64

L'ID del set di asset.

resource_name

string

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

customers/{customer_id}/assetSets/{asset_set_id}

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.

Campi
resource_name

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

string

L'insieme di asset a cui si collega l'asset.

asset

string

La risorsa a cui si collega l'asset dell'insieme.

status

AssetSetAssetStatus

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

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.

Campi
resource_name

string

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

customers/{customer_id}/audiences/{audience_id}

id

int64

ID del segmento di pubblico.

name

string

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

string

Descrizione di questo segmento di pubblico.

BiddingStrategy

Una strategia di offerta.

Campi
resource_name

string

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

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

Lo stato della strategia di offerta.

Questo campo è di sola lettura.

type

BiddingStrategyType

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

Questo campo è di sola lettura.

currency_code

string

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 campoeffective_currency_code restituisce la valuta utilizzata dalla strategia.

id

int64

L'ID della strategia di offerta.

name

string

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

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

effective_currency_code

string

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 currency_code del cliente.

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

Questo campo è di sola lettura.

campaign_count

int64

Il numero di campagne associate a questa strategia di offerta.

Questo campo è di sola lettura.

non_removed_campaign_count

int64

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

Questo campo è di sola lettura.

Campo unione scheme. Lo schema di offerta.

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

enhanced_cpc

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.

maximize_conversion_value

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.

maximize_conversions

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.

target_cpa

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.

target_impression_share

TargetImpressionShare

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

target_outrank_share

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.

target_roas

TargetRoas

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

target_spend

TargetSpend

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

Campagna

Una campagna.

Campi
resource_name

string

Il nome della risorsa della campagna. I nomi delle risorse della campagna sono nel formato:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

Lo stato della campagna.

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

serving_status

CampaignServingStatus

Lo stato di pubblicazione dell'annuncio della campagna.

bidding_strategy_system_status

BiddingStrategySystemStatus

Lo stato del sistema della strategia di offerta della campagna.

ad_serving_optimization_status

AdServingOptimizationStatus

Lo stato di ottimizzazione della pubblicazione di annunci della campagna.

advertising_channel_type

AdvertisingChannelType

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

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.

advertising_channel_sub_type

AdvertisingChannelSubType

Perfezionamento facoltativo a advertising_channel_type. Deve essere un sottotipo valido del tipo di canale principale.

Può essere impostato solo durante la creazione di campagne. Dopo aver creato la campagna, il campo non può essere modificato.

url_custom_parameters[]

CustomParameter

L'elenco di mappature utilizzate per sostituire i tag di parametri personalizzati in tracking_url_template, final_urls o mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Le impostazioni della rete per la campagna.

dynamic_search_ads_setting

DynamicSearchAdsSetting

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

shopping_setting

ShoppingSetting

L'impostazione per il controllo delle campagne Shopping.

geo_target_type_setting

GeoTargetTypeSetting

L'impostazione per il targeting geografico degli annunci.

labels[]

string

I nomi delle risorse delle etichette associate a questa campagna.

bidding_strategy_type

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 bidding_strategy per creare una strategia di offerta di portafoglio.

Questo campo è di sola lettura.

accessible_bidding_strategy

string

Nome della risorsa di AccessibleBiddingStrategy, una visualizzazione di sola lettura degli attributi senza restrizioni della strategia di offerta di portafoglio associata identificata da "Bidding_strategy". 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.

frequency_caps[]

FrequencyCapEntry

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

selective_optimization

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.

optimization_goal_setting

OptimizationGoalSetting

Impostazione degli obiettivi di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.

tracking_setting

TrackingSetting

Impostazioni a livello di campagna per le informazioni sul monitoraggio.

engine_id

string

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" .

excluded_parent_asset_field_types[]

AssetFieldType

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.

create_time

string

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 valore create_time verrà deprecato nella versione 1. Usa il valore di Creation_time al suo posto.

creation_time

string

Il timestamp di creazione della campagna. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato.

last_modified_time

string

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

int64

L'ID della campagna.

name

string

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

tracking_url_template

string

Il modello di URL per la creazione di un URL di monitoraggio.

campaign_budget

string

Il budget della campagna.

start_date

string

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

end_date

string

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.

final_url_suffix

string

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

url_expansion_opt_out

bool

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 campaign_bidding_strategy. La strategia di offerta per la campagna.

Deve essere un portafoglio (creato tramite il servizio BiddingStrategy) o standard incorporato nella campagna. campaign_bidding_strategy può essere solo uno dei seguenti:

bidding_strategy

string

Strategia di offerta di portafoglio utilizzata dalla campagna.

manual_cpa

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.

manual_cpc

ManualCpc

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

manual_cpm

ManualCpm

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

maximize_conversions

MaximizeConversions

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

maximize_conversion_value

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.

target_cpa

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.

target_impression_share

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.

target_roas

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.

target_spend

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.

percent_cpc

PercentCpc

Strategia di offerta CPC percentuale standard in cui le offerte rappresentano una frazione del prezzo pubblicizzato per un prodotto o un servizio.

target_cpm

TargetCpm

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

DynamicSearchAdsSetting

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

Campi
domain_name

string

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

language_code

string

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

use_supplied_urls_only

bool

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

GeoTargetTypeSetting

Rappresenta una raccolta di impostazioni relative al targeting geografico degli annunci.

Campi
positive_geo_target_type

PositiveGeoTargetType

L'impostazione utilizzata per il targeting geografico positivo in questa particolare campagna.

negative_geo_target_type

NegativeGeoTargetType

L'impostazione utilizzata per il targeting geografico escluso in questa determinata campagna.

NetworkSettings

Le impostazioni della rete per la campagna.

Campi
target_search_network

bool

Indica se gli annunci verranno pubblicati sui siti partner della rete di ricerca di Google (richiede che anche target_google_search sia true).

target_content_network

bool

Se gli annunci saranno pubblicati in posizionamenti specificati nella Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.

target_partner_search_network

bool

Se gli annunci saranno pubblicati sulla rete dei partner di Google. Questa opzione è disponibile solo per alcuni Account partner di Google.

OptimizationGoalSetting

Impostazione degli obiettivi di ottimizzazione per questa campagna, che include un insieme di tipi di obiettivi di ottimizzazione.

Campi
optimization_goal_types[]

OptimizationGoalType

L'elenco dei tipi di obiettivi di ottimizzazione.

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.

Campi
conversion_actions[]

string

L'insieme selezionato di azioni di conversione per ottimizzare questa campagna.

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.

Campi
feed_label

string

Etichetta del feed dei prodotti da includere nella campagna. Puoi impostare solo un valore tra feed_label e sale_country. Se utilizzato al posto di Sales_country, il campo feed_label 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.

use_vehicle_inventory

bool

Indica se scegliere come target l'inventario delle schede di veicoli.

merchant_id

int64

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

sales_country

string

Paese di vendita dei prodotti da includere nella campagna.

campaign_priority

int32

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.

enable_local

bool

Indica se includere prodotti locali.

TrackingSetting

Impostazioni a livello di campagna per le informazioni sul monitoraggio.

Campi
tracking_url

string

L'URL utilizzato per il monitoraggio dinamico.

CampaignAsset

Un collegamento tra una campagna e una risorsa.

Campi
resource_name

string

Il nome della risorsa dell'asset della campagna. I nomi delle risorse CampaignAsset sono nel formato:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

Stato dell'asset della campagna.

campaign

string

La campagna a cui è collegato l'asset.

asset

string

L'asset collegato alla campagna.

CampaignAssetSet

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

Campi
resource_name

string

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

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

La campagna a cui è collegato questo set di asset.

asset_set

string

Il set di asset collegato alla campagna.

status

AssetSetLinkStatus

Lo stato dell'asset del 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.

Campi
resource_name

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Il budget di una campagna.

Campi
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

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

BudgetPeriod

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

amount_micros

int64

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.

CampaignCriterion

Un criterio della campagna.

Campi
resource_name

string

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

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

Il nome visualizzato del criterio.

Questo campo viene ignorato per le modifiche.

type

CriterionType

Il tipo di criterio.

status

CampaignCriterionStatus

Lo stato del criterio.

last_modified_time

string

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.

criterion_id

int64

L'ID del criterio.

Questo campo viene ignorato durante la modifica.

bid_modifier

float

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

bool

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

Campo unione criterion. Il criterio della campagna.

Deve essere impostato in modo esatto. criterion può essere solo uno dei seguenti:

keyword

KeywordInfo

Parola chiave.

location

LocationInfo

Posizione.

device

DeviceInfo

Dispositivo.

age_range

AgeRangeInfo

Fascia d'età.

gender

GenderInfo

Genere.

user_list

UserListInfo

Elenco utenti.

language

LanguageInfo

Lingua.

webpage

WebpageInfo

Pagina web.

location_group

LocationGroupInfo

Gruppo di località

CampaignLabel

Rappresenta una relazione tra una campagna e un'etichetta.

Campi
resource_name

string

Nome della risorsa. I nomi delle risorse dell'etichetta campagna hanno il formato: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

La campagna a cui è associata l'etichetta.

label

string

L'etichetta assegnata alla campagna.

CartDataSalesView

Visualizzazione vendite dati del carrello.

Campi
resource_name

string

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

Conversione

Una conversione.

Campi
resource_name

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

L'ID della conversione

criterion_id

int64

ID criterio Search Ads 360. Un valore pari a 0 indica che il criterio non è attribuito.

merchant_id

int64

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.

ad_id

int64

ID annuncio. Il valore 0 indica che l'annuncio non è attribuito.

click_id

string

Una stringa univoca per la visita a cui è attribuita la conversione, che viene passata alla pagina di destinazione come parametro URL clickid.

visit_id

int64

L'ID visita di Search Ads 360 a cui è attribuita la conversione.

advertiser_conversion_id

string

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 corrisponde alla colonna id o alla colonna Floodlight_order_id a seconda delle istruzioni di Floodlight dell'inserzionista.

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.

product_country_code

string

Il paese (formato ISO-3166) registrato per il feed di inventario contenente il prodotto su cui è stato fatto clic.

attribution_type

AttributionType

A cosa viene attribuita la conversione: visita o Parola chiave+annuncio.

conversion_date_time

string

Il timestamp dell'evento di conversione.

conversion_last_modified_date_time

string

Il timestamp dell'ultima modifica della conversione.

conversion_visit_date_time

string

Il timestamp della visita a cui è attribuita la conversione.

conversion_quantity

int64

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.

conversion_revenue_micros

int64

Le entrate rettificate in micro per l'evento di conversione. Sarà sempre nella valuta dell'account di pubblicazione.

floodlight_original_revenue

int64

Le entrate originali e invariate associate all'evento Floodlight (nella valuta del report corrente), prima delle modifiche dell'istruzione della valuta Floodlight.

floodlight_order_id

string

L'ID ordine Floodlight fornito dall'inserzionista per la conversione.

status

ConversionStatus

Lo stato della conversione (ATTIVATA o RIMOSSO).

asset_id

int64

ID dell'asset con cui è stata eseguita l'interazione durante l'evento di conversione.

asset_field_type

AssetFieldType

Tipo di campo dell'asset dell'evento di conversione.

ConversionAction

Un'azione di conversione.

Campi
resource_name

string

Il nome della risorsa dell'azione di conversione. I nomi delle risorse di azione di conversione hanno il formato:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

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

status

ConversionActionStatus

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

type

ConversionActionType

Il tipo di questa azione di conversione.

category

ConversionActionCategory

La categoria di conversioni registrate per questa azione di conversione.

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

Impostazioni Floodlight per i tipi di conversione Floodlight.

id

int64

L'ID dell'azione di conversione.

name

string

Il nome dell'azione di conversione.

Questo campo è obbligatorio e non deve essere vuoto quando crei nuove azioni di conversione.

primary_for_goal

bool

Se il bit primario_for_goal di un'azione di conversione è falso, 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 primario_per_obiettivo; pertanto, se una campagna ha un obiettivo di conversione personalizzato configurato con un'azione di conversione primaria_for_goal = falsa, questa azione di conversione è comunque disponibile. Per impostazione predefinita, il valore true_for_goal è true se non viene impostato. Nella versione V9, Primary_for_goal può essere impostato su false solo dopo la creazione tramite un "update" perché non è dichiarata come facoltativa.

owner_customer

string

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

include_in_client_account_conversions_metric

bool

Indica se questa azione di conversione deve essere inclusa nella colonna "client_account_conversions" o una metrica di valutazione.

include_in_conversions_metric

bool

Indica se questa azione di conversione deve essere inclusa nelle "conversioni" o una metrica di valutazione.

click_through_lookback_window_days

int64

Il numero massimo di giorni che possono trascorrere tra un'interazione (ad esempio un clic) e un evento di conversione.

app_id

string

ID app per un'azione di conversione da app.

AttributionModelSettings

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

Campi
attribution_model

AttributionModel

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

data_driven_model_status

DataDrivenModelStatus

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

FloodlightSettings

Impostazioni relative a un'azione di conversione Floodlight.

Campi
activity_group_tag

string

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

activity_tag

string

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

activity_id

int64

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

ValueSettings

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

Campi
default_value

double

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.

default_currency_code

string

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

always_use_default_value

bool

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.

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

Campi
resource_name

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

L'ID della variabile personalizzata di conversione.

name

string

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

tag

string

Obbligatorio. Il tag della variabile personalizzata di conversione. Il tag deve essere univoco ed essere composto da una "u" carattere immediatamente seguito da un numero minore di ormequal a 100. Ad esempio: "u4".

status

ConversionCustomVariableStatus

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

owner_customer

string

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

family

ConversionCustomVariableFamily

Famiglia della variabile personalizzata di conversione.

cardinality

ConversionCustomVariableCardinality

Cardinalità della variabile personalizzata di conversione.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

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

custom_column_ids[]

int64

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

FloodlightConversionCustomVariableInfo

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

Campi
floodlight_variable_type

FloodlightVariableType

Tipo di variabile Floodlight definito in Search Ads 360.

floodlight_variable_data_type

FloodlightVariableDataType

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

ConversionTrackingSetting

Una raccolta di impostazioni a livello di cliente relative al monitoraggio delle conversioni di Search Ads 360.

Campi
accepted_customer_data_terms

bool

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.

conversion_tracking_status

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 login-customer-id della richiesta.

enhanced_conversions_for_leads_enabled

bool

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.

google_ads_conversion_customer

string

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

conversion_tracking_id

int64

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

google_ads_cross_account_conversion_tracking_id

int64

L'ID di monitoraggio delle conversioni del gestore del cliente. Questo parametro viene impostato quando il cliente attiva il monitoraggio delle conversioni e sostituisce il valore di conversione_tracking_id. Questo campo può essere gestito solo tramite l'interfaccia utente di Google Ads. Questo campo è di sola lettura.

cross_account_conversion_tracking_id

int64

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 conversione_tracking_id.

CustomColumn

Una colonna personalizzata. Vedi la colonna personalizzata di Search Ads 360 all'indirizzo https://support.google.com/sa360/answer/9633916

Campi
resource_name

string

Il nome della risorsa della colonna personalizzata. I nomi delle risorse delle colonne personalizzate hanno il formato:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

ID della colonna personalizzata.

name

string

Nome definito dall'utente della colonna personalizzata.

description

string

Descrizione definita dall'utente della colonna personalizzata.

value_type

CustomColumnValueType

Il tipo di valore del risultato della colonna personalizzata.

references_attributes

bool

True quando la colonna personalizzata fa riferimento a uno o più attributi.

references_metrics

bool

True quando la colonna personalizzata fa riferimento a una o più metriche.

queryable

bool

True quando la colonna personalizzata può essere utilizzata nella query di SearchAds360Service.Search e SearchAds360Service.SearchStream.

referenced_system_columns[]

string

L'elenco delle colonne di sistema di riferimento di questa colonna personalizzata. Ad esempio, una colonna personalizzata "somma di impressioni e clic" ha fatto riferimento a colonne di sistema di {"metrics.clicks", "metrics.impressions"}.

Cliente

Un cliente.

Campi
resource_name

string

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

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Impostazione del monitoraggio delle conversioni per un cliente.

account_type

AccountType

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

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

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

last_modified_time

string

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.

engine_id

string

ID dell'account nell'account motore esterno.

status

CustomerStatus

Lo stato del cliente.

creation_time

string

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

id

int64

L'ID del cliente.

descriptive_name

string

Nome descrittivo facoltativo e non univoco del cliente.

currency_code

string

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

time_zone

string

L'ID fuso orario locale del cliente.

tracking_url_template

string

Il modello di URL per la creazione di un URL di monitoraggio a partire dai parametri.

final_url_suffix

string

Il modello di URL per l'aggiunta di parametri all'URL finale.

auto_tagging_enabled

bool

Indica se il tagging automatico è attivato per il cliente.

manager

bool

Se il cliente è un gestore.

CustomerAsset

Un collegamento tra un cliente e un asset.

Campi
resource_name

string

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

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Obbligatorio. L'asset collegato al cliente.

status

AssetLinkStatus

Stato dell'asset del cliente.

CustomerAssetSet

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

Campi
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Il set di asset collegato al cliente.

customer

string

Il cliente a cui è collegato questo set di asset.

status

AssetSetLinkStatus

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

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.

Campi
resource_name

string

Il nome risorsa del client del cliente. I nomi delle risorse CustomerClient sono nel formato: customers/{customer_id}/customerClients/{client_customer_id}

applied_labels[]

string

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:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

Lo stato del cliente. Sola lettura.

client_customer

string

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

hidden

bool

Specifica se si tratta di un account nascosto.

Sola lettura.

level

int64

Distanza tra il cliente specificato e il cliente. Per il link alla pagina corrente, il valore del livello sarà 0. Sola lettura.

time_zone

string

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

test_account

bool

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

manager

bool

Indica se il cliente è un gestore. Sola lettura.

descriptive_name

string

Nome descrittivo del client. Sola lettura.

currency_code

string

Codice valuta (ad es. "USD", "EUR") del cliente. Sola lettura.

id

int64

L'ID del cliente. Sola lettura.

DoubleClickCampaignManagerSetting

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

Campi
advertiser_id

int64

ID dell'inserzionista Campaign Manager associato a questo cliente.

network_id

int64

ID della rete Campaign Manager associata a questo cliente.

time_zone

string

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

DynamicSearchAdsSearchTermView

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

Campi
resource_name

string

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:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

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

Questo campo è di sola lettura.

GenderView

Una visualizzazione genere. La risorsa gender_view 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 gender_view con le statistiche.

Campi
resource_name

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Una costante per il targeting geografico.

Campi
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

Stato costante del targeting geografico.

id

int64

L'ID della costante del target geografico.

name

string

Nome inglese costante del targeting geografico.

country_code

string

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

target_type

string

Tipo di costante target del targeting geografico.

canonical_name

string

Il nome completo in inglese, composto dal nome del destinatario e da quello dell'entità principale e del paese.

parent_geo_target

string

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

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Una visualizzazione per parole chiave.

Campi
resource_name

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Etichetta

Un'etichetta.

Campi
resource_name

string

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

status

LabelStatus

Stato dell'etichetta. Sola lettura.

text_label

TextLabel

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

id

int64

ID dell'etichetta. Sola lettura.

name

string

Il nome dell'etichetta.

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

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

LanguageConstant

Una lingua.

Campi
resource_name

string

Il nome della risorsa della costante linguistica. I nomi delle risorse delle costanti del linguaggio hanno il seguente formato:

languageConstants/{criterion_id}

id

int64

L'ID della costante linguistica.

code

string

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

name

string

Il nome completo della lingua in inglese, ad esempio "Inglese (USA)", "Spagnolo" e così via.

targetable

bool

Indica se la lingua può essere scelta come target.

ListingGroupFilterDimension

Dimensioni della scheda per il filtro del gruppo di schede del gruppo di asset.

Campi
Campo unione dimension. Una dimensione di uno dei tipi seguenti è sempre presente. dimension può essere solo uno dei seguenti:
product_bidding_category

ProductBiddingCategory

Categoria di offerta di un prodotto.

product_brand

ProductBrand

Il brand di un'offerta di prodotto.

product_channel

ProductChannel

Località dell'offerta di un prodotto.

product_condition

ProductCondition

Condizione di un'offerta di prodotto.

product_custom_attribute

ProductCustomAttribute

Attributo personalizzato dell'offerta di un prodotto.

product_item_id

ProductItemId

ID articolo di un'offerta di prodotto.

product_type

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

Campi
level

ListingGroupFilterBiddingCategoryLevel

Indica il livello della categoria nella tassonomia.

id

int64

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

ProductBrand

Brand del prodotto.

Campi
value

string

Valore della stringa della marca del prodotto.

ProductChannel

Località dell'offerta di un prodotto.

Campi
channel

ListingGroupFilterProductChannel

Valore della località.

ProductCondition

Condizione di un'offerta di prodotto.

Campi
condition

ListingGroupFilterProductCondition

Valore della condizione.

ProductCustomAttribute

Attributo personalizzato dell'offerta di un prodotto.

Campi
index

ListingGroupFilterCustomAttributeIndex

Indica l'indice dell'attributo personalizzato.

value

string

Valore stringa dell'attributo personalizzato del prodotto.

ProductItemId

ID articolo di un'offerta di prodotto.

Campi
value

string

Valore dell'ID.

ProductType

Il tipo di offerta di un prodotto.

Campi
level

ListingGroupFilterProductTypeLevel

Livello del tipo.

value

string

Valore del tipo.

ListingGroupFilterDimensionPath

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

Campi
dimensions[]

ListingGroupFilterDimension

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.

LocationView

Una visualizzazione della località riassume il rendimento delle campagne in base a un criterio relativo alla località.

Campi
resource_name

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Una categoria di offerte per i prodotti.

Campi
resource_name

string

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:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Livello della categoria di offerta del prodotto.

status

ProductBiddingCategoryStatus

Stato della categoria di offerta per il prodotto.

id

int64

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.

country_code

string

Codice del paese a due lettere maiuscole della categoria di offerta per il prodotto.

product_bidding_category_constant_parent

string

Nome della risorsa della categoria principale di offerte dei prodotti.

language_code

string

Codice lingua della categoria di offerte per i prodotti.

localized_name

string

Valore visualizzato della categoria di offerte per il prodotto localizzata in base a language_code.

ProductGroupView

Una visualizzazione del gruppo di prodotti.

Campi
resource_name

string

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

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Un campo o una risorsa (artefatto) utilizzato da SearchAds360Service.

Campi
resource_name

string

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

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

La categoria dell'artefatto.

selectable_with[]

string

I nomi di tutte le risorse, i segmenti e le metriche selezionabili con l'artefatto descritto.

attribute_resources[]

string

I nomi di tutte le risorse selezionabili con l'artefatto descritto. I campi di queste risorse non segmentano le metriche quando sono inclusi nelle query di ricerca.

Questo campo è impostato solo per gli artefatti la cui categoria è RESOURCE.

metrics[]

string

Questo campo elenca i nomi di tutte le metriche selezionabili con l'artefatto descritto quando viene utilizzato nella clausola FROM. È impostato solo per gli artefatti la cui categoria è RESOURCE.

segments[]

string

Questo campo elenca i nomi di tutti gli artefatti, che si tratti di un segmento o di un'altra risorsa, le metriche del segmento quando sono incluse nelle query di ricerca e quando l'artefatto descritto viene utilizzato nella clausola FROM. È impostato solo per gli artefatti la cui categoria è RESOURCE.

enum_values[]

string

Valori che l'artefatto può assumere se è un campo di tipo ENUM.

Questo campo è impostato solo per gli elementi della categoria SEGMENTO o ATTRIBUTE.

data_type

SearchAds360FieldDataType

Questo campo determina gli operatori che possono essere utilizzati con l'artefatto nelle clausole WHERE.

name

string

Il nome dell'artefatto.

selectable

bool

Indica se l'artefatto può essere utilizzato in una clausola SELECT nelle query di ricerca.

filterable

bool

Indica se l'artefatto può essere utilizzato in una clausola WHERE nelle query di ricerca.

sortable

bool

Indica se l'artefatto può essere utilizzato in una clausola ORDER BY nelle query di ricerca.

type_url

string

L'URL del protocollo che descrive il tipo di dati dell'artefatto.

is_repeated

bool

Indica se l'artefatto del campo è ripetuto.

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.

Campi
resource_name

string

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

UserList

Un elenco di utenti. Si tratta di un elenco di utenti che un cliente può scegliere come target.

Campi
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Tipo di questo elenco.

Questo campo è di sola lettura.

id

int64

ID dell'elenco di utenti.

name

string

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)

Visita

Una visita.

Campi
resource_name

string

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

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

L'ID della visita.

criterion_id

int64

ID parola chiave di Search Ads 360. Il valore 0 indica che la parola chiave non è attribuita.

merchant_id

int64

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.

ad_id

int64

ID annuncio. Il valore 0 indica che l'annuncio non è attribuito.

click_id

string

Una stringa univoca per ogni visita che viene passata alla pagina di destinazione come parametro URL click id.

visit_date_time

string

Il timestamp della visita. Il timestamp è espresso nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss" formato.

product_id

string

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

product_channel

ProductChannel

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

product_language_code

string

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

product_store_id

string

Il negozio nell'annuncio di inventario locale su cui è stato fatto clic. che dovrebbe corrispondere agli ID negozio utilizzati nel tuo feed dei prodotti locali.

product_country_code

string

Il paese (formato ISO-3166) registrato per il feed di inventario contenente il prodotto su cui è stato fatto clic.

asset_id

int64

ID dell'asset con cui è stata eseguita l'interazione durante l'evento visita.

asset_field_type

AssetFieldType

Tipo di campo asset dell'evento visita.

WebpageView

Una visualizzazione di pagina web.

Campi
resource_name

string

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

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}