次の方法で共有

キャンペーンの除外サイト レコード - 一括

  • [アーティクル]

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

一括スキーマでは、キャンペーンに関連付けられている各除外サイトは、独自の行で個別に表されます。 たとえば、2 つの否定的なサイトがある場合、一括ファイルの [状態] が [アクティブ] に設定されている 2 つのキャンペーン除外サイト レコードで表されます。 関連付けられている除外サイトの更新されたリストのレコードをアップロードまたはダウンロードする場合、1 つのレコードに [状態] が [削除済み] に設定され、空の [Web サイト ] フィールドが表示されます。 これは、一覧にいくつかの変更が加えられたことを示し、その後に続く キャンペーンの否定的なサイト レコードがアクティブであることを示します。

注:

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

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合、新しいキャンペーンの除外サイトが追加されます。

Type,Status,Id,Parent Id,Campaign,Ad Group,Website,Client Id,Modified Time,Name
Format Version,,,,,,,,,6.0
Campaign Negative Site,Active,,-112,,,contoso.com,ClientIdGoesHere,,

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

var uploadEntities = new List<BulkEntity>();
	
// Map properties in the Bulk file to the BulkCampaignNegativeSites
var bulkCampaignNegativeSites = new BulkCampaignNegativeSites
{
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
                
    // Map properties in the Bulk file to the 
    // CampaignNegativeSites object of the Campaign Management service.
    CampaignNegativeSites = new CampaignNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },

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

// BulkCampaignNegativeSites does not support 'Client Id' and
// replaces all negative sites for the campaign, whereas BulkCampaignNegativeSite
// enables you to add or delete one negative site at a time.

// Map properties in the Bulk file to the BulkCampaignNegativeSite
var bulkCampaignNegativeSite = new BulkCampaignNegativeSite
{
    // '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",
    // 'Status' column header in the Bulk file
    Status = Status.Active,
    // 'Website' column header in the Bulk file
    Website = "contoso.com",
};

uploadEntities.Add(bulkCampaignNegativeSite);

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

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

キャンペーンの除外サイト レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。

キャンペーン

除外サイトを含むキャンペーンの名前。

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

注:

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

クライアント ID

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

足す： 随意
更新： 適用されません。 負のサイトは追加および削除できますが、更新することはできません。
削除： 読み取り専用

変更時刻

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

注:

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

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

Parent Id

ネガティブ サイトを含むキャンペーンのシステム生成識別子。

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

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

注:

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

状態

キャンペーンとネガティブ サイトの間の関連付けの状態を表します。

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

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

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

Web サイト

広告を表示しない Web サイトの URL。

各 URL には、ドメイン名 (最大 3 つのサブドメインと 2 つのサブディレクトリを含めることができる contoso.com など) を指定する必要があります。 サブドメイン数には 、www プレフィックスが含まれます。 たとえば、 one.two.three.contoso.com/1/2、 www.two.three.contoso.com/1/2、 one.two.contoso.co.uk/1/2 は有効な URL ですが、 one.two.three.contoso.co.uk/1/2 (サブドメインが多すぎます)、 one.two.three.contoso.com/1/2/3 (サブディレクトリが多すぎます) は有効ではありません。 キャンペーンまたは広告グループごとに重複する除外サイト URL は許可されません。

配信検索 Web サイトの Web サイトのみを除外できます。 広告グループの ネットワーク は 、OwnedAndOperatedAndSyndicatedSearch に設定する必要があります。

広告グループ レベルで指定された除外サイト URL は、キャンペーン レベルで指定された除外サイト URL ではなく使用されます。 Web サイトの除外リストを広告アカウント (キャンペーン管理サービス経由で利用可能) に関連付ける場合、除外サイトの一覧は、キャンペーンの除外サイトや広告グループの除外サイトに加えて使用されます。

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