Objeto de Dados PageVisitorsRule - Gestão de Campanhas

Artigo
12/21/2023

Define uma regra de remarketing de visitantes de página.

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing. Para a regra PageVisitors , tem de incluir um ou mais grupos de itens de regra.

Importante

Durante o ano civil de 2021, adicionámos suporte para formulário normal conjuntivo (CNF). Anteriormente, o Microsoft Advertising suportava apenas um formulário normal disjuntivo (DNF). O formulário normal predefinido para uma nova regra de visitantes de página permanece DNF. No entanto, tem de garantir que a sua aplicação pode ler e distinguir adequadamente entre CNF e DNF. A aplicação já não deve assumir que a regra é disjuntiva.

Se o formulário normal for conjuntivo (CNF), as condições do item de regra para a mesma página são primeiro associadas com o operador OR lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico E . Por outras palavras, o utilizador será adicionado à sua lista de remarketing se alguma das condições do item de regra especificada em todos os grupos de itens de regra for cumprida.

Se o formulário normal for disjuntivo (DNF), as condições do item de regra para a mesma página são primeiro associadas com o operador AND lógico. Em seguida, cada resultado da lista de grupos de itens de regra é associado com o operador lógico OR . Por outras palavras, o utilizador será adicionado à sua lista de remarketing se todas as condições do item de regra especificadas em qualquer um dos grupos de itens de regra forem cumpridas.

Para obter um exemplo detalhado, veja a secção Observações abaixo.

Sintaxe

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

Elementos

O objeto PageVisitorsRule tem os seguintes elementos: NormalForm, RuleItemGroups.

Elemento	Descrição	Tipo de Dados
Forma Normal	Determina se os grupos de itens de regra são avaliados com base no formulário normal conjuntivo (CNF) ou no formulário normal disjuntivo (DNF). Este elemento não é devolvido por predefinição. Para obter este elemento, inclua o valor NormalForm no elemento ReturnAdditionalFields quando chamar a operação de serviço GetAudiencesByIds . Adicionar: Opcional. O valor predefinido é "Disjuntivo". Atualização: Opcional	Forma Normal
RuleItemGroups	A lista de grupos de itens de regra que pretende aplicar à lista de remarketing. O número máximo de grupos de itens de regra neste elemento é 100. O número máximo de itens de regra por grupo de itens de regra é 100. Adicionar: Necessário Atualização: Obrigatório. Se quiser manter qualquer um dos grupos de itens de regra anteriores, tem de defini-los explicitamente novamente durante a atualização.	Matriz RuleItemGroup

O objeto PageVisitorsRule tem Elementos Herdados.

Elementos Herdados

Elementos Herdados de RemarketingRule

O objeto PageVisitorsRule deriva do objeto RemarketingRule e herda os seguintes elementos: Tipo. As descrições abaixo são específicas de PageVisitorsRule e podem não se aplicar a outros objetos que herdam os mesmos elementos do objeto RemarketingRule .

Elemento	Descrição	Tipo de Dados
Tipo	O tipo da regra de remarketing. Para obter mais informações sobre os tipos de regras de remarketing, veja RemarketingRule Data Object Remarks (Comentários de Objetos de Dados remarketingRule). Adicionar: Só de leitura Atualização: Só de leitura	cadeia

Observações

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing. Para a regra PageVisitors , tem de incluir um ou mais grupos de itens de regra.

Importante

Para obter um exemplo de avaliação de formulário normal disjuntiva, digamos que os seguintes grupos de itens de regra estão definidos.

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

A definição acima é traduzida para a seguinte expressão lógica:

((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z))

A avaliação da expressão lógica determina qual dos seguintes utilizadores de exemplo será adicionado à lista de remarketing.

Utilizador	URL Visitado	URL do Referenciador	Adicionado à Lista
Utilizador 1	A	X	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Verdadeiro) ou (Verdadeiro) ou (Falso) Falso ou Verdadeiro ou Falso Verdadeiro
Utilizador 2	B	Y	Não. Avaliação dos resultados da expressão lógica como Falso. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Verdadeiro) ou (Falso) ou (Falso) Falso ou Falso ou Falso Falso
Utilizador 3	C	Z	Sim. Avaliação dos resultados da expressão lógica como Verdadeiro. ((Url Contém X) e (ReferrerUrl DoesNotContain Z)) ou ((Url DoesNotBeginWith Y)) ou ((ReferrerUrl É Igual a Z)) (Falso e Falso) ou (Verdadeiro) ou (Verdadeiro) Falso ou Verdadeiro ou Verdadeiro Verdadeiro

Requisitos

Serviço: CampaignManagementService.svc v13
Espaço de nomes: https://bingads.microsoft.com/CampaignManagement/v13

Compartilhar via