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

負のキーワード (keyword)リストで共有され、一括ファイルでダウンロードおよびアップロードできる負のキーワード (keyword)を定義します。

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

次の一括 CSV の例では、有効な負のキーワード (keyword)リスト ID (親 ID) を指定して、負のキーワード (keyword)リストに新しい負のキーワード (keyword)を追加します。

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

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkSharedNegativeKeyword
var bulkSharedNegativeKeyword = new BulkSharedNegativeKeyword
{
    // '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"
    },

    // 'Parent Id' column header in the Bulk file
    NegativeKeywordListId = negativeKeywordListIdKey,

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkSharedNegativeKeyword);

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

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

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

• クライアント ID
• Id
• キーワード
• 一致の種類
• 変更時刻
• Parent Id
• 状態

クライアント ID

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

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

Id

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

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

キーワード

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

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

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

一致の種類

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

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

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

変更時刻

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

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

Parent Id

負のキーワード (keyword)を含む負のキーワード (keyword)リストのシステム生成識別子。

この一括フィールドは、負のキーワード リスト レコードの Id フィールドにマップされます。

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

状態

負のキーワード (keyword)リストと負のキーワード (keyword)の間の関連付けの状態を表します。

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

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

追加： オプション。 既定値は [アクティブ] です。
更新： 適用されません。 負のキーワード (keyword)は追加および削除できますが、更新することはできません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。