カスタム対象ユーザーレコード - 一括
一括ファイルでダウンロードおよびアップロードできるカスタム対象ユーザーを定義します。
注:
アップロードには、 対象ユーザー (対象ユーザー 名) フィールドと [説明] フィールドの更新のみがサポートされています。 Bing広告 API を使用してカスタム対象ユーザーを削除することはできますが、追加することはできません。 そうは言っても、カスタム対象ユーザーの関連付けと除外を追加および削除できます。
カスタム オーディエンスは、独自の顧客データを使用して、より豊富なユーザー セグメントを作成することによって生成されるリマーケティング リストの一種です。 カスタム オーディエンスは、通常、データ管理プロバイダー (DMP) を通じて、リマーケティング リストと組み合わせて使用できます。 DMP がカスタムオーディエンス機能に接続すると、カスタムオーディエンスを Microsoft 広告にインポートして検索リマーケティングを行うことができます。 カスタム オーディエンスはリマーケティングとは別に使用でき、UET は必要ありません。
ヒント
対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。
DownloadCampaignsByAccountIds またはDownloadCampaignsByCampaignIds サービス要求に CustomAudiences の DownloadEntity 値を含めることで、アカウント内のすべてのカスタム 対象ユーザー レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。
次の一括 CSV の例では、カスタム対象ユーザーの説明を更新します。 注: カスタム対象ユーザーの場合、Microsoft Advertising Web アプリケーションではメンバーシップ期間が設定されず、Microsoft Advertising はカスタム対象ユーザー プロバイダーの設定に延期されます。
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience
.NET、Java、または Python 用 の Bing Ads SDK を 使用している場合は、 BulkServiceManager を使用して BulkCustomAudience オブジェクトをアップロードしてダウンロードする時間を節約できます。サービス操作を直接呼び出し、カスタム コードを記述してバルク ファイル内の各フィールドを解析する代わりにします。
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CustomAudience object of the Campaign Management service.
CustomAudience = new CustomAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "Updated Custom Audience Description",
// 'Id' column header in the Bulk file
Id = customAudienceIdKey,
// 'Audience' column header in the Bulk file
Name = null,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Scope' column header in the Bulk file
Scope = null,
// 'Audience Search Size' column header in the Bulk file
SearchSize = null,
// 'Supported Campaign Types' column header in the Bulk file
SupportedCampaignTypes = null,
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCustomAudience);
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
- スコープ
- 状態
- サポートされているキャンペーンの種類
対象ユーザー
カスタム対象ユーザーの名前。
名前には最大 128 文字を使用することができます。
追加： サポートされていません
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用
対象ユーザーのネットワーク サイズ
対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。
Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。
追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用
対象ユーザーの検索サイズ
検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。
Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。
このプロパティは、対象ユーザーの作成中に最大 24 時間空になります。たとえば、DMP から新しいカスタム 対象ユーザーをインポートした場合、対象ユーザーの作成に 24 時間かかり、その間、このプロパティは空になります。
追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用
クライアント ID
一括アップロード ファイル内のレコードを結果ファイル内のレコードに関連付けるために使用されます。 このフィールドの値は、サーバーによって使用または格納されません。アップロードされたレコードから対応する結果レコードにコピーされます。 最大 100 の長さの任意の有効な文字列を指定できます。
追加： サポートされていません
更新： オプション
削除： 読み 取り 専用
説明
カスタム対象ユーザーの説明。 説明を使用して、このカスタム 対象ユーザーを対象とする対象ユーザーを覚えておくのに役立ちます。
説明には、最大 1,024 文字を含めることができます。
追加： サポートされていません
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用
Id
カスタム対象ユーザーのシステム生成識別子。
追加： サポートされていません
更新： 必須
削除： 読み取り専用と必須
メンバーシップ期間
メンバーシップ期間は、ユーザーをリストに追加するために、Microsoft Advertising がカスタム対象ユーザー定義に一致するアクションを検索する必要がある期間を決定します。 カスタム対象ユーザーの場合、Microsoft Advertising Web アプリケーションではメンバーシップ期間が設定されず、Microsoft Advertising ではカスタム対象ユーザー プロバイダーの設定が延期されます。
Bing広告 API を使用してカスタム対象ユーザーを要求すると、返されるメンバーシップ期間は null になります。
追加： サポートされていません
更新： サポートされていません
削除： 読み 取り 専用
変更時刻
エンティティが最後に更新された日付と時刻。 値は、世界協定時刻 (UTC) です。
注:
日付と時刻の値は、クライアントではなく、サーバーでの日付と時刻を反映します。 日付と時刻の形式については、「 プリミティブ XML データ型」の dateTime エントリを参照してください。
追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用
Parent Id
カスタム対象ユーザーを含む顧客の Microsoft Advertising 識別子。
追加： サポートされていません
更新： 必須
削除： 読み 取り 専用
範囲
スコープは、このカスタム 対象ユーザーを使用できるアカウントを定義します。 カスタム対象ユーザーの場合、サポートされている範囲は Customer のみです。カスタム対象ユーザーは、顧客のすべてのアカウントの任意のキャンペーンや広告グループに関連付けることができます。
追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用
状態
カスタム対象ユーザーの状態。
使用可能な値は [アクティブ] または [削除済み] です。
追加： サポートされていません
更新： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。
サポートされているキャンペーンの種類
このカスタム対象ユーザーをサポートするキャンペーンの種類のセミコロン区切りのリスト。
サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。
追加： サポートされていません
更新： 読み 取り 専用
削除： 読み 取り 専用