リマーケティング リスト レコード - 一括

一括ファイルでダウンロードおよびアップロードできるリマーケティング リストを定義します。

注:

Microsoft 広告では、ユーザーがパイロット参加者である場合、リマーケティング リストの類似ユーザーが自動的に生成されます。 リマーケティング リストの類似ユーザーを作成または編集することはできません。 そうは言っても、類似のリマーケティング リストの関連付けと除外を追加および削除できます。 ソース リマーケティング リストを削除すると、同様の対象ユーザーも削除されます。 同様の対象ユーザーがキャンペーンまたは広告グループに関連付けられている場合、ソース リマーケティング リストを削除することはできません。 詳細については、「 類似リマーケティング リスト 」を参照してください。

ヒント

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

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

次の一括 CSV の例では、新しいリマーケティング リストを追加します。

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,UET Tag Id,Audience,Remarketing Rule
Format Version,,,,,,6.0,,,,,,
Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New list with CustomEventsRule,30,Account,TagIdHere,Remarketing List with CustomEventsRule,CustomEvents(Action Equals play) and (Category Equals video) and (Label Equals trailer) and (Value Equals 5.00)

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // RemarketingList object of the Campaign Management service.
    RemarketingList = new RemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New list with CustomEventsRule",
        // 'Id' column header in the Bulk file
        Id = remarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Remarketing List with CustomEventsRule " + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Remarketing Rule' column header in the Bulk file
        Rule = new CustomEventsRule
        {
            // The rule definition is translated to the following logical expression: 
            // CustomEvents(Category Equals video) and (Action Equals play) and (Label Equals trailer) 
            // and (Value Equals 5)
            Action = "play",
            ActionOperator = StringOperator.Equals,
            Category = "video",
            CategoryOperator = StringOperator.Equals,
            Label = "trailer",
            LabelOperator = StringOperator.Equals,
            Value = 5.00m,
            ValueOperator = NumberOperator.Equals,
        },
        // '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(bulkRemarketingList);

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
• リマーケティング ルール
• スコープ
• 状態
• サポートされているキャンペーンの種類
• UET タグ ID

対象ユーザー

リマーケティング リストの名前。

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

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

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

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

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

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

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

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

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

リマーケティング リストのメンバーシップ期間、ルール、タグ識別子を追加または更新する場合など、対象ユーザーが作成されている間、このプロパティは最大 24 時間空になります。

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

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

クライアント ID

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

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

説明

リマーケティング リストの説明。 説明を使用すると、このリマーケティング リストでターゲットユーザーを思い出すのに役立ちます。

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

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

Id

リマーケティング リストのシステム生成識別子。

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

メンバーシップ期間

リマーケティング リストを作成する際に、リストにユーザーを追加するために、リマーケティング リストの定義に一致するアクションを Microsoft 広告が検索する必要がある時間を指定できます。

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

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

変更時刻

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

注:

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

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

Parent Id

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

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

リマーケティング ルール

ルール テンプレートには、リマーケティング リストに追加するユーザーを決定するために使用される条件が含まれています。

さまざまな対象ユーザーを対象とする 4 種類のルールのいずれかを選択できます。 CustomEventsRule、 PageVisitorsRule、 PageVisitorsWhoDidNotVisitAnotherPageRule、 PageVisitorsWhoVisitedAnotherPageRule です。 一括ファイル内の各ルールの形式の詳細については、以下の 「CustomEvents、 PageVisitors、 PageVisitorsWhoDidNotVisitAnotherPage、 PageVisitorsWhoVisitedAnotherPage ルール テンプレートの解説」セクションを参照してください。

追加： 必須
更新： オプション。 更新プログラムに値が設定されていない場合、この設定は変更されません。 前のルール項目のいずれかを保持する場合は、更新中に明示的に再度設定する必要があります。 更新中にルールの種類を変更することもできます。
削除： 読み 取り 専用

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 つ以上のルール項目グループを含める必要があります。

重要

2021 年の暦年に、接続標準フォーム (CNF) のサポートが追加されました。 以前の Microsoft Advertising では、非接続標準形式 (DNF) のみがサポートされています。 新しいページ閲覧者ルールの既定の標準フォームは DNF のままです。 ただし、アプリケーションが CNF と DNF を適切に読み取り、区別できることを確認する必要があります。 アプリケーションでは、規則が不一番であると想定しなくなりました。

通常のフォームが接続 (CNF) の場合、同じページのルール項目の条件は、最初に論理 OR 演算子を使用して結合されます。 次に、ルール項目グループの一覧の各結果は、論理 AND 演算子を使用して結合されます。 つまり、すべてのルール アイテム グループ内の指定されたルール アイテム条件のいずれかが満たされている場合、ユーザーはリマーケティング リストに追加されます。

• 規則 1 と規則 2
• (規則 1 または規則 2)AND 規則 3
• (規則 1 または規則 2)AND (規則 3 または規則 4)

通常のフォームが結合解除 (DNF) の場合、同じページのルール項目の条件は、最初に論理 AND 演算子を使用して結合されます。 次に、ルール項目グループのリストの各結果は、論理 OR 演算子を使用して結合されます。 つまり、いずれかのルール アイテム グループ内の指定されたルール アイテム条件がすべて満たされている場合、ユーザーはリマーケティング リストに追加されます。

• 規則 1 または規則 2
• (規則 1 AND 規則 2)OR 規則 3
• (規則 1 AND 規則 2)OR (規則 3 と規則 4)

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

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

範囲

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

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

状態

リマーケティング リストの状態。

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

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

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

このリマーケティング リストをサポートするキャンペーンタイプのセミコロン区切りリスト。

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

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

UET タグ ID

リマーケティング リストで使用されるユニバーサル イベント トラッキング (UET) タグの Microsoft Advertising 識別子。

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