キャンペーンの負の場所基準レコード - 一括

一括ファイルでアップロードおよびダウンロードできるキャンペーンの否定的な場所の条件を定義します。

位置情報の基準は、広告を表示する特定の場所を指定するために最もよく使用されますが、Microsoft Advertising では、広告の表示から除外する場所を指定することもできます。

各否定的な場所の基準は、広告を表示しない場所のコードを定義します。

キャンペーンまたは広告グループごとに指定できる場所と否定的な場所の条件を組み合わせた最大数は 10,000 です。

広告グループ レベルの場所の基準が指定されている場合 (正または負)、その広告グループのキャンペーン レベルの場所の基準は無視されます。 つまり、広告グループの場所の基準はキャンペーンの場所の基準をオーバーライドし、和集合として適用されません。

また、場所、負の位置、半径の基準を一連の 地理的基準として考慮する必要があることにも注意してください。 広告グループに地域基準がある場合、キャンペーンの地理的条件は継承されません。 広告グループに地域基準がない場合は、キャンペーンのすべての地理的条件が継承されます。 地域基準は、広告グループに位置情報の意図条件がある場合でも、キャンペーンから継承できます。 広告グループの地理的条件が使用されている場合は、広告グループの位置情報の意図条件が使用されます。キャンペーンの地理的条件が継承されている場合、キャンペーンの位置情報の意図条件が使用され、広告グループの位置情報の意図条件は無視されます。 キャンペーンや広告グループの場所の意図条件は削除できませんが、場所や半径の基準を持たない目的はありません。

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

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

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Negative Location Criterion,,,-111,PostalCode,,ClientIdGoesHere,,79381,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignNegativeLocationCriterion
var bulkCampaignNegativeLocationCriterion = new BulkCampaignNegativeLocationCriterion
{
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.

    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new LocationCriterion
        {
            // 'Target' column header in the Bulk file
            LocationId = 79381,

            // 'Sub Type' column header in the Bulk file
            LocationType = "PostalCode"
        },

        // 'Id' column header in the Bulk file
        Id = null,

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

uploadEntities.Add(bulkCampaignNegativeLocationCriterion);

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

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

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

• キャンペーン
• クライアント ID
• Id
• 変更時刻
• Parent Id
• 状態
• Sub Type
• Target

キャンペーン

この条件が適用または削除されるキャンペーンの名前。

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

クライアント ID

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

追加： オプション
更新： オプション
削除： オプション

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

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

Parent Id

この条件が適用または削除されるキャンペーンの識別子。

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

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

状態

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

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

Sub Type

ターゲットにしていない場所のサブタイプ。 たとえば、レコードが 市区町村 の基準を表す場合、値は City です。

新しい場所のサブタイプはいつでも追加できます。 特定の場所 ID の場所の種類が変更されることはほとんどありません。

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

Target

ターゲットにしない場所の識別子。

使用可能な値については、地理的な場所ファイルの [場所 ID] フィールドを参照してください。 GetGeoLocationsFileUrl 操作を呼び出して、ファイルをダウンロードできます。

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