次の方法で共有

広告グループの除外サイト レコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできる広告グループに割り当てられた否定的なサイトを定義します。

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

注:

広告グループの除外サイトは追加および削除できますが、更新することはできません。

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

次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しい広告グループの除外サイトを追加します。

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

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

var uploadEntities = new List<BulkEntity>();
	
// Map properties in the Bulk file to the BulkAdGroupNegativeSites
var bulkAdGroupNegativeSites = new BulkAdGroupNegativeSites
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // AdGroupNegativeSites object of the Campaign Management service.
    AdGroupNegativeSites = new AdGroupNegativeSites
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        NegativeSites = new[]
        {
            // 'Website' column header in the Bulk file
            "contoso.com",
        }
    },
                
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Status' column header in the Bulk file
    Status = Status.Active,
};

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

// Map properties in the Bulk file to the BulkAdGroupNegativeSite
var bulkAdGroupNegativeSite = new BulkAdGroupNegativeSite
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // '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(bulkAdGroupNegativeSite);

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

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

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

広告グループ

除外サイトを含む広告グループの名前。

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

注:

追加と削除を行うには、[ 親 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 サイトの除外リストを広告アカウント (キャンペーン管理サービス経由で利用可能) に関連付ける場合、除外サイトの一覧は、キャンペーンの除外サイトや広告グループの除外サイトに加えて使用されます。

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