Experiment

Eksperyment Google Ads, na którym 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
}
Pola
resourceName

string

Niezmienne. Nazwa zasobu eksperymentu. Nazwy zasobów eksperymentu mają postać:

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

string

To pole jest wymagane. Nazwa eksperymentu. Minimalna długość to 1, a maksymalna 1024 znaki. Nie może się powtarzać w obrębie klienta.
description

string

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

string

W przypadku eksperymentów zarządzanych przez system reklamodawca musi podać sufiks podczas tworzenia eksperymentu, na etapie konfiguracji, zanim zostanie on przekształcony. 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 wykorzystuje ten eksperyment.
status

enum (ExperimentStatus)

Wybrany przez reklamodawcę stan 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ę od początku określonej daty w strefie czasowej klienta.

Format: RRRR-MM-DD. Przykład: 14.03.2019.
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ę o końcu w określonym dniu w strefie czasowej klienta.

Format: RRRR-MM-DD. Przykład: 18.04.2019.
longRunningOperation

string

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

ExperimentType

Typ eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN W tej wersji wartość jest nieznana.
DISPLAY_AND_VIDEO_360 To jest eksperyment DISPLAY_AND_VIDEO_360.
AD_VARIATION To jest eksperyment z 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 WYCOFANE. 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 W tej wersji wartość jest nieznana.
ENABLED Eksperyment jest włączony.
REMOVED Eksperyment został usunięty.
HALTED Eksperyment został wstrzymany. Ten stan można ustawić na poziomie WŁĄCZONE za pomocą interfejsu API.
PROMOTED Eksperyment zostanie wycofany ze stanu eksperymentu.
SETUP Początkowy stan eksperymentu.
INITIATED Kampanie eksperymentu oczekują na realizację. Ten stan można ustawić na poziomie konfiguracji za pomocą interfejsu API.
GRADUATED Eksperyment został przeprowadzony.

MetricGoal

Cel danych eksperymentu.

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

enum (ExperimentMetric)

Wartość celu. 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 W tej wersji wartość jest nieznana.
CLICKS Celem eksperymentu są kliknięcia.
IMPRESSIONS Celem eksperymentu są wyświetlenia.
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 zwiększenie liczby konwersji.
COMPLETED_VIDEO_VIEWS Celem eksperymentu jest uzyskanie pełnych wyświetleń filmów.
CUSTOM_ALGORITHMS Celem eksperymentu jest zastosowanie algorytmów niestandardowych.
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 W tej wersji wartość jest nieznana.
NO_CHANGE Celem eksperymentu jest niezmodyfikowanie tych danych.
INCREASE Celem eksperymentu jest utworzenie danych.
DECREASE Celem eksperymentu jest zmniejszenie wartości tego parametru.
NO_CHANGE_OR_INCREASE Celem eksperymentu jest niezmodyfikowanie lub zwiększenie tych danych.
NO_CHANGE_OR_DECREASE Celem eksperymentu jest niezmodyfikowanie lub zmniejszenie wartości.

AsyncActionStatus

Stan działania asynchronicznego eksperymentu.

Wartości w polu enum
UNSPECIFIED Nie określono.
UNKNOWN W tej wersji wartość jest nieznana.
NOT_STARTED Działanie nie zostało rozpoczęte.
IN_PROGRESS Działanie jest 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.