Experiment

Un esperimento Google Ads per consentire agli utenti di sperimentare le modifiche su più campagne, confrontare il rendimento e applicare le modifiche efficaci.

Rappresentazione JSON 
{
  "resourceName": string,
  "name": string,
  "description": string,
  "suffix": string,
  "type": enum (ExperimentType),
  "status": enum (ExperimentStatus),
  "goals": [
    {
      object (MetricGoal)
    }
  ],
  "promoteStatus": enum (AsyncActionStatus),
  "experimentId": string,
  "startDate": string,
  "endDate": string,
  "longRunningOperation": string
}
Campi
resourceName

string

Immutabile. Il nome della risorsa dell'esperimento. I nomi delle risorse dell'esperimento hanno il seguente formato:

customers/{customerId}/experiments/{experimentId}
name

string

Obbligatorio. Il nome dell'esperimento. Deve avere una lunghezza minima di 1 e una massima di 1024. Deve essere univoco per il cliente.
description

string

La descrizione dell'esperimento. Deve avere una lunghezza minima di 1 e una massima di 2048.
suffix

string

Per gli esperimenti gestiti dal sistema, l'inserzionista deve fornire un suffisso durante la creazione, nella fase di configurazione prima di passare a quello avviato. Il suffisso verrà aggiunto ai nomi delle campagne sperimentali e di progettazione in modo che il nome sia il nome della campagna di base + il suffisso.
type

enum (ExperimentType)

Obbligatorio. Il prodotto/la funzionalità che utilizza questo esperimento.
status

enum (ExperimentStatus)

Lo stato scelto dall'inserzionista di questo esperimento.
goals[]

object (MetricGoal)

Gli obiettivi di questo esperimento.
promoteStatus

enum (AsyncActionStatus)

Solo output. Lo stato del processo di promozione dell'esperimento.
experimentId

string (int64 format)

Solo output. ID dell'esperimento. Sola lettura.
startDate

string

Data di inizio dell'esperimento. Per impostazione predefinita, l'esperimento inizia ora o alla data di inizio della campagna, a seconda di quale delle due date è più avanti nel tempo. Se questo campo è impostato, l'esperimento inizia all'inizio della data specificata nel fuso orario del cliente.

Formato: AAAA-MM-GG Esempio: 2019-03-14
endDate

string

Data di fine dell'esperimento. Per impostazione predefinita, l'esperimento termina alla data di fine della campagna. Se questo campo viene impostato, l'esperimento termina alla fine della data specificata nel fuso orario del cliente.

Formato: AAAA-MM-GG Esempio: 2019-04-18
longRunningOperation

string

Solo output. Il nome della risorsa dell'operazione a lunga esecuzione che può essere utilizzato per eseguire il polling per il completamento della pianificazione o la promozione dell'esperimento. Viene restituita l'operazione a lunga esecuzione più recente.

ExperimentType

Il tipo di esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
DISPLAY_AND_VIDEO_360 Questo è un esperimento DISPLAY_AND_VIDEO_360.
AD_VARIATION Questo è un esperimento con la variante dell'annuncio.
YOUTUBE_CUSTOM Un esperimento personalizzato composto da campagne video.
DISPLAY_CUSTOM Un esperimento personalizzato composto da campagne display.
SEARCH_CUSTOM Un esperimento personalizzato composto da campagne sulla rete di ricerca.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Un esperimento che confronta le strategie di offerta per le campagne display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un esperimento che confronta le strategie di offerta per le campagne sulla rete di ricerca."
SHOPPING_AUTOMATED_BIDDING_STRATEGY Un esperimento che confronta le strategie di offerta per le campagne Shopping.
SMART_MATCHING OBSOLETO. Un esperimento di corrispondenza intelligente con le campagne sulla rete di ricerca.
HOTEL_CUSTOM Un esperimento personalizzato composto da campagne per hotel.

ExperimentStatus

Lo stato dell'esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
ENABLED L'esperimento è attivato.
REMOVED L'esperimento è stato rimosso.
HALTED L'esperimento è stato interrotto. Questo stato può essere impostato da ENABLED - Stato tramite API.
PROMOTED L'esperimento non sarà più disponibile in fase sperimentale.
SETUP Stato iniziale dell'esperimento.
INITIATED Le campagne dell'esperimento sono in attesa di materializzazione. Questo stato può essere impostato dallo stato CONFIGURAZIONE tramite API.
GRADUATED L'esperimento è stato promosso.

MetricGoal

Un obiettivo per le metriche per un esperimento.

Rappresentazione JSON 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Campi
metric

enum (ExperimentMetric)

La metrica dell'obiettivo. Ad esempio, clic, impressioni, costo, conversioni e così via.
direction

enum (ExperimentMetricDirection)

La direzione dell'obiettivo in termini di metrica. Ad esempio, aumenta, diminuisci, nessun cambiamento.

ExperimentMetric

Il tipo di metrica dell'esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
CLICKS L'obiettivo dell'esperimento sono i clic.
IMPRESSIONS L'obiettivo dell'esperimento sono le impressioni.
COST L'obiettivo dell'esperimento è il costo.
CONVERSIONS_PER_INTERACTION_RATE L'obiettivo dell'esperimento è il tasso di conversione.
COST_PER_CONVERSION L'obiettivo dell'esperimento è il costo per conversione.
CONVERSIONS_VALUE_PER_COST L'obiettivo dell'esperimento è il valore di conversione per costo.
AVERAGE_CPC L'obiettivo dell'esperimento è il CPC medio.
CTR L'obiettivo dell'esperimento è il CTR
INCREMENTAL_CONVERSIONS L'obiettivo dell'esperimento sono le conversioni incrementali.
COMPLETED_VIDEO_VIEWS L'obiettivo dell'esperimento è rappresentato dalle visualizzazioni di video completate.
CUSTOM_ALGORITHMS L'obiettivo dell'esperimento sono gli algoritmi personalizzati.
CONVERSIONS L'obiettivo dell'esperimento sono le conversioni.
CONVERSION_VALUE L'obiettivo dell'esperimento è il valore di conversione.

ExperimentMetricDirection

Il tipo di direzione della metrica dell'esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
NO_CHANGE L'obiettivo dell'esperimento è non modificare la metrica.
INCREASE L'obiettivo dell'esperimento è increare la metrica.
DECREASE L'obiettivo dell'esperimento è diminuire la metrica.
NO_CHANGE_OR_INCREASE L'obiettivo dell'esperimento è non modificare o aumentare la metrica.
NO_CHANGE_OR_DECREASE L'obiettivo dell'esperimento è non modificare o diminuire la metrica.

AsyncActionStatus

Lo stato dell'azione asincrona dell'esperimento.

Enum
UNSPECIFIED Non specificato.
UNKNOWN Il valore è sconosciuto in questa versione.
NOT_STARTED L'azione non è iniziata.
IN_PROGRESS L'azione è in corso.
COMPLETED L'azione è stata completata correttamente.
FAILED Azione non riuscita.
COMPLETED_WITH_WARNING L'azione è stata completata correttamente con avvisi.