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
}
Felder
resourceName

string

Nicht veränderbar. Der Ressourcenname des Tests. Ressourcennamen für Tests haben das folgende Format:

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

string

Erforderlich. Name des Tests. Sie muss eine Mindestlänge von 1 und eine maximale Länge von 1.024 haben. Sie muss für jeden Kunden eindeutig sein.
description

string

Die Beschreibung des Tests. Sie muss eine Mindestlänge von 1 und eine maximale Länge von 2.048 haben.
suffix

string

Bei Tests, die vom System verwaltet werden, muss der Werbetreibende beim Erstellen ein Suffix angeben, also in der Einrichtungsphase, bevor der Test gestartet wird. Das Suffix wird an die Namen der In-Design- und Testkampagnen 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 „Vom Werbetreibenden ausgewählt“ für diesen Test.
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 ist, beginnt der Test am Anfang des angegebenen Datums in der Zeitzone des Kunden.

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

string

Datum, an dem der Test endet. Standardmäßig endet der Test am Enddatum der Kampagne. Wenn dieses Feld festgelegt ist, 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 lang andauernden Vorgangs, der verwendet werden kann, um den Abschluss des Testzeitplans abzufragen oder hochzustufen. Der letzte Vorgang mit langer Ausführungszeit wird zurückgegeben.

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, der aus Hotelkampagnen besteht.

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 Teststatus.
SETUP Ursprünglicher Status des Tests
INITIATED Die Materialisierung der Testkampagnen steht noch aus. Dieser Status kann über die API ab dem SETUP-Status festgelegt werden.
GRADUATED Der Test wurde ausgeweitet.

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 die Steigerung der Conversions.
COMPLETED_VIDEO_VIEWS Das Ziel des Tests sind vollständige 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 besteht darin, den Messwert zu erstellen.
DECREASE 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 Die Aktion wurde abgeschlossen.
FAILED Die Aktion ist fehlgeschlagen.
COMPLETED_WITH_WARNING Die Aktion wurde mit Warnungen abgeschlossen.