次の方法で共有

キャンペーンの除外キーワード リストの関連付けレコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできる キャンペーン と 負のキーワード リスト の間の関連付けレコードを定義します。 キャンペーンまたは除外キーワード リストをアップロードまたはダウンロードするには、[ キャンペーン] レコードまたは [除外キーワード リスト] レコードを使用します。

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

次の一括 CSV の例では、有効な ID と親 ID の値が指定されている場合、除外キーワード リストをキャンペーンに関連付けます。

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

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeKeywordList
var bulkCampaignNegativeKeywordList = new BulkCampaignNegativeKeywordList
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // SharedEntityAssociation object of the Campaign Management service.
    SharedEntityAssociation = new SharedEntityAssociation
    {
        // 'Parent Id' column header in the Bulk file
        EntityId = campaignIdKey,
        // 'Id' column header in the Bulk file
        SharedEntityId = negativeKeywordListIdKey,
    },

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

uploadEntities.Add(bulkCampaignNegativeKeywordList);

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 List Association レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

キャンペーン

除外キーワード リストが関連付けられているか削除されるキャンペーンの名前。

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

注:

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

クライアント ID

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

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

Id

キャンペーンに関連付けられている、またはキャンペーンから削除された除外キーワード リストの識別子。

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

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

変更時刻

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

注:

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

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

Parent Id

この除外キーワード リストが関連付けられているか削除されるキャンペーンの識別子。

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

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

注:

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

状態

キャンペーンと除外キーワード リストの間の関連付けの状態を表します。 除外キーワード リストがキャンペーンに関連付けられていない場合、このフィールドの値は [アクティブ] になります。 条件を削除するには、状態を [削除済み] に設定します。

追加： 読み 取り 専用。 条件を追加すると、状態は常に [アクティブ] に設定されます。 たとえば、別の値をアップロードした場合、 Foo 結果ファイルには同じ値が含まれますが、条件はアクティブです。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。