広告グループの半径基準レコード - 一括

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

半径の基準を使用すると、郵便番号、座標、ランドマーク、またはエリアの周りの指定された半径に関するページを検索、または表示する潜在的な顧客に広告を表示することを選択できます。

各半径条件は、関連する条件の入札単価調整の半径、緯度、経度を定義します。

キャンペーンまたは広告グループごとに指定できる半径基準の最大数は 2,000 です。

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

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

AdGroupTargetCriterions の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての広告グループ半径基準レコードをダウンロードできます。 さらに、ダウンロード要求には 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 Radius Criterion,Active,,-1111,,,,ClientIdGoesHere,,RadiusName,20,,,10,Kilometers,,,,,10.5,40.5

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupRadiusCriterion
var bulkAdGroupRadiusCriterion = new BulkAdGroupRadiusCriterion
{
    // '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 RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        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(bulkAdGroupRadiusCriterion);

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

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

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

• 広告グループ
• 入札単価調整
• キャンペーン
• クライアント ID
• Id
• Latitude
• Longitude
• 変更時刻
• 名前
• Parent Id
• 半径
• 状態
• 単位

広告グループ

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

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

入札単価調整

対応する半径条件の入札額を調整する割合。

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

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

キャンペーン

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

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

クライアント ID

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

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

Id

条件の Microsoft Advertising 一意識別子。

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

Latitude

半径基準の緯度 (度単位)。

緯度は-85.0 以上で、+85.0 以下である必要があります。

緯度と経度を 10 進値として指定します。 たとえば、One Redmond Way、Redmond、WA の緯度と経度はそれぞれ 47.755367 と -122.091827 です。 これらの値を取得するには、地理的な場所の住所Bing マップ に入力すると、住所の下に座標が表示されます。

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

Longitude

半径基準の経度 (度単位)。

経度は-180.0 以上で、+180.0 以下である必要があります。

緯度と経度を 10 進値として指定します。 たとえば、One Redmond Way、Redmond、WA の緯度と経度はそれぞれ 47.755367 と -122.091827 です。 これらの値を取得するには、地理的な場所の住所Bing マップ に入力すると、住所の下に座標が表示されます。

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

変更時刻

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

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

名前

対象となる地理的な場所の名前。

名前には、最大 50 文字を含めることができます。

追加： オプション
更新： 読み 取り 専用
削除： 読み 取り 専用

Parent Id

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

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

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

円形

ターゲットとする地理的な場所を囲む領域を指定する半径。

[半径単位] フィールドが [マイル] に設定されている場合は、1 から 500 までの正の整数値が受け入れられます。

[半径単位] フィールドが [キロメートル] に設定されている場合は、1 から 800 までの正の整数値が受け入れられます。

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

状態

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

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

単位

指定した半径の測定単位。

サポートされる値は 、Miles (既定値) と Kms です。

追加： オプション。 指定しない場合、 Miles の既定値が設定されます。
更新： 必須
削除： 読み 取り 専用