次の方法で共有


実験レコード - 一括

一括ファイルでダウンロードできる実験を定義します。

注:

拡張テキスト広告を、2023 年 2 月 1 日までにレスポンシブ検索広告にアップグレードします。 この日付を過ぎると、新しいテキスト広告を作成したり、既存の拡張テキスト広告を編集したりできなくなります。 詳細については、「 レスポンシブ検索広告について」を参照してください。

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

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

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

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

注:

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

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

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

  • 実験エンティティは、指定した基本キャンペーン ID終了日名前開始日トラフィック分割率を使用して作成されます。 実験 の状態 は、Microsoft Advertising によって自動的に [作成] に設定され、次に実験をダウンロードすると、その状態は [アクティブ]、[ 作成]、[ CreationFailed]、[ 一時停止]、または [スケジュール済み] になります。

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

    注:

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

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

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

実験が作成されたら、その 終了日名前開始日トラフィック分割率を更新できます。 一部の例外があります。たとえば、 状態アクティブ になった後に開始日を更新することはできません (開始日は既に到着しています)、 Status終了 (終了日が既に経過した) 後に終了日を更新することはできません。

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

ヒント

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

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

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

  • 基本キャンペーンに実験キャンペーンのすべての設定を採用させることができます。つまり、[ 状態][昇格済み] に設定します。 実験キャンペーンの設定とエンティティがベース キャンペーンにコピーされ、実験キャンペーンが一時停止されます。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持ちます。 元のシステム識別子は、可能な限り保持されます。 実験キャンペーンの作成後に基本キャンペーンから広告グループを削除した場合など、いくつかの例外が発生する可能性があります。 実験中に基本キャンペーンの設定が変更された場合 (たとえば、新しい広告グループは実質的に削除されます)。
  • 独自の予算と広告トラフィックを使用して、独立したキャンペーンとして実験を卒業できます。つまり、[ 状態][卒業済み] に設定します。 基本キャンペーンは元の予算とトラフィックの 100% を再び持ち、段階的なキャンペーン (以前は実験キャンペーン) は基本キャンペーンと同じ予算で開始されます。
  • すべての実験キャンペーン設定を使用する代わりに、実験キャンペーン設定のサブセットを基本キャンペーンにマージすることができます。

実験を削除すると、実験キャンペーンも削除され、その逆も削除されます。ただし、基本キャンペーンは削除されません。 基本キャンペーンを削除すると、関連するすべての実験と実験キャンペーンも削除されます。

DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に実験DownloadEntity 値を含めることで、アカウント内のすべての実験レコードダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、新しい実験を追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Start Date, End Date,Name,Traffic Split Percent,Base Campaign Id,Experiment Campaign Id
Format Version,,,,,,,,6.0,,,
Experiment,Active,-20,,ClientIdGoesHere,11/12/2020,12/31/2021,My Campaign - Experiment,50,-111,

.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して、サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりに、 BulkExperiment オブジェクトをアップロードしてダウンロードする時間を節約できます。

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkExperiment
var bulkExperiment = new BulkExperiment
{  
    // Map properties in the Bulk file to the 
    // Experiment object of the Campaign Management service.
    Experiment = new Experiment
    {
        // 'Base Campaign Id' column header in the Bulk file
        BaseCampaignId = campaignIdKey,
        // 'End Date' column header in the Bulk file
        EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Experiment Campaign Id' column header in the Bulk file
        ExperimentCampaignId = null,
        // 'Status' column header in the Bulk file
        ExperimentStatus = "Active",
        // 'Id' column header in the Bulk file
        Id = experimentIdKey,
        // 'Name' column header in the Bulk file
        Name = "My Campaign - Experiment",
        // 'Start Date' column header in the Bulk file
        StartDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = DateTime.UtcNow.Month,
            Day = DateTime.UtcNow.Day,
            Year = DateTime.UtcNow.Year
        },
        // 'Traffic Split Percent' column header in the Bulk file
        TrafficSplitPercent = 50,
    },

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkExperiment);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

実験レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。

基本キャンペーン ID

実験キャンペーンのベースとして使用されるキャンペーンの Microsoft Advertising 識別子。

基本キャンペーンごとに最大 10 個の非コンカレント実験を作成できます。 つまり、同じ基本キャンペーンに対する複数の実験で、時間間隔を重複させることはできません。

注:

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

追加: 読み取り専用と必須。 既存のキャンペーン識別子を指定するか、親キャンペーン レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内に新しいキャンペーンの実験を作成する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新: 読み 取り 専用。 実験の基本キャンペーンを変更することはできません。
削除: 読み 取り 専用

クライアント ID

一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。

追加: オプション
更新: オプション
削除: 読み 取り 専用

終了日

実験の有効期限が切れる日付。

終了日を指定しない場合、広告の有効期限は切れなくなります。 終了日が過ぎると、終了日を延長できません。

終了日は包括的です。 たとえば、終了日を 2020 年 12 月 31 日に設定した場合、実験は 2020 年 12 月 31 日午後 11 時 59 分に終了します。 時間は、 基本キャンペーン のタイム ゾーンを基準としています。

追加: オプション。 この要素を nil のままにするか空にした場合、実験の有効期限が切れるのは、さらにアクションを実行するまでです (例: 実験の 状態[終了] に設定します)。
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 現在の終了日を削除し、実質的に終了日を設定しない場合は、このフィールドを delete_value 文字列に設定します。 次回実験を取得する場合、このフィールドは設定されません。
削除: 読み 取り 専用

実験キャンペーン ID

基本キャンペーンのコピーとして作成される キャンペーンの Microsoft Advertising 識別子。

広告グループ、広告、広告表示オプションの関連付け、ターゲット設定など、すべての基本キャンペーン設定が新しい実験キャンペーンにコピーされます。

実験キャンペーンを作成したら、キャンペーン の [予算] と [ 予算の種類] を除くすべての設定を更新できます。 実験キャンペーンの予算とタイム ゾーンは、常に基本キャンペーン設定から継承されます。

追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用

実験の種類

実験と元のキャンペーンの個々の顧客の広告をランダムに表示するか、一方または他方からのみ表示するかを決定します。

使用可能な値には、TrafficBased と CookieBased が含まれます。

TrafficBased: これは検索ベースのオプションとも呼ばれます。 ユーザーが検索するたびに、実験の広告または元のキャンペーンの広告がランダムに表示されます。 これは、個々の顧客が複数回検索した場合、両方のソースから広告を表示できることを意味します。

CookieBased: 個々のユーザーが検索する場合、実験または元のキャンペーンの広告が表示され、Cookie を使用して今後、このソースからの広告のみが表示されるようにします。 Cookie ベースのオプションには、考慮すべき重要なトレードオフがあります。一方では、個々の顧客が 1 つのソースまたは他のソースにのみ応答していることを確認しているため、より正確なデータが得られる場合があります。 一方、検索ベースのオプションよりも統計的に有意な比較データを構築するのに時間がかかる場合があります。

追加: オプション。 既定値は TrafficBased です。
更新: 読み 取り 専用。 実験の種類を更新することはできません。
削除: 読み 取り 専用

Id

実験のシステム生成識別子。

追加: 読み 取り 専用
更新: 読み取り専用と必須
削除: 読み取り専用と必須

変更時刻

エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。

注:

日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。

追加: 読み 取り 専用
更新: 読み 取り 専用
削除: 読み 取り 専用

名前

実験の名前。

基本キャンペーンから作成される実験キャンペーン名前は実験名と一致し、その逆も同様です。 実験名が更新されると、実験キャンペーンの名前が自動的に一致するように更新されます。その逆も同様です。

名前は、アカウント内のすべてのキャンペーンと実験の間で一意 (大文字と小文字を区別しない) である必要があります。 名前には最大 128 文字を使用することができます。

追加: 必須
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除: 読み 取り 専用

開始日

実験キャンペーンで広告の配信を開始できる日付。

実験が開始された後、つまり開始日が到着した後、開始日を更新することはできません。

開始日は包括的です。 たとえば、開始日を 2020 年 5 月 5 日に設定した場合、実験は 2020 年 5 月 5 日の午前 12 時 00 分に開始されます。 時間は、 基本キャンペーン のタイム ゾーンを基準としています。

追加: 必須
更新: オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 実験が開始された後、つまり開始日が到着した後、開始日を更新することはできません。
削除: 読み 取り 専用

状態

実験の状態。

使用可能な状態の値については、次の表を参照してください。

状態 説明
アクティブ 実験キャンペーンは広告を配信する資格があります。 実験の 開始日 が到着し、 終了日 がまだ渡されていません。
作成 実験が作成され、実験キャンペーンはまだ作成されています。
CreationFailed 実験は作成されましたが、実験キャンペーンを作成できませんでした。 作成が失敗した場合、実験の状態は [削除済み] にのみ設定できます。 実験を削除し、新しい実験を作成する必要があります。 問題が解決しない場合は、サポートにお問い合わせください。
Deleted 実験キャンペーンと実験キャンペーンが削除されました。
終了 この実験では、広告を配信する資格がなくなりました。 終了日が経過したか、状態が直接 [終了] に設定されました。
卒業 実験は、独自の予算と広告トラフィックを含む独立したキャンペーンとして卒業されました。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持ち、段階的なキャンペーン (以前は実験キャンペーン) は基本キャンペーンと同じ予算で開始されました。
卒業 実験キャンペーンは、独自の予算と広告トラフィックを持つ独立したキャンペーンとして卒業されています。 正常に完了すると、状態は自動的に [卒業] に設定されます。 卒業が失敗した場合、何も変更されておらず、状態は Active に戻ります。 (サービスは内部の "GraduateFailed" 状態を返しません)。状態を [卒業] に設定してもう一度試すことができます。それでも実験の卒業が成功しない場合は、サポートにお問い合わせください。
一時停止 基本キャンペーンと実験キャンペーンは一時的に一時停止され、広告を配信することはできません。 実験の 開始日 が到着し、 終了日 がまだ渡されていません。

基本キャンペーンが一時停止されると、実験キャンペーンと実験自体も一時停止されることに注意してください。 同様に、基本キャンペーンが未使用の場合、実験キャンペーンと実験自体は一度も使用されません。 実験が一度も実行されていないと、アクティブ状態またはスケジュールされた状態に移動します。
昇格 基本キャンペーンでは、実験キャンペーンのすべての設定が採用されました。 実験キャンペーンの設定とエンティティがベース キャンペーンにコピーされ、実験キャンペーンが一時停止されます。 基本キャンペーンは、元の予算とトラフィックの 100% を再び持っています。 元のシステム識別子は、できるだけ保持する必要があります。 実験キャンペーンの作成後に基本キャンペーンから広告グループを削除した場合など、いくつかの例外が発生する可能性があります。 実験中に基本キャンペーン設定に対する変更 (たとえば、新しい広告グループ) が効果的に削除されました。
PromoteFailed 実験キャンペーンの設定を基本キャンペーンに適用できませんでした。 状態を [昇格済み] に設定してもう一度試すことができます。PromoteFailed の状態が続く場合は、サポートにお問い合わせください。
推進 実験キャンペーンの設定が基本キャンペーンに適用されています。 正常に完了すると、状態は自動的に [昇格済み] に設定され、それ以外の場合は状態が PromoteFailed に設定されます。 昇格に失敗した場合、実験の状態は [削除済み] にのみ設定できます。 実験キャンペーンと実験キャンペーンを削除する前に、Microsoft Advertising Web アプリケーションや API を使用して、実験キャンペーンから基本キャンペーンに設定をコピーするかどうかを検討してください。
スケジュール済み 実験キャンペーンが作成され、開始日 が到着すると 、実験は広告の配信を開始するようにスケジュールされています。

追加: 必須。 状態を [アクティブ] に設定する必要があります。ただし、状態は Microsoft Advertising によって自動的に [作成中] に設定され、次に実験を取得すると、その状態は アクティブ作成CreationFailedPaused、または Scheduled のいずれかになります。
更新: 読み 取り 専用
削除: 必須。 [状態] を [削除済み] に設定する必要があります。

トラフィック分割率

この実験に割り当てる基本キャンペーンの予算と広告トラフィックの割合。

広告トラフィックは、個々の検索に基づいて実験と基本キャンペーンの間で分割されます。 関連する検索では、実験の広告または基本キャンペーンの広告がランダムに表示されます。 これは、個々の顧客が複数回検索した場合、両方のソースから広告を表示できることを意味します。

指定できる int 値の範囲は 1 ~ 99 です。

追加: 必須
更新: 読み 取り 専用。 実験の実行中に分割を変更することはできません。
削除: 読み 取り 専用