広告グループの配置基準レコード - 一括

[アーティクル]
01/04/2025

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

プレースメントターゲティングを使用すると、潜在的なユーザーの位置と広告を表示する場所を定義できます。

注:

広告グループレベルの配置条件のみがサポートされるようになりました。

ヒント

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

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

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

Type,Status,Id,Parent Id,Target,Bid Adjustment,Name
Format Version,,,,,,6.0
Ad Group Placement Criterion,Active,,parentId,placementId,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupPlacementCriterion
var bulkAdGroupPlacementCriterion = new BulkAdGroupPlacementCriterion
{
    // '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 PlacementCriterion
        {
            // 'Target' column header in the Bulk file
            PlacementId = placementIdKey
        },

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

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

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

uploadEntities.Add(bulkAdGroupPlacementCriterion);

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
状態
Target

広告グループ

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

入札単価調整

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

警告

現在、広告グループの配置条件の入札単価調整はサポートされていません。入札単価調整値は 0 にリセットされます。

足す： 随意
更新： 随意
削除： 読み取り専用

キャンペーン

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

クライアント ID

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

足す： 随意
更新： 随意
削除： 随意

Id

条件の Microsoft Advertising 一意識別子。

足す： 読み取り専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須

Parent Id

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

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

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

状態

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

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

Target

対応する 入札単価調整でターゲットとする配置。

サポートされる値は 、12 NTP、 13 生産性、 14 ゲーム、 15 MSN です。

足す： 必須
更新： 必須
削除： 読み取り専用

次の方法で共有