対象ユーザー グループレコード - 一括
一括ファイルでアップロードおよびダウンロードできる対象ユーザー グループを定義します。
アカウント内のすべての対象ユーザー グループ レコードをダウンロードできます。これには、DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に AudienceGroups の DownloadEntity 値を含めることができます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkAudienceGroup オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述して一括ファイル内の各フィールドを解析する代わりにします。
対象ユーザー グループ レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。
年齢範囲
セミコロンで区切られた年齢範囲の一覧。 サポートされる値は、 18ToTwentyFour、 TwentyFiveToThirtyFour、 ThreeFiveToFourtyNine、 FiftyToSixtyFour、 SixtyFiveAndAbove です。 また、 年齢 が不明なユーザーを対象にすることもできます。
追加： オプション
更新： オプション。
- 更新プログラムに値が設定されていない場合、この設定は変更されません。
- すべての年齢範囲を削除するには、このフィールドを delete_valueに設定します。 delete_value キーワード (keyword)は、既存のすべての年齢範囲を削除します。
- 年齢範囲のサブセットを削除するには、保持する年齢範囲を指定し、保持しない年齢範囲を省略します。 新しい年齢範囲のセットは、既存の年齢範囲に置き換えられます。
対象ユーザー グループ名
対象ユーザー グループの名前。
この名前は、キャンペーン内のすべてのアクティブな対象ユーザー グループ間で一意である必要があります。 名前には、最大 256 文字を含めることができます。
追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
対象ユーザー
セミコロンで区切られた対象ユーザー ID の一覧。
追加： オプション
更新： オプション。
- 更新プログラムに値が設定されていない場合、この設定は変更されません。
- すべての対象ユーザーを削除するには、このフィールドを delete_value に設定します。 delete_value キーワード (keyword)は、既存のすべての対象ユーザーを削除します。
- 対象ユーザーのサブセットを削除するには、保持する対象ユーザーを指定し、保持しない対象ユーザーを省略します。 新しい対象ユーザーのセットは、既存の対象ユーザーに置き換えられます。
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
更新： オプション
削除： 読み 取り 専用
説明
対象ユーザーシグナルの説明。
説明には、最大 1,024 文字を含めることができます。
追加： オプション。
更新： オプション。
性別の種類
セミコロンで区切られた性別の種類の一覧。 サポートされる値は 、女性 と 男性です。 また、 性別 が不明なユーザーを対象にすることもできます。
追加： オプション
更新： オプション。
- 更新プログラムに値が設定されていない場合、この設定は変更されません。
- すべての性別の種類を削除するには、このフィールドを delete_value に設定します。 delete_value キーワード (keyword)は、既存のすべての性別の種類を削除します。
- 性別の種類のサブセットを削除するには、保持する性別の種類を指定し、保持しない種類を省略します。 新しい性別の種類のセットは、既存の型に置き換えられます。
Id
対象ユーザー グループのシステム生成識別子。
追加： オプション。 このフィールドは空のままにするか、負の識別子を指定する必要があります。 対象ユーザー グループに対して設定された負の識別子は、広告、キーワード、条件などの依存レコードタイプの [親 ID] フィールドで参照できます。 これは、同じ Bulk ファイルに新しい対象ユーザー グループと新しい依存レコードを追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
アカウント ID。
追加： オプション
更新： オプション
削除： オプション
状態
対象ユーザー グループの状態。
使用可能な値は [アクティブ]、[ 削除済み]です。
追加： オプション。
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 必須。 [状態] を [削除済み] に設定する必要があります。