キーワード レコード - 一括

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

アカウント内のすべてのキーワード レコードをダウンロードする場合は、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に [キーワード] の DownloadEntity 値を含めます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ダウンロードしたキャンペーン レコードにキーワードの関連性、ランディング ページの関連性、ランディング ページのユーザー エクスペリエンス、品質スコアの各フィールドを含めるには、QualityScoreData スコープも含める必要があります。 BidSuggestionsData スコープも含める場合、一括ファイルには、ダウンロードした各キーワード (keyword)に対応する個別のキーワードの最適位置の入札、キーワードのメイン 行の入札、キーワードの最初のページの入札レコードを含めることもできます。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、有効な親 ID 値が指定されている場合に新しいキーワード (keyword)を追加します。

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Bid,Param1,Param2,Param3,Name,Final Url,Mobile Final Url,Tracking Template,Final Url Suffix,Custom Parameter,Bid Strategy Type
Format Version,,,,,,,,,,,,,,6.0,,,,,,
Keyword,Active,,-1111,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,red shoes,Broad,0.5,,,,,https://www.contoso.com/womenshoesale,https://mobile.contoso.com/womenshoesale,,,{_promoCode}=PROMO1; {_season}=summer,ManualCpc

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkKeyword
var bulkKeyword = new BulkKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // Keyword object of the Campaign Management service.
    Keyword = new Keyword
    {
        // 'Bid' column header in the Bulk file
        Bid = new Bid
        {
            Amount = 0.50,
        },
        // 'Bid Strategy Type' column header in the Bulk file
        BiddingScheme = new ManualCpcBiddingScheme { },
        // 'Destination Url' column header in the Bulk file
        DestinationUrl = null,
        // 'Mobile Final Url' column header in the Bulk file
        FinalMobileUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://mobile.contoso.com/womenshoesale"
        },
        // 'Final Url' column header in the Bulk file
        FinalUrls = new[] {
            // Each Url is delimited by a semicolon (;) in the Bulk file
            "https://www.contoso.com/womenshoesale"
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Broad,
        // 'Param 1 column header in the Bulk file
        Param1 = null,
        // 'Param 2' column header in the Bulk file
        Param2 = null,
        // 'Param 3' column header in the Bulk file
        Param3 = null,
        // 'Status' column header in the Bulk file
        Status = KeywordStatus.Active,
        // 'Text' column header in the Bulk file
        Text = "red shoes",
        // '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(bulkKeyword);

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

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

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

• 広告グループ
• Bid
• 入札戦略の種類
• Campaign
• クライアント ID
• カスタム パラメーター
• 宛先 URL
• 編集上の申し立てステータス
• 編集場所
• 編集理由コード
• 編集状態
• 編集用語
• 最終 URL
• 最終 URL サフィックス
• Id
• 継承された入札戦略の種類
• Keyword
• キーワードの関連性
• ランディング ページの関連性
• ランディング ページのユーザー エクスペリエンス
• 一致の種類
• モバイルの最終 URL
• 変更時刻
• Param1
• Param2
• Param3
• Parent Id
• 発行元の国
• 品質スコア
• 状態
• 追跡テンプレート

広告グループ

キーワード (keyword)を含む広告グループの名前。

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

注:

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

Bid

ユーザーが広告をクリックするたびに支払う最大金額。

同じキーワード (keyword)を使用して他の広告主に対して入札を行うので、一般的に高い入札単価を設定すると、検索結果ページのより望ましい場所に広告が表示されます。

既定の広告グループ レベルの入札を使用する代わりに、キーワード (keyword)ごとにカスタム入札を設定できます。 キーワードのカスタム入札は、これらの特定のキーワードの広告グループの既定の入札よりも優先されます。 カスタム入札では、最も収益性の高いキーワードに時間とお金を集中させることができますが、個々の入札の管理にもっと時間を費やす必要があります。

キーワード (keyword)レベルの入札が設定されていない場合は、広告グループクリック単価が使用されます。 詳細については、「 予算と入札戦略」を参照してください。

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

入札戦略の種類

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

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

注:

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

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

キャンペーン

キーワード (keyword)を含むキャンペーンの名前。

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

クライアント ID

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

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

カスタム パラメーター

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

宛先 URL

ユーザーが広告をクリックしたときにアクセスする Web ページの URL。 指定した場合は、キーワード (keyword)の宛先 URL が使用されます。それ以外の場合は、広告の宛先 URL が使用されます。

重要

2018 年 11 月の時点で、キーワード (keyword)宛先 URL を追加または更新できません。 代わりに Final URL を 使用できます。それ以外の場合、Microsoft Advertising は広告の最終 URL を使用します。 詳細については、「キーワード (keyword)宛先 URL を最終的な URL に移行する」を参照してください。

追加： 許可されていません
更新： 許可されていません
削除： 読み 取り 専用

編集上の申し立てステータス

編集レビューで見つかった問題に異議を申し立てることができるかどうかを判断します。

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

値	説明
上訴可能	編集上の問題は申し立て可能です。
異議申し立て中	編集上の問題は控訴可能であり、控訴が提出されました。
NotAppealable	編集上の問題は不服として申し立てられない。

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

編集場所

編集レビューに失敗したキーワード (keyword)のコンポーネントまたはプロパティ。

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

編集理由コード

エラーの理由を識別するコード。 考えられる理由コードの一覧については、「 編集理由コード」を参照してください。

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

編集状態

キーワード (keyword)の編集状態。

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

値	説明
アクティブ	キーワード (keyword)は編集レビューに合格しました。
ActiveLimited	キーワード (keyword)は 1 つ以上の市場で編集レビューに合格し、キーワード (keyword)の 1 つ以上の要素が別の市場で編集レビューを受けています。 たとえば、キーワード (keyword)はカナダの編集レビューに合格し、米国でレビューを保留中です。
不承認	キーワード (keyword)編集レビューに失敗しました。
非アクティブ	キーワード (keyword)の 1 つ以上の要素が編集レビュー中です。

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

編集用語

編集レビューに失敗した用語。

用語の組み合わせによってエラーが発生した場合、またはポリシー違反に基づいて失敗した場合、このフィールドは設定されません。

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

最終 URL

ランディング ページの URL。 キーワード (keyword)の最終 URL が指定されている場合は使用されます。それ以外の場合は、広告の最終的な URL が使用されます。

次の検証規則は、最終 URL と最終モバイル URL に適用されます。

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

• 最終 URL と最終モバイル URL の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。

• 各 URL は、セミコロンとスペース ("; ") で区切られます。

• '{' と '}' の使用は、"{lpurl}" などのタグのみを示すために許可されます。

• 各 URL は、http:// または https:// で始まる整形式の URL である必要があります。

• Final Mobile URL を指定する場合は、Final Url も指定する必要があります。

また、[ 追跡テンプレート ] フィールドまたは [カスタム パラメーター] フィールドが設定されている場合は、[ 最終 URL] フィールドが必要であることにも注意してください。

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

最終 URL サフィックス

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

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

Id

キーワード (keyword)のシステム生成識別子。

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

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

キーワード (keyword)の入札戦略の種類が InheritFromParent に設定されている場合、親キャンペーンまたは広告グループから継承される入札戦略の種類。 この値は、親キャンペーンまたは広告グループの [入札戦略の種類] フィールドと同じです。 使用できる値は 、EnhancedCpc、 ManualCpc、 MaxClicks、 MaxConversions、 TargetCpa、 TargetRoas です。

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

Keyword

キーワード (keyword)テキスト。

テキストには最大 100 文字を含めることができます。

キーワード (keyword)が属する広告グループに指定した言語値のロケールで、キーワード (keyword)を指定する必要があります。

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

キーワードの関連性

広告がクリックされる可能性と、キーワード (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 時間後に更新されます。

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

一致の種類

キーワード (keyword)とユーザーの検索用語を比較する一致の種類。

キーワード (keyword)でサポートされている一致型の値は、Broad、Exact、Phrase です。

注: 検索キャンペーンの予測ターゲティングを有効にした場合、一致の種類は "予測" です。 この場合、予測ターゲティングを使用して関連する検索クエリと広告を照合するため、マッチタイプを追加、更新、削除することはできません。

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

モバイルの最終 URL

モバイル ランディング ページの URL。 キーワード (keyword)の最終モバイル URL が指定されている場合は使用されます。それ以外の場合は、広告の最終的なモバイル URL が使用されます。

次の検証規則は、最終 URL と最終モバイル URL に適用されます。

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

• 最終 URL と最終モバイル URL の両方に最大 10 個の項目を指定できます。ただし、各一覧の最初の項目のみが配信に使用されます。 このサービスでは、前方互換性の可能性がある最大 10 個を許可します。

• 各 URL は、セミコロンとスペース ("; ") で区切られます。

• '{' と '}' の使用は、"{lpurl}" などのタグのみを示すために許可されます。

• 各 URL は、http:// または https:// で始まる整形式の URL である必要があります。

• Final Mobile URL を指定する場合は、Final Url も指定する必要があります。

また、TrackingUrlTemplate 要素または UrlCustomParameters 要素が設定されている場合は、少なくとも 1 つの最終的な URL が必要であることに注意してください。

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

変更時刻

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

注:

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

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

Param1

広告のタイトル、テキスト、表示 URL、または宛先 URL に {Param1} 動的置換文字列が含まれている場合に、広告の置換値として使用する文字列。

注:

{Param1} を使用して広告の宛先 URL を指定できますが、指定しないことをお勧めします。 代わりに、キーワード (keyword)の DestinationUrl 要素を設定する必要があります。

文字列には、最大 1,022 文字を含めることができます。 実際の制限は、置換文字列を参照する要素の長さによって異なります。 たとえば、テキスト広告のタイトルの長さは最大 25 文字です。

広告コピーに動的テキストを実装する場合は、既定の文字列 (例: {Param1:default} を指定する必要があります。たとえば、キーワード (keyword)の Param1 が null または空の場合、または Param1 置換値を含めると、展開された文字列が要素の制限を超える場合、広告はこのキーワード (keyword)で機能しません。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

また、広告グループに広告が 1 つだけあり、その広告で {Param1} が使用されているが、既定の文字列 ({Param1:default} など) が指定されていない場合は、その置換に有効な Param1 値を指定する必要があることに注意してください。 それ以外の場合、このキーワード (keyword)を追加または更新することはできません。

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

Param2

タイトル、テキスト、表示 URL、または宛先 URL に {Param2} 動的置換文字列が含まれている場合に、広告の置換値として使用する文字列。

通常、{Param2} 置換文字列は、広告のタイトル要素またはテキスト (広告コピーの説明) 要素で使用します。

文字列には、最大 70 文字を含めることができます。 実際の制限は、置換文字列を参照する要素の長さによって異なります。 たとえば、テキスト広告のタイトルの長さは最大 25 文字です。

広告コピーに動的テキストを実装する場合は、既定の文字列 (例: {Param2:default} を指定する必要があります。たとえば、キーワード (keyword)の Param2 が null または空の場合、または Param2 置換値を含めると展開された文字列が要素の制限を超える場合、広告はこのキーワード (keyword)で機能しません。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

また、広告グループに広告が 1 つだけあり、その広告で {Param2} が使用されているが、既定の文字列 ({Param2:default} など) が指定されていない場合は、その置換に有効な Param2 値を指定する必要があります。 それ以外の場合、このキーワード (keyword)を追加または更新することはできません。

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

Param3

タイトル、テキスト、表示 URL、または宛先 URL に {Param3} 動的置換文字列が含まれている場合、広告の置換値として使用する文字列。

通常、{Param3} 置換文字列は、広告のタイトル要素またはテキスト (広告コピーの説明) 要素で使用します。

文字列には、最大 70 文字を含めることができます。 実際の制限は、置換文字列を参照する要素の長さによって異なります。 たとえば、テキスト広告のタイトルの長さは最大 25 文字です。

広告コピーに動的テキストを実装する場合は、既定の文字列 (例: {Param3:default} を指定する必要があります。たとえば、キーワード (keyword)の Param3 が null または空の場合、または Param3 置換値を含めると展開された文字列が要素の制限を超える場合、広告はこのキーワード (keyword)で機能しません。 詳細については、Microsoft Advertising のヘルプ記事「 動的テキスト パラメーターを使用して広告を自動的にカスタマイズする」を参照してください。

また、広告グループに広告が 1 つだけあり、その広告で {Param3} が使用されているが、既定の文字列 (例: {Param3:default}) が指定されていない場合は、その置換に有効な Param3 値を指定する必要があることに注意してください。 それ以外の場合、このキーワード (keyword)を追加または更新することはできません。

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

Parent Id

キーワード (keyword)を含む広告グループのシステム生成識別子。

この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。

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

注:

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

発行元の国

編集ガイドラインで指定した 用語が許可されていない発行元の国または地域の一覧。

一括ファイルでは、発行元の国またはリージョンの一覧はセミコロン (;)で区切られます。

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

品質スコア

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

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

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

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

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

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

状態

キーワード (keyword)の状態。

使用可能 な値は、アクティブ、 一時停止、 非アクティブ、または 削除です。

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

追跡テンプレート

FinalUrls で指定された 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 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用