PageVisitorsRule 數據物件 - 營銷活動管理

定義頁面訪客重新營銷規則。

重新營銷規則是用來判斷要將誰新增至重新行銷清單的條件。 針對 PageVisitors 規則，您必須包含一或多個規則專案群組。

重要事項

在 2021 年日曆年度，我們新增了對聯結一般窗體 (CNF) 的支援。 先前Microsoft Advertising 僅支援 DNF) (分離一般格式。 新頁面訪客規則的預設一般窗體會維持 DNF。 不過，您必須確定您的應用程式可以適當地讀取及區分 CNF 和 DNF。 您的應用程式不應該再假設規則是分離的。

如果一般表單是聯結 (CNF) ，則會先使用邏輯 OR 運算符聯結相同頁面的規則項目條件。 然後，規則專案群組清單中的每個結果都會使用邏輯 AND 運算符聯結。 換句話說，如果符合所有規則專案群組內任何指定的規則專案條件，使用者就會新增至您的重新行銷清單。

如果一般表單與 DNF) (分離，則會先使用邏輯 AND 運算符聯結相同頁面的規則項目條件。 然後，規則專案群組清單中的每個結果都會使用邏輯 OR 運算符聯結。 換句話說，如果符合任何一個規則專案群組內的所有指定規則專案條件，使用者就會新增至您的重新營銷清單。

如需詳細範例，請參閱下 方的 一節。

語法

XML

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

JSON

{
  "Type": "PageVisitors",
  "NormalForm": "ValueHere",
  "RuleItemGroups": [
    {
      "Items": [
        {
          "Type": "Number",
          "Operand": "ValueHere",
          "Operator": "ValueHere",
          "Value": "ValueHere"
        }
      ]
    }
  ]
}

元素

PageVisitorsRule 物件具有下列元素：NormalForm、RuleItemGroups。

元素	描述	資料類型
NormalForm	判斷規則專案群組是根據聯結一般窗體 (CNF) 還是分離一般窗體 (DNF) 來評估。 預設不會傳回這個專案。 若要取得此元素，請在呼叫 GetAudiencesByIds 服務作業時，在 ReturnAdditionalFields 元素中包含 NormalForm 值。 加： 自選。 預設值為 「Disjunctive」。。 更新： 自選	NormalForm
RuleItemGroups	您要套用至重新行銷清單的規則專案群組清單。 此元素中的規則專案群組數目上限為 100。 每個規則專案群組的規則項目數目上限為 100。 加： 必填 更新： 必填。 如果您想要保留任何先前的規則專案群組，則必須在更新期間再次明確地設定它們。	RuleItemGroup 陣 列

PageVisitorsRule 物件具有 Inherited Elements。

繼承的專案

從 RemarketingRule 繼承的元素

PageVisitorsRule 物件衍生自 RemarketingRule 物件，並繼承下列元素：Type。 下列描述專屬於 PageVisitorsRule，可能不適用於從 RemarketingRule 物件繼承相同元素的其他物件。

元素	描述	資料類型
類型	重新營銷規則的類型。 如需重新行銷規則類型的詳細資訊，請參閱 RemarketingRule 資料物件備註。 加： 唯讀 更新： 唯讀	string

註解

重新營銷規則是用來判斷要將誰新增至重新行銷清單的條件。 針對 PageVisitors 規則，您必須包含一或多個規則專案群組。

重要事項

在 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 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) )

邏輯表達式的評估會決定下列哪一個範例使用者會新增至重新營銷清單。

使用者	流覽過的URL	查閱者 URL	已新增至清單
使用者 1	A	X	是。 將邏輯表達式結果評估為 True。 ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) ) (False 和 True) 或 (True) 或 (False) False 或 True 或 False True
使用者 2	B	Y	不能。 將邏輯表達式結果評估為 False。 ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) ) (False 和 True) 或 (False) 或 (False) False 或 False 或 False False
使用者 3	C	Z	是。 將邏輯表達式結果評估為 True。 ( (URL 包含 X) 和 (ReferrerUrl DoesNotContain Z) ) 或 ( (Url DoesNotBeginWith Y) ) 或 ( (ReferrerUrl 等於 Z) ) (False 和 False) 或 (True) 或 (True) False 或 True 或 True True

需求

服務： CampaignManagementService.svc v13
Namespace： https://bingads.microsoft.com/CampaignManagement/v13