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

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

アカウント内のすべてのリマーケティング リスト レコードをダウンロードする場合は、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();

リマーケティング リスト レコードの場合、一括ファイル スキーマでは次の属性フィールドを使用できます。

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

Audience

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

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

足す： 必須
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

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

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

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

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

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

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

クライアント ID

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

足す： 随意
更新： 随意
削除： 読み取り専用

説明

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

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

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

Id

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

足す： 読み取り専用
更新： 読み取り専用と必須
削除： 読み取り専用と必須

メンバーシップ期間

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

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

足す： 随意
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

変更時刻

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

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

通常のフォームが接続 (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))

論理式の評価によって、次の例のユーザーのうち、リマーケティング リストに追加されるユーザーが決まります。

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)))

論理式の評価によって、次の例のユーザーのうち、リマーケティング リストに追加されるユーザーが決まります。

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)))

論理式の評価によって、次の例のユーザーのうち、リマーケティング リストに追加されるユーザーが決まります。

範囲

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

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

状態

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

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

足す： 随意。 既定値は [アクティブ] です。
更新： 読み取り専用
削除： 必須。 [状態] を [削除済み] に設定する必要があります。

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

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

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

足す： 読み取り専用
更新： 読み取り専用
削除： 読み取り専用

UET タグ ID

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

足す： 必須
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用