CampaignDraft

  • Campaign drafts have a unique resource name format that includes customer ID, base campaign ID, and draft ID.

  • The status of a campaign draft is read-only and defaults to PROPOSED upon creation.

  • Key identifying fields for a campaign draft include its read-only ID, the base campaign it belongs to, and a required name for creation.

  • The draft_campaign and has_experiment_running fields are read-only outputs indicating the resulting campaign and whether an experiment is active.

  • A long_running_operation field tracks the progress of draft promotion and is only present when promotion is in progress or completed.

A campaign draft.

Fields

resource_name

string

Immutable. The resource name of the campaign draft. Campaign draft resource names have the form:

customers/{customer_id}/campaignDrafts/{base_campaign_id}~{draft_id}

status

CampaignDraftStatus

Output only. The status of the campaign draft. This field is read-only.

When a new campaign draft is added, the status defaults to PROPOSED.

draft_id

int64

Output only. The ID of the draft.

This field is read-only.

base_campaign

string

Immutable. The base campaign to which the draft belongs.

name

string

The name of the campaign draft.

This field is required and should not be empty when creating new campaign drafts.

It must not contain any null (code point 0x0), NL line feed (code point 0xA) or carriage return (code point 0xD) characters.

draft_campaign

string

Output only. Resource name of the Campaign that results from overlaying the draft changes onto the base campaign.

This field is read-only.

has_experiment_running

bool

Output only. Whether there is an experiment based on this draft currently serving.

long_running_operation

string

Output only. The resource name of the long-running operation that can be used to poll for completion of draft promotion. This is only set if the draft promotion is in progress or finished.