Compartir a través de

Objeto de datos PageVisitorsRule: Administración de campañas

  • Artículo

Define una regla de remarketing de visitantes de página.

Las reglas de remarketing son condiciones que se usan para determinar a quién agregar a la lista de remarketing. Para la regla PageVisitors , debe incluir uno o varios grupos de elementos de regla.

Importante

Durante el año natural 2021 agregamos compatibilidad con la forma normal conjuntiva (CNF). Anteriormente, Microsoft Advertising solo admitía la forma normal disjuntiva (DNF). El formulario normal predeterminado para una nueva regla de visitantes de página sigue siendo DNF. Sin embargo, debe asegurarse de que la aplicación puede leer y distinguir correctamente entre CNF y DNF. La aplicación ya no debe suponer que la regla es disyuntiva.

Si el formulario normal es conjuntivo (CNF), las condiciones del elemento de regla para la misma página se combinan primero mediante el operador OR lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador AND lógico. En otras palabras, el usuario se agregará a la lista de remarketing si se cumple alguna de las condiciones de elemento de regla especificadas dentro de todos los grupos de elementos de regla.

Si el formulario normal es disyuntivo (DNF), las condiciones del elemento de regla para la misma página se combinan primero con el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR . En otras palabras, el usuario se agregará a la lista de remarketing si se cumplen todas las condiciones de elemento de regla especificadas dentro de cualquiera de los grupos de elementos de regla.

Para obtener un ejemplo detallado, vea la sección Comentarios a continuación.

Sintaxis

<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

El objeto PageVisitorsRule tiene los siguientes elementos: NormalForm, RuleItemGroups.

Elemento Descripción Tipo de datos
NormalForm Determina si los grupos de elementos de regla se evalúan en función de la forma normal conjuntiva (CNF) o del formulario normal disjuntivo (DNF).

Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor NormalForm en el elemento ReturnAdditionalFields cuando llame a la operación de servicio GetAudiencesByIds .

Añadir: Opcional. El valor predeterminado es "Disjunctive".
Actualizar: Opcional		 NormalForm
RuleItemGroups Lista de grupos de elementos de regla que desea aplicar a la lista de remarketing.

El número máximo de grupos de elementos de regla de este elemento es 100. El número máximo de elementos de regla por grupo de elementos de regla es 100.

Añadir: Obligatorio
Actualizar: Obligatorio. Si desea conservar cualquiera de los grupos de elementos de regla anteriores, debe volver a establecerlos explícitamente durante la actualización.		 Matriz RuleItemGroup

El objeto PageVisitorsRule tiene elementos heredados.

Elementos heredados

Elementos heredados de RemarketingRule

El objeto PageVisitorsRule deriva del objeto RemarketingRule y hereda los siguientes elementos: Type. Las descripciones siguientes son específicas de PageVisitorsRule y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto RemarketingRule .

Elemento Descripción Tipo de datos
Tipo Tipo de la regla de remarketing. Para obtener más información sobre los tipos de reglas de remarketing, consulte comentarios sobre objetos de datos de RemarketingRule.

Añadir: Solo lectura
Actualizar: Solo lectura		 string

Observaciones

Las reglas de remarketing son condiciones que se usan para determinar a quién agregar a la lista de remarketing. Para la regla PageVisitors , debe incluir uno o varios grupos de elementos de regla.

Importante

Durante el año natural 2021 agregamos compatibilidad con la forma normal conjuntiva (CNF). Anteriormente, Microsoft Advertising solo admitía la forma normal disjuntiva (DNF). El formulario normal predeterminado para una nueva regla de visitantes de página sigue siendo DNF. Sin embargo, debe asegurarse de que la aplicación puede leer y distinguir correctamente entre CNF y DNF. La aplicación ya no debe suponer que la regla es disyuntiva.

Si el formulario normal es conjuntivo (CNF), las condiciones del elemento de regla para la misma página se combinan primero mediante el operador OR lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador AND lógico. En otras palabras, el usuario se agregará a la lista de remarketing si se cumple alguna de las condiciones de elemento de regla especificadas dentro de todos los grupos de elementos de regla.

Si el formulario normal es disyuntivo (DNF), las condiciones del elemento de regla para la misma página se combinan primero con el operador AND lógico. A continuación, cada resultado de la lista de grupos de elementos de regla se une mediante el operador LÓGICO OR . En otras palabras, el usuario se agregará a la lista de remarketing si se cumplen todas las condiciones de elemento de regla especificadas dentro de cualquiera de los grupos de elementos de regla.

Para ver un ejemplo de evaluación de formulario normal disyuntiva, supongamos que se establecen los siguientes grupos de elementos de regla.

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

La definición anterior se traduce a la siguiente expresión lógica:

((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))

La evaluación de la expresión lógica determina cuál de los siguientes usuarios de ejemplo se agregará a la lista de remarketing.

Usuario Url visitada Dirección URL del referenciador Se ha agregado a la lista
Usuario 1 A
 X Sí. Evaluación de los resultados de la expresión lógica como True.

((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))

(False y True) o (True) o (False)

False, True o False

True
Usuario 2 N
 Y No. Evaluación de los resultados de la expresión lógica como False.

((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))

(False y True) o (False) o (False)

False, False o False

False
Usuario 3 C
 Z Sí. Evaluación de los resultados de la expresión lógica como True.

((Url contiene X) y (ReferrerUrl DoesNotContain Z)) o ((Url DoesNotBeginWith Y)) o ((ReferrerUrl Equals Z))

(False y False) o (True) o (True)

False, True o True

True

Requisitos

Servicio: CampaignManagementService.svc v13
Nombres: https://bingads.microsoft.com/CampaignManagement/v13