次の方法で共有

キャンペーンの除外キーワード レコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできるキャンペーンに割り当てられた除外キーワードを定義します。

一括スキーマでは、キャンペーンに関連付けられている各除外キーワードは、独自の行で個別に表されます。 たとえば、キャンペーンに 2 つの除外キーワードがある場合、一括ファイルの [ステータス] が [アクティブ] に設定されている 2 つの [キャンペーンの除外キーワード] レコードで表されます。

注:

キャンペーンの除外キーワードは追加および削除できますが、更新することはできません。

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

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

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Campaign Negative Keyword,Active,,-112,,,ClientIdGoesHere,,shoes,Exact,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeKeyword
var bulkCampaignNegativeKeyword = new BulkCampaignNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeKeyword);

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

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

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

キャンペーン

負のキーワードを含むキャンペーンの名前。

追加： 読み取り専用と必須
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み取り専用と必須

注:

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

クライアント ID

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

追加： オプション
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み 取り 専用

Id

negative キーワードのシステム生成識別子。

追加： 読み 取り 専用
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み取り専用と必須

キーワード

負のキーワード テキスト。

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

追加： 必須
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み 取り 専用

一致の種類

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

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

追加： 必須
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み 取り 専用

変更時刻

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

注:

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

追加： 読み 取り 専用
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 読み 取り 専用

Parent Id

負のキーワードを含むキャンペーンのシステム生成識別子。

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

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

注:

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

状態

キャンペーンと負のキーワードの間の関連付けの状態を表します。

負のキーワードがキャンペーンに関連付けられている場合、このフィールドの値は [アクティブ] になります。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。 既定値は [アクティブ] です。
更新： 適用されません。 負のキーワードは追加および削除できますが、更新することはできません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。 特定の負のキーワードを削除するには、 Status、 Id、Parent Id をアップロードする必要があります。キャンペーンのすべての除外キーワードを削除するには、 ステータス と 親 ID を 1 つのレコードにアップロードするだけで済みます。 必要に応じて、削除されたセットを置き換える新しい負のキーワード レコードを追加できます。