広告グループの否定的な性別基準レコード - 一括
一括ファイルでアップロードおよびダウンロードできる広告グループの否定的な性別基準を定義します。
性別別にユーザーを除外して、興味を持つユーザーに広告を表示する頻度を増やすことができます。
広告グループ レベルの性別基準が指定されている場合、その広告グループのキャンペーン レベルの性別基準は無視されます。 つまり、広告グループの性別基準はキャンペーンの性別基準をオーバーライドし、和集合として適用されません。
ヒント
ターゲット条件の使用方法の概要については、「ターゲット オーディエンスに広告を表示する」を参照してください。
AdGroupTargetCriterions の DownloadEntity 値を DownloadCampaignsByAccountIds または DownloadCampaignsByCampaignIds サービス要求に含めることで、アカウント内のすべての広告グループの否定的な性別基準レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、有効な 親 ID 値が指定されている場合に、新しい広告グループの否定的な性別基準を追加します。
Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Client Id,Modified Time,Target,,Name,OS Names,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,,6.0,,,,,,,,,
Ad Group Negative Gender Criterion,Active,,-1111,,,,ClientIdGoesHere,,Female,,,,,,,,,,,
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkAdGroupNegativeGenderCriterion オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述して一括ファイル内の各フィールドを解析する代わりにします。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkAdGroupNegativeGenderCriterion
var BulkAdGroupNegativeGenderCriterion = new BulkAdGroupNegativeGenderCriterion
{
// '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
// NegativeAdGroupCriterion object of the Campaign Management service.
NegativeAdGroupCriterion = new NegativeAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new GenderCriterion
{
// 'Target' column header in the Bulk file
GenderType = GenderType.Female
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.Active,
}
};
uploadEntities.Add(BulkAdGroupNegativeGenderCriterion);
var entityUploadParameters = new EntityUploadParameters
{
Entities = uploadEntities,
ResponseMode = ResponseMode.ErrorsAndResults,
ResultFileDirectory = FileDirectory,
ResultFileName = DownloadFileName,
OverwriteResultFile = true,
};
var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();
広告グループの負の性別基準レコードの場合は、一括ファイル スキーマで次の属性フィールドを使用できます。
広告グループ
この条件が適用または削除される広告グループの名前。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
キャンペーン
この条件が適用または削除される広告グループを含むキャンペーンの名前。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： オプション
更新： オプション
削除： オプション
Id
条件の Microsoft Advertising 一意識別子。
注:
以前は、Campaign Management API バージョン 10 では、AddTargetsToLibrary、SetTargetToCampaign、および SetTargetToAdGroup 操作を使用して、1 つのターゲット識別子を複数のキャンペーンと広告グループに関連付けることができました。 キャンペーンまたは広告グループの関連付けが共有ターゲットから解除されると、一括ダウンロードまたは一括アップロードの結果ファイルで基準識別子が 0 (ゼロ) に設定されます。
追加： 読み 取り 専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： 読み 取り 専用
更新： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
この条件が適用または削除される広告グループの識別子。
この一括フィールドは、広告グループ レコードの Id フィールドにマップされます。
追加： 読み取り専用と必須。 既存の広告グループ識別子を指定するか、親広告グループ レコードの Id フィールドと等しい負の識別子を指定する必要があります。 これは、同じ Bulk ファイル内の新しい広告グループに新しい条件を追加する場合に推奨されます。 詳細については、「 一括ファイル スキーマ参照キー」を参照してください。
更新： 読み取り専用と必須
削除： 読み取り専用と必須
状態
広告グループと条件の間の関連付けの状態を表します。 条件が広告グループに適用されている場合、このフィールドの値は [アクティブ] になります。 条件を削除するには、状態を [削除済み] に設定します。
追加： 読み 取り 専用。 条件を追加すると、状態は常に [アクティブ] に設定されます。 たとえば、別の値をアップロードした場合、 Foo 結果ファイルには同じ値が含まれますが、条件はアクティブです。
更新： オプション
削除： 必須。 [状態] を [削除済み] に設定する必要があります。 特定の性別基準を削除するには、 状態、 ID、 親 ID をアップロードする必要があります。
Target
除外する性別。
サポートされる値は 、女性 と 男性です。 対象ユーザー キャンペーンでは、 性別 が不明なユーザーを除外することもできます。
追加： 必須
更新： 必須
削除： 読み 取り 専用