Experiment

사용자가 여러 캠페인의 변경사항을 실험하고 실적을 비교하고 효과적인 변경사항을 적용할 수 있는 Google Ads 실험입니다.

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
}
필드
resourceName

string

변경할 수 없습니다. 실험의 리소스 이름입니다. 실험 리소스 이름의 형식은 다음과 같습니다.

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

string

필수 항목입니다. 실험의 이름입니다. 길이는 1~1,024자여야 합니다. 고객별로 고유해야 합니다.
description

string

실험에 대한 설명입니다. 길이는 1~2,048자여야 합니다.
suffix

string

시스템 관리 실험의 경우 광고주는 시작 단계로 이동하기 전에 구성 단계에서 접미사를 제공해야 합니다. 이 접미사는 설계 내 캠페인 및 실험 캠페인 이름에 추가되어 기본 캠페인 이름과 접미사 이름이 됩니다.
type

enum (ExperimentType)

필수 항목입니다. 이 실험을 사용하는 제품/기능입니다.
status

enum (ExperimentStatus)

광고주가 선택한 실험의 상태입니다.
goals[]

object (MetricGoal)

실험의 목표입니다.
promoteStatus

enum (AsyncActionStatus)

출력 전용. 실험 프로모션 프로세스의 상태입니다.
experimentId

string (int64 format)

출력 전용. 실험의 ID입니다. 읽기 전용입니다.
startDate

string

실험이 시작되는 날짜입니다. 기본적으로 실험은 지금 시작되거나 캠페인 시작일 중 더 늦은 날짜에 시작됩니다. 이 필드가 설정되면 고객의 시간대에서 지정된 날짜의 시작 부분에 실험이 시작됩니다.

형식: YYYY-MM-DD(예: 2019-03-14)
endDate

string

실험이 종료되는 날짜입니다. 기본적으로 실험은 캠페인의 종료일에 종료됩니다. 이 필드가 설정되면 고객의 시간대에서 지정된 날짜가 지나면 실험이 종료됩니다.

형식: YYYY-MM-DD(예: 2019-04-18)
longRunningOperation

string

출력 전용. 실험 일정 완료 또는 승격 완료를 폴링하는 데 사용할 수 있는 장기 실행 작업의 리소스 이름입니다. 가장 최근의 장기 실행 작업이 반환됩니다.

ExperimentType

실험의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
DISPLAY_AND_VIDEO_360 DISPLAY_AND_VIDEO_360 실험입니다.
AD_VARIATION 유사 광고 실험입니다.
YOUTUBE_CUSTOM 동영상 캠페인으로 구성된 맞춤 실험
DISPLAY_CUSTOM 디스플레이 캠페인으로 구성된 맞춤 실험
SEARCH_CUSTOM 검색 캠페인으로 구성된 맞춤 실험
DISPLAY_AUTOMATED_BIDDING_STRATEGY 디스플레이 캠페인의 입찰 전략을 비교하는 실험입니다.
SEARCH_AUTOMATED_BIDDING_STRATEGY 검색 캠페인의 입찰 전략을 비교하는 실험입니다.
SHOPPING_AUTOMATED_BIDDING_STRATEGY 쇼핑 캠페인의 입찰 전략을 비교하는 실험입니다.
SMART_MATCHING DEPRECATED. 검색 캠페인을 사용한 스마트 검색 실험
HOTEL_CUSTOM 호텔 캠페인으로 구성된 맞춤 실험

ExperimentStatus

실험의 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
ENABLED 실험이 사용 설정되었습니다.
REMOVED 실험이 삭제되었습니다.
HALTED 실험이 중지되었습니다. 이 상태는 API를 통해 ENABLED 상태에서 설정할 수 있습니다.
PROMOTED 실험이 실험 상태에서 승격됩니다.
SETUP 실험의 초기 상태입니다.
INITIATED 실험의 캠페인이 구체화 대기 중입니다. 이 상태는 API를 통해 설정 상태에서 설정할 수 있습니다.
GRADUATED 실험이 종료되었습니다.

MetricGoal

실험의 측정항목 목표입니다.

JSON 표현 
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
필드
metric

enum (ExperimentMetric)

목표의 측정항목입니다. 예: 클릭수, 노출수, 비용, 전환수
direction

enum (ExperimentMetricDirection)

목표의 측정항목 방향입니다. 예: 증가, 감소, 변화 없음

ExperimentMetric

실험 측정항목의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
CLICKS 실험의 목표는 클릭수입니다.
IMPRESSIONS 실험의 목표는 노출수입니다.
COST 실험의 목표는 비용입니다.
CONVERSIONS_PER_INTERACTION_RATE 실험의 목표는 전환율입니다.
COST_PER_CONVERSION 실험의 목표는 전환당비용입니다.
CONVERSIONS_VALUE_PER_COST 실험의 목표는 비용당 전환 가치입니다.
AVERAGE_CPC 실험의 목표는 평균 CPC입니다.
CTR 실험의 목표는 CTR입니다.
INCREMENTAL_CONVERSIONS 실험의 목표는 전환수를 늘리는 것입니다.
COMPLETED_VIDEO_VIEWS 실험의 목표는 완료된 동영상 조회수입니다.
CUSTOM_ALGORITHMS 실험의 목표는 맞춤 알고리즘입니다.
CONVERSIONS 실험의 목표는 전환수입니다.
CONVERSION_VALUE 실험의 목표는 전환 가치입니다.

ExperimentMetricDirection

실험 측정항목의 방향 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
NO_CHANGE 실험의 목표는 측정항목을 변경하지 않는 것입니다.
INCREASE 실험의 목표는 측정항목을 생성하는 것입니다.
DECREASE 실험의 목표는 측정항목을 줄이는 것입니다.
NO_CHANGE_OR_INCREASE 실험의 목표는 측정항목을 변경하지 않거나 늘리는 것입니다.
NO_CHANGE_OR_DECREASE 실험의 목표는 측정항목을 변경하거나 낮추지 않는 것입니다.

AsyncActionStatus

실험의 비동기 작업 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 알 수 없는 값입니다.
NOT_STARTED 작업이 시작되지 않았습니다.
IN_PROGRESS 작업이 진행 중입니다.
COMPLETED 작업이 완료되었습니다.
FAILED 작업에 실패했습니다.
COMPLETED_WITH_WARNING 작업이 완료되었으나 경고가 발생했습니다.