Experiment

یک آزمایش تبلیغات گوگل برای کاربران برای آزمایش تغییرات در چندین کمپین، مقایسه عملکرد و اعمال تغییرات موثر.

نمایندگی 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 و حداکثر طول 1024 داشته باشد. باید تحت نظر مشتری منحصر به فرد باشد.

description

string

شرح آزمایش. حداقل طول آن باید 1 و حداکثر طول 2048 باشد.

suffix

string

برای آزمایش‌های مدیریت‌شده سیستم، تبلیغ‌کننده باید پسوندی را در حین ساخت، در مرحله راه‌اندازی، قبل از انتقال به شروع، ارائه دهد. پسوند به نام‌های کمپین در طراحی و آزمایش الحاق می‌شود تا نام، نام کمپین پایه + پسوند باشد.

type

enum ( ExperimentType )

ضروری. محصول/ویژگی که از این آزمایش استفاده می کند.

status

enum ( ExperimentStatus )

وضعیت انتخاب شده توسط تبلیغ کننده برای این آزمایش.

goals[]

object ( MetricGoal )

اهداف این آزمایش

promoteStatus

enum ( AsyncActionStatus )

فقط خروجی وضعیت فرآیند ترویج آزمایش.

experimentId

string ( int64 format)

فقط خروجی شناسه آزمایش فقط خواندنی.

startDate

string

تاریخ شروع آزمایش به‌طور پیش‌فرض، آزمایش اکنون یا در تاریخ شروع کمپین، هر کدام که دیرتر باشد، شروع می‌شود. اگر این فیلد تنظیم شده باشد، آزمایش از ابتدای تاریخ مشخص شده در منطقه زمانی مشتری شروع می شود.

قالب: YYYY-MM-DD مثال: 2019-03-14

endDate

string

تاریخ پایان آزمایش به طور پیش فرض، آزمایش در تاریخ پایان کمپین به پایان می رسد. اگر این فیلد تنظیم شده باشد، آزمایش در پایان تاریخ مشخص شده در منطقه زمانی مشتری به پایان می رسد.

قالب: YYYY-MM-DD مثال: 2019-04-18

longRunningOperation

string

فقط خروجی نام منبع عملیات طولانی مدت که می تواند برای نظرسنجی برای تکمیل برنامه آزمایشی یا تبلیغ استفاده شود. آخرین عملیات طولانی مدت برگردانده شده است.

ExperimentType

نوع آزمایش.

Enums
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 منسوخ. یک آزمایش تطبیق هوشمند با کمپین های جستجو.
HOTEL_CUSTOM یک آزمایش سفارشی متشکل از کمپین های هتل.

وضعیت آزمایش

وضعیت آزمایش.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
ENABLED آزمایش فعال است.
REMOVED آزمایش حذف شده است.
HALTED آزمایش متوقف شده است. این وضعیت را می توان از وضعیت ENABLED از طریق API تنظیم کرد.
PROMOTED آزمایش از وضعیت آزمایشی ارتقاء خواهد یافت.
SETUP وضعیت اولیه آزمایش
INITIATED کمپین های آزمایش در انتظار تحقق هستند. این وضعیت را می توان از وضعیت SETUP از طریق API تنظیم کرد.
GRADUATED آزمایش فارغ التحصیل شده است.

MetricGoal

یک هدف متریک برای یک آزمایش.

نمایندگی JSON
{
  "metric": enum (ExperimentMetric),
  "direction": enum (ExperimentMetricDirection)
}
زمینه های
metric

enum ( ExperimentMetric )

معیار هدف. به عنوان مثال، کلیک ها، نمایش ها، هزینه ها، تبدیل ها و غیره.

direction

enum ( ExperimentMetricDirection )

جهت متریک هدف. مثلاً افزایش، کاهش، بدون تغییر.

ExperimentMetric

نوع متریک آزمایش

Enums
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

نوع جهت متریک آزمایش.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
NO_CHANGE هدف آزمایش عدم تغییر متریک است.
INCREASE هدف آزمایش ایجاد متریک است.
DECREASE هدف آزمایش کاهش متریک است.
NO_CHANGE_OR_INCREASE هدف آزمایش تغییر نکردن یا افزایش متریک است.
NO_CHANGE_OR_DECREASE هدف آزمایش تغییر نکردن یا کاهش متریک است.

AsyncActionStatus

وضعیت عملکرد ناهمگام آزمایش.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
NOT_STARTED اقدام شروع نشده است.
IN_PROGRESS اقدام در حال انجام است.
COMPLETED اقدام با موفقیت انجام شد.
FAILED اقدام شکست خورده است.
COMPLETED_WITH_WARNING اقدام با اخطارها با موفقیت انجام شد.