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à dei gestori del cliente e condivise con il cliente, oltre alle strategie di proprietà del 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 uno solo. scheme può essere solo uno dei seguenti:
maximize_conversion_value

MaximizeConversionValue

Una strategia di offerta automatica che ti consente di ottenere il valore di conversione più alto possibile per le tue campagne rispettando il budget.
maximize_conversions

MaximizeConversions

Una strategia di offerte automatiche che ti consente di ottenere il maggior numero di conversioni per le tue campagne rispettando il 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 ottimizza automaticamente in base a una percentuale di impressioni scelta.
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 farti ottenere il maggior numero possibile di clic in base al tuo budget.

MaximizeConversionValue

Una strategia di offerta automatica che ti consente di ottenere il valore di conversione più alto possibile per le tue campagne rispettando il 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 offerte automatiche che ti consente di ottenere il maggior numero di conversioni per le tue campagne rispettando il 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 di offerta automatica che imposta le offerte in modo da ottenere il maggior numero di conversioni possibile al costo per acquisizione (CPA) target che hai definito.

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 visualizzata nella parte superiore della prima pagina (o in un'altra posizione target).

Campi
location

TargetImpressionShareLocation

La località scelta come target nella pagina dei risultati di ricerca.
location_fraction_micros

int64

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

int64

L'offerta CPC massima che il sistema di offerte automatiche è autorizzato a specificare. Si tratta di un campo obbligatorio inserito dall'inserzionista che imposta il limite massimo e specificato nelle microlocali.

TargetRoas

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

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 al di sotto della quale massimizzare i clic. Un offerente TargetSpend tenterà di spendere il valore più basso tra questo valore o l'importo della spesa per il throttling naturale. Se non specificato, il budget viene utilizzato come target di spesa. Questo campo è deprecato 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 visualizzato 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. Al momento, il campo name è supportato solo per DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd.
Campo unione ad_data. Dettagli pertinenti al tipo di annuncio. È necessario impostare 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 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 del gruppo 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 degli annunci del gruppo di annunci.
creation_time

string

Il timestamp di 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 il targeting di funzionalità correlate.
labels[]

string

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

string

I nomi delle risorse delle etichette efficaci 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 è destinato 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 di inizio della pubblicazione degli annunci di questo gruppo di annunci. Per impostazione predefinita, il gruppo di annunci inizia immediatamente o alla data di inizio del gruppo di annunci, a seconda del caso. 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

Data di fine della pubblicazione degli annunci del gruppo di annunci. Per impostazione predefinita, il gruppo di annunci termina alla relativa data di fine. 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).
cpc_bid_micros

int64

L'offerta CPC (costo per clic) massima.
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 annuncio del gruppo 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 della creazione di questo annuncio gruppo. 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 all'annuncio di questo 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 è destinato solo agli account Search Ads 360, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per un'entità non Search Ads 360, utilizza invece "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".

AdGroupAdEffectiveLabel

Una relazione tra un annuncio del gruppo di annunci e un'etichetta efficace. Un'etichetta efficace è un'etichetta ereditata o assegnata direttamente all'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 efficaci per gli annunci del gruppo di annunci hanno il formato: customers/{customer_id}/adGroupAdEffectiveLabels/{ad_group_id}~{ad_id}~{label_id}
ad_group_ad

string

L'annuncio del gruppo di annunci a cui è allegata l'etichetta effettiva.
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 una casa discografica.

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

string

L'annuncio del gruppo di annunci a cui è associata 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 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 insieme di asset del gruppo di annunci 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 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 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 del 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 della 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.

Si tratta dello stato dell'entità del criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità all'esecuzione di un criterio. In alcuni casi, un criterio rimosso nell'API può comunque essere visualizzato come abilitato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non vengano escluse. Nell'interfaccia utente tutte le fasce d'età verranno indicate come "attivate", in quanto sono idonee alla visualizzazione degli annunci, ma groupCriterion.status mostrerà "rimosso", in quanto 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 basate su criteri 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 è riservato 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 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 il criterio come target (false) o escluderlo (true).

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 tra 0,1 e 10,0. La maggior parte dei tipi di criteri che possono essere scelti come target supporta i modificatori.
cpc_bid_micros

int64

L'offerta CPC (costo per clic).
effective_cpc_bid_micros

int64

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

AdGroupCriterionEngineStatus

Lo stato del motore per il criterio del 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.

È necessario impostarne esattamente uno. 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 basate su criteri in varie posizioni.

Campi
top_of_page_cpc_micros

int64

La stima dell'offerta CPC necessaria per la visualizzazione 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.

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 efficace del criterio del gruppo di annunci. I nomi delle risorse delle etichette efficaci del criterio del gruppo di annunci hanno il seguente formato: customers/{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 efficace.
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 seguente 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.
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 effettiva è un'etichetta ereditata o assegnata direttamente a questo gruppo di annunci.

Campi
resource_name

string

Il nome della risorsa dell'etichetta efficace del gruppo di annunci. I nomi delle risorse delle etichette efficaci del gruppo di annunci hanno il seguente formato: customers/{customer_id}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
ad_group

string

Il gruppo di annunci a cui è associata 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 del gruppo di annunci hanno il seguente formato: customers/{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 Intervallo di età hanno il seguente formato:

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

Asset

Un asset è un elemento di un annuncio che può essere condiviso 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 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 tra domini.
status

AssetStatus

Lo stato dell'asset.
creation_time

string

Timestamp della creazione dell'asset. 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 della risorsa.
tracking_url_template

string

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

AssetEngineStatus

Lo stato del motore per una risorsa.
Campo unione asset_data. Il tipo specifico di risorsa. 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 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 massima di 128. Deve essere univoco all'interno di una campagna.
final_urls[]

string

Un elenco di URL finali dopo tutti i reindirizzamenti tra domini. In Performance Max, per impostazione predefinita, gli URL sono idonei per l'espansione, a meno che non venga disattivata questa opzione.
final_mobile_urls[]

string

Un elenco di URL mobile finali dopo tutti i reindirizzamenti interdominio. In Performance Max, per impostazione predefinita, gli URL sono idonei per l'espansione, a meno che non venga disattivata questa opzione.
status

AssetGroupStatus

Lo stato del gruppo di asset.
path1

string

Prima parte di testo che potrebbe essere aggiunta all'URL visualizzato nell'annuncio.
path2

string

Seconda parte di testo che può 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 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 a cui si collega questo asset gruppo di asset.
asset

string

L'asset a cui si collega 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 e così via
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 dell'elenco di gruppo degli asset. Il nome della risorsa del filtro dell'elenco di gruppo degli asset ha il 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 dell'elenco di gruppo di asset.
id

int64

L'ID di ListingGroupFilter.
type

ListingGroupFilterType

Tipo di un nodo del filtro del gruppo di schede.
vertical

ListingGroupFilterVertical

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

ListingGroupFilterDimension

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

string

Nome della risorsa della suddivisione del gruppo di schede principale. Valore nullo per il nodo del filtro dell'elenco di gruppi 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 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 del segmento di pubblico da utilizzare per la campagna Performance Max.

AssetGroupTopCombinationView

Una visualizzazione dell'utilizzo della combinazione di asset dell'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 principale di AssetGroup sono nel formato: ""customers/{customer_id}/assetGroupTopCombineViews/{asset_group_id}~{asset_combination_category}"
asset_group_top_combinations[]

AssetGroupAssetCombinationData

Le combinazioni principali 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 del 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 risorse. 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 set hanno il seguente formato:

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

string

L'insieme di asset a cui si collega questo asset dell'insieme di asset.
asset

string

La risorsa a cui si collega questo asset dell'insieme di asset.
status

AssetSetAssetStatus

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

Pubblico

Il pubblico è un'opzione di targeting efficace che ti consente di combinare 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 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 in tutti i segmenti di pubblico. Deve avere una lunghezza minima di 1 e una 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 per impostazione predefinita corrisponde alla valuta del cliente amministratore. Per i clienti di pubblicazione, questo campo non può essere impostato; tutte le strategie in un cliente di pubblicazione utilizzano implicitamente la valuta del cliente 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, inclusi, in byte UTF-8 (riordinata).
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 durante la creazione della strategia. Per fornire servizi ai clienti, è il valore currency_code del cliente.

Le metriche della strategia di offerta vengono 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 che ti consente di ottenere il valore di conversione più alto possibile per le tue campagne rispettando il budget.
maximize_conversions

MaximizeConversions

Una strategia di offerte automatiche che ti consente di ottenere il maggior numero di conversioni per le tue campagne rispettando il 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 ottimizza automaticamente 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 delle aste in cui l'inserzionista deve superare 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. Le mutazioni alle strategie in cui questo schema è già stato compilato sono consentite.
target_roas

TargetRoas

Una strategia di offerta che ti consente di massimizzare le entrate mantenendo un ritorno sulla spesa pubblicitaria (ROAS) target medio.
target_spend

TargetSpend

Una strategia di offerta che imposta le offerte in modo da farti 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 dell'annuncio della campagna.
bidding_strategy_system_status

BiddingStrategySystemStatus

Lo stato di 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 si creano 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 a advertising_channel_type. Deve essere un sottotipo valido del tipo di canale principale.

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

CustomParameter

L'elenco delle mappature utilizzate 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 della rete per la campagna.
dynamic_search_ads_setting

DynamicSearchAdsSetting

L'impostazione per il controllo degli 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.
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.

Puoi creare una strategia di offerta 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 restrizioni 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. Gli attributi con limitazioni, invece, sono disponibili solo per il cliente proprietario della strategia e per i relativi 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 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 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 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 della creazione della campagna. Il timestamp è nel fuso orario del cliente ed è nel formato "aaaa-MM-gg HH:mm:ss". Il valore create_time verrà ritirato nella versione v1. Utilizza invece creation_time.
creation_time

string

Il timestamp della creazione della 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".
id

int64

L'ID della campagna.
name

string

Il nome della campagna.

Questo campo è obbligatorio e non deve essere vuoto durante la creazione di 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 la creazione di un URL di monitoraggio.
campaign_budget

string

Il nome risorsa del budget della campagna.
start_date

string

La data di inizio della pubblicazione 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 che pubblica l'annuncio 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 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 a URL più mirati. Se la disattivazione è attiva (true), vengono scelti come target solo gli URL finali nel gruppo di asset o gli URL specificati in Google Merchant Center o nei feed di dati aziendali dell'inserzionista. Se l'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 di tipo portafoglio (creata tramite il servizio BiddingStrategy) o standard, incorporata nella campagna. campaign_bidding_strategy può essere solo uno dei seguenti:
bidding_strategy

string

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

ManualCpa

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

ManualCpc

Strategia di offerta manuale basata su CPC standard. Offerte manuali basate sui clic in cui l'utente paga per clic.
manual_cpm

ManualCpm

Strategia di offerta manuale basata su CPM standard. Offerte manuali basate sulle impressioni in cui l'utente paga per mille impressioni.
maximize_conversions

MaximizeConversions

Strategia di offerta Massimizza le conversioni standard che massimizza automaticamente il numero di conversioni rispettando il budget.
maximize_conversion_value

MaximizeConversionValue

Strategia di offerta Massimizza il valore di conversione standard che imposta automaticamente le offerte per massimizzare le entrate rispettando il 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 basata sulla Quota impressioni target. Una strategia di offerte automatiche che imposta le offerte in modo da raggiungere una percentuale scelta di impressioni.
target_roas

TargetRoas

Strategia di offerta ROAS target standard che massimizza automaticamente le entrate, calcolando al contempo la 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 farti 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 il controllo degli 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 "it".
use_supplied_urls_only

bool

Indica se la campagna utilizza esclusivamente gli 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 campagna specifica.

NetworkSettings

Le impostazioni di rete per la campagna.

Campi
target_search_network

bool

Indica se gli annunci devono essere pubblicati sui siti partner della rete di ricerca di Google (è necessario che target_google_search sia anche true).
target_content_network

bool

Indica se gli annunci verranno pubblicati in posizionamenti specifici della Rete Display di Google. I posizionamenti vengono specificati utilizzando il criterio Posizionamento.
target_partner_search_network

bool

Se gli annunci verranno pubblicati sulla Rete partner di Google. Questa funzionalità è disponibile solo per alcuni account partner di 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 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 nomi di risorse per le azioni di conversione per l'ottimizzazione di questa campagna.

ShoppingSetting

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

Campi
feed_label

string

L'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 è immutabile 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à numeriche più elevate hanno la precedenza su quelle con priorità più basse. Questo campo è obbligatorio per le campagne Shopping e i valori devono essere 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

La risorsa collegata alla campagna.

CampaignAssetSet

CampaignAssetSet è il collegamento tra una campagna e un insieme di asset. L'aggiunta di un set di asset della campagna 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 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 insieme di asset.
asset_set

string

Il set di asset collegato alla campagna.
status

AssetSetLinkStatus

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

CampaignAudienceView

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

Campi
resource_name

string

Il nome della risorsa della visualizzazione del segmento di pubblico della campagna. I nomi delle risorse delle visualizzazioni dei segmenti di 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 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 frequenza 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 è 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 della risorsa del criterio 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 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 modifica.
bid_modifier

float

Il modificatore delle offerte quando il criterio corrisponde. Il modificatore deve essere compreso nell'intervallo 0,1 - 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

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

Campo unione criterion. Il criterio della campagna.

È necessario impostarne esattamente uno. 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 seguente formato: customers/{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 una casa discografica.

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

int64

L'ID del cliente proprietario dell'etichetta.

CartDataSalesView

Visualizzazione vendite dati del carrello.

Campi
resource_name

string

Il nome della risorsa della visualizzazione delle vendite dei dati del carrello. I nomi delle risorse della vista delle vendite dei dati del carrello hanno il seguente 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 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, corrisponde 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 (in formato ISO 3166) registrato per il feed di inventario che contiene il prodotto su cui è stato fatto clic.
attribution_type

AttributionType

Elemento a cui 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 registrata dalla conversione, come determinata dal parametro URL qty. L'inserzionista è responsabile della compilazione dinamica 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. Verrà sempre utilizzato nella valuta dell'account di pubblicazione.
floodlight_original_revenue

int64

Le entrate originali non modificate associate all'evento Floodlight (nella valuta del report corrente), prima delle modifiche alle istruzioni relative alla valuta Floodlight.
floodlight_order_id

string

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

ConversionStatus

Lo stato della conversione, ENABLED o REMOVED.
asset_id

int64

ID della risorsa 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 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 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 è falso, l'azione di conversione non è disponibile per le offerte 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 primary_for_goal, pertanto 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, il valore primary_for_goal sarà true se non viene impostato. Nella versione 9, il valore primary_for_goal può essere impostato su false solo dopo la creazione tramite un 'operazione "update" perché non è dichiarato come facoltativo.
owner_customer

string

Il nome della risorsa del cliente proprietario dell'azione di conversione oppure 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 es. 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 di attività Floodlight quando vengono registrate le 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 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 e costituito da un carattere "u" seguito direttamente da un numero minore o uguale 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

Indica 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 saperne di più, vedi 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 il cliente utilizza il monitoraggio delle conversioni su più account, il valore restituito varierà in base al login-customer-id della richiesta.
enhanced_conversions_for_leads_enabled

bool

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

int64

L'ID monitoraggio delle conversioni del gestore del cliente. Viene impostato quando il cliente attiva il monitoraggio delle conversioni e sostituisce conversion_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 monitoraggio delle conversioni del gestore 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 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 della colonna personalizzata definita dall'utente.
value_type

CustomColumnValueType

Il tipo di valore del risultato della colonna personalizzata.
references_attributes

bool

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

bool

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

bool

True se la colonna personalizzata è disponibile per l'utilizzo 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" ha fatto 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 della 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 del 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 della creazione del cliente. Il timestamp è nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
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 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 una risorsa.

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 della risorsa del cliente.

CustomerAssetSet

CustomerAssetSet è il collegamento tra un cliente e un insieme di asset. L'aggiunta di un CustomerAssetSet collega un set 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 set hanno il seguente formato:

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

string

L'insieme 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 del cliente. I Clienti Cliente esistono solo per i clienti amministratore. Sono inclusi tutti i clienti diretti e indiretti del cliente, nonché il gestore stesso.

Campi
resource_name

string

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

string

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

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

CustomerStatus

Lo stato del cliente del cliente. Di sola lettura.
client_customer

string

Il nome della risorsa del cliente-cliente collegato al cliente specificato. Di sola lettura.
hidden

bool

Specifica se si tratta di un account nascosto.

Di sola lettura.
level

int64

Distanza tra un determinato cliente e un client. Per il link autoreferenziale, il valore del livello sarà 0. Di 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 client è un account di prova. Di sola lettura.
manager

bool

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

string

Nome descrittivo per il cliente. Di sola lettura.
currency_code

string

Codice valuta (ad es. "USD", "EUR") per il cliente. Di sola lettura.
id

int64

L'ID del cliente 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 di 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 della 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 seguente 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 selezionato dinamicamente dell'impressione.

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 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 vista Genere hanno il seguente formato:

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

GeoTargetConstant

Una costante del targeting geografico.

Campi
resource_name

string

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

geoTargetConstants/{geo_target_constant_id}
status

GeoTargetConstantStatus

Stato della costante del targeting geografico.
id

int64

L'ID della costante del target geografico.
name

string

Nome in inglese della costante del targeting geografico.
country_code

string

Il codice paese ISO-3166-1 alpha-2 associato alla destinazione.
target_type

string

Tipo di target costante del targeting geografico.
canonical_name

string

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

string

Il nome della risorsa della costante del target geografico principale. I nomi delle risorse costanti dei target geografici hanno il seguente formato:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Una visualizzazione delle 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. Di 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 linguistica. I nomi delle risorse delle 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 "Inglese (Stati Uniti)", "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. La dimensione di uno dei tipi riportati di seguito è sempre presente. dimension può essere solo uno dei seguenti:
product_bidding_category

ProductBiddingCategory

Categoria di offerta di un prodotto.
product_brand

ProductBrand

Marca 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 di un'offerta di 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, ai loro figli 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 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 del prodotto.

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

ProductBrand

Brand del prodotto.

Campi
value

string

Valore stringa del brand 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

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 definiscono un filtro per gruppo di schede.

Campi
dimensions[]

ListingGroupFilterDimension

Il percorso completo delle dimensioni attraverso la gerarchia dei filtri dei gruppi di schede (escluso il nodo principale) fino 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 della stazione di ricarica. I nomi delle risorse della vista località hanno il formato:

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

ProductBiddingCategoryConstant

Una categoria di offerte di prodotto.

Campi
resource_name

string

Il nome della risorsa della categoria di offerta del prodotto. 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 del prodotto.
id

int64

ID della categoria di offerta del prodotto.

Questo ID è equivalente all'ID google_product_category 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 di offerta del prodotto principale.
language_code

string

Codice lingua della categoria di offerta del prodotto.
localized_name

string

Mostra il valore della categoria di offerta del 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 della visualizzazione del gruppo di prodotti hanno il seguente formato:

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

SearchAds360Field

Un campo o una risorsa (elemento) utilizzata da SearchAds360Service.

Campi
resource_name

string

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

SearchAds360Fields/{name}
category

SearchAds360FieldCategory

La categoria dell'elemento.
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 viene impostato solo per gli elementi 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 elementi 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. Viene impostato solo per gli elementi la cui categoria è RESOURCE.
enum_values[]

string

Valori che l'elemento può assumere se si tratta di un campo di tipo ENUM.

Questo campo viene impostato solo per gli elementi della categoria SEGMENT o ATTRIBUTE.
data_type

SearchAds360FieldDataType

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

string

Il nome dell'elemento.
selectable

bool

Indica se l'elemento 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'elemento 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'elemento 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 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 che un cliente può scegliere come target.

Campi
resource_name

string

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

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

UserListType

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 di utenti potrebbe non essere univoco (ad esempio, se access_reason=SHARED)

UserLocationView

Una visualizzazione della posizione dell'utente.

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

Campi
resource_name

string

Il nome della risorsa della visualizzazione della posizione dell'utente. I nomi delle risorse della vista 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 la località è stata scelta come target o meno.

Visita

Una visita.

Campi
resource_name

string

Il nome della risorsa della visita. I nomi delle risorse di Visit 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 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 passata alla pagina di destinazione come parametro URL click id.
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 contenente il prodotto su cui è stato fatto clic.
asset_id

int64

ID della risorsa con cui è stata eseguita l'interazione durante l'evento di visita.
asset_field_type

AssetFieldType

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

WebpageView

Una visualizzazione di una pagina web.

Campi
resource_name

string

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

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