実験レコード - 一括

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

実験では、キャンペーンの予算とトラフィックを分割し、限られた期間に 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
• 終了日
• 実験キャンペーン ID
• 実験の種類
• クライアント ID
• Id
• 変更時刻
• 名前
• 開始日
• 状態
• トラフィック分割率

基本キャンペーン 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) です。

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

名前

実験の名前。

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

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

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

開始日

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

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

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

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

状態

実験の状態。

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

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

トラフィック分割率

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

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

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

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