次の方法で共有

実験データ オブジェクト - キャンペーン管理

  • [アーティクル]

キャンペーンの予算とトラフィックを分割し、限られた期間に 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

Used By

AddExperiments
GetExperimentsByIds
UpdateExperiments