キャンペーンの性別基準レコード - 一括

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

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

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

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

キャンペーンまたは広告グループごとに指定できる性別基準の最大数は、男性用と女性用の 2 つです。

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

ヒント

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

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

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkCampaignGenderCriterion
var bulkCampaignGenderCriterion = new BulkCampaignGenderCriterion
{
    // '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 GenderCriterion
        {
            // 'Target' column header in the Bulk file
            GenderType = GenderType.Female
        },

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

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

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

サポートされる値は 、女性 と 男性です。

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

次の方法で共有