Experiment

Ein Google Ads-Test, bei dem Nutzer Änderungen an mehreren Kampagnen testen, die Leistung vergleichen und die effektiven Änderungen anwenden können

JSON-Darstellung 
{
  "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
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Tests. Namen von Testressourcen haben das folgende Format:

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

string

Erforderlich. Name des Tests. Sie muss zwischen 1 und 1.024 Zeichen lang sein. Sie muss für jeden Kunden eindeutig sein.
description

string

Die Beschreibung des Tests. Es muss zwischen 1 und 2.048 Zeichen lang sein.
suffix

string

Bei vom System verwalteten Tests muss der Werbetreibende bei der Erstellung, also in der Einrichtungsphase, ein Suffix angeben, bevor der Test gestartet wird. Das Suffix wird an die Namen der ursprünglichen und der Testkampagne angehängt, sodass der Name „Basiskampagnenname + Suffix“ lautet.
type

enum (ExperimentType)

Erforderlich. Das Produkt oder die Funktion, für die dieser Test verwendet wird.
status

enum (ExperimentStatus)

Der Status, den der Werbetreibende für diesen Test ausgewählt hat.
goals[]

object (MetricGoal)

Die Ziele dieses Tests.
promoteStatus

enum (AsyncActionStatus)

Nur Ausgabe Der Status des Werbeverfahrens für den Test.
experimentId

string (int64 format)

Nur Ausgabe Die ID des Tests. Schreibgeschützt.
startDate

string

Datum, an dem der Test beginnt. Standardmäßig beginnt der Test jetzt oder am Startdatum der Kampagne, je nachdem, was später eintritt. Wenn dieses Feld festgelegt wurde, beginnt der Test zu Beginn des angegebenen Datums in der Zeitzone des Kunden.

Format: JJJJ-MM-TT, Beispiel: 2019-03-14
endDate

string

Das Datum, an dem der Test endet. Standardmäßig endet der Test am Enddatum der Kampagne. Wenn dieses Feld festgelegt wurde, endet der Test am Ende des angegebenen Datums in der Zeitzone des Kunden.

Format: JJJJ-MM-TT, Beispiel: 2019-04-18
longRunningOperation

string

Nur Ausgabe Der Ressourcenname des Vorgangs mit langer Ausführungszeit, der verwendet werden kann, um den Abschluss des Testzeitplans abzufragen oder hochzustufen. Der letzte Vorgang mit langer Ausführungszeit wird zurückgegeben.
syncEnabled

boolean

Nicht veränderbar. Geben Sie „true“ an, wenn Änderungen an Ausgangskampagnen mit den Testkampagnen synchronisiert werden sollen. Alle direkt an Testlauf-Kampagnen vorgenommenen Änderungen bleiben erhalten. Dieses Feld kann nur festgelegt werden, wenn der Test erstellt wird.

ExperimentType

Der Typ des Tests.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
DISPLAY_AND_VIDEO_360 Dies ist ein DISPLAY_AND_VIDEO_360-Test.
AD_VARIATION Dies ist ein Test mit Anzeigenvariationen.
YOUTUBE_CUSTOM Ein benutzerdefinierter Test mit Videokampagnen
DISPLAY_CUSTOM Ein benutzerdefinierter Test mit Displaykampagnen
SEARCH_CUSTOM Ein benutzerdefinierter Test, der aus Suchkampagnen besteht.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Ein Test, bei dem Gebotsstrategien für Displaykampagnen verglichen werden.
SEARCH_AUTOMATED_BIDDING_STRATEGY Ein Test, bei dem Gebotsstrategien für Suchkampagnen verglichen werden.
SHOPPING_AUTOMATED_BIDDING_STRATEGY Ein Test, bei dem Gebotsstrategien für Shopping-Kampagnen verglichen werden
SMART_MATCHING VERWORFEN. Ein Smart-Matching-Test mit Suchkampagnen.
HOTEL_CUSTOM Ein benutzerdefinierter Test mit Hotelkampagnen

ExperimentStatus

Der Status des Tests.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
ENABLED Der Test ist aktiviert.
REMOVED Der Test wurde entfernt.
HALTED Der Test wurde angehalten. Dieser Status kann über die API auf "AKTIVIERT" gesetzt werden.
PROMOTED Der Test erhält den Status „Test“.
SETUP Ursprünglicher Status des Tests.
INITIATED Die Kampagnen des Tests wurden noch nicht materialisiert. Dieser Status kann über die API ab dem SETUP-Status festgelegt werden.
GRADUATED Das Experiment wurde hochgestuft.

MetricGoal

Ein metrisches Ziel für einen Test

JSON-Darstellung 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Felder
metric

enum (ExperimentMetric)

Die Metrik des Ziels. Dazu zählen beispielsweise Klicks, Impressionen, Kosten und Conversions.
direction

enum (ExperimentMetricDirection)

Die metrische Richtung des Ziels. Zum Beispiel: erhöhen, verringern, keine Änderung.

ExperimentMetric

Der Typ des Testmesswerts.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
CLICKS Das Ziel des Tests sind Klicks.
IMPRESSIONS Das Ziel des Tests sind Impressionen.
COST Das Ziel des Tests sind die Kosten.
CONVERSIONS_PER_INTERACTION_RATE Das Ziel des Tests ist die Conversion-Rate.
COST_PER_CONVERSION Das Ziel des Tests ist der Cost-per-Conversion.
CONVERSIONS_VALUE_PER_COST Das Ziel des Tests ist der Conversion-Wert pro Kosten.
AVERAGE_CPC Das Ziel des Tests ist der durchschnittliche CPC.
CTR Das Ziel des Tests ist CTR.
INCREMENTAL_CONVERSIONS Das Ziel des Tests ist eine Steigerung der Conversions.
COMPLETED_VIDEO_VIEWS Das Ziel des Tests sind Videoaufrufe.
CUSTOM_ALGORITHMS Das Ziel des Tests sind benutzerdefinierte Algorithmen.
CONVERSIONS Das Ziel des Tests sind Conversions.
CONVERSION_VALUE Das Ziel des Tests ist der Conversion-Wert.

ExperimentMetricDirection

Die Art der Richtung des Testmesswerts.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
NO_CHANGE Das Ziel des Tests ist es, den Messwert nicht zu ändern.
INCREASE Das Ziel des Tests ist es, den Messwert zu erstellen.
DECREASE Das Ziel des Tests ist es, den Messwert zu verringern.
NO_CHANGE_OR_INCREASE Ziel des Tests ist es, den Messwert entweder nicht zu ändern oder zu erhöhen.
NO_CHANGE_OR_DECREASE Ziel des Tests ist es, den Messwert entweder nicht zu ändern oder zu verringern.

AsyncActionStatus

Der Status der asynchronen Aktion des Tests.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Der Wert ist in dieser Version unbekannt.
NOT_STARTED Die Aktion wurde nicht gestartet.
IN_PROGRESS Aktion wird ausgeführt.
COMPLETED Aktion wurde abgeschlossen.
FAILED Die Aktion ist fehlgeschlagen.
COMPLETED_WITH_WARNING Aktion wurde mit Warnungen abgeschlossen.