キャンペーン DeviceOS 条件レコード - 一括

[アーティクル]
11/13/2024

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

デバイスでターゲットを設定する場合は、デスクトップやタブレットやスマートフォンを使用している潜在顧客に広告を表示することを選択します。

各デバイス条件は、関連する条件の入札単価調整のデバイス名を定義します。

キャンペーンまたは広告グループごとに指定できるデバイス条件の最大数は 3 です。 コンピューター、スマートフォン、タブレットには 3 つの異なる条件が必要です。それ以外の場合は、キャンペーンや広告グループに対してデバイスの基準を存在させてはいけません。

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

ヒント

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

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

次の一括 CSV の例では、有効な親 ID 値が指定されている場合、3 つの新しいキャンペーンデバイス条件 (デバイスの種類ごとに 1 つ) を追加します。

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 DeviceOS Criterion,Active,,-111,,,ClientIdGoesHere,,Computers,20,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Smartphones,0,,,,,,,,,
Campaign DeviceOS Criterion,,,-111,,,ClientIdGoesHere,,Tablets,0,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

var bulkCampaignDeviceCriterions = new[] {
    // Map properties in the Bulk file to the BulkCampaignDeviceCriterion
    new BulkCampaignDeviceCriterion
    {
        // '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 DeviceCriterion
            {
                // 'Target' column header in the Bulk file
                DeviceName = "Computers",
            },

            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,
        }
    },
    new BulkCampaignDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        CampaignCriterion = new BiddableCampaignCriterion
        {
            CampaignId = campaignIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Smartphones",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
    new BulkCampaignDeviceCriterion
    {
        ClientId = "ClientIdGoesHere",
        CampaignCriterion = new BiddableCampaignCriterion
        {
            CampaignId = campaignIdKey,
            Criterion = new DeviceCriterion
            {
                DeviceName = "Tablets",
            },
            CriterionBid = new BidMultiplier
            {
                Multiplier = 0,
            },
        }
    },
};

foreach (var bulkCampaignDeviceCriterion in bulkCampaignDeviceCriterions)
{
    uploadEntities.Add(bulkCampaignDeviceCriterion);
}

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

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

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

入札単価調整
キャンペーン
クライアント ID
Id
変更時刻
Parent Id
状態
Target

入札単価調整

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

サポートされる値は、-100 (負の 100) から正の 900 (900) % です。入札単価調整を -100% に設定すると、対応する ターゲットが除外されます。

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

キャンペーン

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

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

クライアント ID

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

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

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

注:

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

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

Parent Id

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

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

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

状態

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

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

Target

対応する 入札単価調整でターゲットにするデバイスの名前。

サポートされる値は、 コンピューター、 スマートフォン、 タブレットです。

追加： 必須。 コンピューター、スマートフォン、タブレットの 3 つの個別の入札は、一括ファイルにまとめて指定する必要があります (各入札は個別のレコード/行に含まれます)。 3 つのデバイスの種類を表す個々のデバイス条件を追加しない場合、キャンペーンのデバイス条件は追加されません。
更新： 必須
削除： 読み取り専用

次の方法で共有