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 le strategie di proprietà degli amministratori del cliente e condivise con questo cliente, oltre a quelle di proprietà di questo cliente. Questa risorsa non fornisce metriche ed espone solo un sottoinsieme limitato degli attributi BiddingStrategy.

Campi
resource_name

string

Il nome della risorsa della strategia di offerta accessibile. I nomi delle risorse AccessibleBiddingStrategy hanno il seguente 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

descriptive_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 che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.
maximize_conversions

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetRoas

Una strategia di offerta che ti aiuta a massimizzare le entrate mantenendo 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 che ti aiuta a ottenere il valore di conversione più alto possibile per le tue campagne entro i limiti di spesa del budget.

Campi
target_roas

double

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

MaximizeConversions

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

Campi
target_cpa

int64

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

int64

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

TargetCpa

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

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 offerte automatiche che imposta le offerte in modo che una determinata percentuale di annunci della rete di ricerca venga mostrata nella parte superiore della prima pagina (o in un'altra posizione target).

Campi
location

TargetImpressionShareLocation

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

int64

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

int64

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

TargetRoas

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

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

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

FinalAppUrl

Un elenco di URL finali dell'app che verranno utilizzati sui dispositivi mobili se l'utente ha installato l'app specifica.
final_mobile_urls[]

string

L'elenco dei possibili URL mobile finali dopo tutti i reindirizzamenti cross-domain per l'annuncio.
type

AdType

Il tipo di annuncio.
id

int64

L'ID dell'annuncio.
tracking_url_template

string

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

string

Il suffisso da utilizzare per creare un URL finale.
display_url

string

L'URL visualizzato nella descrizione dell'annuncio per alcuni formati degli annunci.
name

string

Il nome dell'annuncio. Viene utilizzato solo per identificare l'annuncio. Non deve essere univoco e non influisce sull'annuncio pubblicato.
Campo unione ad_data. Dettagli pertinenti al tipo di annuncio. Deve essere impostato un solo 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 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 del gruppo di annunci hanno il 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 degli annunci del gruppo di annunci.
creation_time

string

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

TargetingSetting

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

string

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

string

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

string

ID del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza invece "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 data di inizio del gruppo di annunci, a seconda di quale data è successiva. Se questo campo è impostato, il gruppo di annunci inizia all'inizio della data specificata nel fuso orario del cliente. Questo campo è disponibile solo per gli account gateway Microsoft Advertising e Facebook.

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

string

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

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

string

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

string

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

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 null (punto di codice 0x0), feed di linea NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
tracking_url_template

string

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

int64

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

AdGroupEngineStatus

Lo stato del motore per il gruppo di annunci.
final_url_suffix

string

Modello di URL per aggiungere parametri all'URL finale.

AdGroupAd

Un annuncio del gruppo di annunci.

Campi
resource_name

string

Il nome della risorsa dell'annuncio. I nomi delle risorse annuncio del gruppo di annunci hanno il 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 della creazione di questo ad_group_ad. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
labels[]

string

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

string

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

string

ID dell'annuncio nell'account motore esterno. Questo campo è solo per l'account Search Ads 360, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per le entità non Search Ads 360, utilizza "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

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

AdGroupAdEffectiveLabel

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

Campi
resource_name

string

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

string

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

string

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

int64

L'ID del cliente proprietario dell'etichetta effettiva.

AdGroupAdLabel

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

Campi
resource_name

string

Il nome della risorsa dell'etichetta dell'annuncio del gruppo di annunci. I nomi delle risorse delle etichette degli annunci del gruppo di annunci hanno il formato: customers/{owner_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.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta.

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 AdGroupAsset hanno il seguente 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

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

Campi
resource_name

string

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

customers/{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

Il set di asset collegato al gruppo di annunci.
status

AssetSetLinkStatus

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

AdGroupAudienceView

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

Campi
resource_name

string

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

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

AdGroupBidModifier

Rappresenta un modificatore dell'offerta per gruppo di annunci.

Campi
resource_name

string

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

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

double

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

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

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

DeviceInfo

Un criterio per dispositivo.

AdGroupCriterion

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

Campi
resource_name

string

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

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

string

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

AdGroupCriterionStatus

Lo stato del criterio.

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

string

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

PositionEstimates

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

string

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

string

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

CustomParameter

L'elenco dei mapping utilizzati per sostituire i tag dei parametri personalizzati in un tracking_url_template, final_urls o mobile_final_urls.
engine_id

string

ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è riservato solo agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per l'entità Google Ads, utilizza invece "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 e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
criterion_id

int64

L'ID del criterio.
ad_group

string

Il gruppo di annunci a cui appartiene il criterio.
negative

bool

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

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

double

Il modificatore dell'offerta quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 10,0. La maggior parte dei tipi di criteri targetizzabili supporta i modificatori.
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 del motore per il criterio del gruppo di annunci.
final_url_suffix

string

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

string

Il modello di URL per creare un URL di monitoraggio.

Campo unione criterion. Il criterio del gruppo di annunci.

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

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 dei criteri in varie posizioni.

Campi
top_of_page_cpc_micros

int64

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

QualityInfo

Un contenitore per le informazioni sulla qualità dei criteri 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.

AdGroupCriterionEffectiveLabel

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

Campi
resource_name

string

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

string

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

string

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

int64

L'ID del cliente proprietario dell'etichetta effettiva.

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 delle etichette dei criteri del gruppo di annunci hanno il formato: customers/{owner_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.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta.

AdGroupEffectiveLabel

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

Campi
resource_name

string

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

string

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

string

L'etichetta effettiva assegnata al gruppo di annunci.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta effettiva.

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 delle etichette dei gruppi di annunci hanno il seguente formato: customers/{owner_customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group

string

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

string

L'etichetta assegnata al gruppo di annunci.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta.

AgeRangeView

Una visualizzazione della 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 d'età hanno il seguente formato:

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

Asset

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

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 asset.
final_urls[]

string

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

string

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

CustomParameter

Un elenco di mappature da utilizzare per sostituire i tag dei parametri personalizzati dell'URL in tracking_url_template, final_urls e/o final_mobile_urls.
status

AssetStatus

Lo stato della risorsa.
creation_time

string

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

string

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

int64

ID della risorsa.
name

string

Nome facoltativo dell'asset.
tracking_url_template

string

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

string

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

AssetEngineStatus

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

YoutubeVideoAsset

Un asset 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 del gruppo di asset hanno il 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. Il nome del gruppo di asset. Obbligatorio. Deve avere una lunghezza minima di 1 e una lunghezza massima di 128. Deve essere univoco in una campagna.
final_urls[]

string

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

string

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

AssetGroupStatus

Lo stato del gruppo di asset.
path1

string

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

string

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

AdStrength

Efficacia dell'annuncio complessiva 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 asset del gruppo di asset ha il formato:

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

string

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

string

L'asset a cui è collegato questo asset del gruppo di asset.
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 una risorsa e un gruppo di asset.

AssetGroupAssetCombinationData

Dati sulle combinazioni di asset del gruppo di asset

Campi
asset_combination_served_assets[]

AssetUsage

Asset pubblicati.

AssetGroupListingGroupFilter

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

Campi
resource_name

string

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

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

string

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

int64

L'ID di ListingGroupFilter.
type

ListingGroupFilterType

Tipo di nodo del filtro del gruppo di schede.
vertical

ListingGroupFilterVertical

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

ListingGroupFilterDimension

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

string

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

ListingGroupFilterDimensionPath

Il percorso delle dimensioni che definiscono 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 gli utenti che hanno maggiori probabilità di generare conversioni. Performance Max utilizza l'indicatore per cercare nuovi utenti che dimostrano un interesse simile o superiore al tuo nel trovare conversioni sulla rete di ricerca, sulla Rete Display, sulla rete video e su altri tipi.

Campi
resource_name

string

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

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

string

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

AudienceInfo

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

AssetGroupTopCombinationView

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

Campi
resource_name

string

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

AssetGroupAssetCombinationData

Le principali combinazioni di asset pubblicati insieme.

AssetSet

Un insieme di asset che rappresenta una raccolta di asset. Utilizza AssetSetAsset per collegare un asset all'insieme 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 dei set di asset hanno il seguente formato:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

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

Campi
resource_name

string

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

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

string

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

string

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

AssetSetAssetStatus

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

Pubblico

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

Campi
resource_name

string

Il nome 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 in tutti i segmenti di pubblico. Deve avere una lunghezza minima di 1 e una lunghezza massima di 255.
description

string

Descrizione di questo segmento di pubblico.

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 di tre lettere).

Per le strategie di offerta nei clienti amministratore, questa valuta può essere impostata al momento della creazione e viene impostata per impostazione predefinita sulla valuta del cliente amministratore. Per i clienti associati a un account di pubblicazione, questo campo non può essere impostato; tutte le strategie in un cliente associato a un account di pubblicazione utilizzano implicitamente la valuta del cliente associato a un account di pubblicazione. In tutti i casi, il campo effective_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 un nome distinto.

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

string

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

Per le strategie di offerta nei clienti amministratore, questa è la valuta impostata dall'inserzionista al momento della creazione della strategia. Per la pubblicazione per i clienti, questo è il 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 sembrano avere maggiori probabilità di generare una conversione e le riduce per i clic che sembrano avere minori probabilità.
maximize_conversion_value

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

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

TargetImpressionShare

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

TargetOutrankShare

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

TargetRoas

Una strategia di offerta che ti aiuta a massimizzare le entrate mantenendo 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 hanno il seguente formato:

customers/{customer_id}/campaigns/{campaign_id}
status

CampaignStatus

Lo stato della campagna.

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

CampaignServingStatus

Lo stato di pubblicazione degli annunci 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 degli 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 crei nuove campagne.

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

AdvertisingChannelSubType

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

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

CustomParameter

L'elenco dei mapping utilizzati per sostituire i tag dei parametri personalizzati in un 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 di 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 controllare le campagne Shopping.
geo_target_type_setting

GeoTargetTypeSetting

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

string

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

string

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

BiddingStrategyType

Il tipo di strategia di offerta.

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

Questo campo è di sola lettura.
accessible_bidding_strategy

string

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

FrequencyCapEntry

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

SelectiveOptimization

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

OptimizationGoalSetting

Impostazione dell'obiettivo 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 di monitoraggio.
engine_id

string

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

AssetFieldType

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

string

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

string

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

string

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

AssetSetType

Tipi di feed collegati direttamente a questa campagna.
id

int64

L'ID della campagna.
name

string

Il nome della campagna.

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

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

string

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

string

Il nome della risorsa del budget della campagna.
start_date

string

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

string

L'ultimo giorno della campagna nel fuso orario del cliente nel formato AAAA-MM-GG. Al momento della creazione, il valore predefinito è 30/12/2037, il che significa che la campagna verrà pubblicata a tempo indeterminato. Per impostare una campagna esistente in modo che venga pubblicata a tempo indeterminato, imposta questo campo su 2037-12-30.
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 a URL più mirati. Se l'espansione è disattivata (true), vengono presi di mira solo gli URL finali nel gruppo di asset o gli URL specificati nei feed di dati aziendali o di Google Merchant Center dell'inserzionista. Se è attivata (false), verrà scelto come target l'intero dominio. Questo campo può essere impostato solo per le campagne Performance Max, dove il valore predefinito è false.

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

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

string

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

ManualCpa

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

ManualCpc

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

ManualCpm

Strategia di offerta CPM manuale 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 sul CPA target standard che imposta automaticamente le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target che hai definito.
target_impression_share

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

PercentCpc

Strategia di offerta basata sul CPC percentuale standard in cui le offerte sono una frazione del prezzo pubblicizzato per alcuni beni o servizi.
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 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 geotargeting degli annunci.

Campi
positive_geo_target_type

PositiveGeoTargetType

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

NegativeGeoTargetType

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

NetworkSettings

Le impostazioni di rete per la campagna.

Campi
target_search_network

bool

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 verranno pubblicati nei posizionamenti specificati sulla Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.
target_partner_search_network

bool

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

OptimizationGoalSetting

Impostazione dell'obiettivo 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 per cui ottimizzare la campagna. Questa funzionalità si applica solo alle campagne per app che utilizzano MULTI_CHANNEL come AdvertisingChannelType e APP_CAMPAIGN o APP_CAMPAIGN_FOR_ENGAGEMENT come AdvertisingChannelSubType.

Campi
conversion_actions[]

string

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

ShoppingSetting

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

Campi
feed_label

string

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

bool

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 è immutabile per le campagne Shopping.
sales_country

string

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

int32

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

bool

Se includere i prodotti locali.

TrackingSetting

Impostazioni a livello di campagna per le informazioni di 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 hanno il seguente 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 set di asset. L'aggiunta di un CampaignAssetSet collega un set 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 dei set di asset hanno il formato:

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

string

La campagna a cui è collegato questo insieme 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 segmento di pubblico della campagna. Include i dati sul rendimento degli annunci della rete di ricerca, della Rete Display e della rete YouTube, nonché degli elenchi per il remarketing per gli annunci della rete di ricerca (RLSA), aggregati per campagna e criterio del segmento di pubblico. Questa visualizzazione include solo i segmenti di pubblico collegati a livello di campagna.

Campi
resource_name

string

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

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

CampaignBudget

Un budget della campagna.

Campi
resource_name

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}
delivery_method

BudgetDeliveryMethod

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

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

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 equivale a un'unità di valuta. La spesa mensile è limitata a 30,4 volte questo importo.

CampaignCriterion

Un criterio campagna.

Campi
resource_name

string

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

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

string

Il nome visualizzato del criterio.

Questo campo viene ignorato per le mutazioni.
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 e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
criterion_id

int64

L'ID del criterio.

Questo campo viene ignorato durante la mutazione.
bid_modifier

float

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

bool

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

Campo unione criterion. Il criterio campagna.

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

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à

CampaignEffectiveLabel

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

Campi
resource_name

string

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

string

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

string

L'etichetta effettiva assegnata alla campagna.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta effettiva.

CampaignLabel

Rappresenta una relazione tra una campagna e un'etichetta.

Campi
resource_name

string

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

string

La campagna a cui è associata l'etichetta.
label

string

L'etichetta assegnata alla campagna.
owner_customer_id

int64

L'ID del cliente proprietario dell'etichetta.

CartDataSalesView

Visualizzazione delle vendite dei dati del carrello.

Campi
resource_name

string

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

Conversione

Una conversione.

Campi
resource_name

string

Il nome della risorsa della conversione. I nomi delle risorse di conversione hanno il seguente 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. Un valore pari a 0 indica che l'annuncio non è attribuito.
click_id

string

Una stringa univoca, per la visita a cui è attribuita la conversione, che viene trasmessa alla pagina di destinazione come parametro URL ID clic.
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, Search Ads 360 ne genera uno. Per le conversioni online, questo valore è uguale alla colonna id o alla colonna floodlight_order_id, a seconda delle istruzioni 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 che contiene il prodotto su cui è stato fatto clic.
attribution_type

AttributionType

A cosa è 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, determinata dal parametro URL qty. L'inserzionista è responsabile del riempimento dinamico del parametro (ad esempio, il numero di articoli venduti nella conversione), altrimenti il valore predefinito è 1.
conversion_revenue_micros

int64

Le entrate aggiustate 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 alle istruzioni sulla valuta Floodlight.
floodlight_order_id

string

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

ConversionStatus

Lo stato della conversione, ovvero ATTIVATO o RIMOSSO.
asset_id

int64

ID dell'asset con cui è stata eseguita un'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 delle azioni di conversione hanno il seguente 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 di eventi di conversione.
type

ConversionActionType

Il tipo di questa azione di conversione.
category

ConversionActionCategory

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

ValueSettings

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

string

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

bool

Indica se questa azione di conversione deve essere inclusa nella metrica "client_account_conversions".
include_in_conversions_metric

bool

Indica se questa azione di conversione deve essere inclusa nella metrica "Conversioni".
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 per gli 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

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

ConversionCustomVariable

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

Campi
resource_name

string

Il nome della risorsa della variabile personalizzata di conversione. I nomi delle risorse delle variabili personalizzate di conversione hanno il 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 è di 100 caratteri. Non devono esserci spazi aggiuntivi prima e dopo.
tag

string

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

ConversionCustomVariableStatus

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

string

Il nome 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

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

Campi
accepted_customer_data_terms

bool

Indica se il cliente ha accettato i termini relativi ai dati dei clienti. Se utilizzi il monitoraggio delle conversioni su più account, questo valore viene ereditato dall'account amministratore. Questo campo è di sola lettura. Per ulteriori informazioni, visita la pagina https://support.google.com/adspolicy/answer/7475709.
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 di questo cliente. Se questo cliente utilizza il monitoraggio delle conversioni su più account, il valore restituito varia in base al login-customer-id della richiesta.
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'account amministratore. Questo campo è di sola lettura.
google_ads_conversion_customer

string

Il nome 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 (lo fa conversion_tracking_status). Questo campo è di sola lettura.
google_ads_cross_account_conversion_tracking_id

int64

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

int64

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

CustomColumn

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

Campi
resource_name

string

Il nome risorsa della colonna personalizzata. I nomi delle risorse delle colonne personalizzate hanno il seguente 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 della colonna personalizzata definita dall'utente.
value_type

CustomColumnValueType

Il tipo di valore del risultato della colonna personalizzata.
references_attributes

bool

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

bool

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

bool

True se la colonna personalizzata è disponibile per essere utilizzata nella query di SearchAds360Service.Search e SearchAds360Service.SearchStream.
referenced_system_columns[]

string

L'elenco delle colonne di sistema a cui fa riferimento questa colonna personalizzata. Ad esempio, una colonna personalizzata "Somma di impressioni e clic" fa riferimento alle colonne di sistema {"metrics.clicks", "metrics.impressions"}.
render_type

CustomColumnRenderType

Come deve essere interpretato il valore del risultato della colonna personalizzata.

Cliente

Un cliente.

Campi
resource_name

string

Il nome risorsa del cliente. I nomi delle risorse cliente 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 di questo cliente. La data e l'ora sono nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss".
engine_id

string

ID dell'account nell'account motore esterno.
status

CustomerStatus

Lo stato del cliente.
creation_time

string

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

int64

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

string

Il nome descrittivo del gestore.
sub_manager_id

int64

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

string

Il nome descrittivo dell'amministratore secondario.
associate_manager_id

int64

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

string

Il nome descrittivo dell'amministratore associato.
account_level

AccountLevelType

Il livello di account del cliente: amministratore, amministratore secondario, amministratore associato, account di servizio.
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 del fuso orario locale del cliente.
tracking_url_template

string

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

string

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

bool

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

bool

Indica se il cliente è un amministratore.

CustomerAsset

Un collegamento tra un cliente e una risorsa.

Campi
resource_name

string

Il nome risorsa dell'asset del cliente. I nomi delle risorse CustomerAsset hanno il seguente 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 asset set a un cliente.

Campi
resource_name

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}
asset_set

string

Il gruppo di asset collegato al cliente.
customer

string

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

AssetSetLinkStatus

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

CustomerClient

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

Campi
resource_name

string

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

string

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

customers/{customer_id}/labels/{label_id}
status

CustomerStatus

Lo stato del cliente cliente. Sola lettura.
client_customer

string

Il nome 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 e il client specificati. Per il collegamento automatico, il valore del livello sarà 0. Sola lettura.
time_zone

string

Rappresentazione della stringa Common Locale Data Repository (CLDR) 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 amministratore. Sola lettura.
descriptive_name

string

Nome descrittivo del client. Sola lettura.
currency_code

string

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

int64

L'ID del cliente 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

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

string

Fuso orario della rete Campaign Manager associata a questo cliente nel formato del database dei fusi orari 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 risorsa della visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca. I nomi delle risorse della visualizzazione dei termini di ricerca degli annunci dinamici della rete di ricerca hanno il formato:

customers/{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 del genere. La risorsa gender_view riflette lo stato di pubblicazione effettivo, anziché i criteri aggiunti. Un gruppo di annunci senza criteri di genere viene mostrato per impostazione predefinita a tutti i generi, pertanto tutti i generi vengono visualizzati in gender_view con le statistiche.

Campi
resource_name

string

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

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

GeoTargetConstant

Una costante di targeting geografico.

Campi
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}
status

GeoTargetConstantStatus

Stato costante del target geografico.
id

int64

L'ID della costante di targeting 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 target costante di targeting geografico.
canonical_name

string

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

string

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

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Una visualizzazione delle parole chiave.

Campi
resource_name

string

Il nome risorsa della visualizzazione delle parole chiave. I nomi delle risorse della visualizzazione delle parole chiave hanno il seguente 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/{owner_customer_id}/labels/{label_id}
status

LabelStatus

Stato dell'etichetta. Sola lettura.
text_label

TextLabel

Un tipo di etichetta che mostra il 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 caratteri inclusi.

LanguageConstant

Una lingua.

Campi
resource_name

string

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

languageConstants/{criterion_id}
id

int64

L'ID della costante di lingua.
code

string

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

string

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

bool

Indica se la lingua può essere impostata come target.

ListingGroupFilterDimension

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

Campi
Campo unione dimension. È sempre presente una dimensione di uno dei tipi riportati di seguito. 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à di un'offerta di prodotto.
product_condition

ProductCondition

Condizione di un'offerta di prodotto.
product_custom_attribute

ProductCustomAttribute

Attributo personalizzato di un'offerta di prodotto.
product_item_id

ProductItemId

ID articolo di un'offerta di prodotto.
product_type

ProductType

Tipo di offerta di un prodotto.

ProductBiddingCategory

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

Campi
level

ListingGroupFilterBiddingCategoryLevel

Indica il livello della categoria nella tassonomia.
id

int64

ID della categoria di offerta del prodotto.

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

ProductBrand

La marca del prodotto.

Campi
value

string

Valore stringa del brand del prodotto.

ProductChannel

Località di un'offerta di prodotto.

Campi
channel

ListingGroupFilterProductChannel

Valore della località.

ProductCondition

Condizione di un'offerta di prodotto.

Campi
condition

ListingGroupFilterProductCondition

Valore della condizione.

ProductCustomAttribute

Attributo personalizzato di un'offerta di 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

Tipo di offerta di un prodotto.

Campi
level

ListingGroupFilterProductTypeLevel

Il livello del tipo.
value

string

Valore del tipo.

ListingGroupFilterDimensionPath

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

Campi
dimensions[]

ListingGroupFilterDimension

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

LocationView

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

Campi
resource_name

string

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

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

ProductBiddingCategoryConstant

Una categoria di offerta per i prodotti.

Campi
resource_name

string

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

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

ProductBiddingCategoryLevel

Livello della categoria di offerta del prodotto.
status

ProductBiddingCategoryStatus

Stato della categoria di offerta del prodotto.
id

int64

ID della categoria di offerta del prodotto.

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

string

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

string

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

string

Codice lingua della categoria di offerta del prodotto.
localized_name

string

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

ProductGroupView

Una visualizzazione dei gruppi di prodotti.

Campi
resource_name

string

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

customers/{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 vengono 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. Viene 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, che segmentano le metriche quando vengono inclusi nelle query di ricerca e quando l'artefatto descritto viene utilizzato nella clausola FROM. Viene 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 viene impostato solo per gli artefatti della categoria SEGMENT 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 proto che descrive il tipo di dati dell'artefatto.
is_repeated

bool

Se l'artefatto del campo viene ripetuto.

ShoppingPerformanceView

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

Campi
resource_name

string

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

UserList

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

Campi
resource_name

string

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

customers/{customer_id}/userLists/{user_list_id}
type

UserListType

Il tipo di elenco.

Questo campo è di sola lettura.
id

int64

ID dell'elenco di utenti.
name

string

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

UserLocationView

Una visualizzazione della posizione degli utenti.

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

Campi
resource_name

string

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

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}
country_criterion_id

int64

ID criterio per il paese.
targeting_location

bool

Indica se il targeting è stato impostato sulla località.

Visita

Una visita.

Campi
resource_name

string

Il nome della risorsa della visita. I nomi delle risorse di visita 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. Un valore pari a 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. Un valore pari a 0 indica che l'annuncio non è attribuito.
click_id

string

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

string

Il timestamp dell'evento di visita. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
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 che contiene il prodotto su cui è stato fatto clic.
asset_id

int64

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

AssetFieldType

Tipo di campo asset dell'evento di visita.

WebpageView

Visualizzazione di una 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}