Attenzione: stai visualizzando la documentazione per l'interfaccia REST dell'API. La maggior parte delle nostre librerie client ufficiali utilizza gRPC. Per informazioni dettagliate, consulta la Introduzione a REST.

Questa pagina è stata tradotta dall'API Cloud Translation.

AdGroup

Rappresentazione JSON
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- Rappresentazione JSON

Un gruppo di annunci.

Rappresentazione JSON

Rappresentazione JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Campi
`resourceName`	`string` Immutabile. Il nome della risorsa del gruppo di annunci. I nomi delle risorse dei gruppi di annunci hanno il seguente formato: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` Lo stato del gruppo di annunci.
`type`	`enum (AdGroupType)` Immutabile. Il tipo di gruppo di annunci.
`adRotationMode`	`enum (AdGroupAdRotationMode)` La modalità di rotazione degli annunci del gruppo di annunci.
`urlCustomParameters[]`	`object (CustomParameter)` L'elenco di mappature utilizzate per sostituire i tag di parametri personalizzati in `trackingUrlTemplate`, `finalUrls` o `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` True se il targeting ottimizzato è attivato. Il targeting ottimizzato sostituisce l'espansione del pubblico.
`displayCustomBidDimension`	`enum (TargetingDimension)` Consente agli inserzionisti di specificare una dimensione di targeting in base alla quale fare offerte assolute. Questo vale solo per le campagne che hanno come target solo la Rete Display e non la rete di ricerca.
`targetingSetting`	`object (TargetingSetting)` Impostazione per le funzionalità correlate al targeting.
`audienceSetting`	`object (AudienceSetting)` Immutabile. Impostazione delle funzionalità correlate al pubblico.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Solo output. Origine del CPA target effettivo. Questo campo è di sola lettura.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Solo output. Origine del ROAS target effettivo. Questo campo è di sola lettura.
`labels[]`	`string` Solo output. I nomi delle risorse delle etichette associate a questo gruppo di annunci.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` I tipi di campo degli asset che devono essere esclusi da questo gruppo di annunci. I link agli asset con questi tipi di campi non verranno ereditati da questo gruppo di annunci dai livelli superiori.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` I tipi di set di asset che devono essere esclusi da questo gruppo di annunci. I link agli insiemi di asset con questi tipi non verranno ereditati da questo gruppo di annunci dai livelli superiori. I tipi di gruppi di località (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) sono tipi secondari di LOCATION_SYNC. Pertanto, se per questo campo è impostata l'opzione LOCATION_SYNC, tutti gli insiemi di asset dei gruppi di località non possono essere collegati a questo gruppo di annunci e tutte le estensioni di località (LE) e le estensioni di località dell'affiliato (ALE) non verranno pubblicate in questo gruppo di annunci. Al momento è supportato solo LOCATION_SYNC.
`id`	`string (int64 format)` Solo output. L'ID del gruppo di annunci.
`name`	`string` Il nome del gruppo di annunci. Questo campo è obbligatorio e non deve essere vuoto durante la creazione di nuovi gruppi di annunci. Deve contenere meno di 255 caratteri a larghezza intera UTF-8. Non deve contenere caratteri null (punto di codice 0x0), avanzamento riga NL (punto di codice 0xA) o ritorno a capo (punto di codice 0xD).
`baseAdGroup`	`string` Solo output. Per i gruppi di annunci in versione bozza o sperimentale, questo campo è il nome risorsa del gruppo di annunci di base da cui è stato creato il gruppo di annunci. Se un gruppo di annunci in versione bozza o sperimentale non ha un gruppo di annunci di base, questo campo è nullo. Per i gruppi di annunci di base, questo campo equivale al nome della risorsa del gruppo di annunci. Questo campo è di sola lettura.
`trackingUrlTemplate`	`string` Il modello di URL per la creazione di un URL di monitoraggio.
`campaign`	`string` Immutabile. La campagna a cui appartiene il gruppo di annunci.
`cpcBidMicros`	`string (int64 format)` L'offerta CPC (costo per clic) massimo.
`effectiveCpcBidMicros`	`string (int64 format)` Solo output. Il valore sarà uguale a quello del valore dell'offerta CPC (costo per clic) se la strategia di offerta prevede CPC manuale, CPC ottimizzato, promozione della prima pagina o quota superamento target. In caso contrario, il valore sarà nullo.
`cpmBidMicros`	`string (int64 format)` L'offerta CPM (costo per mille impressioni visibili) massimo.
`targetCpaMicros`	`string (int64 format)` Il CPA (costo per acquisizione) target. Se la strategia di offerta della campagna del gruppo di annunci è Cpa target o Massimizza le conversioni (con il campo Cpa target impostato), questo campo sostituisce il CPA target specificato nella strategia di offerta della campagna. In caso contrario, questo valore viene ignorato.
`cpvBidMicros`	`string (int64 format)` L'offerta CPV (costo per visualizzazione).
`targetCpmMicros`	`string (int64 format)` L'importo medio in micro che l'inserzionista è disposto a pagare per ogni mille impressioni dell'annuncio.
`targetRoas`	`number` L'override del ROAS (ritorno sulla spesa pubblicitaria) target. Se la strategia di offerta della campagna del gruppo di annunci è TargetRoas o optimizeConversionValue (con il relativo campo targetRoas), questo campo sostituisce il ROAS target specificato nella strategia di offerta della campagna. In caso contrario, questo valore viene ignorato.
`percentCpcBidMicros`	`string (int64 format)` L'importo dell'offerta CPC percentuale, espresso come frazione del prezzo pubblicizzato per un bene o servizio. L'intervallo valido per la frazione è [0,1) e il valore memorizzato qui è 1.000.000 * [frazione].
`finalUrlSuffix`	`string` Modello di URL per aggiungere parametri all'URL finale.
`effectiveTargetCpaMicros`	`string (int64 format)` Solo output. Il CPA (costo per acquisizione) target effettivo. Questo campo è di sola lettura.
`effectiveTargetRoas`	`number` Solo output. Il ROAS (ritorno sulla spesa pubblicitaria) target effettivo. Questo campo è di sola lettura.

AdGroupStatus

I possibili stati di un gruppo di annunci.

Enum
`UNSPECIFIED`	Lo stato non è stato specificato.
`UNKNOWN`	Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
`ENABLED`	Il gruppo di annunci è attivato.
`PAUSED`	Il gruppo di annunci è in pausa.
`REMOVED`	Il gruppo di annunci viene rimosso.

AdGroupType

Enum che elenca i possibili tipi di un gruppo di annunci.

Enum
`UNSPECIFIED`	Il tipo non è stato specificato.
`UNKNOWN`	Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
`SEARCH_STANDARD`	Il tipo di gruppo di annunci predefinito per le campagne sulla rete di ricerca.
`DISPLAY_STANDARD`	Il tipo di gruppo di annunci predefinito per le campagne display.
`SHOPPING_PRODUCT_ADS`	Il tipo di gruppo di annunci per le campagne Shopping che pubblicano annunci di prodotto standard.
`HOTEL_ADS`	Il tipo di gruppo di annunci predefinito per le campagne per hotel.
`SHOPPING_SMART_ADS`	Il tipo di gruppi di annunci nelle campagne Shopping intelligenti.
`VIDEO_BUMPER`	Annunci video in-stream non ignorabili brevi.
`VIDEO_TRUE_VIEW_IN_STREAM`	Annunci video in-stream TrueView (ignorabili).
`VIDEO_TRUE_VIEW_IN_DISPLAY`	Annunci video TrueView in-display.
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Annunci video in-stream non ignorabili.
`VIDEO_OUTSTREAM`	Annunci video outstream.
`SEARCH_DYNAMIC_ADS`	Tipo di gruppo di annunci per i gruppi di annunci dinamici della rete di ricerca.
`SHOPPING_COMPARISON_LISTING_ADS`	Il tipo di gruppi di annunci nelle campagne di questo tipo.
`PROMOTED_HOTEL_ADS`	Il tipo di gruppo di annunci per i gruppi di annunci per hotel sponsorizzati.
`VIDEO_RESPONSIVE`	Gruppi di annunci adattabili video.
`VIDEO_EFFICIENT_REACH`	Gruppi di annunci per la copertura efficace dei video.
`SMART_CAMPAIGN_ADS`	Tipo di gruppo di annunci per le campagne intelligenti.
`TRAVEL_ADS`	Tipo di gruppo di annunci per le campagne per viaggi.

AdGroupAdRotationMode

Le possibili modalità di rotazione degli annunci di un gruppo di annunci.

Enum
`UNSPECIFIED`	La modalità di rotazione degli annunci non è stata specificata.
`UNKNOWN`	Il valore ricevuto non è noto in questa versione. Questo è un valore di sola risposta.
`OPTIMIZE`	Ottimizza gli annunci del gruppo di annunci in base ai clic o alle conversioni.
`ROTATE_FOREVER`	Ruota in modo uniforme all'infinito.

AudienceSetting

Impostazioni per il targeting per pubblico.

Rappresentazione JSON
{ "useAudienceGrouped": boolean }

Campi

Campi
`useAudienceGrouped`	`boolean` Immutabile. Se è vero, questo gruppo di annunci utilizza una risorsa pubblico per il targeting per pubblico. Se è falso, questo gruppo di annunci potrebbe utilizzare invece i criteri del segmento di pubblico.

useAudienceGrouped

boolean

Immutabile. Se è vero, questo gruppo di annunci utilizza una risorsa pubblico per il targeting per pubblico. Se è falso, questo gruppo di annunci potrebbe utilizzare invece i criteri del segmento di pubblico.