広告グループレコード - 一括

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

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

次の一括 CSV の例では、正しいキャンペーン ID が指定された場合に新しい広告グループを追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Network Distribution,Ad Rotation,Cpc Bid,Language,Bid Adjustment,Name,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type,Target Setting
Format Version,,,,,,,,,,,,,,,6.0,,,,,
Ad Group,Active,,-111,ParentCampaignNameGoesHere,Women's Red Shoe Sale,ClientIdGoesHere,,11/12/2020,12/31/2021,OwnedAndOperatedAndSyndicatedSearch,RotateAdsEvenly,0.1,English,10,,https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl},,{_promoCode}=PROMO1; {_season}=summer,ManualCpc,Audience

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroup
var bulkAdGroup = new BulkAdGroup
{
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                  
    // Map properties in the Bulk file to the 
    // AdGroup object of the Campaign Management service.
    AdGroup = new AdGroup
    {
        // 'Ad Rotation' column header in the Bulk file
        AdRotation = new AdRotation
        {
            Type = AdRotationType.RotateAdsEvenly
        },
        // 'Ad Schedule Use Searcher Time Zone' column header in the Bulk file
        AdScheduleUseSearcherTimeZone = true,
        // 'Bid Adjustment' column header in the Bulk file
        AudienceAdsBidAdjustment = 10,
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new ManualCpcBiddingScheme { },
        // 'Cpc Bid' column header in the Bulk file
        CpcBid = new Bid
        {
            Amount = 0.10
        },
        // 'End Date' column header in the Bulk file
        EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
        {
            Month = 12,
            Day = 31,
            Year = DateTime.UtcNow.Year + 1
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Language' column header in the Bulk file
        Language = "English",
        // 'Ad Group' column header in the Bulk file
        Name = "Women's Red Shoe Sale",
        // 'Network Distribution' column header in the Bulk file
        Network = Network.OwnedAndOperatedAndSyndicatedSearch,
        // 'Privacy Status' column header in the Bulk file
        PrivacyStatus = null,
        // 'Target Setting' column header in the Bulk file
        Settings = new []
        {
            new TargetSetting
            {
                // Each target setting detail is delimited by a semicolon (;) in the Bulk file
                Details = new []
                {
                    new TargetSettingDetail
                    {
                        CriterionTypeGroup = CriterionTypeGroup.Audience,
                        TargetAndBid = true
                    }
                }
            }
        },
        // '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
        },
        // 'Status' column header in the Bulk file
        Status = AdGroupStatus.Paused,
        // '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"
                },
            }
        },
    },
};

uploadEntities.Add(bulkAdGroup);

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

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

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

• 広告グループ
• 広告グループの種類
• 広告のローテーション
• 広告スケジュール Searcher タイム ゾーンを使用する
• 入札単価調整
• 入札ブースト値
• 入札オプション
• 入札戦略の種類
• Campaign
• クライアント ID
• クリック単価
• カスタム パラメーター
• 終了日
• 最終 URL サフィックス
• 周波数上限の設定
• Id
• 継承された入札戦略の種類
• キーワードの関連性
• ランディング ページの関連性
• ランディング ページのユーザー エクスペリエンス
• Language
• 最大入札価格
• 変更時刻
• ネットワーク配布
• Parent Id
• プライバシーの状態
• 品質スコア
• 開始日
• 状態
• ターゲット設定
• 追跡テンプレート
• 最適化されたターゲット設定を使用する
• 予測ターゲティングを使用する

広告グループ

広告グループの名前。

この名前は、キャンペーン内のすべてのアクティブな広告グループで一意である必要があります。 名前には、最大 256 文字を含めることができます。

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

広告グループの種類

広告グループの種類。

キャンペーンの種類が "検索" である混合キャンペーンでは、実験 ID が設定されておらず、キャンペーンに有効な動的検索広告設定 (ドメイン言語、動的説明が有効、ページ フィード ID、ソース、Web サイトフィールドで構成) が既に存在し、使用可能な値は "SearchDynamic" と "SearchStandard" です。 それ以外の場合、"検索" キャンペーン内の広告グループの種類は "SearchStandard" にのみ設定できます。 広告グループの種類が "SearchDynamic" の場合は、この広告グループ内にのみ動的検索広告を追加できます。 広告グループの種類が "SearchStandard" の場合は、この広告グループ内に拡張テキスト広告またはレスポンシブ検索広告を追加できます。

"DynamicSearchAds" キャンペーン内の広告グループの種類は、"SearchDynamic" にのみ設定できます。 "DynamicSearchAds" キャンペーンの広告グループの種類を設定する必要はありませんが、広告グループを取得する場合、このフィールドは "SearchDynamic" に設定されることに注意してください。

このフィールドは、"Hotel" または "検索" キャンペーンの種類に対して HotelAds に設定できます。

このフィールドは、[対象ユーザー] または [ショッピング] キャンペーンの種類に設定できません。 サポートされていないキャンペーン内で広告グループを取得すると、このフィールドは空になります。

追加： オプション。 検索キャンペーンの既定値は "SearchStandard" です。 "DynamicSearchAds" キャンペーンの既定値は "SearchDynamic" です。
更新： 読み 取り 専用。 広告グループの種類を更新することはできません。
削除： 読み 取り 専用

広告のローテーション

広告ローテーションは、広告グループ内に複数の広告がある場合に、配信する広告を Microsoft Advertising が選択する頻度を設定します。 アカウントから一度に表示できる広告は 1 つ以上ないため、広告ローテーションでは、パフォーマンスが向上する可能性が高い統計的に表示される広告が優先されます。

注:

広告ローテーションは製品広告には適用されません。

使用できる値は OptimizeForClicks と RotateAdsEvenly です。

OptimizeForClicks に設定されている場合、Microsoft Advertising は、オークションの特性や要因 (キーワード (keyword)、検索用語、デバイス、場所など) に基づいて、パフォーマンスが最も高い広告グループの広告に優先順位を付けます。 パフォーマンスの向上した広告は表示頻度が高くなり、他の広告は配信頻度が低くなります(まったく表示される場合)。

RotateAdsEvenly に設定すると、Microsoft Advertising は広告間のローテーションのバランスを取ります。 つまり、特定の広告グループ内の広告も、検索者のクエリに応答して表示される可能性が高くなります。 広告の品質が低い場合は、広告の優先順位が低くなります。そのため、表示頻度が低くなる場合や、まったく表示されない場合があります。

• RotateAdsEvenly 設定を使用すると、パフォーマンスの低い広告をパフォーマンスの高い広告と同じ頻度で表示できます。 これは広告グループのパフォーマンスに影響を与える可能性があります。
• 広告グループのキャンペーンで自動入札戦略 (MaxClicks、MaxConversions、TargetCpa、TargetRoas) が使用されている場合、これらの入札戦略はパフォーマンスの高い広告を優先するため、RotateAdsEvenly 設定は無視されます。

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

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

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

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

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

入札単価調整

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

注:

このプロパティは 、スマート ショッピング キャンペーンでは使用できません。

サポートされる値は、負の 100 (-100) から正の 900 (900) です。 入札単価調整を -100% に設定すると、この広告グループに対してオーディエンス広告が表示されなくなります。

対象ユーザー広告の入札単価調整を行わない場合は、このフィールドをゼロ (0) に設定します。 このフィールドが空の場合は、広告グループの [キャンペーン] の [入札単価調整] 設定を継承します。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 広告グループにオーディエンス広告の入札単価調整が既にあり、広告グループの [キャンペーン] の [入札単価調整] 設定を効果的に継承するために削除する場合は、このフィールドをdelete_valueに設定します。 delete_value キーワード (keyword)では、前の設定が削除されます。
削除： 読み 取り 専用

入札ブースト値

新しい製品グループの Microsoft Advertising Web アプリケーションに表示される既定の入札ブースト率。

この広告グループ レベルのターゲット設定は、オークションでは直接使用されません。 商品グループ の入札単価調整 は、パートナーの入札を促進するために使用 されます。

注:

この設定は、ブランド向け ショッピング キャンペーンの広告グループにのみ適用されます。

追加：[Bid Option]\(入札オプション\) が BidBoost に設定されている場合は必須です。それ以外の場合は、このフィールドを設定することはできません。
更新： Bid Option が BidBoost に設定されている場合は省略可能。それ以外の場合は、このフィールドを設定できません。
削除： 読み 取り 専用

入札オプション

パートナーの入札を増幅するかどうかを決定します。

注:

この設定は、ブランド向け ショッピング キャンペーンの広告グループにのみ適用されます。

サポートされている値は BidBoost と BidValue です。 単価型広告グループを使用すると、マーチャンダイジング パートナーがターゲットにしていない商品に対して入札できます。 入札ブーストを使用すると、商品グループの [入札調整 ] フィールド (広告グループの [ 入札ブースト値] も参照してください) と広告グループの [最大入札価格 ] フィールドを使用して、パートナーの入札単価を引き上げます。 BidBoost は、パートナーが BidValue を使用している場合にのみ使用してください。

この設定が入札可能な 広告グループ製品パーティション レコードに与える影響 (つまり、[除外される] フィールド がFALSE で、[ サブタイプ ] が [ユニット] である場合) に次の影響があることに注意してください。

• この要素が BidValue に設定されている場合、オークションでは広告グループ製品パーティションの [入札] フィールドが使用されます。
• この要素が BidBoost に設定されている場合、オークションでは広告グループ製品パーティションの [入札調整] フィールドが使用されます。

追加： オプション。 このフィールドが設定されていない場合、広告グループの既定の [ブランド向けショッピング キャンペーン] 入札オプションは BidValue です。
更新： 読み 取り 専用。 前の入札オプションを変更しようとすると、エラーが返されます。
削除： 読み 取り 専用

入札戦略の種類

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

広告グループとキーワードの入札戦略の種類は "InheritFromParent" です。

注:

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

キャンペーンの種類ごとにサポートされている入札戦略の詳細については、「 予算と入札戦略」を参照してください。

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

Campaign

広告グループを含むキャンペーンの名前。

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

注:

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

クライアント ID

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

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

クリック単価

ユーザーのクエリと広告グループのキーワードが一致する場合に、広範、正確、またはフレーズの一致の比較を使用して使用する既定の入札。

最小入札価格と最大入札範囲は、アカウントの通貨によって異なります。 詳細については、「 通貨」を参照してください。

キーワード (keyword)レベルで広い一致単価、正確一致、語句の一致単価を指定すると、対応する一致タイプの広告グループの検索入札値がオーバーライドされます。

追加： オプション。 入札を設定しない場合は、アカウントの通貨に応じて最小値に設定されます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

カスタム パラメーター

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 キーワード (keyword)では、前の設定が削除されます。 カスタム パラメーターのサブセットを削除するには、保持するカスタム パラメーターを指定し、保持しないパラメーターを省略します。 カスタム パラメーターの新しいセットは、以前のカスタム パラメーター セットに置き換えられます。
削除： 読み 取り 専用

終了日

広告グループ内の広告の有効期限が切れる日付。

終了日を指定しない場合、広告の有効期限は切れなくなります。 終了日を延長すると、広告グループの有効期限が切れた後でも、広告グループの広告を配信の対象にすることができます。

終了日は包括的です。 たとえば、 終了日 を 2020 年 12 月 31 日に設定した場合、広告グループの広告は 2020 年 12 月 31 日午後 11 時 59 分に期限切れになります。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

追加： オプション。 広告グループを追加するときに終了日を設定しない場合は、このフィールドを設定しないでください。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 現在の終了日を削除し、実質的に終了日を設定しない場合は、このフィールドを "delete_value" 文字列に設定します。 次回広告グループを取得する場合、このフィールドは設定されません。
削除： 読み 取り 専用

最終 URL サフィックス

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

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

周波数上限の設定

周波数キャップ設定配列。 CapValue、TimeGranularity が含まれます。 許可される要素は 1 つだけです (複数の周波数上限はありません)。

コード例

[{""CapValue"": 10, ""TimeGranularity"": ""DAY""}]

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

Id

広告グループのシステム生成識別子。

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

継承された入札戦略の種類

親キャンペーンから継承される入札戦略の種類。

この値は、親キャンペーンの [入札戦略の種類] フィールドと同じです。 使用できる値は 、EnhancedCpc、 ManualCpc、 MaxClicks、 MaxConversions、 TargetCpa、 TargetRoas です。

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

キーワードの関連性

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

注:

キーワードの関連性は、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 つ以上の言語が設定されている場合は省略可能で、それ以外の場合はほとんどのキャンペーンの種類に言語が必要です。 オーディエンス キャンペーンの広告グループに対してこの要素を設定することはできません。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 言語を削除し、キャンペーン レベルの言語に延期するには、このフィールドを delete_value に設定します。 delete_value キーワード (keyword)では、前の設定が削除されます。
削除： 読み 取り 専用

最大入札価格

ブランド向けショッピング キャンペーンの入札額の一定額。

注:

この設定は、ブランド向け ショッピング キャンペーンの広告グループにのみ適用されます。

追加：[Bid Option]\(入札オプション\) が BidBoost に設定されている場合は必須です。それ以外の場合は、このフィールドを設定することはできません。
更新： Bid Option が BidBoost に設定されている場合は省略可能。それ以外の場合は、このフィールドを設定できません。
削除： 読み 取り 専用

変更時刻

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

注:

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

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

ネットワーク配布

広告を表示する検索ネットワーク。

ほとんどのキャンペーンタイプの広告グループでサポートされているネットワーク値は、 OwnedAndOperatedAndSyndicatedSearch、 OwnedAndOperatedOnly、 SyndicatedSearchOnly です。 既定値は OwnedAndOperatedAndSyndicatedSearch です。 ネットワークと広告配信の詳細については、広告配信に 関する ヘルプ記事を参照してください。

オーディエンス キャンペーンの広告グループの場合、広告グループ レベルのネットワークはサポートされていないため、このフィールドは空になります。 広告グループは Microsoft Audience Network にあります。

スマート ショッピング キャンペーンの広告グループの場合、ネットワークを設定することはできません。 サービスは、ネットワークを OwnedAndOperatedAndSyndicatedSearch に設定します。

ブランドのショッピング キャンペーンの広告グループの場合、InHousePromotion ネットワーク (小売業者ネットワークのみ) は、OwnedAndOperatedAndSyndicatedSearch、OwnedAndOperatedOnly、SyndicatedSearchOnly に加えてサポートされます。

配信検索オプションのいずれかを選択した場合は、 SetNegativeSitesToAdGroups または SetNegativeSitesToCampaigns 操作を呼び出して、特定の配信検索 Web サイトに広告が表示されないようにすることができます。

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

Parent Id

広告グループを含むキャンペーンのシステム生成識別子。

この一括フィールドは、キャンペーン レコードの Id フィールドにマップされます。

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

注:

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

プライバシーの状態

オーディエンス キャンペーンの広告グループに対して広告グループのターゲット条件が狭すぎるかどうかを示します。

状態	説明
アクティブ	広告グループは、サービスを提供する資格があります。
Pending	プライバシー評価はまだ進行中であり、広告グループはまだ配信の資格がありません。
TargetingTooNarrow	広告グループのターゲット条件 (広告グループの会社名基準など) が狭すぎるため、 広告グループ は配信の対象になりません。 ターゲット条件またはリマーケティング リストを更新して、対象ユーザーを広げ、推定一意のユーザーを増やします。

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

品質スコア

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

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

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

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

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

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

開始日

広告グループ内の広告の配信を開始できる日付。それ以外の場合は、広告グループがアクティブになった日に広告グループ内の広告の配信を開始できます。

開始日は包括的です。 たとえば、 開始日 を 2020 年 5 月 5 日に設定した場合、広告グループの広告は 2020 年 5 月 5 日の午前 12 時に開始されます。 時間は、キャンペーン レベルで指定したタイム ゾーンに基づいています。

追加： オプション。 このフィールドを設定しない場合、または送信した日付が今日の日付より前の場合、今日の日付が設定され、広告グループの状態がアクティブになるとすぐに、サービスは広告グループ内の広告の配信を開始できます。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 開始日は、広告グループが送信された後、つまり開始日が到着した後は更新できません。
削除： 読み 取り 専用

状態

広告グループの状態。

使用可能な値は、 アクティブ、 削除、 期限切れ、 一時停止です。 期限切れの状態は読み取り専用です。

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

ターゲット設定

条件の種類 (たとえば、この広告グループに関連付けられている対象ユーザー) に適用されるターゲット設定。

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

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

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

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

注:

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

条件の種類グループ	サポートされているキャンペーン	説明
年齢	Audience	このフィールドに [年齢基準の種類] グループ名を含めた場合、年齢基準の少なくとも 1 つを満たすユーザーにのみ広告が配信され、特定の年齢範囲に対して入札単価調整が行われます。 この設定により、広告を見ているユーザーが年齢基準を満たすことができます。 このフィールドから [年齢基準の種類] グループ名を除外した場合、他のターゲティング条件を満たすすべてのユーザーに広告が配信され、特定の年齢範囲に対して入札単価を調整できるようになります。 この設定を使用すると、特定の年齢基準を満たすユーザーに対して、広告をそれらのユーザーに制限することなく、積極的に入札することができます。
Audience	すべて	対象ユーザーに含まれるユーザーにのみ広告を表示する場合は、[対象ユーザー条件の種類] グループ名をこのフィールドに含め、入札金額を変更するオプションを指定します。 この広告グループの広告は、対象ユーザーに含まれるユーザーにのみ表示されます。 広告を検索しているユーザーに広告を表示する場合は、対象ユーザー条件の種類グループ名をこのフィールドから除外します。対象ユーザーに含まれるユーザーの入札金額を変更するオプションを使用します。 この広告グループの広告はすべてのユーザーに表示できますが、入札単価調整は対象ユーザーに含まれるユーザーに適用されます。
CompanyName	Audience	このフィールドに CompanyName 条件の種類のグループ名を含める場合、会社の条件を少なくとも 1 つ満たすユーザーにのみ広告が配信され、特定の企業に対して入札単価調整を行うことができます。 この設定により、広告を見ているユーザーが会社の基準を満たすことができます。 このフィールドから CompanyName 条件の種類のグループ名を除外した場合、他のターゲティング条件を満たすすべてのユーザーに広告が配信され、特定の企業の入札単価調整が可能になります。 この設定を使用すると、特定の会社の条件を満たすユーザーに対して、広告をそれらのユーザーに制限することなく、積極的に入札することができます。
Gender	Audience	このフィールドに [性別基準の種類] グループ名を含めた場合、性別基準を満たすユーザーにのみ広告が配信され、特定の性別に対して入札単価調整を行うことができます。 この設定により、広告を見ているユーザーが性別の基準を満たすことができます。 このフィールドから [性別基準の種類] グループ名を除外した場合、他のターゲティング条件を満たすすべてのユーザーに広告が配信され、特定の性別に対して入札単価調整を行うことができます。 この設定を使用すると、特定の性別基準を満たすユーザーに対して、広告をそれらのユーザーに制限することなく、積極的に入札することができます。
Industry	Audience	このフィールドに [業界基準の種類] グループ名を含める場合、広告は業界の基準の少なくとも 1 つを満たすユーザーにのみ配信され、特定の業界の入札単価調整を行うことができます。 この設定により、広告を見ているユーザーが業界の基準を満たすことができます。 このフィールドから [業界基準の種類] グループ名を除外した場合、他のターゲティング条件を満たすすべてのユーザーに広告が配信され、特定の業種に対して入札単価調整を行うことができます。 この設定を使用すると、特定の業界基準を満たすユーザーに対して、広告をそれらのユーザーに制限することなく、積極的に入札することができます。
JobFunction	Audience	このフィールドに JobFunction 条件の種類のグループ名を含める場合、特定のジョブ機能に対して入札調整を行いながら、少なくとも 1 つのジョブ機能条件を満たすユーザーにのみ広告が配信されます。 この設定により、広告を見ているユーザーがジョブ機能の条件を満たすことができます。 このフィールドから JobFunction 条件の種類のグループ名を除外した場合、他のターゲティング条件を満たすすべてのユーザーに広告が配信され、特定のジョブ機能に対して入札単価調整を行うことができます。 この設定を使用すると、特定の職務条件を満たすユーザーに対して、広告をそれらのユーザーに制限することなく、積極的に入札することができます。

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

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

追跡テンプレート

広告グループ内のすべての 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}、キャンペーン、広告グループ、条件、キーワード (keyword)、または広告レベルで {_season} または {_promocode} が定義されていない場合、ランディング ページの URL は同じになります。

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

最適化されたターゲット設定を使用する

UseOptimizedTargeting は非推奨になります。 代わりに UsePredictiveTargeting を 使用します。

予測ターゲティングを使用する

AdGroup に対して予測ターゲティングが有効になっているかどうかを示します。

注: UsePredictiveTargeting は、対象ユーザー キャンペーンでのみ使用できます。

追加： オプション。
更新： オプション。