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