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

Artículo
12/21/2023

Define un objetivo de conversión de eventos personalizado.

Use este tipo de objetivo para contar cada vez que alguien complete una acción específica, como suscribirse a un boletín o descargar un documento como conversión.

De forma predeterminada, la etiqueta UET registra las visitas del usuario a las páginas de su sitio web que permiten a Microsoft Advertising admitir tipos de objetivos como UrlGoal, DurationGoal y PagesViewedPerVisitGoal. Sin embargo, es posible que desee realizar un seguimiento de otros tipos de eventos, como suscribirse a un boletín o descargar un documento. Microsoft Advertising habilita este escenario con EventGoal. Además de crear un EventGoal, debe personalizar el código de seguimiento de etiquetas de UET para notificar los valores de uno o varios de los parámetros de evento personalizados. Para más información, consulte Cómo notificar eventos personalizados con UET.

Sugerencia

Para obtener información general sobre la implementación, consulte la guía técnica de Seguimiento universal de eventos .

Importante

Cada vez que agrega o actualiza un nuevo DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal o UrlGoal a través de la aplicación web Microsoft Advertising o campaign management API, el valor MSCLKIDAutoTaggingEnabled de la propiedad AccountProperty correspondiente se establece en True automáticamente. Si el ámbito del objetivo se establece en Nivel de cliente , se establecerá accountproperty para todas las cuentas del cliente.

Sintaxis

<xs:complexType name="EventGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="CategoryExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="LabelExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" nillable="true" type="tns:ValueOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementos

El objeto EventGoal tiene los siguientes elementos: ActionExpression, ActionOperator, CategoryExpression, CategoryOperator, LabelExpression, LabelOperator, Value, ValueOperator.

Elemento	Descripción	Tipo de datos
ActionExpression	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 . La cadena no puede superar la longitud máxima de 100. 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ActionOperator y ActionExpression durante la actualización, se eliminarán las configuraciones ActionOperator y ActionExpression existentes.	string
ActionOperator	Operador que se puede aplicar al valor del elemento ActionExpression . Si este elemento se especifica durante una operación de adición o actualización, también se requiere el elemento ActionExpression . 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye ActionOperator y ActionExpression durante la actualización, se eliminarán las configuraciones ActionOperator y ActionExpression existentes.	ExpressionOperator
CategoryExpression	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 . La cadena no puede superar la longitud máxima de 100. 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye CategoryOperator y CategoryExpression durante la actualización, se eliminarán las configuraciones CategoryOperator y CategoryExpression existentes.	string
CategoryOperator	Operador que se puede aplicar al valor del elemento CategoryExpression . 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye CategoryOperator y CategoryExpression durante la actualización, se eliminarán las configuraciones CategoryOperator y CategoryExpression existentes.	ExpressionOperator
LabelExpression	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 . La cadena no puede superar la longitud máxima de 100. 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye LabelOperator y LabelExpression durante la actualización, se eliminarán las configuraciones LabelOperator y LabelExpression existentes.	string
LabelOperator	Operador que se puede aplicar al valor del elemento LabelExpression . 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualizar: Opcional si incluye uno o varios de los demás eventos; Si no incluye LabelOperator y LabelExpression durante la actualización, se eliminarán las configuraciones LabelOperator y LabelExpression existentes.	ExpressionOperator
Valor	Valor numérico 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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (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.	ValueOperator

El objeto EventGoal tiene elementos heredados.

Elementos heredados

Elementos heredados de conversionGoal

El objeto EventGoal deriva del objeto ConversionGoal y hereda los siguientes elementos: AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. Las descripciones siguientes son específicas de EventGoal y es posible que no se apliquen a otros objetos que hereden los mismos elementos del objeto ConversionGoal .

Elemento	Descripción	Tipo de datos
AttributionModelType	Determina qué modelo de atribución, LastTouch o LastClick, se usa con un objetivo de conversión.	AttributionModelType
ConversiónWindowInMinutes	La ventana de conversión es el período de tiempo en minutos después de un clic en el que desea realizar un seguimiento de las conversiones. Si establece este valor en 43200 minutos (30 días), se realiza el seguimiento de las conversiones que se producen dentro de los 30 días posteriores a un clic. Las conversiones anteriores no se ven afectadas. El valor mínimo admitido es de 1 minuto, aunque tenga en cuenta que una ventana de conversión más corta reducirá el número de conversiones que registra su cuenta. El valor máximo admitido es 129600 minutos (90 días). Añadir: Opcional Actualizar: Opcional	int
CountType	Esto determina cómo se registran las conversiones en la ventana de conversión elegida. Hay dos opciones y, si no establece un valor, el valor predeterminado es All: - Todo: se contarán todas las conversiones que se producen después de un clic en un anuncio. Esta es una opción común para las ventas. - Único: solo se contará una conversión que se produzca después de hacer clic en un anuncio. Esta es una opción común para los clientes potenciales. Por ejemplo: realiza un seguimiento de dos conversiones: clientes potenciales y ventas. Seleccione Único para clientes potenciales y Todo para ventas. Cuando un clic en un anuncio se convierte en dos clientes potenciales y dos ventas, se cuenta como tres conversiones: una para el cliente potencial único y dos para todas las ventas. Añadir: Opcional Actualizar: Opcional	ConversionGoalCountType
ExcludeFromBidding	Determina si se excluyen o no los datos relacionados con este objetivo de conversión de un subconjunto de columnas de informe de rendimiento. Este elemento solo está disponible para los clientes que están habilitados para la característica Incluir en conversiones (GetCustomerPilotFeatures devuelve 574). Si este elemento se establece en true, los datos relacionados con este objetivo de conversión se excluirán de las `Conversions`columnas de informe , `ConversionRate`, `CostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`y `Revenue` . Además, si usa una estrategia de puja automatizada, establecer esta propiedad true dará lugar a que las conversiones del objetivo ya no se factoricen en cálculos de puja automatizados. Establecer esta propiedad "true" es efectivamente lo mismo que desactivar "Incluir en conversiones" en la aplicación web de Microsoft Advertising. Independientemente de este valor de elemento, las `AllConversions`columnas de informe , `AllConversionRate`, `AllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`y `AllRevenue` incluirán datos para todos los objetivos de conversión. De forma predeterminada, este elemento es false y los datos relacionados con este objetivo de conversión se incluyen en todas las columnas de informe. Para obtener más información, vea Atributos de informe y estadísticas de rendimiento y el artículo de ayuda Objetivos de conversión: "Conversiones" frente a "Todas las conversiones". Añadir: Opcional Actualizar: Opcional	boolean
GoalCategory	Categoría usada para segmentar el objetivo de conversión. Sin embargo, clasificar los objetivos de conversión tiene sentido para su empresa. Las categorías de objetivos no afectan al rendimiento: están aquí para ayudarle a segmentar sus objetivos y sus métricas de rendimiento. Los valores de categoría admitidos varían según el tipo de objetivo de conversión. Los objetivos de evento admiten las categorías AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm y Subscribe . Añadir: Obligatorio a partir de junio de 2021. Anteriormente, si dejaba este elemento vacío o nulo, la categoría predeterminada se estableció en Ninguno. Actualizar: Opcional si el objetivo de conversión ya tiene un conjunto de categorías distinto de Ninguno. Si no se establece ningún valor para la actualización, esta configuración no cambia.	ConversionGoalCategory
Id	Identificador único de Microsoft Advertising para el objetivo de conversión. Añadir: Solo lectura Actualizar: Obligatorio y Read-Only	Largo
IsEnhancedConversionsEnabled	Determina si las conversiones mejoradas están habilitadas para un objetivo de conversión. Nota: Para crear un objetivo de conversión mejorado y establecer `isEnhancedConversionsEnabled=true`, debe crear un objetivo de conversión para la cuenta a través de la interfaz de usuario de Microsoft Advertising con la configuración de conversión mejorada seleccionada y la casilla asociada activada.	boolean
Nombre	Nombre del objetivo de conversión. La longitud máxima del nombre es 100 y el nombre debe ser único entre todos los objetivos de conversión que pertenecen al mismo cliente. Añadir: Obligatorio Actualizar: Opcional	string
Ingresos	Determina cuánto vale cada conversión para su empresa. Al agregar un objetivo de conversión si no especifica ninguna preferencia de seguimiento de ingresos, cada ConversionGoalRevenue se establecerá en sus respectivos valores predeterminados. Al actualizar un objetivo de conversión, si el elemento Revenue es nulo o vacío, no se actualizará ninguna de las propiedades anidadas. Sin embargo, si este elemento no está vacío o nulo, se reemplazan eficazmente las propiedades de ingresos existentes. Añadir: Opcional Actualizar: Opcional	ConversionGoalRevenue
Ámbito	Determina si el objetivo se aplica a todas las cuentas o solo a la cuenta especificada en el elemento de encabezado CustomerAccountId necesario. Si tiene varias cuentas de Microsoft Advertising, puede realizar un seguimiento de las conversiones en todas esas cuentas. Si asocia un objetivo a una cuenta, solo se realizará un seguimiento de las conversiones para esa cuenta. Los valores posibles son Account y Customer. Si no se especifica, el ámbito se establecerá en Customer de forma predeterminada. Una vez que haya establecido el ámbito, no podrá cambiarlo. Si desea cambiar el ámbito, debe crear un nuevo objetivo de conversión y pausar el anterior. Añadir: Opcional Actualizar: Opcional	EntityScope
Estado	Define los posibles valores de estado determinados por el usuario de un objetivo de conversión. Estos son los valores de estado que un usuario puede decidir establecer, por ejemplo, un objetivo se puede establecer en Pausado si ya no desea realizar un seguimiento de las conversiones para ese objetivo. Para ver los valores de estado que puede establecer el sistema, por ejemplo, si se comprueba la etiqueta UET, consulte el elemento TrackingStatus . Añadir: Opcional Actualizar: Opcional	ConversionGoalStatus
TagId	Identificador único de Microsoft Advertising de la etiqueta UET que agregó a su sitio web para permitir que Microsoft Advertising recopile acciones que los usuarios realizan en su sitio web. Antes de tomar una dependencia del identificador de etiqueta, tenga en cuenta que la etiqueta de UET se puede compartir con o desde otro cliente. Las etiquetas y audiencias de UET compartidas solo están disponibles para los clientes piloto. Para obtener información general sobre cómo compartir audiencias y etiquetas de UET en una jerarquía de clientes, consulte la guía técnica Compartir audiencias y etiquetas de UET . Añadir: Obligatorio Actualizar: Opcional	Largo
TrackingStatus	Define los posibles valores de estado determinados por el sistema de un objetivo de conversión. Estos son los valores de estado que puede establecer el sistema, por ejemplo, el sistema establece el estado en TagUnverified si la etiqueta UET aún no se ha comprobado. Para ver los valores de estado que un usuario puede decidir establecer, por ejemplo, establecer el estado en Pausado si ya no desea realizar un seguimiento de las conversiones para ese objetivo, vea el elemento Status . Añadir: Solo lectura Actualizar: Solo lectura	ConversionGoalTrackingStatus
Tipo	Tipo del objetivo de conversión. Este valor es Event cuando se recupera un objetivo de evento. Para obtener más información sobre los tipos de objetivo de conversión, vea las observaciones del objeto de datos ConversionGoal. Añadir: Solo lectura Actualizar: Solo lectura	ConversionGoalType
ViewThroughConversionWindowInMinutes	La ventana de conversión de vista a través es el período de tiempo en minutos después de un clic en el que desea realizar un seguimiento de las conversiones de visualización. Si establece este valor en 43200 minutos (30 días), se realiza el seguimiento de las conversiones de visualización que se producen dentro de los 30 días posteriores a un clic. Las conversiones anteriores no se ven afectadas. El valor mínimo admitido es de 1 minuto, aunque tenga en cuenta que una ventana de conversión más corta reducirá el número de conversiones que registra su cuenta. El valor máximo admitido es 43200 minutos (30 días). La propiedad de cuenta IncludeViewThroughConversions también debe establecerse en true para realizar un seguimiento de las conversiones de vista a través. Este elemento no se devuelve de forma predeterminada. Para obtener este elemento, incluya el valor ViewThroughConversionWindowInMinutes en el elemento ReturnAdditionalFields cuando llame a las operaciones de servicio GetConversionGoalsByIds y GetConversionGoalsByTagIds . Añadir: Opcional Actualizar: Opcional	int

Requisitos

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

Compartir a través de