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

キャンペーンの予算とトラフィックを分割し、限られた期間に A/B テストを実行する実験を定義します。

注:

2023 年 2 月 1 日から、拡張テキスト広告は基本キャンペーンから実験キャンペーンにのみコピーできますが、拡張テキスト広告は編集できなくなります。 各広告グループに少なくとも 1 つの レスポンシブ検索広告 を作成してください。

別の入札戦略や異なる種類のターゲティングを使用すると、広告キャンペーンのパフォーマンスにどのような影響がありますか? それはより良い、悪い、または基本的に同じでしょうか? これで、A/B テストを実行して確認できます。

Microsoft Advertising の実験では、ベース キャンペーンの予算と広告トラフィックの分割を受け取る検索キャンペーンの複製を作成します。 基本キャンペーンごとに最大 10 個の非コンカレント実験を作成できます。 その後、次のことができます。

  • 実験キャンペーンで変更を試す。
  • 基本キャンペーンと比較して、実験キャンペーンのパフォーマンスを確認します。
  • 実験の結果が必要な場合は、基本キャンペーンに変更を適用するか、新しいキャンペーン全体を作成します。

注:

実験は、動的検索広告の設定がない検索キャンペーンでのみ使用できます。 混合キャンペーンは、実験キャンペーンまたは実験の基本キャンペーンにすることはできません。

実験では、共有予算はサポートされていません。 キャンペーンで共有予算を使用する場合、それを実験の基本キャンペーンとして使用することはできません。

アカウントで実験を作成すると、新しい実験と新しいキャンペーンの両方が作成されます。 注目すべき詳細の一部を次に示します。

  • 実験エンティティは、指定した BaseCampaignIdEndDateNameStartDateTrafficSplitPercent を使用して作成されます。 実験 ExperimentStatus は Microsoft Advertising によって自動的に [作成] に設定され、次に実験を取得すると、その状態はアクティブ作成CreationFailedPaused、または Scheduled になります。

  • 実験 キャンペーン は、 基本キャンペーンのコピーとして作成されます。 広告グループ、広告、広告表示オプションの関連付け、ターゲット設定など、すべての基本キャンペーン設定が新しい実験キャンペーンにコピーされます。 この新しいキャンペーンのシステム識別子は、Experiment オブジェクトの ExperimentCampaignId 要素 (一括アップロード結果ファイルなど) を使用して取得できます。 基本キャンペーンから作成される実験キャンペーン名前は実験と一致し、その逆も同様です。 実験名が更新されると、実験キャンペーンの名前が自動的に一致するように更新されます。その逆も同様です。

    注:

    次のエンティティは、基本キャンペーンから実験キャンペーンにコピーされません。

    • 期限切れの広告グループ(終了日が過ぎた場合)は、基本キャンペーンから実験キャンペーンにコピーされません。 実験が昇格され、実験キャンペーンの設定によって基本キャンペーンの設定が上書きされると、基本キャンペーンの期限切れの広告グループが削除されます。 同様に、実験キャンペーンの期限切れの広告グループは、プロモーション中に基本キャンペーンにコピーされません。
    • ターゲット URL を持つキーワードは、基本キャンペーンから実験キャンペーンにコピーされません。 FinalUrls にアップグレードすることをお勧めしますが、ターゲット URL を持つキーワードが残っている場合は、実験キャンペーンでは使用されず、(実験が後で昇格された場合でも) 基本キャンペーンに残ります。
    • 標準テキスト広告 (STA) は、基本キャンペーンから実験キャンペーンにコピーされません。 拡張テキスト広告にアップグレードすることをお勧めしますが、STA を引き続き使用している場合は、実験キャンペーンでは使用されず、(実験が後で促進された場合でも) 基本キャンペーンに残ります。
    • 削除された市場内オーディエンスの対象ユーザーの関連付けは、最初は基本キャンペーンで使用できますが、実験キャンペーンにはコピーされません。 後で実験キャンペーンを宣伝する場合、基本キャンペーンでは実験キャンペーンのすべての設定が採用され、削除された市場内オーディエンスの対象ユーザーの関連付けが基本キャンペーンから削除されます。

    Microsoft Advertising Web アプリケーションの [実験] タブでは、基本キャンペーンから実験キャンペーンにコピーされなかった項目の詳細な一覧を取得できます。 一覧は、一括アップロードの結果ファイル (実験キャンペーンにコピーされなかったアイテムのエラー レコード) として書式設定されます。 実験キャンペーンにコピーする必要があると思われるエラー レコードが見つかる場合は、詳細をサポートにお問い合わせください。

実験が作成されたら、 その EndDateNameStartDateTrafficSplitPercent を更新できます。 いくつかの例外があります。たとえば、 ExperimentStatusアクティブ になった後に開始日を更新することはできません (開始日は既に到着しています)、 ExperimentStatus終了 (終了日が既に渡された) 後に終了日を更新することはできません。

実験キャンペーンを作成したら、キャンペーン の予算BudgetType状態タイムゾーンを除くすべての設定を更新できます。 実験キャンペーンの予算、状態、タイム ゾーンは、常に基本キャンペーン設定から継承されます。 実験の予算を変更する場合は、基本キャンペーンの予算を変更する必要があります。 値の変更は、実験 TrafficSplitPercent 設定に基づいて分割されます。 実験キャンペーンには、実験以外のキャンペーンに ExperimentId がない新しいプロパティが 1 つ含まれます。

ヒント

実験を作成した後、基本キャンペーンの設定に加えた変更 (予算と状態を除く) は実験に影響しません。 公平な比較を行うために、実験の実行中に基本キャンペーンの設定を変更しないことをお勧めします。

実験を EndDate で実行したり、一時的に一時停止したり、早い段階で実験を終了したりすることができます。 実験を一時停止するには、基本キャンペーンを一時停止する必要があります。 基本キャンペーンを一時停止すると、実験キャンペーンと実験自体も一時停止されます。 実験を早期に終了するには、 実験 ExperimentStatus[終了] に設定します。 実験を終了すると、実験キャンペーンは一時停止されます。 実験が終了すると、再起動できません。 後で終了した実験を昇格、卒業、または削除できます。

実験から学んだことを使用するには、いくつかのオプションがあります。

  • 基本キャンペーンに実験キャンペーンのすべての設定を採用させることができます。つまり、 ExperimentStatus[昇格済み] に設定します。 実験キャンペーンの設定とエンティティがベース キャンペーンにコピーされ、実験キャンペーンが一時停止されます。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持ちます。 元のシステム識別子は、可能な限り保持されます。 実験キャンペーンの作成後に基本キャンペーンから広告グループを削除した場合など、いくつかの例外が発生する可能性があります。 実験中に基本キャンペーンの設定が変更された場合 (たとえば、新しい広告グループは実質的に削除されます)。
  • 実験は、独自の予算と広告トラフィックを使用して独立したキャンペーンとして卒業できます。つまり、 ExperimentStatusGraduated に設定します。 基本キャンペーンは元の予算とトラフィックの 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 オブジェクトには、BaseCampaignIdEndDateExperimentCampaignIdExperimentStatusExperimentTypeIdNameStartDateTrafficSplitPercent の各要素があります。

要素 説明 データ型
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 によって自動的に [作成中] に設定され、次に実験を取得すると、その状態は アクティブ作成CreationFailedPaused、または 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