Registro de objetivo de evento: masivo
Define un objetivo de conversión de eventos personalizado que se puede cargar y descargar en un archivo masivo.
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.
Puede descargar todos los registros de Event Goal de la cuenta incluyendo el valor DownloadEntity de EventGoals en la solicitud de servicio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Además, la solicitud de descarga debe incluir el ámbito EntityData . Para obtener más información sobre el servicio masivo, incluidos los procedimientos recomendados, consulte Descarga y carga masivas.
El siguiente ejemplo de CSV masivo agregaría un nuevo objetivo de evento.
Type,Id,Attribution Model Type,Count Type,Exclude From Bidding,Goal Category,Is Enhanced Conversions Enabled,Name,Conversion Currency Code,Revenue Value,Revenue Type,Scope,UET Tag Id,Status,View Through Conversion Window In Minutes,Conversion Window In Minutes,Category Expression,Category Operator,Action Expression,Action Operator,Label Expression,Label Operator,Event Value,Event Value Operator,URL Expression,URL Operator,Minimum Duration In Second,App Platform,App Id,Minimum Pages Viewed
Format Version,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,
Event Goal,,LastTouch,Unique,False,AddToCart,False,GoalA,USD,1,FixedValue,Account,123431,Active,150,367,video,Contains,buy,Contains,lb,Contains,3,Equals,,,,,,
Para un registro de objetivo de evento , los siguientes campos de atributo están disponibles en el esquema de archivos masivos.
- Expresión de acción
- Operador action
- Tipo de modelo de atribución
- Expresión category
- Operador Category
- Ventana de conversión en minutos
- Tipo de recuento
- Código de moneda
- Valor del evento
- Operador de valor de evento
- Excluir de las pujas
- Categoría objetivo
- Id
- Está habilitada la opción Conversiones mejoradas
- Expresión de etiqueta
- Operador Label
- Nombre
- Tipo de ingresos
- Valor de ingresos
- Scope
- Estado
- Seguimiento de estado
- Tipo
- Identificador de etiqueta de UET
- Ver a través de los minutos de la ventana de conversión
Expresión de 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.
La cadena no puede superar la longitud máxima de 100.
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value).
Actualización: 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.
Operador action
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 .
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value).
Actualización: 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.
Tipo de modelo de atribución
Determina qué modelo de atribución, LastTouch o LastClick, se usa con un objetivo de conversión.
Agregar: opcional
Actualización: opcional
Expresión category
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.
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualización: 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.
Operador Category
Operador que se puede aplicar al valor del elemento CategoryExpression.
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value).
Actualización: 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.
Ventana de conversión en minutos
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).
Agregar: opcional
Actualización: opcional
Tipo de recuento
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.
Agregar: Actualización opcional: opcional
Código de moneda
Tipo de moneda que desea que se notifiquen los ingresos del objetivo de conversión.
Para obtener una lista de los posibles valores de cadena, consulte Monedas de Microsoft Advertising.
Si el elemento Scope se establece en Customer y si Type es FixedValue o VariableValue, se requiere esta propiedad.
Agregar: Opcional a menos que se indique lo contrario anteriormente.
Actualizar: Opcional a menos que se indique lo contrario anteriormente.
Valor del evento
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 .
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualización: 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.
Operador de valor de evento
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value). Actualización: 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.
Excluir de las pujas
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".
Agregar: opcional
Actualización: opcional
Categoría objetivo
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 solo admiten la categoría Descargar .
Agregar: opcional. Si deja este elemento vacío o nulo, la categoría predeterminada se establecerá en Descargar.
Actualización: opcional. Si no se establece ningún valor para la actualización, esta configuración no cambia.
Id
Identificador único de Microsoft Advertising para el objetivo de conversión.
Agregar: Solo lectura
Actualizar: Solo lectura y Obligatorio
Está habilitada la opción Conversiones mejoradas
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.
Agregar: opcional
Actualización: opcional
Expresión de 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.
La cadena no puede superar la longitud máxima de 100.
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value).
Actualización: 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.
Operador Label
Operador que se puede aplicar al valor del elemento LabelExpression .
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 ActionExpression), (CategoryOperator y CategoryExpression), (LabelOperator y LabelExpression), (ValueOperator y Value).
Actualización: 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.
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.
Agregar: obligatorio
Actualización: opcional
Tipo de 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.
Agregar: opcional
Actualización: opcional
Valor de ingresos
Valor o importe de los ingresos. Si asigna valores a las conversiones, podrá ver el valor total controlado por la publicidad en distintas conversiones, en lugar de simplemente el número de conversiones que se han producido.
El valor predeterminado es efectivamente 0 y los valores posibles oscilan entre 0 y 999 99999. Los valores aceptados dependen del tipo de ingresos, por lo que consulte el elemento Type para obtener más información.
Agregar: opcional. Si no se especifica, el tipo predeterminado es efectivamente 0.
Actualización: opcional. Si no se especifica, el tipo predeterminado es efectivamente 0.
Á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.
En el caso de los objetivos de evento, no se admite el ámbito de nivel de cuenta. Puede establecer este elemento en Customer o dejarlo nulo. Si no se especifica, el ámbito se establecerá en Customer de forma predeterminada.
Agregar: opcional
Actualización: opcional
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, vea el elemento TrackingStatus .
Agregar: opcional
Actualización: opcional
Seguimiento de estado
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 RecordingConversions si hemos registrado conversiones en los últimos 7 días.
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.
Agregar: solo lectura
Actualización: solo lectura
Tipo
Tipo del objetivo de conversión. Este valor es InStoreTransaction 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.
Agregar: solo lectura
Actualización: solo lectura
Identificador de etiqueta de UET
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 .
Agregar: obligatorio
Actualización: opcional
Ver a través de los minutos de la ventana de conversión
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.
Agregar: Actualización opcional: opcional