La nuova API Search Ads 360 Reporting è ora disponibile. Unisciti al gruppo Google searchads-api-announcements per non perderti i prossimi miglioramenti e release.

Questa pagina è stata tradotta dall'API Cloud Translation.

ad_group_criterion

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

Risorse attribuite
ad_group
campagna
cliente
user_list

I campi delle risorse precedenti possono essere selezionati insieme a questa risorsa nelle clausole SELECT e WHERE. Questi campi non segmentano le metriche nella clausola SELECT.

ad_group_criterion.ad_group
Descrizione del campo	Il gruppo di annunci a cui appartiene il criterio.
Categoria	`ATTRIBUTE`
Tipo di dati	`RESOURCE_NAME`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	False

ad_group_criterion.age_range.type
Descrizione del campo	Tipo di fascia d'età.
Categoria	`ATTRIBUTE`
Tipo di dati	`ENUM AGE_RANGE_18_24 AGE_RANGE_25_34 AGE_RANGE_35_44 AGE_RANGE_45_54 AGE_RANGE_55_64 AGE_RANGE_65_UP AGE_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED`
Digita un URL	`google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.bid_modifier
Descrizione del campo	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 disponibili per il targeting supporta i modificatori.
Categoria	`ATTRIBUTE`
Tipo di dati	`DOUBLE`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.cpc_bid_micros
Descrizione del campo	L'offerta CPC (costo per clic).
Categoria	`ATTRIBUTE`
Tipo di dati	`INT64`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.creation_time
Descrizione del campo	Il timestamp della creazione di questo criterio del gruppo di annunci. Il timestamp è espresso nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss".
Categoria	`ATTRIBUTE`
Tipo di dati	`DATE`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.criterion_id
Descrizione del campo	L'ID del criterio.
Categoria	`ATTRIBUTE`
Tipo di dati	`INT64`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.effective_cpc_bid_micros
Descrizione del campo	L'offerta CPC (costo per clic) effettivo.
Categoria	`ATTRIBUTE`
Tipo di dati	`INT64`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.engine_id
Descrizione del campo	ID del criterio del gruppo di annunci nell'account motore esterno. Questo campo è destinato esclusivamente agli account non Google Ads, ad esempio Yahoo Japan, Microsoft, Baidu e così via. Per le entità Google Ads, utilizza invece "ad_group_criterion.criterion_id".
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.engine_status
Descrizione del campo	Il criterio Stato motore per il gruppo di annunci.
Categoria	`ATTRIBUTE`
Tipo di dati	ENUM AD_GROUP_CRITERION_ACCOUNT_PAUSED AD_GROUP_CRITERION_APPROVED AD_GROUP_CRITERION_DISAPPROVED AD_GROUP_CRITERION_ELIGIBLE AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH AD_GROUP_CRITERION_INVALID_PC_SEARCH AD_GROUP_CRITERION_INVALID_SEARCH AD_GROUP_CRITERION_LOW_SEARCH_VOLUME AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW AD_GROUP_CRITERION_NOT_REVIEWED AD_GROUP_CRITERION_ON_HOLD AD_GROUP_CRITERION_PARTIALLY_INVALID AD_GROUP_CRITERION_PAUSED AD_GROUP_CRITERION_PENDING_REVIEW AD_GROUP_CRITERION_REMOVED AD_GROUP_CRITERION_SERVING AD_GROUP_CRITERION_TO_BE_ACTIVATED AD_GROUP_CRITERION_UNDER_REVIEW UNKNOWN UNSPECIFIED
Digita un URL	`google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.final_url_suffix
Descrizione del campo	Modello di URL per l'aggiunta di parametri all'URL finale.
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.final_urls
Descrizione del campo	L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	True

ad_group_criterion.gender.type
Descrizione del campo	Tipo del genere.
Categoria	`ATTRIBUTE`
Tipo di dati	`ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED`
Digita un URL	`google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.keyword.match_type
Descrizione del campo	Il tipo di corrispondenza della parola chiave.
Categoria	`ATTRIBUTE`
Tipo di dati	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Digita un URL	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.keyword.text
Descrizione del campo	Il testo della parola chiave (massimo 80 caratteri e 10 parole).
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.labels
Descrizione del campo	I nomi delle risorse delle etichette associate a questo criterio del gruppo di annunci.
Categoria	`ATTRIBUTE`
Tipo di dati	`RESOURCE_NAME`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	True

ad_group_criterion.last_modified_time
Descrizione del campo	Data e ora dell'ultima modifica di questo criterio del gruppo di annunci. L'ora è espressa nel fuso orario del cliente e nel formato "aaaa-MM-gg HH:mm:ss.ssssss"
Categoria	`ATTRIBUTE`
Tipo di dati	`DATE`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.listing_group.type
Descrizione del campo	Tipo di gruppo di schede.
Categoria	`ATTRIBUTE`
Tipo di dati	`ENUM SUBDIVISION UNIT UNKNOWN UNSPECIFIED`
Digita un URL	`google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.location.geo_target_constant
Descrizione del campo	Il nome della risorsa costante del target geografico.
Categoria	`ATTRIBUTE`
Tipo di dati	`RESOURCE_NAME`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	False

ad_group_criterion.negative
Descrizione del campo	Indica se scegliere come target (`false`) o escludere (`true`) il criterio. Questo campo è immutabile. Per cambiare un criterio da positivo a negativo, rimuovilo e aggiungilo di nuovo.
Categoria	`ATTRIBUTE`
Tipo di dati	`BOOLEAN`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.position_estimates.top_of_page_cpc_micros
Descrizione del campo	La stima dell'offerta CPC necessaria per pubblicare l'annuncio nella parte superiore della prima pagina dei risultati di ricerca.
Categoria	`ATTRIBUTE`
Tipo di dati	`INT64`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.quality_info.quality_score
Descrizione del campo	Il punteggio di qualità. Questo campo potrebbe non essere compilato se Google non dispone di informazioni sufficienti per determinare un valore.
Categoria	`ATTRIBUTE`
Tipo di dati	`INT32`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.resource_name
Descrizione del campo	Il nome della risorsa del criterio del gruppo di annunci. I nomi delle risorse per i criteri dei gruppi di annunci hanno il seguente formato: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`
Categoria	`ATTRIBUTE`
Tipo di dati	`RESOURCE_NAME`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	False

ad_group_criterion.status
Descrizione del campo	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 alla pubblicazione. In alcuni casi, un criterio RIMOSSO nell'API può comunque essere visualizzato come attivato nell'interfaccia utente. Ad esempio, per impostazione predefinita le campagne vengono mostrate agli utenti di tutte le fasce d'età, a meno che non siano esclusi. Nell'interfaccia utente tutte le fasce d'età vengono mostrate come "attivate", in quanto queste sono idonee a visualizzare gli annunci, mentre GruppoAnnunci.AdsCriterion.status mostrerà "rimosso", in quanto non è stato aggiunto alcun criterio positivo.
Categoria	`ATTRIBUTE`
Tipo di dati	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
Digita un URL	`google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.tracking_url_template
Descrizione del campo	Il modello di URL per creare un URL di monitoraggio.
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.type
Descrizione del campo	Il tipo di criterio.
Categoria	`ATTRIBUTE`
Tipo di dati	ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO
Digita un URL	`google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.user_list.user_list
Descrizione del campo	Il nome della risorsa elenco utenti.
Categoria	`ATTRIBUTE`
Tipo di dati	`RESOURCE_NAME`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	False
Ripetuto	False

ad_group_criterion.webpage.conditions
Descrizione del campo	Condizioni, o espressioni logiche, per il targeting di pagine web. L'elenco di condizioni di targeting di pagine web viene combinato durante la valutazione per il targeting. Un elenco di condizioni vuoto indica che tutte le pagine del sito web della campagna sono scelte come target. Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.
Categoria	`ATTRIBUTE`
Tipo di dati	`MESSAGE`
Digita un URL	`google.ads.searchads360.v0.common.WebpageConditionInfo`
Filtrabile	False
Selezionabile	True
Sortable	False
Ripetuto	True

ad_group_criterion.webpage.coverage_percentage
Descrizione del campo	Percentuale di copertura dei criteri dei siti web. È la percentuale calcolata della copertura del sito web in base al target del sito web, al target del sito web escluso e alle parole chiave escluse nel gruppo di annunci e nella campagna. Ad esempio, quando la copertura restituisce 1, significa che ha una copertura al 100%. Questo campo è di sola lettura.
Categoria	`ATTRIBUTE`
Tipo di dati	`DOUBLE`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion.webpage.criterion_name
Descrizione del campo	Il nome del criterio definito da questo parametro. Il valore del nome verrà utilizzato per identificare, ordinare e filtrare i criteri con questo tipo di parametri. Questo campo è obbligatorio per le operazioni di CREATE ed è vietato nelle operazioni di UPDATE.
Categoria	`ATTRIBUTE`
Tipo di dati	`STRING`
Digita un URL	`N/A`
Filtrabile	True
Selezionabile	True
Sortable	True
Ripetuto	False

ad_group_criterion

ad_group_criterion.ad_group

ad_group_criterion.age_range.type

ad_group_criterion.bid_modifier

ad_group_criterion.cpc_bid_micros

ad_group_criterion.creation_time

ad_group_criterion.criterion_id

ad_group_criterion.effective_cpc_bid_micros

ad_group_criterion.engine_id

ad_group_criterion.engine_status

ad_group_criterion.final_url_suffix

ad_group_criterion.final_urls

ad_group_criterion.gender.type

ad_group_criterion.keyword.match_type

ad_group_criterion.keyword.text

ad_group_criterion.labels

ad_group_criterion.last_modified_time

ad_group_criterion.listing_group.type

ad_group_criterion.location.geo_target_constant

ad_group_criterion.negative

ad_group_criterion.position_estimates.top_of_page_cpc_micros

ad_group_criterion.quality_info.quality_score

ad_group_criterion.resource_name

ad_group_criterion.status

ad_group_criterion.tracking_url_template

ad_group_criterion.type

ad_group_criterion.user_list.user_list

ad_group_criterion.webpage.conditions

ad_group_criterion.webpage.coverage_percentage

ad_group_criterion.webpage.criterion_name