キャンペーン レコード - 一括

一括ファイルでアップロードおよびダウンロードできるキャンペーンを定義します。

アカウント内のすべてのキャンペーン レコードをダウンロードするには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求にキャンペーンの DownloadEntity 値を含めます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ダウンロードしたキャンペーン レコードにキーワードの関連性、ランディング ページの関連性、ランディング ページのユーザー エクスペリエンス、品質スコアの各フィールドを含めるには、QualityScoreData スコープも含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、1 つの検索キャンペーンを追加します。

Type,Status,Id,Parent Id,Campaign,Website,Client Id,Modified Time,Budget Id,Budget Name,Budget,Budget Type,Bid Adjustment,Name,Country Code,Store Id,Campaign Type,Language,Target Setting,Priority,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type,Domain Language,Source
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,,,
Campaign,Active,-111,0,Women's Shoes,,ClientIdGoesHere,,PacificTimeUSCanadaTijuana,,,50,DailyBudgetStandard,10,,,,Search,All,Audience,,,,{_promoCode}=PROMO1; {_season}=summer,EnhancedCpc,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaign
var bulkCampaign = new BulkCampaign
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // Campaign object of the Campaign Management service.
    Campaign = new Campaign
    {        
        // 'Ad Schedule Use Searcher Time Zone' column header in the Bulk file
        AdScheduleUseSearcherTimeZone = true,
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new EnhancedCpcBiddingScheme { },
        // 'Budget Id' column header in the Bulk file
        BudgetId = null,
        // 'Budget Type' column header in the Bulk file
        BudgetType = BudgetLimitType.DailyBudgetStandard,
        // 'Campaign Type' column header in the Bulk file
        CampaignType = CampaignType.Search,
        // 'Budget' column header in the Bulk file
        DailyBudget = 50,
        // 'Experiment Id' column header in the Bulk file
        ExperimentId = null,
        // 'Id' column header in the Bulk file
        Id = campaignIdKey,
        // 'Language' column header in the Bulk file
        Languages = new string[] { "All" },
        // 'Campaign' column header in the Bulk file
        Name = "Women's Shoes",
        // 'Bid Adjustment' column header in the Bulk file
        AudienceAdsBidAdjustment = 10,
        Settings = new Setting[] 
        {
            // 'Target Setting' column header in the Bulk file
            new TargetSetting
            {
                // Each target setting detail is delimited by a semicolon (;) in the Bulk file
                Details = new TargetSettingDetail[]
                {
                    new TargetSettingDetail
                    {
                        CriterionTypeGroup = CriterionTypeGroup.Audience,
                        TargetAndBid = false
                    }
                }
            }
        },
        // 'Status' column header in the Bulk file
        Status = CampaignStatus.Active,
        // 'Sub Type' column header in the Bulk file
        SubType = null,
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] 
            {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            },
        },
        // 'URL Expansion Opt Out' column header in the Bulk file
        UrlExpansionOptOut = false,
    },
};

uploadEntities.Add(bulkCampaign);

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

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

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

列ヘッダー	サポートされているキャンペーンの種類
自動生成されたイメージ資産のオプトアウト	パフォーマンス最大化
自動生成されたテキストアセットのオプトアウト	パフォーマンス最大化
自動アクション呼び出しのオプトアウト	検索
広告スケジュール Searcher タイム ゾーンを使用する	すべて
入札単価調整	すべて
入札戦略委員会	ホテル
入札戦略 ID	検索 ショッピング
入札戦略マニュアルCpc	Audience ホテル
入札戦略 MaxCpc	検索 ショッピング
入札戦略名	検索 ショッピング
入札戦略パーセントCpc	ホテル
入札戦略 TargetAdPosition	検索
入札戦略 TargetCostPerSale	パフォーマンス最大化 ショッピング
入札戦略ターゲットCpa	パフォーマンス最大化 検索
入札戦略ターゲットImpressionShare	検索
入札戦略 TargetRoas	パフォーマンス最大化 検索 ショッピング
入札戦略の種類	すべて
Budget	すべて
予算 ID	すべて
予算名	すべて
予算の種類	すべて
Campaign	すべて
キャンペーンの種類	すべて
クライアント ID	すべて
国コード	パフォーマンス最大化 ショッピング
免責事項広告が有効	検索
ドメイン言語	検索
動的な説明が有効	検索
実験 ID	検索
フィード ラベル	パフォーマンス最大化 検索
最終 URL サフィックス	すべて
Id	すべて
キーワードの関連性	すべて
ランディング ページの関連性	すべて
ランディング ページのユーザー エクスペリエンス	すべて
Language	すべて
LocalInventoryAdsEnabled	ショッピング
変更時刻	すべて
ページ フィード ID	パフォーマンス最大化 検索
Parent Id	すべて
優先度	パフォーマンス最大化 ショッピング
品質スコア	すべて
RSA 自動生成資産が有効	検索
Source	検索
状態	すべて
ストア ID	Audience パフォーマンス最大化 ショッピング
Sub Type	ショッピング
ターゲット設定	すべて
追跡テンプレート	すべて
URL 拡張オプトアウト	パフォーマンス最大化
Web サイト	検索

自動生成されたイメージ資産のオプトアウト

false の場合、イメージ資産が動的に生成されます。 true (オプトアウト) の場合、イメージ資産は動的に生成されません。 このフィールドは、パフォーマンスの上限キャンペーンにのみ適用されます。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値 false が設定されます。 このフィールドは、パフォーマンスの上限キャンペーンにのみ適用されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

自動生成されたテキストアセットのオプトアウト

false の場合、テキストアセットが動的に生成されます。 true (オプトアウト) の場合、テキストアセットは動的に生成されません。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値 false が設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

自動アクション呼び出しのオプトアウト

false の場合は、キャンペーンのマルチメディア広告に対してアクション呼び出しアセットが自動的に選択されます。 個々の広告の行動喚起設定は無視されます。 true (オプトアウト) の場合、アクションへの呼び出し資産は自動的に選択されません。 このフィールドは、検索キャンペーンにのみ適用されます。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値 false が設定されます。 このフィールドは、検索キャンペーンにのみ適用されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

広告スケジュール Searcher タイム ゾーンを使用する

広告を配信できる検索ユーザーのアカウント タイム ゾーンとタイム ゾーンのどちらを使用するかを指定します。

検索ユーザーのタイム ゾーンに広告を表示する場合は、このプロパティを TRUE に設定し、それ以外の場合は FALSE に設定 します。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値の FALSE が設定され、アカウントのタイム ゾーンが使用されます。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札単価調整

ベース広告グループまたはキーワードの入札単価を上回る、または下回るオーディエンス広告の入札単価を調整する割合です。

注:

このプロパティは、顧客が Microsoft Audience Network に対して有効になっている場合、検索キャンペーンで使用できます。 このプロパティは 、スマート ショッピング キャンペーンでは使用できません。

サポートされる値は、負の 100 (-100) から正の 900 (900) です。 入札単価調整を -100% に設定すると、このキャンペーンの対象ユーザー広告が表示されなくなります。

対象ユーザー広告の入札単価調整を行わない場合は、このフィールドをゼロ (0) に設定します。

追加： オプション。 このフィールドを設定しない場合は、システムの既定の入札単価調整が使用されます。 システムの既定の入札単価調整は現在 0 (0) であり、変更される可能性があります。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 このフィールドを delete_value に設定すると、実質的にシステムの既定の入札単価調整が使用されます。 システムの既定の入札単価調整は現在 0 (0) であり、変更される可能性があります。
削除： 読み 取り 専用

入札戦略委員会

1 滞在につき支払う手数料の金額。

[委員会] 入札戦略では、[入札戦略] [CommissionRate] フィールドを設定する必要があります。

詳細については、「 予算と入札戦略」を参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 削除： 読み 取り 専用

入札戦略 ID

このキャンペーンがアカウント内の他のキャンペーンと共有する 入札戦略 のシステム生成識別子。

フィールドが空の場合、キャンペーンはポートフォリオ入札戦略を使用していません。 フィールドが空ではなく、値が 0 より大きい場合、キャンペーンではポートフォリオ入札戦略が使用されます。 キャンペーンでポートフォリオ入札戦略を使用していて、独自の入札戦略を使用する場合は、このフィールドを "0" (ゼロ) に設定します。

注:

ポートフォリオの入札戦略は、 スマート ショッピング キャンペーンではサポートされていません。

追加： オプション。 既存の入札戦略識別子を指定するか、入札戦略レコードのId フィールドと等しい負の識別子を指定できます。 これは、同じ Bulk ファイル内の新しいキャンペーンに新しいポートフォリオ入札戦略を適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札戦略マニュアルCpc

広告グループとキーワードの入札単価を設定すると、Microsoft Advertising では毎回これらの入札が使用されます。

詳細については、「 予算と入札戦略」を参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 削除： 読み 取り 専用

入札戦略 MaxCpc

対応する入札戦略の種類で使用するクリックあたりの最大コスト。

このフィールドは、[ 入札戦略の種類 ] フィールドが MaxClicks、MaxConversions、TargetCpa、TargetImpressionShare、または TargetRoas に設定されている場合にのみ使用されます。それ以外の場合、このフィールドは無視されます。

詳細については、「 予算と入札戦略」を参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 削除： 読み 取り 専用

入札戦略名

入札戦略の名前。

フィールドが空の場合、キャンペーンはポートフォリオ入札戦略を使用していません。

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

入札戦略パーセントCpc

税金と料金を含む、1 泊あたりの合計ホテル価格の割合。

PercentCPC 入札戦略では、[入札戦略の割合][マックス][CPC] フィールドを設定する必要があります。

詳細については、「 予算と入札戦略」を参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 削除： 読み 取り 専用

入札戦略 TargetAdPosition

広告を表示するターゲット広告の位置。

このフィールドは、[ 入札戦略の種類 ] フィールドが [TargetImpressionShare] に設定されている場合にのみ使用されます。それ以外の場合、このフィールドは無視されます。

詳細については、「 予算と入札戦略」を参照してください。

追加：[入札戦略の種類] フィールドが [TargetImpressionShare] に設定されている場合は必須で、それ以外の場合、このフィールドは無視されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札戦略 TargetCostPerSale

Microsoft Advertising がコンバージョンを最大化するために使用する目標販売単価 (CPS)。

詳細については、「 予算と入札戦略」を参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。 削除： 読み 取り 専用

入札戦略ターゲットCpa

コンバージョンを最大化するために Microsoft Advertising で使用する目標取得単価 (CPA)。

パフォーマンス上限キャンペーンの場合、このフィールドは、[ 入札戦略の種類 ] フィールドが MaxConversion に設定されている場合にのみ使用されます。 他のすべてのキャンペーンでは、このフィールドは [ 入札戦略の種類 ] フィールドが TargetCpa に設定されている場合にのみ使用されます。 それ以外の場合、このフィールドは無視されます。

詳細については、「 予算と入札戦略」を参照してください。

追加：[入札戦略の種類] フィールドが [MaxConversion] に設定されている場合、パフォーマンスの最大キャンペーンでは省略可能です。 [ 入札戦略の種類 ] フィールドが [TargetCpa] に設定されている場合は、他のすべてのキャンペーンに必要です。 それ以外の場合、このフィールドは無視されます。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 削除： 読み 取り 専用

入札戦略ターゲットImpressionShare

広告を表示する広告の位置のターゲット インプレッション シェア。

このフィールドは、[ 入札戦略の種類 ] フィールドが [TargetImpressionShare] に設定されている場合にのみ使用されます。それ以外の場合、このフィールドは無視されます。

詳細については、「 予算と入札戦略」を参照してください。

追加：[入札戦略の種類] フィールドが [TargetImpressionShare] に設定されている場合は必須で、それ以外の場合、このフィールドは無視されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札戦略 TargetRoas

Microsoft Advertising がコンバージョンを最大化するために使用する広告費用 (ROAS) の目標収益率。

サポートされている目標 ROAS 値の範囲は、0.01 (1%) から 1,000.00 (100,000%) です。

パフォーマンスの上限キャンペーンの場合、このフィールドは、[入札戦略の 種類 ] フィールドが [MaxConversionValue] に設定されている場合にのみ使用されます。 他のすべてのキャンペーンでは、このフィールドは [ 入札戦略の種類 ] フィールドが [TargetRoas] に設定されている場合にのみ使用されます。 それ以外の場合、このフィールドは無視されます。

詳細については、「 予算と入札戦略」を参照してください。

追加： [ 入札戦略の種類 ] フィールドが [TargetRoas] に設定されている場合、パフォーマンスの上限キャンペーンでは省略可能です。 [ 入札戦略の種類 ] フィールドが [TargetRoas] に設定されている場合は、他のすべてのキャンペーンに必要です。 それ以外の場合、このフィールドは無視されます。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

入札戦略の種類

入札を管理する方法の入札戦略の種類。

考えられる入札戦略の種類の値は、Commission、EnhancedCpc、ManualCpc、MaxClicks、MaxConversions、PercentCpc、TargetCpa、TargetImpressionShare、TargetRoas です。 キャンペーンの種類ごとにサポートされている入札戦略の詳細については、「 予算と入札戦略」を参照してください。

重要

2024 年 5 月の時点で、対象ユーザーのネイティブ キャンペーンに対して手動の CPC 入札戦略を使用できなくなります。 手動クリック単価は、対象ユーザーの表示と動画のキャンペーンと、宿泊キャンペーンにのみ使用できます。 既存の手動 CPC オーディエンス ネイティブ キャンペーンは、拡張 CPC に自動的に変換されます。 他のキャンペーンタイプに対して手動のクリック単価を設定しようとすると、リクエストはエラーなしで無視され、入札戦略は拡張 CPC に設定されます。

2021 年 4 月の時点で、広告グループやキーワードに対して入札戦略を設定することはできません。 入札戦略はキャンペーン レベルでのみ設定できます。 広告グループまたはキーワードの入札戦略を設定しようとすると、要求はエラーなしで無視されます。 広告グループとキーワードは、キャンペーンの入札戦略を継承します。

[手数料] 入札戦略タイプを使用する場合は、必要に応じて [ 入札戦略委員会 ] フィールドを含めることができます。

"ManualCpc" 入札戦略タイプを使用する場合は、必要に応じて [ 入札戦略の手動][Cpc ] フィールドを含めることができます。

[MaxClicks] 入札戦略の種類を使用する場合は、必要に応じて [ 入札戦略の MaxCpc ] フィールドを含めることができます。

[MaxConversions] 入札戦略タイプを使用する場合は、必要に応じて [ 入札戦略の MaxCpc ] フィールドを含めることができます。

"PercentCpc" 入札戦略タイプを使用する場合は、必要に応じて [ 入札戦略のパーセント] フィールドを含めることができます。

[TargetCostPerSale] 入札戦略の種類を使用する場合は、必要に応じて [ 入札戦略のターゲット][コスト][PerSale ] フィールドを含めることができます。

[TargetCpa] 入札戦略タイプを使用する場合は、[ 入札戦略のターゲット][Cpa ] フィールドを含める必要があります。

[TargetImpressionShare] 入札戦略タイプを使用する場合は、[ 入札戦略のターゲット][AdPosition] フィールドと [ 入札戦略のターゲット][ImpressionShare ] フィールドを含める必要があります。 必要に応じて、[ 入札戦略の MaxCpc ] フィールドを含めることができます。

"TargetRoas" 入札戦略の種類を使用する場合は、[入札戦略のターゲット][ロア ] フィールドを含める必要があります。 必要に応じて、[ 入札戦略の MaxCpc ] フィールドを含めることができます。

重要

一部の入札戦略の種類では、入札単価と広告ローテーションの設定は無視され、コンバージョントラッキング ( ユニバーサル イベント トラッキング タグとコンバージョン目標を使用) が必要です。 サポートされている場所などの詳細については、「 Microsoft Advertising で入札戦略を使用して入札を管理できるようにする」を参照してください。

追加： オプション。 Search キャンペーンと DynamicSearchAds キャンペーンの既定値は EnhancedCpc です。 ほとんどのショッピング キャンペーンの既定の入札戦略の種類は EnhancedCpc です。ただし、 スマート ショッピング キャンペーン でサポートされている入札戦略の種類は MaxConversionValue のみです。 対象ユーザー キャンペーンでサポートされている値は ManualCpc のみです。 Performance Max キャンペーンの既定値は MaxConversions です。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 入札戦略の種類を更新すると、入札戦略の MaxCpc、入札戦略の TargetCpa、入札戦略の TargetAdPosition、入札戦略ターゲットImpressionShare、および [入札戦略ターゲット][ロアス] フィールドの既存の値が削除されます。
削除： 読み 取り 専用

Budget

キャンペーンの予算金額。

警告

予算はターゲットです。実際の支出が多いか低いかも知れません。 バリエーションは、さまざまな曜日のトラフィック量や、クリックから数時間以内にキャンペーンに返金できる詐欺クリックの自動検出と払い戻しなど、さまざまな要因によって発生します。 Microsoft Advertising は変動を予測して自動的に補正し、通常は 1 日の上限を 100% 未満に過大支出し続けます。

また、Microsoft Advertising では、キャンペーン予算が広告グループとキーワードの入札単価を上回る必要はありません。 つまり、広告グループとキーワードの入札は、キャンペーン予算とは無関係に検証されます。

共有予算のコンテキストでは、予算金額は、キャンペーンが共有予算を使用するかどうかに関係なく、常に返される読み取り専用プロパティです。 キャンペーンが共有予算に関連付けられている場合、返される金額は共有予算の金額になります。 キャンペーンで共有予算が使用されているかどうかを判断するには、[ 予算 ID ] フィールドの値を確認します。

実験キャンペーンでは、 予算、予算の 種類、または 状態を更新することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。

追加：予算 ID が設定されていない場合は必須です。 キャンペーンで共有予算が使用されている場合は、読み取り専用です。
更新：BudgetId が設定されていない場合は省略可能です。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンで共有予算を使用する場合は許可されません。 共有予算を持つキャンペーンの予算金額を更新しようとすると、Service は CampaignServiceCannotUpdateSharedBudget エラー コードを返します。
削除： 読み 取り 専用

予算 ID

このキャンペーンがアカウント内の他のキャンペーンと共有する 予算 のシステム生成識別子。

フィールドが空の場合、キャンペーンは共有予算を使用していません。 フィールドが空ではなく、値が 0 より大きい場合、キャンペーンでは共有予算が使用されます。 キャンペーンで共有予算を使用していて、独自の予算金額を使用する場合は、このフィールドを '0' (ゼロ) に設定し、[ 予算 ] フィールドを有効な予算金額に設定します。

注:

この値は、予算レコードの Id フィールドに対応します。

注:

共有予算はスマート ショッピング キャンペーンではサポートされていません。 スマート ショッピング キャンペーンでは、1 日の予算額を設定する必要があります。

追加： オプション。 既存の予算識別子を指定するか、予算レコードの Id フィールドと等しい負の識別子を指定できます。 これは、同じ Bulk ファイル内の新しいキャンペーンに新しい共有予算を適用する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

予算名

共有予算の名前。

この値は、予算レコードの [予算名] フィールドに対応します。 この値は、 予算 レコードを使用してのみ設定できます。

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

予算の種類

予算の種類によって、予算の使い方が決まります。

指定できる値は、DailyBudgetAccelerated と DailyBudgetStandard です。 DailyBudgetAccelerated の予算タイプは、共有されていないキャンペーン レベルの予算を使用する対象ユーザー キャンペーンでのみ使用できます。

共有予算のコンテキストでは、予算タイプは、キャンペーンが共有予算を使用するかどうかに関係なく、常に返される読み取り専用プロパティです。 キャンペーンで共有予算が使用されているかどうかを判断するには、[ 予算 ID ] フィールドの値を確認します。

実験キャンペーンでは、 予算、予算の 種類、または 状態を更新することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。

追加：予算 ID が設定されていない場合は必須です。 キャンペーンで共有予算が使用されている場合は、読み取り専用です。
更新：BudgetId が設定されていない場合は省略可能です。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンで共有予算を使用する場合は許可されません。 共有予算を持つキャンペーンの予算の種類を更新しようとすると、 サービスから CampaignServiceCannotUpdateSharedBudget エラー コードが返されます。
削除： 読み 取り 専用

キャンペーン

キャンペーンの名前。

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

注:

更新と削除を行うには、[ ID ] フィールドまたは [ キャンペーン ] フィールドを指定する必要があります。

キャンペーンの種類

キャンペーンの種類。

キャンペーンの種類によって、キャンペーンが Microsoft ショッピング キャンペーン、動的検索広告キャンペーン、宿泊キャンペーン、検索キャンペーン、パフォーマンス 最大キャンペーンのいずれであるかが決まります。 指定できる値には、 Audience、 DynamicSearchAds、 Hotel、 Shopping、 Search、 PerformanceMax などがあります。

注:

動的検索広告のみをサポートするキャンペーンを追加、更新、または取得することはできなくなります。 既存のキャンペーンのキャンペーンの種類が "DynamicSearchAds" から "検索" に更新されました。 広告グループは現在、"動的" 広告グループと見なされますが、構造的な変更はありません。つまり、以前と同じ自動ターゲットと動的検索広告が含まれています。

追加： オプション。 指定しない場合は、 Search の既定値が使用されます。 キャンペーンの種類が [ショッピング ] の場合は、[ 国コード]、[ 優先度]、[ ストア ID] フィールドも含める必要があります。 キャンペーンの種類が DynamicSearchAds の場合は、[ ドメイン言語] フィールドと [Web サイト ] フィールドも含める必要があります。
更新： 読み 取り 専用
削除： 読み 取り 専用

クライアント ID

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

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

Country Code

Microsoft Merchant Center ストアの国コード。

Microsoft Merchant Center ストア カタログは、指定した国または地域の製品のみを含むようにフィルター処理されます。

サポートされている国コードの一覧を取得するには 、GetBSCCountries 操作を使用します。 たとえば、サポートされている国コードには、"AU" (オーストラリア)、"AT" (オーストリア)、"BE" (ベルギー)、"CA" (カナダ)、"CH" (スイス)、"DE" (ドイツ)、"ES" (スペイン)、"FR" (フランス)、"GB" (英国)、"IN" (インド)、"IT" (イタリア)、"NL" (オランダ)、"SE" (スウェーデン)、"US" (米国) などがあります。

追加：[キャンペーンの種類] フィールドが [ショッピング] に設定されている場合、または [キャンペーンの種類] フィールドが PerformanceMax に設定され、ストアがキャンペーンに関連付けられている場合は必須です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： 読み 取り 専用
削除： 読み 取り 専用

カスタム パラメーター

URL 追跡用のキーパラメーターと値パラメーターのカスタム コレクション。

一括ファイルでは、カスタム パラメーターの一覧は次のように書式設定されます。

• 各カスタム パラメーター ペアを Key=Value (例: {_promoCode}=PROMO1) として書式設定します。

• Microsoft Advertising は、含める最初の 8 つのカスタム パラメーター キーと値のペアを受け入れ、8 つ以上のカスタム パラメーターを含める場合はエラーが返されます。 各キーと値のペアは、セミコロンとスペース ("; ") で区切られます (例: {_promoCode}=PROMO1;{_season}=summer.

• Key にはセミコロンを含めることはできません。 Value にセミコロンが含まれている場合は、'\;' としてエスケープする必要があります。 さらに、Value に円記号が含まれている場合は、'\' としてもエスケープする必要があります。

• キーは 16 UTF-8 バイトを超えることはできません。値は 250 UTF-8 バイトを超えることはできません。 キーは必須であり、値は省略可能です。 Key の最大サイズには、中かっことアンダースコア ('{'、'_'、'}' は含まれません。

  注:

  Bulk サービスでは、Key は周囲の中かっこと先頭のアンダースコアで書式設定する必要があります。たとえば、Key が promoCode の場合は、{_promoCode} として書式設定する必要があります。 キャンペーン管理サービスでは、周囲の中かっことアンダースコアを指定できません。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 すべてのカスタム パラメーターを削除するには、このフィールドを delete_value に設定します。 delete_value キーワードは、前の設定を削除します。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

宛先チャネル

将来使用するために予約されています。

ドメイン言語

動的検索広告のターゲットにする Web サイト ページの 言語 。

ウェブサイトの言語によって、広告の掲載対象となる場所が決まります。 たとえば、ドイツ語の広告はドイツ、オーストリア、スイスに表示できますが、スペインには表示されません。 Web サイトに複数の言語のページが含まれており、これらのページをすべてアドバタイズする場合は、言語ごとに個別のキャンペーンを作成する必要があります。

サポートされているドメイン言語は、オランダ語、英語、フランス語、ドイツ語、イタリア語、スペイン語、スウェーデン語です。

キャンペーンの [言語] または [広告グループ の言語] を設定した場合、それらは無視されます。

注:

動的検索広告設定を使用した 混合キャンペーンでは 、実験はサポートされていません。 実験キャンペーンと実験の基本キャンペーンには、動的検索広告の設定を含めることはできません ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 このキャンペーンを実験に使用する場合は、動的検索広告の設定は含めないでください。 既存の実験がこのキャンペーンに基づいている場合、動的検索広告設定を含むようにキャンペーンを更新することはできません。

追加：[キャンペーンの種類] フィールドが DynamicSearchAds に設定されている場合は必須です。 アカウントが 混合キャンペーン 機能パイロット内にある場合は省略可能。 [キャンペーンの種類 ] フィールドが [検索] に設定されている場合、および [実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： 読み 取り 専用。 ドメイン言語を更新することはできません。
削除： 読み 取り 専用

免責事項広告が有効

これは、true に設定されている場合の免責事項キャンペーンです。 免責事項キャンペーンには、拡張テキスト広告 (EXTA) またはレスポンシブ検索広告 (RSA) のみを含めることができます。

注: これが true に設定されると、これは常に免責事項キャンペーンになります。 免責事項を設定できるのは、広告 の 作成時のみです。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合、既定値の false が設定され、免責事項広告はこのキャンペーンで有効になりません。
更新： 読み 取り 専用。 キャンペーン作成後 に免責事項AdsEnabledを 更新することはできません。
削除： 読み 取り 専用

動的な説明が有効

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください - それはすぐに来ています!

指定した広告テキストに加えて動的検索広告テキストを自動的に生成するかどうかを決定します。 広告配信中は、人工知能を使用して、これらのオプションから最適な広告テキストを選択します。

動的検索広告テキストを有効にする場合は、この要素を true に設定し、それ以外の場合は false に設定 します。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合、既定値 の false が設定され、動的検索広告のテキストは有効になりません。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 削除： 読み 取り 専用

実験 ID

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

このフィールドは、実験キャンペーン、つまり、別の検索キャンペーンに基づいて A/B テスト用に作成されたキャンペーンに対してのみ設定されます。 基本キャンペーンには実験 ID は含まれません。 同様に、実験が独立したキャンペーンに 卒業した 後、このフィールドは空になります。ただし、キャンペーンは以前は実験キャンペーンでした。

実験キャンペーンでは、 予算、予算の 種類、または 状態を更新することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。 実験の予算を変更する場合は、基本キャンペーンの予算を変更する必要があります。 値の変更は、実験 TrafficSplitPercent 設定に基づいて分割されます。

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

フィード ラベル

ショッピング キャンペーンまたはパフォーマンス上限キャンペーンで、同じフィード ラベルを持つすべての製品を宣伝できます。

• キャンペーンごとに 1 つのフィード ラベルしか存在できません。
• FeedLabel と SalesCountryCode は相互に排他的です。これらのプロパティの 1 つだけを設定できます。
• 各フィード ラベルの最大文字数は 20 文字です。
• ショッピング CoOp キャンペーンでは FeedLabel を使用できません。

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

最終 URL サフィックス

最後の URL サフィックスには、ランディング ページ URL の末尾に追加される追跡パラメーターを含めることができます。 顧客が常にランディング ページに送信されるように、ランディング ページで必要な追跡パラメーターを最終的な URL サフィックスに配置することをお勧めします。 詳細と検証規則については、テクニカル ガイドの 「最終 URL サフィックス」を 参照してください。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Id

キャンペーンのシステム生成識別子。

追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 キャンペーンに対して設定された負の識別子は、広告グループや条件などの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しいキャンペーンと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須

注:

更新と削除を行うには、[ ID ] フィールドまたは [ キャンペーン ] フィールドを指定する必要があります。

マルチチャネル キャンペーン

将来使用するために予約されています。

キーワードの関連性

広告がクリックされる可能性と、同じトラフィックをターゲットとする他のキーワードとの競合状況を示す数値スコア。 このスコアは、キーワードが広告の位置に対する過去のパフォーマンスを考慮して、広告のクリックにつながる可能性があるかどうかを予測します。

注:

キーワードの関連性は、Microsoft Advertising Web アプリケーションで使用される [予期される Click-Through レート ] ラベルと同じです。

スコア 3 は平均より上です。スコア 2 は Average です。スコア 1 は平均以下と見なされます。

複数日にわたる期間を指定した場合、スコアは期間内の各日で同じになり、値は最新の計算スコアになります。

この列のデータは、通常、UTC 日が終了した 14 から 18 時間後に更新されます。

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

ランディング ページの関連性

広告とランディング ページが顧客の検索クエリやその他の入力にどの程度関連しているかを示す数値スコア。

注:

ランディング ページの関連性は、Microsoft Advertising Web アプリケーションで使用される 広告の関連性 ラベルと同じです。

スコア 3 は平均より上です。スコア 2 は Average です。スコア 1 は平均以下と見なされます。

複数日にわたる期間を指定した場合、スコアは期間内の各日で同じになり、値は最新の計算スコアになります。

この列のデータは、通常、UTC 日が終了した 14 から 18 時間後に更新されます。

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

ランディング ページのユーザー エクスペリエンス

広告をクリックしてウェブサイトに掲載した顧客にランディング ページが適切なエクスペリエンスを提供する可能性があるかどうかを示す数値スコア。

注:

ランディング ページ ユーザー エクスペリエンスは、Microsoft Advertising Web アプリケーションで使用される ランディング ページ エクスペリエンス ラベルと同じです。

スコア 3 は平均より上です。スコア 2 は Average です。スコア 1 は平均以下と見なされます。

複数日にわたる期間を指定した場合、スコアは期間内の各日で同じになり、値は最新の計算スコアになります。

この列のデータは、通常、UTC 日が終了した 14 から 18 時間後に更新されます。

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

言語

広告の言語設定は、広告を作成するときに使用する言語を決定し、顧客の言語にする必要があります。

重要

言語が広告グループレベルとキャンペーンレベルの両方で設定されている場合、広告グループレベルの言語はキャンペーンレベルの言語よりも優先されます。

一覧で複数の言語を個別に指定することも、すべての言語を対象とする場合は、このフィールドに 1 つの言語文字列のみを "すべて" に設定できます。

検索およびショッピング キャンペーンでサポートされている言語文字列は、すべて、ブルガリア語、クロアチア語、チェコ語、デンマーク語、オランダ語、英語、エストニア語、フィンランド語、フランス語、ドイツ語、ギリシャ語、ハンガリー語、イタリア語、ラトビア語、リトアニア語、マルタ語、ノルウェー語、ポーランド語、ポルトガル語、ルーマニア語、スロバキア語、スロベニア語、スペイン語、スウェーデン語、および TraditionalChinese です。 この一括フィールドの各言語は、セミコロン (";") (英語など) で区切られます 。フランス語;ドイツ語。

注:

ブルガリア語、クロアチア語、チェコ語、エストニア語、ギリシャ語、ハンガリー語、ラトビア語、リトアニア語、マルタ語、ポーランド語、ルーマニア語、スロバキア語、スロベニア語の各言語はまだ使用できません。

対象ユーザー キャンペーンの場合は、すべての言語を含める必要があります。つまり、このフィールドを "すべて" に設定します。

動的検索広告キャンペーンの場合、キャンペーンと広告グループレベルの言語設定は、ウェブサイトドメイン の言語を優先して無視されます。 キャンペーンの言語を [すべて] に設定し、広告グループ レベルの 言語 は空のままにする必要があります。

追加： 対象ユーザー キャンペーンに必要です。それ以外の場合は、このフィールドは省略可能です。 キャンペーンの言語が設定されていない場合は、キャンペーン内の各広告グループの言語が必要です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 キャンペーンの言語を設定すると、その言語をすべて削除することはできません。 更新中に指定した言語の一覧は、以前の設定に置き換えられます。つまり、既存の言語セットには追加されません。
削除： 読み 取り 専用

LocalInventoryAdsEnabled

Microsoft Merchant Center ストアでローカル インベントリ広告を有効にするかどうかを指定します。

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。 近日公開予定です。

ローカル インベントリ広告を有効にする場合は、このプロパティを TRUE に設定し、それ以外の場合は FALSE に設定 します。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合、 FALSE の既定値 が設定され、ローカル 在庫広告は有効になりません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

変更時刻

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

注:

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

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

ページ フィード ID

動的検索広告と Performance Max キャンペーンのページ フィード識別子。

各ページ フィード識別子は、Bulk ファイルでセミコロン (";") で区切られます。

動的検索広告の場合、 ソース は、Microsoft Advertising が関連付けられているページ フィードを使用するかどうかを決定します。

ヒント

実装の概要については、 ページ フィード のテクニカル ガイドを参照してください。

注:

動的検索広告設定を使用した 混合キャンペーンでは 、実験はサポートされていません。 実験キャンペーンと実験の基本キャンペーンには、動的検索広告の設定を含めることはできません ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 このキャンペーンを実験に使用する場合は、動的検索広告の設定は含めないでください。 既存の実験がこのキャンペーンに基づいている場合、動的検索広告設定を含むようにキャンペーンを更新することはできません。

追加： [ キャンペーンの種類 ] フィールドが [検索 ] または [ パフォーマンスの最大値] に設定され、[ 実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： [ キャンペーンの種類 ] フィールドが [検索 ] または [ パフォーマンスの最大値] に設定され、[ 実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Parent Id

キャンペーンを含むアカウントのシステム生成識別子。

この一括フィールドは、取引先企業レコードの Id フィールドにマップされます。

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

優先度

2 つ以上のキャンペーンが同じ Microsoft Merchant Center ストアの製品カタログ フィードを使用する場合に、どの Microsoft ショッピング キャンペーンが広告を配信するかを判断するのに役立ちます。

優先度が高い値は、優先度が高いことを示します。 ほとんどのショッピング キャンペーンでサポートされている値は、0、1、および 2 です。 スマート ショッピング キャンペーン (キャンペーンのサブタイプが ShoppingSmartAds に設定) の場合は、優先度を 3 に設定する必要があります。 Performance Max キャンペーンの場合は、優先度を 4 に設定する必要があります。

注:

Microsoft Advertising Web アプリケーションで Microsoft ショッピング キャンペーンを作成する場合、選択されている既定の優先順位は "Low" で、これは "0" と同じです。

追加：[キャンペーンの種類] フィールドが [ショッピング] に設定されている場合、または [キャンペーンの種類] フィールドが PerformanceMax に設定され、ストアがキャンペーンに関連付けられている場合は必須です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

品質スコア

数値スコアは、顧客の検索語句に対するキーワードとランディング ページの関連性を測定することで、マーケットプレースでの広告の競争力を示します。 品質スコアは、 キーワードの関連性、 ランディング ページの関連性、 ランディング ページユーザー エクスペリエンス のサブスコアを使用して、Microsoft Advertising によって計算されます。 使用可能な場合、品質スコアの範囲は低い 1 から高い 10 までです。

品質スコアは、所有および運用されている検索トラフィックの最後のローリング 30 日に基づいています。 キーワードの入札でオークションに勝てなかった場合は、インプレッションなしで品質スコアを割り当てることができます。 シンジケート ネットワークのトラフィックは品質スコアに影響しません。 スコアが計算されなかった場合、ファイル内の値は "" (空の文字列) になります。 これは、キーワードのインプレッションが 30 日以上ない場合に発生する可能性があります。

品質スコアは通常、UTC 日が終了した 14 から 18 時間後に更新されます。 すべてのタイム ゾーンのキーワードには、対応する UTC 日の品質スコアが割り当てられます。

レポートを 1 日に複数回実行すると、スコアが計算されるタイミングを基準としてレポートを実行した場合に基づいて、品質スコアの値がレポートからレポートに変わる可能性があります。

複数日にわたる期間を指定した場合、品質スコアは現在のスコアと最近計算されたスコアであり、その期間内の各日に同じとして報告されます。 履歴品質スコアを使用して、品質スコアが時間の経過とともにどのように変化したかを調べる。 履歴品質スコアは、ローリング品質スコアの毎日のスナップショットです。 履歴品質スコアの詳細については、「レポート属性とパフォーマンス統計」の「HistoricalQualityScore」列を参照してください。

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

RSA 自動生成資産が有効

指定した広告テキストに加えて、レスポンシブ検索広告アセットを自動的に生成するかどうかを指定します。 広告配信中は、人工知能を使用して、これらのオプションから最適なアセットを選択します。

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

ソース

動的検索広告にBingインデックス、広告主が提供する URL、またはその両方を使用するかどうかを指定します。

使用可能な値を次の表に示します。

値	説明
AdvertiserSuppliedUrls	ページ フィードからの URL のみを使用します。 このキャンペーンでは、フィード ファイルで指定された URL のみが配信されます。 このオプションを選択した場合、 ページ フィード ID が 設定されていない場合、キャンペーンでは動的検索広告は配信されません。 このオプションは、カスタマイズされた広告コピーを使用した高度に特定のキャンペーンに使用することをお勧めします。
すべて	Bingの Web サイトのインデックスとページ フィードの両方の URL を使用します。 両方のソースのページが使用されますが、フィード ファイル内の URL が優先されます。
SystemIndex	Bingの Web サイトのインデックスを使用します。 これは、Bingでの動的検索広告キャンペーンの既定の動作です。

注:

動的検索広告設定を使用した 混合キャンペーンでは 、実験はサポートされていません。 実験キャンペーンと実験の基本キャンペーンには、動的検索広告の設定を含めることはできません ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 このキャンペーンを実験に使用する場合は、動的検索広告の設定は含めないでください。 既存の実験がこのキャンペーンに基づいている場合、動的検索広告設定を含むようにキャンペーンを更新することはできません。

追加： [キャンペーンの 種類] フィールドが DynamicSearchAds に設定されている場合は省略可能です。 アカウントが 混合キャンペーン 機能パイロット内にある場合は省略可能。 [キャンペーンの種類 ] フィールドが [検索] に設定されている場合、および [実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。 既定では、Bingのインデックスのみが使用されます。つまり、空の値は実質的に SystemIndex の指定と同じです。
更新： [キャンペーンの 種類] フィールドが DynamicSearchAds に設定されている場合は省略可能です。 アカウントが 混合キャンペーン 機能パイロット内にある場合は省略可能。 [キャンペーンの種類 ] フィールドが [検索] に設定されている場合、および [実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

状態

キャンペーンの状態。

ダウンロードとアップロードに使用できる値は、アクティブ、一時停止、および削除です。 さらに、BudgetAndManualPaused、BudgetPaused、Suspended の値は、一括ダウンロードによって読み取り専用です。

実験キャンペーンでは、 予算、予算の 種類、または 状態を更新することはできません。 実験キャンペーンの予算と状態は、常に基本キャンペーン設定から継承されます。

値	説明
アクティブ	キャンペーンはアクティブであり、キャンペーンの広告を配信できることを示します。
BudgetAndManualPaused	キャンペーンは一時停止され、キャンペーンの広告が配信されないことを示します。 この状態は、予算が枯渇したため、サービスがキャンペーンを一時停止した後にユーザーがキャンペーンの状態を一時停止に設定した場合に発生します。
BudgetPaused	キャンペーンは一時停止され、キャンペーンの広告が配信されないことを示します。 予算が枯渇した場合、サービスによってこの状態が設定されます。 予算が復元されると、サービスによって状態が [アクティブ] に戻ります。
Deleted	キャンペーンが削除されます。 この状態は、内部でのみ使用されます。 すべての Get 操作では削除されたオブジェクトが返されないため、この状態のオブジェクトは表示されません。
一時停止	キャンペーンは一時停止され、キャンペーンの広告が配信されないことを示します。
中断	不審なアクティビティが原因でキャンペーンが中断され、配信の対象となる広告はありません。 Microsoft Advertising サポートにお問い合わせください。

追加： オプション。 既定値は Active です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

ストア ID

キャンペーンに使用する製品カタログ フィードを含む Microsoft Merchant Center ストアの一意識別子。

キャンペーンのストアを選択すると、そのストアを変更することはできません。 ある時点で別のストアを使用する場合は、新しいショッピング設定で新しいショッピング キャンペーンを作成する必要があります。

ブランド向けショッピング キャンペーンでは、1 つのキャンペーンですべての小売業者パートナーをターゲットにすることができ、小売業者ごとに個別のキャンペーンを作成する必要はありません。 これを、マネージャー アカウントのグローバル ストアの ID に設定することをお勧めします (ストア SubType は GlobalStore に設定されています)。 最初にキャンペーンショッピング設定を介してすべてのリンクされたストアをターゲットにすることで、最大10個の キャンペーンネガティブストア基準 レコードをアップロードして、必要に応じて特定の小売業者を除外できます。

ストア識別子を取得するには、 GetBMCStoresByCustomerId 操作を 呼び出します。

追加：[キャンペーンの種類] フィールドが [ショッピング] に設定されている場合、または [キャンペーンの種類] フィールドが PerformanceMax に設定され、ストアがキャンペーンに関連付けられている場合は必須です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： 読み 取り 専用
削除： 読み 取り 専用

Sub Type

キャンペーンのサブタイプ。

サブタイプが設定されていない場合、キャンペーンはキャンペーンタイプに従って作成されます。

サブタイプが AudienceVideoAds に設定され、キャンペーンの種類が [対象ユーザー] の場合、キャンペーンはビデオ対象ユーザー キャンペーンです。

サブタイプが ShoppingSmartAds に設定されている場合、キャンペーンは Microsoft スマート ショッピング キャンペーンです。

サブタイプが ShoppingSponsoredProductAd に設定されている場合、キャンペーンは ブランド向けの Microsoft ショッピング キャンペーンです。

追加： オプションで、ほとんどのキャンペーンタイプには適用されません。 Microsoft スマート ショッピング キャンペーンの場合は、 サブタイプを ShoppingSmartAds に設定する必要があります。 ブランドの Microsoft ショッピング キャンペーンの場合は、サブタイプを ShoppingSponsoredProductAd に設定する必要があります。
更新： 読み 取り 専用
削除： 読み 取り 専用

ターゲット設定

条件の種類 (このキャンペーンに関連付けられている対象ユーザーなど) に適用されるターゲット設定。

注:

誰もがこの機能をまだ持っているわけではありません。 そうでない場合は、心配しないでください。 近日公開予定です。

[ターゲットと入札] オプションが必要な場合は、このフィールドに条件の種類グループ名を含めます。 この場合、広告は少なくとも 1 つの条件を満たすユーザーにのみ配信され、特定の条件に対して入札単価調整を行うことができます。

[入札のみ] オプションが必要な場合は、このフィールドから条件の種類グループ名を除外します。 この場合、他のターゲティング条件を満たすすべてのユーザーに広告を配信し、特定の条件に対して入札単価調整を行います。

各条件の種類のグループ名は、Bulk ファイルでセミコロン (";") で区切られます。 一括ファイルをダウンロードすると、"ターゲットと入札" オプションを使用するように設定されている種類のみがこのフィールドに含まれます。

キャンペーン レベルのターゲット設定で現在サポートされている条件の種類の値は、"対象ユーザー" のみです。 対象ユーザーの条件の種類の [ターゲットと入札] オプションは、すべてのキャンペーンタイプでサポートされています。 将来、新しい値がサポートされる可能性があるため、固定の値セットに依存しないでください。 とはいえ、このフィールドに使用できる値は、キャンペーン管理 API の CriterionTypeGroup 値セットにも定義する必要があります。

注:

対象ユーザーキャンペーンの種類と対象ユーザー条件の種類グループ名を混同しないでください。

条件の種類グループ	サポートされているキャンペーン	説明
Audience	すべて	対象ユーザーに含まれるユーザーにのみ広告を表示する場合は、[対象ユーザー条件の種類] グループ名をこのフィールドに含め、入札金額を変更するオプションを指定します。 このキャンペーンの広告は、対象ユーザーに含まれるユーザーにのみ表示されます。 広告を検索しているユーザーに広告を表示する場合は、対象ユーザー条件の種類グループ名をこのフィールドから除外します。対象ユーザーに含まれるユーザーの入札金額を変更するオプションを使用します。 このキャンペーンの広告はすべてのユーザーに表示できますが、入札単価調整は対象ユーザーに含まれるユーザーに適用されます。

リマーケティング リストなどのエンティティは複数のキャンペーンに関連付けることができ、各キャンペーンのターゲット設定 (リマーケティング リストの対象ユーザー基準グループ名など) は配信に個別に適用されます。 たとえば、同じリマーケティング リストをキャンペーン A とキャンペーン B に関連付けることができます。各キャンペーンの [ターゲット設定] フィールドは個別に設定されるため、キャンペーン A の [ターゲットと入札] オプションを使用して同じリマーケティング リストが関連付けられる場合があります。一方、キャンペーン B の [入札のみ] オプションを使用して関連付けられます。

追加： オプション。 条件の種類のグループ名がこのフィールドから除外されている場合、既定の設定は実質的に "入札のみ" です。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 すべての条件の種類のグループ名を削除するには、このフィールドを delete_value に設定します。 delete_value キーワードは、前の設定を削除します。 条件の種類のグループ名のサブセットを削除するには、保持する条件の種類グループ名を指定し、保持する必要のない条件の種類グループ名を省略します。 新しい条件タイプグループ名のセットは、キャンペーンに設定された以前の条件グループに置き換えられます。
削除： 読み 取り 専用

追跡テンプレート

キャンペーン内のすべての URL の既定として使用する追跡テンプレート。

追跡テンプレートには、次の検証規則が適用されます。 サポートされているテンプレートとパラメーターの詳細については、Microsoft Advertising のヘルプ記事「 どのような追跡または URL パラメーターを使用できますか?」を参照してください。

• 広告など、下位レベルのエンティティに対して定義された追跡テンプレートは、キャンペーンなどの上位レベルのエンティティに対する設定をオーバーライドします。 詳細については、「 エンティティの制限」を参照してください。

• 追跡テンプレートの長さは 2,048 文字に制限されています。 HTTP または HTTPS プロトコル文字列は、2,048 文字の制限にカウントされます。

• 追跡テンプレートは、 http://、 https://、 {lpurl}、または {unescapedlpurl} のいずれかで始まる適切な形式の URL である必要があります。

• Microsoft Advertising では、カスタム パラメーターが存在するかどうかを検証しません。 追跡テンプレートでカスタム パラメーターを使用し、それらが存在しない場合、ランディング ページ URL には、代替なしでカスタム パラメーターのキーと値のプレースホルダーが含まれます。 たとえば、トラッキング テンプレートが で https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}、キャンペーン、広告グループ、条件、キーワード、または広告レベルで {_season} または {_promocode} が 定義されていない場合、ランディング ページの URL は同じになります。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

URL 拡張オプトアウト

false の場合、ドメイン全体が対象になります。 true (オプトアウト) の場合、アセット グループとフィードの最終的な URL のみが対象になります。 このフィールドは、パフォーマンスの上限キャンペーンにのみ適用されます。

追加： オプション。 このフィールドを指定しない場合、または空のままにした場合は、既定値 false が設定されます。 更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 削除： 読み 取り 専用

Web サイト

動的検索広告のターゲットにする Web サイトのドメイン名。

文字列の長さは 2,048 文字に制限されています。 ドメイン名に www が含まれている場合は、トリミングされ、使用されません。

注:

動的検索広告設定を使用した 混合キャンペーンでは 、実験はサポートされていません。 実験キャンペーンと実験の基本キャンペーンには、動的検索広告の設定を含めることはできません ( [ドメイン言語]、[ 動的説明が有効]、[ ページ フィード ID]、[ ソース]、および [Web サイト ] フィールドで構成されます)。 このキャンペーンを実験に使用する場合は、動的検索広告の設定は含めないでください。 既存の実験がこのキャンペーンに基づいている場合、動的検索広告設定を含むようにキャンペーンを更新することはできません。

追加：[キャンペーンの種類] フィールドが DynamicSearchAds に設定されている場合は必須です。 アカウントが 混合キャンペーン 機能パイロット内にある場合は省略可能。 [キャンペーンの種類 ] フィールドが [検索] に設定されている場合、および [実験 ID ] フィールドが設定されていない場合は省略可能です。 他のキャンペーンタイプにはこの列を含めることはできません。
更新： 読み 取り 専用。 ドメイン名を更新することはできません。
削除： 読み 取り 専用