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,
  "syncEnabled": boolean
}
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 lunghezza massima di 1024 caratteri. Deve essere univoco per il 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 in fase di creazione, prima di passare a quello avviato. Il suffisso verrà aggiunto ai nomi delle campagne in fase di progettazione e di esperimento in modo che il nome sia il nome di base della campagna + 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 è la successiva. Se questo campo viene impostato, l'esperimento inizia all'inizio della data specificata nel fuso orario del cliente.

Formato: AAAA-MM-GG Esempio: 14-03-2019
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: 18-04-2019
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 dell'esperimento o per la promozione. 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 di variante dell'annuncio.
YOUTUBE_CUSTOM Un esperimento personalizzato costituito da campagne video.
DISPLAY_CUSTOM Un esperimento personalizzato costituito da campagne display.
SEARCH_CUSTOM Un esperimento personalizzato costituito 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 sulla corrispondenza intelligente con le campagne sulla rete di ricerca.
HOTEL_CUSTOM Un esperimento personalizzato costituito 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 ABILITAZIONE tramite API.
PROMOTED L'esperimento verrà promosso fuori 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 di CONFIGURAZIONE 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, diminuisce, 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 è il completamento delle visualizzazioni di video.
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

La direzione della metrica del tipo di 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 è 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 Azione completata correttamente.
FAILED Azione non riuscita.
COMPLETED_WITH_WARNING L'azione è stata completata correttamente con avvisi.