実験データ オブジェクト - キャンペーン管理
キャンペーンの予算とトラフィックを分割し、限られた期間に A/B テストを実行する実験を定義します。
注:
2023 年 2 月 1 日から、拡張テキスト広告は基本キャンペーンから実験キャンペーンにのみコピーできますが、拡張テキスト広告は編集できなくなります。 各広告グループに少なくとも 1 つの レスポンシブ検索広告 を作成してください。
別の入札戦略や異なる種類のターゲティングを使用すると、広告キャンペーンのパフォーマンスにどのような影響がありますか? それはより良い、悪い、または基本的に同じでしょうか? これで、A/B テストを実行して確認できます。
Microsoft Advertising の実験では、ベース キャンペーンの予算と広告トラフィックの分割を受け取る検索キャンペーンの複製を作成します。 基本キャンペーンごとに最大 10 個の非コンカレント実験を作成できます。 その後、次のことができます。
- 実験キャンペーンで変更を試す。
- 基本キャンペーンと比較して、実験キャンペーンのパフォーマンスを確認します。
- 実験の結果が必要な場合は、基本キャンペーンに変更を適用するか、新しいキャンペーン全体を作成します。
注:
実験は、動的検索広告の設定がない検索キャンペーンでのみ使用できます。 混合キャンペーンは、実験キャンペーンまたは実験の基本キャンペーンにすることはできません。
実験では、共有予算はサポートされていません。 キャンペーンで共有予算を使用する場合、それを実験の基本キャンペーンとして使用することはできません。
アカウントで実験を作成すると、新しい実験と新しいキャンペーンの両方が作成されます。 注目すべき詳細の一部を次に示します。
実験エンティティは、指定した BaseCampaignId、EndDate、Name、StartDate、TrafficSplitPercent を使用して作成されます。 実験 ExperimentStatus は Microsoft Advertising によって自動的に [作成] に設定され、次に実験を取得すると、その状態はアクティブ、作成、CreationFailed、Paused、または Scheduled になります。
実験 キャンペーン は、 基本キャンペーンのコピーとして作成されます。 広告グループ、広告、広告表示オプションの関連付け、ターゲット設定など、すべての基本キャンペーン設定が新しい実験キャンペーンにコピーされます。 この新しいキャンペーンのシステム識別子は、Experiment オブジェクトの ExperimentCampaignId 要素 (一括アップロード結果ファイルなど) を使用して取得できます。 基本キャンペーンから作成される実験キャンペーンの名前は実験名と一致し、その逆も同様です。 実験名が更新されると、実験キャンペーンの名前が自動的に一致するように更新されます。その逆も同様です。
注:
次のエンティティは、基本キャンペーンから実験キャンペーンにコピーされません。
- 期限切れの広告グループ(終了日が過ぎた場合)は、基本キャンペーンから実験キャンペーンにコピーされません。 実験が昇格され、実験キャンペーンの設定によって基本キャンペーンの設定が上書きされると、基本キャンペーンの期限切れの広告グループが削除されます。 同様に、実験キャンペーンの期限切れの広告グループは、プロモーション中に基本キャンペーンにコピーされません。
- ターゲット URL を持つキーワードは、基本キャンペーンから実験キャンペーンにコピーされません。 FinalUrls にアップグレードすることをお勧めしますが、ターゲット URL を持つキーワードが残っている場合は、実験キャンペーンでは使用されず、(実験が後で昇格された場合でも) 基本キャンペーンに残ります。
- 標準テキスト広告 (STA) は、基本キャンペーンから実験キャンペーンにコピーされません。 拡張テキスト広告にアップグレードすることをお勧めしますが、STA を引き続き使用している場合は、実験キャンペーンでは使用されず、(実験が後で促進された場合でも) 基本キャンペーンに残ります。
- 削除された市場内オーディエンスの対象ユーザーの関連付けは、最初は基本キャンペーンで使用できますが、実験キャンペーンにはコピーされません。 後で実験キャンペーンを宣伝する場合、基本キャンペーンでは実験キャンペーンのすべての設定が採用され、削除された市場内オーディエンスの対象ユーザーの関連付けが基本キャンペーンから削除されます。
Microsoft Advertising Web アプリケーションの [実験] タブでは、基本キャンペーンから実験キャンペーンにコピーされなかった項目の詳細な一覧を取得できます。 一覧は、一括アップロードの結果ファイル (実験キャンペーンにコピーされなかったアイテムのエラー レコード) として書式設定されます。 実験キャンペーンにコピーする必要があると思われるエラー レコードが見つかる場合は、詳細をサポートにお問い合わせください。
実験が作成されたら、 その EndDate、 Name、 StartDate、 TrafficSplitPercent を更新できます。 いくつかの例外があります。たとえば、 ExperimentStatus が アクティブ になった後に開始日を更新することはできません (開始日は既に到着しています)、 ExperimentStatus が 終了 (終了日が既に渡された) 後に終了日を更新することはできません。
実験キャンペーンを作成したら、キャンペーン の予算、 BudgetType、 状態、 タイムゾーンを除くすべての設定を更新できます。 実験キャンペーンの予算、状態、タイム ゾーンは、常に基本キャンペーン設定から継承されます。 実験の予算を変更する場合は、基本キャンペーンの予算を変更する必要があります。 値の変更は、実験 TrafficSplitPercent 設定に基づいて分割されます。 実験キャンペーンには、実験以外のキャンペーンに ExperimentId がない新しいプロパティが 1 つ含まれます。
ヒント
実験を作成した後、基本キャンペーンの設定に加えた変更 (予算と状態を除く) は実験に影響しません。 公平な比較を行うために、実験の実行中に基本キャンペーンの設定を変更しないことをお勧めします。
実験を EndDate で実行したり、一時的に一時停止したり、早い段階で実験を終了したりすることができます。 実験を一時停止するには、基本キャンペーンを一時停止する必要があります。 基本キャンペーンを一時停止すると、実験キャンペーンと実験自体も一時停止されます。 実験を早期に終了するには、 実験 ExperimentStatus を [終了] に設定します。 実験を終了すると、実験キャンペーンは一時停止されます。 実験が終了すると、再起動できません。 後で終了した実験を昇格、卒業、または削除できます。
実験から学んだことを使用するには、いくつかのオプションがあります。
- 基本キャンペーンに実験キャンペーンのすべての設定を採用させることができます。つまり、 ExperimentStatus を [昇格済み] に設定します。 実験キャンペーンの設定とエンティティがベース キャンペーンにコピーされ、実験キャンペーンが一時停止されます。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持ちます。 元のシステム識別子は、可能な限り保持されます。 実験キャンペーンの作成後に基本キャンペーンから広告グループを削除した場合など、いくつかの例外が発生する可能性があります。 実験中に基本キャンペーンの設定が変更された場合 (たとえば、新しい広告グループは実質的に削除されます)。
- 実験は、独自の予算と広告トラフィックを使用して独立したキャンペーンとして卒業できます。つまり、 ExperimentStatus を Graduated に設定します。 基本キャンペーンは元の予算とトラフィックの 100% を再び持ち、段階的なキャンペーン (以前は実験キャンペーン) は基本キャンペーンと同じ予算で開始されます。
- すべての実験キャンペーン設定を使用する代わりに、実験キャンペーン設定のサブセットを基本キャンペーンにマージすることができます。
実験を削除すると、実験キャンペーンも削除され、その逆も削除されます。ただし、基本キャンペーンは削除されません。 基本キャンペーンを削除すると、関連するすべての実験と実験キャンペーンも削除されます。
構文
<xs:complexType name="Experiment" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="BaseCampaignId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="ExperimentCampaignId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="ExperimentStatus" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="ExperimentType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="TrafficSplitPercent" nillable="true" type="xs:int" />
</xs:sequence>
</xs:complexType>
要素
Experiment オブジェクトには、BaseCampaignId、EndDate、ExperimentCampaignId、ExperimentStatus、ExperimentType、Id、Name、StartDate、TrafficSplitPercent の各要素があります。
要素 | 説明 | データ型 |
---|---|---|
BaseCampaignId | 実験キャンペーンのベースとして使用されるキャンペーンの Microsoft Advertising 識別子。 基本キャンペーンごとに最大 10 個の非コンカレント実験を作成できます。 つまり、同じ基本キャンペーンに対する複数の実験で、時間間隔を重複させることはできません。 実験は検索キャンペーンでのみ使用できます。 キャンペーンで共有予算が使用されている場合、それを実験の基本キャンペーンとして使用することはできません。 追加: 読み取り専用と必須。 更新: 読み 取り 専用。 実験の基本キャンペーンを変更することはできません。 |
long |
EndDate | 実験の有効期限が切れる日付。 終了日を指定しない場合、広告の有効期限は切れなくなります。 終了日が過ぎると、終了日を延長できません。 終了日は包括的です。 たとえば、終了日を 2020 年 12 月 31 日に設定した場合、実験は 2020 年 12 月 31 日午後 11 時 59 分に終了します。 時間は、 基本キャンペーン のタイム ゾーンを基準としています。 追加: オプション。 この要素を nil のままにするか空にした場合、実験の有効期限が切れるのは、さらにアクションを実行するまでです (例: 実験の 状態 を [終了] に設定します)。 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 現在の終了日を削除し、実質的に終了日を設定しない場合は、 日、 月、 年 をそれぞれ '0' (ゼロ) に設定します。 次回実験を取得する場合、この要素は設定されません。 |
Date |
ExperimentCampaignId | 基本キャンペーンのコピーとして作成される キャンペーンの Microsoft Advertising 識別子。 広告グループ、広告、広告表示オプションの関連付け、ターゲット設定など、すべての基本キャンペーン設定が新しい実験キャンペーンにコピーされます。 実験キャンペーンを作成したら、キャンペーン の [予算]、[ BudgetType]、[ タイムゾーン] を除くすべての設定を更新できます。 実験キャンペーンの予算とタイム ゾーンは、常に基本キャンペーン設定から継承されます。 追加: 読み 取り 専用 更新: 読み 取り 専用 |
long |
ExperimentStatus | 実験の状態。 使用可能な状態の値については、以下の 解説 を参照してください。 追加: 必須。 状態を [アクティブ] に設定する必要があります。ただし、状態は Microsoft Advertising によって自動的に [作成中] に設定され、次に実験を取得すると、その状態は アクティブ、 作成、 CreationFailed、 Paused、または Scheduled のいずれかになります。 更新: 読み 取り 専用 |
string |
ExperimentType | 実験と元のキャンペーンの個々の顧客の広告をランダムに表示するか、一方または他方からのみ表示するかを決定します。 使用可能な値には、TrafficBased と CookieBased が含まれます。 TrafficBased: これは検索ベースのオプションとも呼ばれます。 ユーザーが検索するたびに、実験の広告または元のキャンペーンの広告がランダムに表示されます。 これは、個々の顧客が複数回検索した場合、両方のソースから広告を表示できることを意味します。 CookieBased: 個々のユーザーが検索する場合、実験または元のキャンペーンの広告が表示され、Cookie を使用して今後、このソースからの広告のみが表示されるようにします。 Cookie ベースのオプションには、考慮すべき重要なトレードオフがあります。一方では、個々の顧客が 1 つのソースまたは他のソースにのみ応答していることを確認しているため、より正確なデータが得られる場合があります。 一方、検索ベースのオプションよりも統計的に有意な比較データを構築するのに時間がかかる場合があります。 追加: オプション。 既定値は TrafficBased です。 更新: 読み 取り 専用。 実験の種類を更新することはできません。 |
string |
Id | 実験の一意の Microsoft Advertising 識別子。 追加: 読み 取り 専用 更新: 必須 |
long |
名前 | 実験の名前。 基本キャンペーンから作成される実験キャンペーンの名前は実験名と一致し、その逆も同様です。 実験名が更新されると、実験キャンペーンの名前が自動的に一致するように更新されます。その逆も同様です。 名前は、アカウント内のすべてのキャンペーンと実験の間で一意 (大文字と小文字を区別しない) である必要があります。 名前には最大 128 文字を使用することができます。 追加: 必須 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
string |
StartDate | 実験キャンペーンで広告の配信を開始できる日付。 実験が開始された後、つまり開始日が到着した後、開始日を更新することはできません。 開始日は包括的です。 たとえば、開始日を 2020 年 5 月 5 日に設定した場合、実験は 2020 年 5 月 5 日の午前 12 時 00 分に開始されます。 時間は、 基本キャンペーン のタイム ゾーンを基準としています。 追加: 必須 更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 |
Date |
TrafficSplitPercent | この実験に割り当てる基本キャンペーンの予算と広告トラフィックの割合。 広告トラフィックは、個々の検索に基づいて実験と基本キャンペーンの間で分割されます。 関連する検索では、実験の広告または基本キャンペーンの広告がランダムに表示されます。 これは、個々の顧客が複数回検索した場合、両方のソースから広告を表示できることを意味します。 指定できる値の範囲は 1 ~ 99 です。 追加: 必須 更新: 読み 取り 専用。 実験の実行中に分割を変更することはできません。 |
int |
注釈
考えられる実験状態の値を次の表に示します。
状態 | 説明 |
---|---|
アクティブ | 実験キャンペーンは広告を配信する資格があります。 実験 StartDate が到着し、 EndDate がまだ渡されていません。 |
作成 | 実験が作成され、実験キャンペーンはまだ作成されています。 |
CreationFailed | 実験は作成されましたが、実験キャンペーンを作成できませんでした。 作成が失敗した場合、実験の状態は [削除済み] にのみ設定できます。 実験を削除し、新しい実験を作成する必要があります。 問題が解決しない場合は、サポートにお問い合わせください。 |
Deleted | 実験キャンペーンと実験キャンペーンが削除されました。 |
終了 | この実験では、広告を配信する資格がなくなりました。 EndDate が渡されたか、状態が直接 [終了] に設定されました。 |
卒業 | 実験は、独自の予算と広告トラフィックを含む独立したキャンペーンとして卒業されました。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持ち、段階的なキャンペーン (以前は実験キャンペーン) は基本キャンペーンと同じ予算で開始されました。 |
卒業 | 実験キャンペーンは、独自の予算と広告トラフィックを持つ独立したキャンペーンとして卒業されています。 正常に完了すると、状態は自動的に [卒業] に設定されます。 卒業が失敗した場合、何も変更されておらず、状態は Active に戻ります。 (サービスは内部の "GraduateFailed" 状態を返しません)。状態を [卒業] に設定してもう一度試すことができます。それでも実験の卒業が成功しない場合は、サポートにお問い合わせください。 |
一時停止 | 基本キャンペーンと実験キャンペーンは一時的に一時停止され、広告を配信することはできません。 実験 StartDate が到着し、 EndDate がまだ渡されていません。 基本キャンペーンが一時停止されると、実験キャンペーンと実験自体も一時停止されることに注意してください。 同様に、基本キャンペーンが未使用の場合、実験キャンペーンと実験自体は一度も使用されません。 実験が一度も実行されていないと、アクティブ状態またはスケジュールされた状態に移動します。 |
昇格 | 基本キャンペーンでは、実験キャンペーンのすべての設定が採用されました。 実験キャンペーンの設定とエンティティがベース キャンペーンにコピーされ、実験キャンペーンが一時停止されます。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持っています。 元のシステム識別子は、できるだけ保持する必要があります。 実験キャンペーンの作成後に基本キャンペーンから広告グループを削除した場合など、いくつかの例外が発生する可能性があります。 実験中に基本キャンペーン設定に対する変更 (たとえば、新しい広告グループ) が効果的に削除されました。 |
PromoteFailed | 実験キャンペーンの設定を基本キャンペーンに適用できませんでした。 状態を [昇格済み] に設定してもう一度試すことができます。PromoteFailed の状態が続く場合は、サポートにお問い合わせください。 |
推進 | 実験キャンペーンの設定が基本キャンペーンに適用されています。 正常に完了すると、状態は自動的に [昇格済み] に設定され、それ以外の場合は状態が PromoteFailed に設定されます。 昇格に失敗した場合、実験の状態は [削除済み] にのみ設定できます。 実験キャンペーンと実験キャンペーンを削除する前に、Microsoft Advertising Web アプリケーションや API を使用して、実験キャンペーンから基本キャンペーンに設定をコピーするかどうかを検討してください。 |
スケジュール済み | 実験キャンペーンが作成され、 StartDate が到着すると、実験の配信が開始される予定です。 |
要件
サービス: CampaignManagementService.svc v13
名前 空間: https://bingads.microsoft.com/CampaignManagement/v13