次の方法で共有

広告グループの場所基準レコード - 一括

  • [アーティクル]

一括ファイルでアップロードおよびダウンロードできる広告グループの場所の条件を定義します。

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

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

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

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

注:

広告グループごとに 1 つの広告グループの場所の意図条件レコードのみを使用して、すべての広告グループの [広告グループの場所基準] レコードと [広告グループの半径基準] レコードに適用される場所の意図オプションを決定できます。 広告グループの最初の条件を作成すると、既定の [ターゲット] が PeopleInOrSearchingForOrViewingPages に設定された広告グループの場所の意図基準レコードも自動的に追加されます。 広告グループに他の基準があるかどうかに関係なく、広告グループの [広告 グループの場所の意図条件] を追加または更新できます。 広告グループの [広告グループの場所の意図の基準] は削除できませんが、場所や半径の基準がない目的はありません。

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

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

ヒント

ターゲット条件の使用方法の概要については、「ターゲット オーディエンスに広告を表示する」を参照してください。

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

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

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,Bid Adjustment,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Location Criterion,Active,,-1111,Country,,,ClientIdGoesHere,,190,20,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupLocationCriterion
var bulkAdGroupLocationCriterion = new BulkAdGroupLocationCriterion
{
    // 'Ad Group' column header in the Bulk file is read-only
    AdGroupName = null,

    // '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 
    // BiddableAdGroupCriterion object of the Campaign Management service.

    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,

        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 = AdGroupCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkAdGroupLocationCriterion);

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

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

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

広告グループ

この条件が適用または削除される広告グループの名前。

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

入札単価調整

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

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

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

キャンペーン

この条件が適用または削除される広告グループを含むキャンペーンの名前。

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

クライアント ID

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

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

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

注:

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

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

Parent Id

この条件が適用または削除される広告グループの識別子。

この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。

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

状態

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

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

Sub Type

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

注:

近隣の場所は近日公開予定です。 サブタイプは Neighborhood になります。

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

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

Target

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

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

重要

場所の条件を追加または更新する前に、地理的な場所ファイルの [状態] フィールドをチェックしてください。 状態が PendingDeprecation の場合、場所の条件はターゲットまたは除外に使用されなくなりました。 非推奨の場所条件は引き続き取得できますが、非推奨の場所条件を追加または更新することはできません。

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