キャンペーン年齢基準レコード - 一括

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

一括ファイルでアップロードおよびダウンロードできるキャンペーンの年齢基準を定義します。

年齢別にユーザーをターゲットにして、関心のあるユーザーに広告を表示する頻度を高めることができます。

各年齢基準は、関連する条件の入札単価調整の年齢範囲を定義します。

キャンペーンまたは広告グループごとに指定できる年齢基準の最大数は 5 です。つまり、サポートされている年齢範囲 18ToTwentyFour、 TwentyFiveToThirtyFour、 ThreeFiveToFourtyNine、 FiveyToSixtyFour、 SixtyFiveAndAbove の 1 つです。

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

ヒント

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

アカウント内のすべてのキャンペーン年齢基準レコードをダウンロードするには、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 Age Criterion,Active,,-111,,,ClientIdGoesHere,,EighteenToTwentyFour,20,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignAgeCriterion
var bulkCampaignAgeCriterion = new BulkCampaignAgeCriterion
{
    // '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 AgeCriterion
        {
            // 'Target' column header in the Bulk file
            AgeRange = AgeRange.EighteenToTwentyFour,
        },

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

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

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

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

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

入札単価調整

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

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

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

キャンペーン

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

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

クライアント ID

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

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

Id

条件の Microsoft Advertising 一意識別子。

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

変更時刻

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

注:

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

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

Parent Id

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

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

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

状態

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

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

Target

対応する 入札単価調整でターゲットとする年齢範囲。

サポートされる値は、 18ToTwentyFour、 TwentyFiveToThirtyFour、 ThreeFiveToFourtyNine、 FiftyToSixtyFour、 SixtyFiveAndAbove です。

注:

多くの国や地域では、オンライン広告主が 18 歳未満のユーザーをターゲットにすることは想定されていません。 Microsoft Advertising は、Microsoft アカウントの生年月日が 13 歳未満と識別されるお子様には、興味に基づく広告を配信しません。詳細については、 Microsoft のプライバシーに関する声明を参照してください。

現在、13 歳から 17 歳のユーザーは広告を表示できますが、その年齢範囲の入札単価を調整することはできません。 Microsoft Advertising では間もなく、13 歳から 17 歳までの年齢を特に除外できるようになります。 13ToSeventeen の目標値は、-100 から 0 の間の負の入札単価調整でサポートされます。今後数か月以内に、より具体的な日付を発表します。

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

次の方法で共有