Experiment

Eksperyment Google Ads, w ramach którego użytkownicy mogą eksperymentować ze zmianami w wielu kampaniach, porównywać skuteczność i wprowadzać efektywne zmiany.

Zapis 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
}
Pola
resourceName

string

Stałe. Nazwa zasobu eksperymentu. Nazwy zasobów eksperymentu mają postać:

customers/{customerId}/experiments/{experimentId}

name

string

To pole jest wymagane. Nazwa eksperymentu. Musi mieć minimalną długość 1 i maksymalną 1024 znaki. Nie może się powtarzać w obrębie danego klienta.

description

string

Opis eksperymentu. Minimalna długość to 1 znaki, a maksymalna – 2048 znaków.

suffix

string

W przypadku eksperymentów zarządzanych przez system reklamodawca musi podać sufiks w trakcie tworzenia eksperymentu, na etapie konfiguracji, zanim zostanie on zainicjowany. Przyrostek zostanie dołączony do nazw kampanii w projekcie i kampanii eksperymentalnych, tak aby nazwa składała się z nazwy podstawowej kampanii i przyrostka.

type

enum (ExperimentType)

To pole jest wymagane. Usługa lub funkcja, która jest objęta tym eksperymentem.

status

enum (ExperimentStatus)

Stan wybranego przez reklamodawcę tego eksperymentu.

goals[]

object (MetricGoal)

Cele tego eksperymentu.

promoteStatus

enum (AsyncActionStatus)

Tylko dane wyjściowe. Stan procesu promowania eksperymentu.

experimentId

string (int64 format)

Tylko dane wyjściowe. Identyfikator eksperymentu. Tylko do odczytu.

startDate

string

Data rozpoczęcia eksperymentu. Domyślnie eksperyment rozpoczyna się teraz lub w dniu rozpoczęcia kampanii (w zależności od tego, co nastąpi później). Jeśli to pole jest skonfigurowane, eksperyment rozpoczyna się w określonym dniu w strefie czasowej klienta.

Format: RRRR-MM-DD Przykład: 2019-03-14

endDate

string

Data zakończenia eksperymentu. Domyślnie eksperyment kończy się w dniu zakończenia kampanii. Jeśli to pole jest skonfigurowane, eksperyment kończy się w określonym dniu w strefie czasowej klienta.

Format: RRRR-MM-DD Przykład: 2019-04-18

longRunningOperation

string

Tylko dane wyjściowe. Nazwa zasobu długo trwającej operacji, która może być używana do sondowania w celu ukończenia harmonogramu eksperymentu lub awansowania. Zwracana jest ostatnia długo trwająca operacja.

syncEnabled

boolean

Stałe. Ustaw wartość „true”, jeśli zmiany w kampaniach podstawowych mają być synchronizowane z kampaniami próbnymi. Wszelkie zmiany wprowadzone bezpośrednio w kampaniach próbnych zostaną zachowane. To pole można skonfigurować tylko podczas tworzenia eksperymentu.

ExperimentType

Typ eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
DISPLAY_AND_VIDEO_360 To jest eksperyment DISPLAY_AND_VIDEO_360.
AD_VARIATION To jest eksperyment dotyczący odmian reklamy.
YOUTUBE_CUSTOM Eksperyment niestandardowy składający się z kampanii wideo.
DISPLAY_CUSTOM Eksperyment niestandardowy składający się z kampanii w sieci reklamowej.
SEARCH_CUSTOM Eksperyment niestandardowy składający się z kampanii w sieci wyszukiwania.
DISPLAY_AUTOMATED_BIDDING_STRATEGY Eksperyment porównujący strategie ustalania stawek w kampaniach w sieci reklamowej.
SEARCH_AUTOMATED_BIDDING_STRATEGY Eksperyment porównujący strategie ustalania stawek w kampaniach w sieci wyszukiwania”.
SHOPPING_AUTOMATED_BIDDING_STRATEGY Eksperyment porównujący strategie ustalania stawek w kampaniach produktowych.
SMART_MATCHING WYCOFANY. Eksperyment dotyczący inteligentnego dopasowywania w kampaniach w sieci wyszukiwania.
HOTEL_CUSTOM Eksperyment niestandardowy składający się z kampanii reklam hoteli.

ExperimentStatus

Stan eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
ENABLED Eksperyment jest włączony.
REMOVED Eksperyment został usunięty.
HALTED Eksperyment został zatrzymany. Ten stan można ustawić jako WŁĄCZONO za pomocą interfejsu API.
PROMOTED Stan eksperymentu zostanie zmieniony na inny.
SETUP Początkowy stan eksperymentu.
INITIATED Kampanie eksperymentu oczekują na realizację. Ten stan można ustawić w interfejsie API w sekcji SKONFIGURACJA.
GRADUATED Eksperyment został zakończony.

MetricGoal

Cel danych eksperymentu.

Zapis JSON
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
Pola
metric

enum (ExperimentMetric)

Dane celu. Mogą to być na przykład kliknięcia, wyświetlenia, koszt, konwersje itp.

direction

enum (ExperimentMetricDirection)

Kierunek wskaźnika celu. Na przykład: wzrost, spadek, brak zmian.

ExperimentMetric

Typ danych eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
CLICKS Celem eksperymentu są kliknięcia.
IMPRESSIONS Celem eksperymentu jest liczba wyświetleń.
COST Celem eksperymentu jest koszt.
CONVERSIONS_PER_INTERACTION_RATE Celem eksperymentu jest współczynnik konwersji.
COST_PER_CONVERSION Celem eksperymentu jest koszt konwersji.
CONVERSIONS_VALUE_PER_COST Celem eksperymentu jest wartość konwersji/koszt.
AVERAGE_CPC Celem eksperymentu jest średni CPC.
CTR Celem eksperymentu jest CTR.
INCREMENTAL_CONVERSIONS Celem eksperymentu jest przyrostowe konwersje.
COMPLETED_VIDEO_VIEWS Celem eksperymentu jest pełne wyświetlenia filmów.
CUSTOM_ALGORITHMS Celem eksperymentu są niestandardowe algorytmy.
CONVERSIONS Celem eksperymentu są konwersje.
CONVERSION_VALUE Celem eksperymentu jest wartość konwersji.

ExperimentMetricDirection

Typ kierunku danych eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
NO_CHANGE Celem eksperymentu jest niezmiana danych.
INCREASE Celem eksperymentu jest utworzenie danych.
DECREASE Celem eksperymentu jest obniżenie tych danych.
NO_CHANGE_OR_INCREASE Celem eksperymentu jest nie zmiana ani zwiększenie wartości.
NO_CHANGE_OR_DECREASE Celem eksperymentu jest nie zmiana ani zmniejszenie wartości.

AsyncActionStatus

Stan działania asynchronicznego eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN Wartość jest nieznana w tej wersji.
NOT_STARTED Działanie się nie rozpoczęło.
IN_PROGRESS Działanie w toku.
COMPLETED Działanie zostało wykonane.
FAILED Nie udało się wykonać czynności.
COMPLETED_WITH_WARNING Działanie zostało wykonane, ale wystąpiły ostrzeżenia.