インプレッション ベースのリマーケティング リスト レコード - 一括

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

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

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

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Membership Duration,Scope,Audience,Impression Campaign Id,Impression Ad Group Id,Entity Type
Format Version,,,,,,6.0,,,,,,
Impression Based Remarketing List,Active,-10,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name,CampaignIdHere,AdGroupIdHere,AdGroup
Impression Based Remarketing List,Active,-11,ParentIdHere,ClientIdGoesHere,,,New impression based remarketing list description,30,Account,Impression Based Remarketing List Name1,CampaignIdHere,,Campaign

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

var uploadEntities = new List<BulkEntity>();

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

    // Map properties in the Bulk file to the 
    // ImpressionBasedRemarketingList object of the Campaign Management service.
    ImpressionBasedRemarketingList = new ImpressionBasedRemarketingList
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "New Impression Based Remarketing List",
        // 'Id' column header in the Bulk file
        Id = impressionBasedRemarketingListIdKey,
        // 'Membership Duration' column header in the Bulk file
        MembershipDuration = 30,
        // 'Audience' column header in the Bulk file
        Name = "Impression Based Remarketing List" + DateTime.UtcNow,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = EntityScope.Account,
        // 'Impression Ad Group Id' column header in the Bulk file
        AdGroupId = AdGroupIdHere,
        // 'Impression Campaign Id' column header in the Bulk file
        CampaignId = CampaignIdHere,
        // 'Audience Search Size' column header in the Bulk file
        SearchSize = null,
        // 'Supported Campaign Types' column header in the Bulk file
        SupportedCampaignTypes = null,
        // 'Entity Type' column header in the Bulk file
        EntityType = ImpressionBasedEntityType.AdGroup
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkImpressionBasedRemarketingList);

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
• インプレッション広告グループ ID
• インプレッション キャンペーン ID
• メンバーシップ期間
• 変更時刻
• Parent Id
• スコープ
• 状態
• サポートされているキャンペーンの種類

Audience

インプレッション ベースのリマーケティング リストの名前。

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

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

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

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

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

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

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

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

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

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

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

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

クライアント ID

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

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

説明

インプレッション ベースのリマーケティング リストの説明。 説明を使用すると、このインプレッション ベースのリマーケティング リストでターゲットを設定しているユーザーを思い出しやすくなります。

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

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

エンティティ型

このエンティティの種類は、ユーザーが広告を表示した方法に基づいています。 インプレッション ベースのリマーケティング リストを作成するときは、エンティティの種類を特定する必要があります。 指定できる値は 、AdGroup または キャンペーンです。

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

Id

インプレッション ベースのリマーケティング リストのシステム生成識別子。

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

インプレッション広告グループ ID

インプレッション ベースのリマーケティング リストの作成に使用される AdGroupId。

足す： エンティティの種類が AdGroup の場合、これは必須です。 [エンティティの種類] が [キャンペーン] の場合、これは空です。
更新： 随意。 更新プログラムに値が設定されていない場合、この設定は変更されません。
削除： 読み取り専用

インプレッション キャンペーン ID

インプレッション ベースのリマーケティング リストを作成するために使用される CampaignId。

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

メンバーシップ期間

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

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

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

変更時刻

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

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

Parent Id

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

足す： 随意
更新： 読み取り専用。 親 ID は変更できません。
削除： 読み取り専用

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、検索、ショッピングです。 今後、新しいキャンペーンの種類が追加される可能性があるため、固定の値セットに依存しないようにしてください。

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