AdGroupCriterion

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

Rappresentazione JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Campi
resourceName

string

Immutabile. 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/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Solo output. Il nome visualizzato del criterio.

Questo campo viene ignorato per le modifiche.
status

enum (AdGroupCriterionStatus)

Lo stato del criterio.

Questo è lo stato dell'entità criterio del gruppo di annunci, impostato dal cliente. Nota: i report dell'interfaccia utente possono includere informazioni aggiuntive che influiscono sull'idoneità di un criterio 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.
qualityInfo

object (QualityInfo)

Solo output. Informazioni sulla qualità del criterio.
type

enum (CriterionType)

Solo output. Il tipo di criterio.
systemServingStatus

enum (CriterionSystemServingStatus)

Solo output. Stato di pubblicazione del criterio.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Solo output. Stato di approvazione del criterio.
disapprovalReasons[]

string

Solo output. Elenco dei motivi della mancata approvazione del criterio.

I diversi motivi per la mancata approvazione di un criterio sono disponibili qui: https://support.google.com/adspolicy/answer/6008942

Questo campo è di sola lettura.
labels[]

string

Solo output. I nomi delle risorse delle etichette associate a questo criterio del gruppo di annunci.
effectiveCpcBidSource

enum (BiddingSource)

Solo output. Origine dell'offerta CPC effettivo.
effectiveCpmBidSource

enum (BiddingSource)

Solo output. Origine dell'offerta CPM effettivo.
effectiveCpvBidSource

enum (BiddingSource)

Solo output. Origine dell'offerta basata su CPV effettivo.
effectivePercentCpcBidSource

enum (BiddingSource)

Solo output. Origine dell'offerta CPC percentuale effettiva.
positionEstimates

object (PositionEstimates)

Solo output. Stime per le offerte per criterio in varie posizioni.
finalUrls[]

string

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

string

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

object (CustomParameter)

L'elenco di mappature utilizzate per sostituire i tag di parametri personalizzati in un elemento trackingUrlTemplate, finalUrls o mobile_final_urls.
criterionId

string (int64 format)

Solo output. L'ID del criterio.

Questo campo viene ignorato per le modifiche.
adGroup

string

Immutabile. Il gruppo di annunci a cui appartiene il criterio.
negative

boolean

Immutabile. 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.
bidModifier

number

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

string (int64 format)

L'offerta CPC (costo per clic).
cpmBidMicros

string (int64 format)

L'offerta CPM (costo per mille impressioni visibili).
cpvBidMicros

string (int64 format)

L'offerta CPV (costo per visualizzazione).
percentCpcBidMicros

string (int64 format)

Importo dell'offerta CPC, 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].
effectiveCpcBidMicros

string (int64 format)

Solo output. L'offerta CPC (costo per clic) effettivo.
effectiveCpmBidMicros

string (int64 format)

Solo output. L'offerta CPM (costo per mille impressioni visibili) effettivo.
effectiveCpvBidMicros

string (int64 format)

Solo output. L'offerta CPV (costo per visualizzazione) effettivo.
effectivePercentCpcBidMicros

string (int64 format)

Solo output. L'importo dell'offerta CPC percentuale effettiva.
finalUrlSuffix

string

Modello di URL per l'aggiunta di parametri all'URL finale.
trackingUrlTemplate

string

Il modello di URL per creare un URL di monitoraggio.

Campo di unione criterion. Il criterio del gruppo di annunci.

Ne deve essere impostata una sola. criterion può essere solo uno dei seguenti:
keyword

object (KeywordInfo)

Immutabile. Parola chiave.
placement

object (PlacementInfo)

Immutabile. Posizionamento.
mobileAppCategory

object (MobileAppCategoryInfo)

Immutabile. Categoria di app mobile.
mobileApplication

object (MobileApplicationInfo)

Immutabile. App per dispositivi mobili.
listingGroup

object (ListingGroupInfo)

Immutabile. Gruppo di schede.
ageRange

object (AgeRangeInfo)

Immutabile. Fascia d'età.
gender

object (GenderInfo)

Immutabile. Genere.
incomeRange

object (IncomeRangeInfo)

Immutabile. Fascia di reddito.
parentalStatus

object (ParentalStatusInfo)

Immutabile. Stato parentale.
userList

object (UserListInfo)

Immutabile. Elenco utenti.
youtubeVideo

object (YouTubeVideoInfo)

Immutabile. Video di YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Immutabile. Canale YouTube.
topic

object (TopicInfo)

Immutabile. Argomento.
userInterest

object (UserInterestInfo)

Immutabile. Interesse degli utenti.
webpage

object (WebpageInfo)

Immutabile. Pagina web
appPaymentModel

object (AppPaymentModelInfo)

Immutabile. il modello di pagamento dell'app.
customAffinity

object (CustomAffinityInfo)

Immutabile. Affinità personalizzata.
customIntent

object (CustomIntentInfo)

Immutabile. Personalizzato per intenzione.
customAudience

object (CustomAudienceInfo)

Immutabile. Segmento di pubblico personalizzato.
combinedAudience

object (CombinedAudienceInfo)

Immutabile. Segmento di pubblico combinato.
audience

object (AudienceInfo)

Immutabile. Pubblico.
location

object (LocationInfo)

Immutabile. Posizione
language

object (LanguageInfo)

Immutabile. La lingua.

AdGroupCriterionStatus

Gli stati possibili di un criterio del gruppo di annunci.

Enum
UNSPECIFIED Non è stato specificato alcun valore.
UNKNOWN

Il valore ricevuto non è noto in questa versione.

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

QualityInfo

Un contenitore per le informazioni sulla qualità del criterio del gruppo di annunci.

Rappresentazione JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Campi
creativeQualityScore

enum (QualityScoreBucket)

Solo output. Il rendimento dell'annuncio rispetto a quello di altri inserzionisti.
postClickQualityScore

enum (QualityScoreBucket)

Solo output. Il punteggio di qualità della pagina di destinazione.
searchPredictedCtr

enum (QualityScoreBucket)

Solo output. La percentuale di clic rispetto a quella di altri inserzionisti.
qualityScore

integer

Solo output. Il punteggio di qualità.

Questo campo potrebbe non essere compilato se Google non dispone di informazioni sufficienti per determinare un valore.

CriterionSystemServingStatus

Enumera gli stati di pubblicazione del sistema di criteri.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
ELIGIBLE Idoneo.
RARELY_SERVED Basso volume di ricerca.

AdGroupCriterionApprovalStatus

Enumera gli stati di approvazione del criterio del gruppo di annunci.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
APPROVED Approvato.
DISAPPROVED Non approvato.
PENDING_REVIEW In attesa di revisione.
UNDER_REVIEW In corso di revisione.

PositionEstimates

Stime per le offerte per criterio in varie posizioni.

Rappresentazione JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Campi
firstPageCpcMicros

string (int64 format)

Solo output. La stima dell'offerta CPC necessaria per pubblicare l'annuncio sulla prima pagina dei risultati di ricerca.
firstPositionCpcMicros

string (int64 format)

Solo output. La stima dell'offerta CPC necessaria per pubblicare l'annuncio nella prima posizione, ossia nella parte superiore della prima pagina dei risultati di ricerca.
topOfPageCpcMicros

string (int64 format)

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

string (int64 format)

Solo output. Stima di quanti clic a settimana potresti ottenere modificando l'offerta per parola chiave impostandola sul valore in firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Solo output. Stima di come potrebbe variare il tuo costo settimanale quando modifichi l'offerta per parola chiave impostandola sul valore in firstPositionCpcMicros.

ListingGroupInfo

Un criterio del gruppo di schede.

Rappresentazione JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Campi
type

enum (ListingGroupType)

Tipo di gruppo di schede.
caseValue

object (ListingDimensionInfo)

Valore della dimensione con cui questo gruppo di schede sta perfezionando il relativo gruppo principale. Non definito per il gruppo principale.
parentAdGroupCriterion

string

Nome della risorsa del criterio del gruppo di annunci, che è la suddivisione del gruppo di schede principale. Null per il gruppo principale.
path

object (ListingDimensionPath)

Il percorso delle dimensioni che definiscono questo gruppo di schede.

ListingGroupType

Il tipo di gruppo di schede.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
SUBDIVISION Suddivisione dei prodotti in base ad alcune dimensioni della scheda. Questi nodi non vengono utilizzati per scegliere come target le voci dell'elenco, ma servono solo a definire la struttura della struttura ad albero.
UNIT Unità del gruppo di schede che definisce un'offerta.

ListingDimensionPath

Il percorso delle dimensioni che definiscono un gruppo di schede.

Rappresentazione JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Campi
dimensions[]

object (ListingDimensionInfo)

Il percorso completo delle dimensioni attraverso la gerarchia del gruppo di schede, dalla directory principale (esclusa la directory principale stessa) a questo gruppo di schede.

AppPaymentModelInfo

Un criterio del modello di pagamento delle app.

Rappresentazione JSON 
{
  "type": enum (AppPaymentModelType)
}
Campi
type

enum (AppPaymentModelType)

Tipo di modello di pagamento dell'app.

AppPaymentModelType

Enum che descrive i possibili modelli di pagamento delle app.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Utilizzato solo per il valore restituito. Rappresenta un valore sconosciuto in questa versione.
PAID Rappresenta le app a pagamento.

CustomIntentInfo

Un criterio personalizzato per intenzione. Un criterio di questo tipo può essere scelto come target solo.

Rappresentazione JSON 
{
  "customIntent": string
}
Campi
customIntent

string

Il nome della risorsa Custominterest.