AdGroup

Un gruppo di annunci.

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)
  ],
  "primaryStatus": enum (AdGroupPrimaryStatus),
  "primaryStatusReasons": [
    enum (AdGroupPrimaryStatusReason)
  ],
  "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 un elemento 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 per le 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 campi relativi agli asset che devono essere esclusi da questo gruppo di annunci. I collegamenti 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 collegamenti agli insiemi di asset con questi tipi non verranno ereditati da questo gruppo di annunci dai livelli superiori. I tipi di gruppo di località (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP e STATIC_LOCATION_GROUP) sono tipi figlio di LOCATION_SYNC. Pertanto, se LOCATION_SYNC è impostato per questo campo, tutti gli insiemi di asset dei gruppi di località non possono essere collegati a questo gruppo di annunci e tutte le estensioni di località e le estensioni di località dell'affiliato non verranno pubblicate in questo gruppo di annunci. Al momento è supportato solo LOCATION_SYNC.
primaryStatus

enum (AdGroupPrimaryStatus)

Solo output. Fornisce una visualizzazione aggregata sul motivo per cui un gruppo di annunci non viene pubblicato o non viene pubblicato in modo ottimale.
primaryStatusReasons[]

enum (AdGroupPrimaryStatusReason)

Solo output. Indica i motivi per cui un gruppo di annunci non viene pubblicato o non viene pubblicato in modo ottimale.
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 quando crei 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 ritorni a capo (punto di codice 0xD).
baseAdGroup

string

Solo output. Per i gruppi di annunci in versione bozza o di prova, questo campo è il nome della risorsa del gruppo di annunci di base da cui è stato creato il gruppo di annunci. Se un gruppo di annunci provvisorio o di prova non ha un gruppo di annunci di base, il campo è nullo.

Per i gruppi di annunci di base, questo campo corrisponde al nome della risorsa del gruppo di annunci.

Questo campo è di sola lettura.
trackingUrlTemplate

string

Il modello di URL per creare 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 dell'offerta CPC (costo per clic) se la strategia di offerta prevede CPC manuale, CPC ottimizzato, pagina uno promossa 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 relativo 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)

Importo medio in micro che l'inserzionista è disposto a pagare per ogni mille visualizzazioni 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 Massimizza il valore di conversione (con il relativo campo targetRoas impostato), 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 l'aggiunta di 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

Gli stati possibili di un gruppo di annunci.

Enum
UNSPECIFIED Lo stato non è stato specificato.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

Questo è un valore solo risposta.
ENABLED Il gruppo di annunci è attivato.
PAUSED Il gruppo di annunci è in pausa.
REMOVED Il gruppo di annunci viene rimosso.

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 solo risposta.
OPTIMIZE Ottimizza gli annunci dei gruppi 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
useAudienceGrouped

boolean

Immutabile. Se è vero, questo gruppo di annunci utilizza una risorsa pubblico per il targeting per pubblico. Se il valore è falso, questo gruppo di annunci può utilizzare invece i criteri dei segmenti di pubblico.

AdGroupPrimaryStatus

I possibili stati di un gruppo di annunci.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
ELIGIBLE Il gruppo di annunci è idoneo alla pubblicazione.
PAUSED Il gruppo di annunci è in pausa.
REMOVED Il gruppo di annunci viene rimosso.
PENDING Il gruppo di annunci potrebbe essere pubblicato in futuro.
NOT_ELIGIBLE Il gruppo di annunci non è idoneo alla pubblicazione.
LIMITED La pubblicazione del gruppo di annunci è limitata.

AdGroupPrimaryStatusReason

Possibili motivi dello stato del gruppo di annunci.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
CAMPAIGN_REMOVED Lo stato della campagna specificato dall'utente viene rimosso. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
CAMPAIGN_PAUSED Lo stato della campagna specificato dall'utente è in pausa. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
CAMPAIGN_PENDING L'ora di inizio di questa campagna specificata dall'utente è nel futuro. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE
CAMPAIGN_ENDED Il tempo specificato dall'utente per la fine di questa campagna è trascorso. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
AD_GROUP_PAUSED Lo stato del gruppo di annunci specificato dall'utente è in pausa. Contribuisce a AirflowprincipaleStatus.PAUSED.
AD_GROUP_REMOVED Lo stato del gruppo di annunci specificato dall'utente viene rimosso. Contribuisce a GruppoAnnunciPrincipaleStatus.REMOVED.
AD_GROUP_INCOMPLETE La creazione di questo gruppo di annunci non è ancora completa. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
KEYWORDS_PAUSED Gli stati delle parole chiave specificati dall'utente in questo gruppo di annunci sono tutti in pausa. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
NO_KEYWORDS Non esistono parole chiave idonee in questo gruppo di annunci. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
AD_GROUP_ADS_PAUSED Gli stati degli annunci dei gruppi di annunci specificati dall'utente in questo gruppo di annunci sono tutti in pausa. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
NO_AD_GROUP_ADS Non sono presenti annunci di gruppo idonei in questo gruppo di annunci. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
HAS_ADS_DISAPPROVED Motivo dello stato secondo le norme quando almeno un annuncio non è stato approvato. Contribuisce a più GruppoAnnunciPrincipaleStatus.
HAS_ADS_LIMITED_BY_POLICY Motivo dello stato secondo le norme quando almeno un annuncio è limitato dalle norme. Contribuisce a più GruppoAnnunciPrincipaleStatus.
MOST_ADS_UNDER_REVIEW Motivo dello stato secondo le norme quando la maggior parte degli annunci è in attesa di revisione. Contribuisce a GruppoAnnunciPrincipaleStatus.PENDING.
CAMPAIGN_DRAFT Il gruppo di annunci appartiene a una bozza di campagna. Contribuisce a GruppoAnnunciPrincipaleStatus.NOT_ELIGIBLE.
AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY Il gruppo di annunci è stato messo in pausa a causa di una scarsa attività prolungata di pubblicazione. Contribuisce a AirflowprincipaleStatus.PAUSED.