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

特定の場所のユーザーに広告を表示するために使用できるキャンペーンの場所の条件を定義します。

場所の基準を使用すると、次のページに関する潜在顧客に広告を表示したり、検索したり、表示したりすることができます。

• 利用可能なすべての国/地域
• 選択した都市、郵便番号、メトロ エリア (米国の Microsoft マーケット エリア)、郡、州/都道府県、国/地域

各場所条件は、関連する条件の入札単価調整の場所コードを定義します。

キャンペーンまたは広告グループごとに指定できる場所と否定的な場所の条件を組み合わせた最大数は 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 Location Criterion,Active,,-111,Country,,ClientIdGoesHere,,190,20,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignLocationCriterion
var bulkCampaignLocationCriterion = new BulkCampaignLocationCriterion
{
    // '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 
    // BiddableCampaignCriterion object of the Campaign Management service.

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

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

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

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

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

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

uploadEntities.Add(bulkCampaignLocationCriterion);

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

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

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

• 入札単価調整
• Campaign
• クライアント ID
• Id
• 変更時刻
• Parent Id
• 状態
• Sub Type
• Target

入札単価調整

対応する ターゲットの入札単価を調整する割合。

サポートされる値は、負の 90 (-90) から正の 900 (900) です。

追加： オプション。 含まれていない場合、入札単価調整は既定値の 0 に設定されます。
更新： 必須
削除： 読み 取り 専用

キャンペーン

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

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

クライアント ID

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

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

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

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

Parent Id

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

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

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

状態

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

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

Sub Type

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

指定できる値は、 City、 Country、 County、 MetroArea、 PostalCode、 State です。

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

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

Target

対応する 入札単価調整でターゲットにする場所の識別子。

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

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