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

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

XML

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

JSON

{
  "Type": "CustomEvents",
  "Action": "ValueHere",
  "ActionOperator": "ValueHere",
  "Category": "ValueHere",
  "CategoryOperator": "ValueHere",
  "Label": "ValueHere",
  "LabelOperator": "ValueHere",
  "Value": DecimalValueHere,
  "ValueOperator": "ValueHere"
}

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 . Agregar: 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 . Agregar: 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 . Agregar: 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 . Agregar: 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 . Agregar: 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 . Agregar: 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 . Agregar: 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 . Agregar: 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. Agregar: Solo lectura Actualizar: Solo lectura	string

Comentarios

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
Namespace: https://bingads.microsoft.com/CampaignManagement/v13