製品の対象ユーザーレコード - 一括

一括ファイルでダウンロードおよびアップロードできる製品の対象ユーザーを定義します。

注:

動的リマーケティング リストは、以前は Microsoft Advertising で製品の対象ユーザーとして知られていました。 Microsoft Advertising UI には "動的リマーケティング リスト" と表示されますが、破壊的変更を避けるために、API objets には "製品の対象ユーザー" という名前が付けられます。

動的リマーケティング リストは、ユーザーがウェブサイトで見た内容、検討済み、または既に購入した内容に基づいて、特定の製品と顧客をペアリングします。 動的リマーケティング リストは、検索キャンペーンと対象ユーザー キャンペーンの両方で使用できます (すべてのユーザーがまだ対象ユーザー キャンペーンを持っているわけではありません)。

動的リマーケティング リストは、ショッピング キャンペーンとフィードベースのオーディエンス キャンペーン(Microsoft Merchant Center ストア ID を利用するキャンペーン)の両方で最適に機能します。

重要

Web サイトの UET タグ ID に対応するスクリプトを編集して、 パラメーターと ecomm_pagetype パラメーターをecomm_prodid含めます。 ecomm_prodid パラメーターは、ページ上の製品の製品 ID です。 アイテムごとに一意であり、製品フィードの id 属性または item_group_id 属性と一致する必要があります。 数字と英数字 (ハイフンを含む) 文字のみ(最大 50 文字)。 ecomm_pagetype パラメーターは、ユーザーがアクセスしたページの種類を識別します。 有効なオプション: ホーム、検索結果、カテゴリ、製品、カート、購入、その他。

window.uetq = window.uetq || [];
window.uetq.push('event', '', {'ecomm_prodid': 'REPLACE_WITH_PRODUCT_ID', 'ecomm_pagetype': 'REPLACE_WITH_PAGE_TYPE'});

ヒント

対象ユーザーの概要と詳細については、 対象ユーザー API の テクニカル ガイドを参照してください。

DownloadCampaignsByAccountIds またはDownloadCampaignsByCampaignIds サービス要求に ProductAudiences の DownloadEntity 値を含めることで、アカウント内のすべての Product Audience レコードをダウンロードできます。 さらに、ダウンロード要求には EntityData スコープを含める必要があります。 ベスト プラクティスを含む一括サービスの詳細については、「 一括ダウンロードとアップロード」を参照してください。

次の一括 CSV の例では、新しい製品の対象ユーザーを追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Product Audience Type,Supported Campaign Types
Format Version,,,,,,6.0,,,,,,,
Product Audience,Active,-10,ParentIdHere,ClientIdGoesHere,,,New product audience,30,Account,TagIdHere,My Product Audience,GeneralVisitors,Search;DynamicSearchAds;Shopping;Audience

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAudience
var bulkProductAudience = new BulkProductAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAudience object of the Campaign Management service.
    ProductAudience = new ProductAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New product audience",
        // 'Id' column header in the Bulk file
        Id = productAudienceIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "My Product Audience",
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Product Audience Type' column header in the Bulk file
        ProductAudienceType = ProductAudienceType.GeneralVisitors,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'UET Tag Id' column header in the Bulk file
        TagId = tagIdKey
    },

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkProductAudience);

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

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

Product Audience レコードの場合、一括ファイル スキーマでは、次の属性フィールドを使用できます。

• 対象ユーザー
• 対象ユーザーのネットワーク サイズ
• 対象ユーザーの検索サイズ
• クライアント ID
• 説明
• Id
• メンバーシップ期間
• 変更時刻
• Parent Id
• 製品の対象ユーザーの種類
• スコープ
• 状態
• サポートされているキャンペーンの種類
• UET タグ ID

対象ユーザー

製品の対象ユーザーの名前。

名前には最大 128 文字を使用することができます。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

対象ユーザーのネットワーク サイズ

対象ユーザー ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、対象となる対象ユーザーの数を把握できます。

Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。

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

対象ユーザーの検索サイズ

検索ネットワーク内のこの対象ユーザーのアクティブ メンバーであるユーザーの合計数。 これにより、ターゲットにできる検索ユーザーの数を把握できます。

Microsoft Advertising が最適化に使用する前に、対象ユーザーは少なくとも 300 人である必要があります。

このプロパティは、対象ユーザーの作成中に最大 24 時間空になります(たとえば、製品の対象ユーザーのメンバーシップ期間、ルール、タグ識別子を追加または更新する場合)。

このプロパティは、製品の対象ユーザーに関連付けられている UET タグの状態が [未確認] または [非アクティブ] の場合、リストの作成に必要な顧客情報を Web サイトから受け取ることができないため、空になります。

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

クライアント ID

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

追加： オプション
更新： オプション
削除： 読み 取り 専用

説明

製品の対象ユーザーの説明。 説明を使用して、この製品の対象ユーザーを対象とする対象ユーザーを思い出すのに役立ちます。

説明には、最大 1,024 文字を含めることができます。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 このフィールドを delete_value 文字列に設定すると、前の設定は削除されます。
削除： 読み 取り 専用

Id

製品の対象ユーザーのシステム生成識別子。

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

メンバーシップ期間

製品の対象ユーザーを作成するときに、Microsoft Advertising が製品の対象ユーザー定義に一致するアクションを検索してリストにユーザーを追加する必要がある時間を指定できます。

mimimum 期間は 1 日で、許可される最大期間は 180 日です。

追加： オプション
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

変更時刻

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

注:

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

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

Parent Id

アカウントまたは顧客のシステム生成識別子。 [スコープ] が [アカウント] に設定されている場合、これはアカウント ID、それ以外の場合は顧客 ID です。

追加： オプション
更新： 読み 取り 専用。 親 ID は変更できません。
削除： 読み 取り 専用

製品の対象ユーザーの種類

製品の対象ユーザーに追加するユーザーを決定します。

使用可能な値は GeneralVisitors、ProductSearchers、ProductViewers、ShoppingCartAbandoners、および PastBuyers です。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

範囲

スコープは、この製品の対象ユーザーを使用できるアカウントを定義します。 スコープが [アカウント] に設定されている場合、製品の対象ユーザーは、指定した 1 つのアカウント (親 ID) 内のキャンペーンと広告グループにのみ関連付けることができます。 スコープが [顧客] に設定されている場合、製品の対象ユーザーは、顧客のすべてのアカウントのキャンペーンや広告グループに関連付けることができます。

追加： 必須
更新： 読み 取り 専用。 スコープを変更することはできません。
削除： 読み 取り 専用

状態

製品の対象ユーザーの状態。

使用可能な値は [アクティブ] または [削除済み] です。

追加： オプション。 既定値は [アクティブ] です。
更新： 読み 取り 専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

サポートされているキャンペーンの種類

この製品の対象ユーザーをサポートするキャンペーンの種類のセミコロン区切りの一覧。

サポートされる値は、対象ユーザー、DynamicSearchAds、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。

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

UET タグ ID

製品の対象ユーザーと共に使用されるユニバーサル イベント 追跡 (UET) タグの Microsoft Advertising 識別子。

重要

Web サイトの UET スクリプトを編集して、 パラメーターと pagetype パラメーターをprodid含めます。

window.uetq = window.uetq || [];
window.uetq.push({'prodid': 'PRODUCT_ID', 'pagetype': 'PAGE_TYPE'});

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み 取り 専用

CustomEvents ルール テンプレート

CustomEvents ルールの場合は、次の条件付きイベント演算子のペア (ActionOperator と Action)、(CategoryOperator と Category)、(LabelOperator と Label)、(ValueOperator、Value) の 1 つ以上を含める必要があります。 複数の条件を指定した場合、論理 AND 演算子を使用して条件が結合されます。 つまり、指定されたすべてのルール条件が満たされている場合にのみ、訪問者が製品の対象ユーザーに追加されます。

たとえば、次のカスタム イベントが一括ファイルの論理式として設定されるとします。

CustomEvents(Category Equals video) と (Action Equals play) と (Label Equals trailer) and (Value Equals 5)

論理式の評価によって、製品の対象ユーザーに追加されるユーザーが決まります。

PageVisitors ルール テンプレート

PageVisitors ルールの場合は、1 つ以上のルール項目グループを含める必要があります。 各ルール項目グループでは、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。 つまり、いずれかのルール項目グループ内の指定されたルール項目条件がすべて満たされている場合、ユーザーは製品の対象ユーザーに追加されます。

たとえば、次のルール項目グループが一括ファイルの論理式として設定されるとします。

PageVisitors((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))

論理式の評価によって、次の例のユーザーのうち、製品の対象ユーザーに追加されるユーザーが決まります。

User	アクセスされた URL	参照元 URL	リストに追加
ユーザー 1	A	X	はい。 論理式の結果を True として評価 します。 ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z)) (False と True) または (True) または (False) False または True または False True
ユーザー 2	B	Y	いいえ。 論理式の評価の結果は False です。 ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z)) (False と True) または (False) または (False) False または False または False False
ユーザー 3	C	Z	はい。 論理式の結果を True として評価 します。 ((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z)) (False と False) または (True) または (True) False または True または True True

PageVisitorsWhoDidNotVisitAnotherPage ルール テンプレート

リマーケティング ルールは、製品の対象ユーザーに追加するユーザーを決定するために使用される条件です。 PageVisitorsWhoDidNotVisitAnotherPage ルールの場合は、アクセスしたページの 1 つ以上のルール項目グループ (IncludeRuleItemGroups) を含める必要があります。また、アクセスされていないページの 1 つ以上のルール項目グループ (ExcludeRuleItemGroups) も含める必要があります。

IncludeRuleItemGroups 内のルール項目グループごとに、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。

同様に、 ExcludeRuleItemGroups 内のルール項目グループごとに、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。 最後に、論理 NOT 演算子は、除外ルール項目グループの集計結果に適用されます。

つまり、含めるルール項目グループの条件のいずれかが満たされ、除外ルール項目グループの条件が満たされていない場合、訪問者は製品の対象ユーザーに追加されます。

たとえば、次のルール項目グループが一括ファイルの論理式として設定されるとします。

(((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) ではなく (((Url BeginsWith A) および (ReferrerUrl BeginsWith B)) または ((Url Contains C)))

論理式の評価によって、次の例のユーザーのうち、製品の対象ユーザーに追加されるユーザーが決まります。

User	アクセスされた URL	参照元 URL	リストに追加
ユーザー 1	A	X	はい。 論理式の結果を True として評価 します。 (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) ではなく (((Url BeginsWith A) および (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と True) または (True) または (False)) ではなく ((True と False) または (False)) (False または True または False) ではなく (False または False) False ではなく True True
ユーザー 2	B	Y	はい。 論理式の結果を True として評価 します。 (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) ではなく (((Url BeginsWith A) および (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と True) または (True) または (False)) ではなく ((False と False) または (False)) (False または True または False) ではなく (False または False) False ではなく True True
ユーザー 3	C	Z	いいえ。 論理式の評価の結果は False です。 (((Url Contains X) and (ReferrerUrl DoesNotContain Z)) または ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) ではなく (((Url BeginsWith A) および (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と False) または (True) または (True)) ではなく ((False と False) または (True)) (False または True または True) ではなく (False または True) True ではなく True False

PageVisitorsWhoVisitedAnotherPage ルール テンプレート

リマーケティング ルールは、製品の対象ユーザーに追加するユーザーを決定するために使用される条件です。 PageVisitorsWhoVisitedAnotherPage ルールの場合、アクセスしたページの 1 つ以上のルール項目グループ (RuleItemGroups) を含める必要があります。また、アクセスする必要がある別のページの 1 つ以上のルール項目グループ (AnotherRuleItemGroups) も含める必要があります。

RuleItemGroups 内のルール項目グループごとに、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。

同様に、 AnotherRuleItemGroups 内のルール項目グループごとに、同じページのルール項目の条件が論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。

つまり、いずれかのルールアイテムグループ条件が満たされ、別のルールアイテムグループ条件のいずれかが満たされている場合、訪問者は製品の対象ユーザーに追加されます。

たとえば、次のルール項目グループが一括ファイルの論理式として設定されるとします。

(((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) および (((Url BeginsWith A) と (ReferrerUrl BeginsWith B)) または ((Url Contains C)))

論理式の評価によって、次の例のユーザーのうち、製品の対象ユーザーに追加されるユーザーが決まります。

User	アクセスされた URL	参照元 URL	リストに追加
ユーザー 1	A	X	いいえ。 論理式の評価の結果は False です。 (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) および (((Url BeginsWith A) と (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と True) または (True) または (False)) と ((True と False) または (False)) (False または True または False) と (False または False) True と False False
ユーザー 2	B	Y	いいえ。 論理式の評価の結果は False です。 (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) および (((Url BeginsWith A) と (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と True) または (True) または (False)) と ((False と False) または (False)) (False または True または False) と (False または False) True と False False
ユーザー 3	C	Z	はい。 論理式の結果を True として評価 します。 (((Url Contains X) and (ReferrerUrl NotEquals Z)) or ((Url DoesNotBeginWith Y)) または ((ReferrerUrl Equals Z))) および (((Url BeginsWith A) と (ReferrerUrl BeginsWith B)) または ((Url Contains C))) ((False と True) または (True) または (True)) と ((False と False) または (True)) (False または True または True) と (False または True) True と True True