Experiment

Ein Google Ads-Test mit Nutzern, um Änderungen an mehreren Kampagnen zu testen, die Leistung zu vergleichen und die Änderungen anzuwenden

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 folgendes Format:

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

string

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

string

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

string

Bei vom System verwalteten Tests muss der Werbetreibende bei der Erstellung in der Einrichtungsphase ein Suffix angeben, bevor er mit dem Initiieren fortfahren kann. Das Suffix wird an die Namen der Kampagnen im Design 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 vom Werbetreibenden ausgewählte Status dieses Tests.
goals[]

object (MetricGoal)

Die Ziele dieses Tests.
promoteStatus

enum (AsyncActionStatus)

Nur Ausgabe. Der Status des Werbevorgangs 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 sofort oder am Startdatum der Kampagne – je nachdem, was später eintritt. Ist dieses Feld festgelegt, beginnt der Test am Anfang 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. Ist dieses Feld festgelegt, 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 zum Abfragen der Fertigstellung des Testzeitplans oder zum Hochstufen verwendet werden kann. Der letzte lang andauernde Vorgang wird zurückgegeben.
syncEnabled

boolean

Nicht veränderbar. Geben Sie „true“ an, wenn Änderungen an den Ausgangskampagnen mit den Testlauf-Kampagnen synchronisiert werden sollen. Alle Änderungen, die direkt an Testlauf-Kampagnen vorgenommen werden, bleiben erhalten. Dieses Feld kann nur beim Erstellen des Tests festgelegt werden.

ExperimentType

Die Art 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, der aus Videokampagnen besteht.
DISPLAY_CUSTOM Ein benutzerdefinierter Test mit Displaykampagnen.
SEARCH_CUSTOM Ein benutzerdefinierter Test mit Suchkampagnen.
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 vom Status AKTIVIERT geändert werden.
PROMOTED Das Experiment wird aus dem Teststatus hochgestuft.
SETUP Ursprünglicher Status des Tests.
INITIATED Die Kampagnen des Tests wurden noch nicht ausgeführt. Dieser Status kann über die API vom Status SETUP (Einrichtung) aus festgelegt werden.
GRADUATED Das Experiment wurde abgeschlossen.

MetricGoal

Ein metrisches Ziel für einen Test.

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

enum (ExperimentMetric)

Die Metrik des Ziels. Beispiele: Klicks, Impressionen, Kosten, Conversions usw.
direction

enum (ExperimentMetricDirection)

Die metrische Richtung des Ziels. Beispiele: Erhöhen, verringern, keine Änderung vornehmen.

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 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 Testziel ist der durchschnittliche CPC
CTR Das Testziel ist die CTR.
INCREMENTAL_CONVERSIONS Das Ziel des Tests sind zusätzliche Conversions.
COMPLETED_VIDEO_VIEWS Das Ziel des Tests sind abgeschlossene Videoaufrufe.
CUSTOM_ALGORITHMS Das Ziel des Tests sind benutzerdefinierte Algorithmen.
CONVERSIONS Das Zielvorhaben des Tests sind Conversions.
CONVERSION_VALUE Das Ziel des Tests ist der Conversion-Wert.

ExperimentMetricDirection

Der Typ der Richtung des Testmesswerts.

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

AsyncActionStatus

Der asynchrone Aktionsstatus 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 erfolgreich abgeschlossen.
FAILED Die Aktion ist fehlgeschlagen.
COMPLETED_WITH_WARNING Die Aktion wurde mit Warnungen abgeschlossen.