Objeto de Dados CustomEventsRule - Gestão de Campanhas

Define uma regra de remarketing de eventos personalizados.

As regras de remarketing são condições utilizadas para determinar quem adicionar à sua lista de remarketing. Para a regra de eventos personalizados, tem de incluir um ou mais dos seguintes pares de operadores de eventos condicionais: (ActionOperator e Action), (CategoryOperator e Category), (LabelOperator e Label) (ValueOperator e Value). Se for especificada mais do que uma condição, as condições são associadas com o operador lógico E . Por outras palavras, o visitante só será adicionado à sua lista de remarketing se todas as condições de regra especificadas forem cumpridas.

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

Sintaxe

<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

O objeto CustomEventsRule tem os seguintes elementos: Action, ActionOperator, Category, CategoryOperator, Label, LabelOperator, Value, ValueOperator.

Elemento	Descrição	Tipo de Dados
Ação	O tipo de interação do utilizador que pretende controlar. Por exemplo, "reproduzir" ou "colocar em pausa". Se este elemento for especificado durante uma operação de adição ou atualização, o elemento ActionOperator também é necessário. Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir ActionOperator e Ação durante a atualização, todas as definições de ActionOperator e Ação existentes serão eliminadas.	cadeia
ActionOperator	O operador que pode ser aplicado ao valor do elemento Ação . Se este elemento for especificado durante uma operação de adição ou atualização, o elemento Ação também é necessário. Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir ActionOperator e Ação durante a atualização, todas as definições de ActionOperator e Ação existentes serão eliminadas.	StringOperator
Categoria	A categoria do evento que pretende controlar. Por exemplo, "vídeo". Se este elemento for especificado durante uma operação de adição ou atualização, o elemento CategoryOperator também é necessário. Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir CategoryOperator e Category durante a atualização, quaisquer definições de CategoryOperator e Categoria existentes serão eliminadas.	cadeia
CategoryOperator	O operador que pode ser aplicado ao valor do elemento Categoria . Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir CategoryOperator e Category durante a atualização, quaisquer definições de CategoryOperator e Categoria existentes serão eliminadas.	StringOperator
Etiqueta	O nome do elemento que causou a ação. Por exemplo, "trailer" ou "behindthescenes". Se este elemento for especificado durante uma operação de adição ou atualização, o elemento LabelOperator também é necessário. Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir LabelOperator e Label durante a atualização, quaisquer definições de LabelOperator e Etiqueta existentes serão eliminadas.	cadeia
LabelOperator	O operador que pode ser aplicado ao valor do elemento Label . Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir LabelOperator e Label durante a atualização, quaisquer definições de LabelOperator e Etiqueta existentes serão eliminadas.	StringOperator
Valor	Um valor inteiro positivo associado a esse evento. Por exemplo, o valor pode ser a duração do tempo que o vídeo reproduziu. Se este elemento for especificado durante uma operação de adição ou atualização, o elemento ValueOperator também é necessário. Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir ValueOperator e Value durante a atualização, quaisquer definições existentes de ValueOperator e Value serão eliminadas	decimal
ValueOperator	O operador que pode ser aplicado ao valor do elemento Value . Adicionar: Opcional se incluir um ou mais dos outros eventos; Tem de incluir um ou mais dos seguintes pares de operadores de eventos: (ActionOperator e Ação), (CategoryOperator e Categoria), (LabelOperator e Etiqueta) (ValueOperator e Value). Atualização: Opcional se incluir um ou mais dos outros eventos; Se não incluir ValueOperator e Value durante a atualização, todas as definições ValueOperator e Value existentes serão eliminadas.	NumberOperator

O objeto CustomEventsRule tem Elementos Herdados.

Elementos Herdados

Elementos Herdados de RemarketingRule

O objeto CustomEventsRule deriva do objeto RemarketingRule e herda os seguintes elementos: Tipo. As descrições abaixo são específicas de CustomEventsRule 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

Para a regra CustomEvents , tem de incluir um ou mais dos seguintes pares de operadores de eventos condicionais: (ActionOperator e Action), (CategoryOperator e Category), (LabelOperator e Label) (ValueOperator e Value). Se for especificada mais do que uma condição, as condições são associadas com o operador lógico E . Por outras palavras, o visitante só será adicionado à sua lista de remarketing se todas as condições de regra especificadas forem cumpridas.

Por exemplo, digamos que os seguintes eventos personalizados estão definidos.

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

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

(Categoria Igual a vídeo) e (Ação É Igual a reprodução) e (Etiqueta Igual a trailer) e (Valor Igual a 5)

A avaliação da expressão lógica determina quem será adicionado à lista de remarketing.

Requisitos

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