Experiment

Un esperimento Google Ads che consente agli utenti di sperimentare le modifiche apportate a più campagne, confrontare il rendimento e applicare le modifiche effettive.

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,
  "syncEnabled": boolean
}
Campi
resourceName

string

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

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

string

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

string

La descrizione dell'esperimento. Deve avere una lunghezza minima di 1 e una lunghezza 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 quella iniziata. Il suffisso verrà aggiunto ai nomi delle campagne in-design e sperimentali in modo che il nome sia nome della campagna di base 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 della procedura 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 dell'evento che si verifica per ultimo. Se questo campo è impostato, l'esperimento inizia dall'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 è 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.
syncEnabled

boolean

Immutabile. Imposta il valore su true se le modifiche alle campagne di base devono essere sincronizzate con le campagne di prova. Eventuali modifiche apportate direttamente alle campagne di prova verranno mantenute. Questo campo può essere impostato solo durante la creazione dell'esperimento.

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 relativo alla 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 mette a confronto le strategie di offerta per le campagne display.
SEARCH_AUTOMATED_BIDDING_STRATEGY Un esperimento che mette a confronto le strategie di offerta per le campagne sulla rete di ricerca."
SHOPPING_AUTOMATED_BIDDING_STRATEGY Un esperimento che mette a confronto le strategie di offerta per le campagne Shopping.
SMART_MATCHING OBSOLETO. Un esperimento sulla 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 dallo stato ATTIVATO tramite l'API.
PROMOTED L'esperimento verrà escluso dallo stato sperimentale.
SETUP Stato iniziale dell'esperimento.
INITIATED Le campagne dell'esperimento sono in attesa di materializzazione. Questo stato può essere impostato dallo stato IMPOSTAZIONE tramite l'API.
GRADUATED L'esperimento è stato promosso.

MetricGoal

Un obiettivo di metrica 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 della metrica dell'obiettivo. Ad esempio, aumenta, diminuisci, nessuna variazione.

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 sono le visualizzazioni di video completate.
CUSTOM_ALGORITHMS L'obiettivo dell'esperimento sono 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 è creare la metrica.
DECREASE L'obiettivo dell'esperimento è ridurre la metrica.
NO_CHANGE_OR_INCREASE L'obiettivo dell'esperimento è non modificare né 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 è stata avviata.
IN_PROGRESS Azione in corso.
COMPLETED Azione completata.
FAILED Azione non riuscita.
COMPLETED_WITH_WARNING L'azione è stata completata correttamente con avvisi.