ConversionAction

Una acción de conversión.

Representación JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Campos
resourceName

string

Inmutable. El nombre del recurso de la acción de conversión. Los nombres de los recursos de las acciones de conversión tienen el siguiente formato:

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

Es el estado de esta acción de conversión para la acumulación de eventos de conversión.
type

enum (ConversionActionType)

Inmutable. El tipo de esta acción de conversión.
origin

enum (ConversionOrigin)

Solo salida. Es el origen de conversión de esta acción de conversión.
category

enum (ConversionActionCategory)

Es la categoría de conversiones registradas para esta acción de conversión.
valueSettings

object (ValueSettings)

Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión.
countingType

enum (ConversionActionCountingType)

Cómo registrar los eventos de conversión para la acción de conversión
attributionModelSettings

object (AttributionModelSettings)

Es la configuración relacionada con el modelo de atribución de esta acción de conversión.
tagSnippets[]

object (TagSnippet)

Solo salida. Son los fragmentos que se utilizan para hacer un seguimiento de las conversiones.
mobileAppVendor

enum (MobileAppVendor)

Solo salida. Proveedor de una aplicación para dispositivos móviles para una acción de conversión de aplicación.
firebaseSettings

object (FirebaseSettings)

Solo salida. Configuración de Firebase para los tipos de conversión de Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Solo salida. La configuración de estadísticas de aplicaciones de terceros para los tipos de conversión de terceros
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Solo salida. Configuración de Google Analytics 4 para los tipos de conversión de Google Analytics 4.
id

string (int64 format)

Solo salida. El ID de la acción de conversión.
name

string

Es el nombre de la acción de conversión.

Este campo es obligatorio y no debe estar vacío cuando se crean acciones de conversión nuevas.
primaryForGoal

boolean

Si el bit principalForGoal de una acción de conversión es falso, la acción de conversión no podrá ofertar en ninguna campaña, independientemente del objetivo de conversión de su cliente o del objetivo de conversión de la campaña. Sin embargo, los objetivos de conversión personalizados no respetan el elemento primaryForGoal. Por lo tanto, si una campaña tiene un objetivo de conversión personalizado configurado con una acción de conversión falsa como primaryForGoal, esa acción de conversión podrá ofertar de todas formas. De forma predeterminada, el parámetro primaryForGoal será verdadero si no se establece. En la versión 9, primaryForGoal solo se puede establecer como falso después de su creación mediante una operación de "actualización", ya que no se declara como opcional.
ownerCustomer

string

Solo salida. El nombre del recurso del cliente propietario de la acción de conversión o nulo si se trata de una acción de conversión definida por el sistema.
includeInConversionsMetric

boolean

Indica si esta acción de conversión debe incluirse en la métrica "conversiones".
clickThroughLookbackWindowDays

string (int64 format)

Es la cantidad máxima de días que pueden transcurrir entre una interacción (por ejemplo, un clic) y un evento de conversión.
viewThroughLookbackWindowDays

string (int64 format)

Es la cantidad máxima de días que pueden transcurrir entre una impresión y una conversión sin una interacción.
phoneCallDurationSeconds

string (int64 format)

Es la duración de la llamada telefónica en segundos después de la cual se debe registrar una conversión para esta acción de conversión.

El valor debe ser entre 0 y 10,000, ambos incluidos.
appId

string

Es el ID de aplicación de una acción de conversión de aplicación.

ConversionActionStatus

Posibles estados de una acción de conversión.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
ENABLED Se registrarán las conversiones.
REMOVED No se registrarán las conversiones.
HIDDEN No se registrarán las conversiones, y la acción de conversión no aparecerá en la IU.

ConversionActionType

Tipos posibles de una acción de conversión.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
AD_CALL Conversiones que se producen cuando un usuario hace clic en la extensión de llamada de un anuncio.
CLICK_TO_CALL Conversiones que se producen cuando un usuario de un dispositivo móvil hace clic en un número de teléfono.
GOOGLE_PLAY_DOWNLOAD Son las conversiones que se producen cuando un usuario descarga una aplicación para dispositivos móviles desde Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversiones que se producen cuando un usuario realiza una compra en una aplicación a través de la facturación de Android.
UPLOAD_CALLS Son las conversiones de llamada que el anunciante hace un seguimiento y que suben.
UPLOAD_CLICKS Conversiones de las que el anunciante hace un seguimiento y que se suben con clics atribuidos.
WEBPAGE Conversiones que se generan en una página web
WEBSITE_CALL Conversiones que se producen cuando un usuario llama a un número de teléfono generado de forma dinámica desde el sitio web de un anunciante.
STORE_SALES_DIRECT_UPLOAD La conversión de ventas en la tienda según las cargas de datos de comercios de origen o de terceros. Solo los clientes de la lista de entidades permitidas pueden usar los tipos de carga directa de ventas en la tienda.
STORE_SALES La conversión de ventas en la tienda se basa en cargas de datos de comercios de origen o de terceros, o bien de compras en la tienda realizadas con tarjetas de redes de pagos. Solo los clientes de la lista de entidades permitidas pueden usar los tipos de ventas en la tienda. Solo lectura.
FIREBASE_ANDROID_FIRST_OPEN Conversiones de primer acceso de aplicación para Android a las que se les hace un seguimiento mediante Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación en la aplicación para Android a las que se hace un seguimiento a través de Firebase.
FIREBASE_ANDROID_CUSTOM Conversiones personalizadas de aplicaciones para Android cuyo seguimiento se realiza a través de Firebase
FIREBASE_IOS_FIRST_OPEN Conversiones de primer acceso de aplicación para iOS a las que se les hace un seguimiento a través de Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación en la aplicación para iOS a las que se les hace un seguimiento a través de Firebase.
FIREBASE_IOS_CUSTOM Conversiones personalizadas de aplicaciones para iOS cuyo seguimiento se realiza a través de Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversiones de primer acceso de aplicación para Android a las que se les hace un seguimiento mediante estadísticas de aplicaciones de terceros
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación en la aplicación para Android a las que se hace un seguimiento a través de estadísticas de aplicaciones de terceros
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversiones personalizadas de aplicaciones para Android cuyo seguimiento se realiza mediante estadísticas de aplicaciones de terceros
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversiones de primer acceso en aplicación para iOS registradas a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación en la aplicación para iOS a las que se hace un seguimiento mediante estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversiones personalizadas de aplicaciones para iOS a las que se les hace un seguimiento mediante estadísticas de aplicaciones de terceros
ANDROID_APP_PRE_REGISTRATION Son las conversiones que se producen cuando un usuario realiza el registro previo de una aplicación para dispositivos móviles en Google Play Store. Solo lectura.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversiones que realizan un seguimiento de todas las descargas de Google Play a las que no se hace seguimiento por un tipo específico de aplicación. Solo lectura.
FLOODLIGHT_ACTION Actividad de Floodlight que cuenta la cantidad de veces que los usuarios visitaron una página web específica después de ver uno de los anuncios de un anunciante o hacer clic en él Solo lectura.
FLOODLIGHT_TRANSACTION Actividad de Floodlight que realiza un seguimiento de la cantidad de ventas realizadas o de artículos comprados También puede captar el valor total de cada venta. Solo lectura.
GOOGLE_HOSTED Conversiones que realizan un seguimiento de las acciones locales de los productos y servicios de Google después de interactuar con un anuncio. Solo lectura.
LEAD_FORM_SUBMIT Las conversiones se registran cuando un usuario envía un formulario de clientes potenciales. Solo lectura.
SALESFORCE Conversiones que provienen de Salesforce. Solo lectura.
SEARCH_ADS_360 Son las conversiones importadas desde los datos de Floodlight de Search Ads 360. Solo lectura.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversiones de llamadas que se generan en anuncios de campañas inteligentes sin configurar el seguimiento de llamadas que utilizan criterios personalizados para las campañas inteligentes Solo lectura.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL El usuario hace clic en un elemento de llamada en Google Maps. Solo para campañas inteligentes. Solo lectura.
SMART_CAMPAIGN_MAP_DIRECTIONS El usuario solicita instrucciones sobre cómo llegar a la ubicación de una empresa en Google Maps. Solo para campañas inteligentes. Solo lectura.
SMART_CAMPAIGN_TRACKED_CALLS Conversiones de llamada que se producen en anuncios de campañas inteligentes con la configuración del seguimiento de llamadas y utilizan criterios personalizados para las campañas inteligentes. Solo lectura.
STORE_VISITS Conversiones que se producen cuando un usuario visita la tienda de venta minorista de un anunciante. Solo lectura.
WEBPAGE_CODELESS Conversiones creadas a partir de eventos de sitios web (como envíos de formularios o cargas de páginas) que no utilizan fragmentos de evento codificados de forma individual. Solo lectura.
UNIVERSAL_ANALYTICS_GOAL Conversiones que provienen de objetivos de Universal Analytics vinculados.
UNIVERSAL_ANALYTICS_TRANSACTION Conversiones que provienen de transacciones de Universal Analytics vinculadas.
GOOGLE_ANALYTICS_4_CUSTOM Conversiones que provienen de conversiones de eventos personalizados de Google Analytics 4 vinculadas.
GOOGLE_ANALYTICS_4_PURCHASE Son las conversiones que provienen de conversiones por compras vinculadas de Google Analytics 4.

ValueSettings

Es la configuración relacionada con el valor de los eventos de conversión asociados a esta acción de conversión.

Representación JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Campos
defaultValue

number

Es el valor que se debe usar cuando los eventos de conversión de esta acción de conversión se envían con un valor no válido, no permitido o faltante, o bien cuando esta acción de conversión está configurada para utilizar siempre el valor predeterminado.
defaultCurrencyCode

string

El código de moneda que se debe usar cuando se envían eventos de conversión para esta acción de conversión con un código de moneda no válido o faltante, o cuando esta acción de conversión está configurada para utilizar siempre el valor predeterminado.
alwaysUseDefaultValue

boolean

Controla si se utilizan el valor y el código de moneda predeterminados en lugar del valor y el código de moneda especificados en los eventos de conversión para esta acción de conversión.

ConversionActionCountingType

Indica cómo se registrarán las conversiones para esta acción. Para obtener más información, consulta https://support.google.com/google-ads/answer/3438531.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
ONE_PER_CLICK Registrar solo una conversión por clic.
MANY_PER_CLICK Registrar todas las conversiones por clic.

AttributionModelSettings

Es la configuración relacionada con el modelo de atribución de esta acción de conversión.

Representación JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Campos
attributionModel

enum (AttributionModel)

Es el tipo de modelo de atribución de esta acción de conversión.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Solo salida. Indica el estado del modelo de atribución basada en datos de la acción de conversión.

AttributionModel

Es el modelo de atribución que describe cómo distribuir el crédito de una conversión en particular entre muchas interacciones anteriores.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
EXTERNAL Utiliza la atribución externa.
GOOGLE_ADS_LAST_CLICK Atribuye todo el crédito de una conversión al último clic.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Atribuye todo el crédito de una conversión al primer clic mediante la atribución en la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Atribuye el crédito de una conversión de manera equitativa entre todos sus clics y utiliza la atribución en la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Atribuye un crédito exponencialmente más alto por una conversión a sus clics más recientes mediante la atribución en la Búsqueda de Google (la semivida es de 1 semana).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Atribuye el 40% del crédito de una conversión a sus primeros y últimos clics. El 20% restante se distribuye de manera uniforme entre todos los demás clics. Se utiliza la atribución de la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Es un modelo flexible que utiliza el aprendizaje automático para determinar la distribución adecuada del crédito entre los clics mediante la atribución en la Búsqueda de Google.

DataDrivenModelStatus

Enumera los estados de los modelos basados en datos.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor que se muestra. Representa un valor desconocido en esta versión.
AVAILABLE El modelo basado en datos está disponible.
STALE El modelo basado en datos está inactivo. No se actualizó hace al menos 7 días. Todavía se utiliza, pero vencerá si no se actualiza en 30 días.
EXPIRED Venció el modelo basado en datos. No se actualizó hace al menos 30 días y no se puede usar. Por lo general, esto se debe a que no se registró la cantidad necesaria de eventos en un período reciente de 30 días.
NEVER_GENERATED Nunca se generó el modelo basado en datos. Por lo general, esto se debe a que nunca ha habido la cantidad requerida de eventos en un período de 30 días.

FirebaseSettings

Es la configuración relacionada con una acción de conversión de Firebase.

Representación JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Campos
propertyId

string (int64 format)

Solo salida. El ID de propiedad de Google Analytics de la conversión.
propertyName

string

Solo salida. El nombre de la propiedad de Google Analytics de la conversión.
eventName

string

Solo salida. Es el nombre del evento de una conversión de Firebase.
projectId

string

Solo salida. Es el ID del proyecto de Firebase de la conversión.

ThirdPartyAppAnalyticsSettings

Es la configuración relacionada con una acción de conversión de estadísticas de aplicaciones de terceros.

Representación JSON 
{
  "providerName": string,
  "eventName": string
}
Campos
providerName

string

Solo salida. Nombre del proveedor de estadísticas de aplicaciones de terceros.
eventName

string

Solo salida. Es el nombre del evento de una conversión de estadísticas de aplicaciones de terceros.

GoogleAnalytics4Settings

Configuración relacionada con una acción de conversión de Google Analytics 4.

Representación JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Campos
eventName

string

Solo salida. El nombre del evento de GA 4
propertyName

string

Solo salida. El nombre de la propiedad GA 4
propertyId

string (int64 format)

Solo salida. El ID de la propiedad GA 4.