Compartir a través de

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

  • Artículo

Define una regla de remarketing de eventos personalizados.

Las reglas de remarketing son condiciones que se usan para determinar a quién agregar a la lista de remarketing. Para la regla de eventos personalizados, debe incluir uno o varios de los siguientes pares de operadores de eventos condicionales: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label), (ValueOperator y Value). Si se especifica más de una condición, las condiciones se combinan mediante el operador AND lógico. En otras palabras, el visitante solo se agregará a su lista de remarketing si se cumplen todas las condiciones de regla especificadas.

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

Sintaxis

<xs:complexType name="CustomEventsRule" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:RemarketingRule">
      <xs:sequence>
        <xs:element minOccurs="0" name="Action" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Category" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Label" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" type="tns:StringOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" type="tns:NumberOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto CustomEventsRule tiene los siguientes elementos: Action, ActionOperator, Category, CategoryOperator, Label, LabelOperator, Value, ValueOperator.

Elemento Descripción Tipo de datos
Acción Tipo de interacción del usuario del que desea realizar un seguimiento. Por ejemplo, "play" o "pause".

Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento ActionOperator .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ActionOperator y Action durante la actualización, se eliminarán las opciones ActionOperator y Action existentes.		 string
ActionOperator Operador que se puede aplicar al valor del elemento Action .

Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento Action .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ActionOperator y Action durante la actualización, se eliminarán las opciones ActionOperator y Action existentes.		 StringOperator
Categoría Categoría de evento de la que desea realizar un seguimiento. Por ejemplo, "vídeo".

Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento CategoryOperator .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye CategoryOperator y Category durante la actualización, se eliminarán los valores de CategoryOperator y Category existentes.		 string
CategoryOperator Operador que se puede aplicar al valor del elemento Category .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye CategoryOperator y Category durante la actualización, se eliminarán los valores de CategoryOperator y Category existentes.		 StringOperator
Etiqueta Nombre del elemento que provocó la acción. Por ejemplo, "trailer" o "behindthescenes".

Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento LabelOperator .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye LabelOperator y Label durante la actualización, se eliminarán los valores de LabelOperator y Label existentes.		 string
LabelOperator Operador que se puede aplicar al valor del elemento Label .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye LabelOperator y Label durante la actualización, se eliminarán los valores de LabelOperator y Label existentes.		 StringOperator
Valor Valor entero positivo asociado a ese evento. Por ejemplo, el valor podría ser la duración del tiempo que se reprodujo el vídeo.

Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento ValueOperator .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ValueOperator y Value durante la actualización, se eliminarán los valores ValueOperator y Value existentes.		 Decimal
ValueOperator Operador que se puede aplicar al valor del elemento Value .

Añadir: Opcional si incluye uno o varios de los demás eventos; Debe incluir uno o varios de los siguientes pares de operadores de eventos: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label) (ValueOperator y Value).
Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ValueOperator y Value durante la actualización, se eliminarán los valores ValueOperator y Value existentes.		 NumberOperator

El objeto CustomEventsRule tiene elementos heredados.

Elementos heredados

Elementos heredados de RemarketingRule

El objeto CustomEventsRule deriva del objeto RemarketingRule y hereda los siguientes elementos: Type. Las descripciones siguientes son específicas de CustomEventsRule 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

Para la regla CustomEvents , debe incluir uno o varios de los siguientes pares de operadores de eventos condicionales: (ActionOperator y Action), (CategoryOperator y Category), (LabelOperator y Label), (ValueOperator y Value). Si se especifica más de una condición, las condiciones se combinan mediante el operador AND lógico. En otras palabras, el visitante solo se agregará a su lista de remarketing si se cumplen todas las condiciones de regla especificadas.

Por ejemplo, supongamos que se establecen los siguientes eventos personalizados.

<Rule i:type="CustomEventsRule">
  <Type i:nil="true" />
  <Action>play</Action>
  <ActionOperator>Equals</ActionOperator>
  <Category>video</Category>
  <CategoryOperator>Equals</CategoryOperator>
  <Label>trailer</Label>
  <LabelOperator>Equals</LabelOperator>
  <Value>5.00</Value>
  <ValueOperator>Equals</ValueOperator>
</Rule>

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

(Vídeo categoría igual a) y (acción igual a reproducir) y (tráiler etiqueta igual a) y (valor igual a 5)

La evaluación de la expresión lógica determina quién se agregará a la lista de remarketing.

Requisitos

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