次の方法で共有

PageVisitorsRule データ オブジェクト - キャンペーン管理

  • [アーティクル]

ページ訪問者のリマーケティング ルールを定義します。

リマーケティング ルールは、リマーケティング リストに追加するユーザーを決定するために使用される条件です。 PageVisitors ルールの場合は、1 つ以上のルール項目グループを含める必要があります。

重要

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

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

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

詳細な例については、以下の 「備考 」セクションを参照してください。

構文

<xs:complexType name="PageVisitorsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="NormalForm" nillable="true" type="tns:NormalForm">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
        <xs:element minOccurs="0" name="RuleItemGroups" nillable="true" type="tns:ArrayOfRuleItemGroup" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

要素

PageVisitorsRule オブジェクトには、NormalForm、RuleItemGroups という要素があります。

要素 説明 データ型
NormalForm 規則項目グループを接続標準形式 (CNF) または非結合標準形式 (DNF) に基づいて評価するかどうかを決定します。

この要素は既定では返されません。 この要素を取得するには、 GetAudiencesByIds サービス操作を呼び出すときに、ReturnAdditionalFields 要素に NormalForm 値を含めます。

追加： オプション。 既定値は "Disjunctive" です。
更新： オプション		 NormalForm
RuleItemGroups リマーケティング リストに適用するルール アイテム グループの一覧。

この要素のルール項目グループの最大数は 100 です。 ルール項目グループあたりのルール項目の最大数は 100 です。

追加： 必須
更新： 必須。 前のルール項目グループのいずれかを保持する場合は、更新中に明示的に再度設定する必要があります。		 RuleItemGroup 配列

PageVisitorsRule オブジェクトには継承された要素があります。

継承された要素

リマーケティング ルールから継承された要素

PageVisitorsRule オブジェクトは、リマーケティング ルール オブジェクトから派生し、Type という要素を継承します。 以下の説明は PageVisitorsRule に固有であり、同じ要素を リマーケティング ルール オブジェクトから継承する他のオブジェクトには適用されない場合があります。

要素 説明 データ型
型 リマーケティング ルールの種類。 リマーケティング ルールの種類の詳細については、「 リマーケティング ルール データ オブジェクトの備考」を参照してください。

追加： 読み 取り 専用
更新： 読み 取り 専用		 string

注釈

リマーケティング ルールは、リマーケティング リストに追加するユーザーを決定するために使用される条件です。 PageVisitors ルールの場合は、1 つ以上のルール項目グループを含める必要があります。

重要

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

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

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

通常のフォームの分離評価の例として、次のルール項目グループが設定されているとします。

<Rule i:type="PageVisitorsRule">
  <Type i:nil="true" />
  <NormalForm i:nil="true" />
  <RuleItemGroups>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>Contains</Operator>
          <Value>X</Value>
        </RuleItem>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>DoesNotContain</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>Url</Operand>
          <Operator>DoesNotBeginWith</Operator>
          <Value>Y</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
    <RuleItemGroup>
      <Items>
        <RuleItem i:type="StringRuleItem">
          <Type i:nil="true" />
          <Operand>ReferrerUrl</Operand>
          <Operator>Equals</Operator>
          <Value>Z</Value>
        </RuleItem>
      </Items>
    </RuleItemGroup>
  </RuleItemGroups>
</Rule>

上記の定義は、次の論理式に変換されます。

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

要件

サービス: CampaignManagementService.svc v13
名前 空間： https://bingads.microsoft.com/CampaignManagement/v13