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 eventos de conversión para la acción de conversión
attributionModelSettings

object (AttributionModelSettings)

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 usan para hacer un seguimiento de las conversiones.
mobileAppVendor

enum (MobileAppVendor)

Solo salida. Proveedor de apps para dispositivos móviles que realiza 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. Configuración de estadísticas de aplicaciones de terceros para 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 mainForGoal de una acción de conversión es falso, la acción de conversión no se puede ofertar para todas las campañas, independientemente de su objetivo de conversión de clientes o del objetivo de conversión de la campaña. Sin embargo, los objetivos de conversión personalizados no respetan primaryForGoal. Por lo tanto, si una campaña tiene un objetivo de conversión personalizado configurado con una acción de conversión primaryForGoal = false, esa acción de conversión aún se podrá ofertar. De forma predeterminada, primaryForGoal será verdadero si no se configura. En la versión 9, primaryForGoal solo se puede establecer como falso después de la 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 del 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, inclusive.
appId

string

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

ConversionActionStatus

Son los posibles estados de una acción de conversión.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
ENABLED Se registrarán las conversiones.
REMOVED No se registrarán las conversiones.
HIDDEN Las conversiones no se registrarán 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 de retorno. 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 que utiliza un dispositivo móvil hace clic en un número de teléfono
GOOGLE_PLAY_DOWNLOAD 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 mediante la facturación de Android.
UPLOAD_CALLS Conversiones de llamada a las que el anunciante hace un seguimiento y que sube.
UPLOAD_CLICKS Conversiones de las que el anunciante hace un seguimiento y que se suben con clics atribuidos
WEBPAGE Conversiones que se producen 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 Conversión de ventas en la tienda basada en 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 en 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 registradas a través de Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Seguimiento de conversiones por compras directas desde la aplicación para Android mediante Firebase.
FIREBASE_ANDROID_CUSTOM Conversiones personalizadas de aplicaciones para Android a las que se les hace un seguimiento mediante Firebase
FIREBASE_IOS_FIRST_OPEN Conversiones de primer acceso de aplicación para iOS registradas a través de Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación para iOS registradas a través de Firebase.
FIREBASE_IOS_CUSTOM Conversiones personalizadas de aplicaciones para iOS a las que se les hace un seguimiento mediante Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversiones de primer acceso de aplicación para Android registradas a través de estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversiones por compras directas desde la aplicación para Android de las que se hace un seguimiento mediante Analytics de aplicaciones de terceros
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversiones personalizadas de aplicaciones para Android a las que se hace un seguimiento mediante estadísticas de aplicaciones de terceros.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversiones de primer acceso en aplicaciones 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 para iOS registradas a través de Analytics 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 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 Son las conversiones que 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 llamada que se generan en los anuncios de campañas inteligentes sin la configuración del seguimiento de llamadas y con criterios personalizados de 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 los anuncios de campañas inteligentes con la configuración del seguimiento de llamadas y con criterios personalizados de las campañas inteligentes. Solo lectura.
STORE_VISITS Conversiones que se producen cuando un usuario visita la tienda 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 individualmente. Solo lectura.
UNIVERSAL_ANALYTICS_GOAL Conversiones que provienen de objetivos vinculados de Universal Analytics
UNIVERSAL_ANALYTICS_TRANSACTION Conversiones que provienen de transacciones vinculadas de Universal Analytics
GOOGLE_ANALYTICS_4_CUSTOM Conversiones que provienen de conversiones de eventos personalizados de Google Analytics 4 vinculadas.
GOOGLE_ANALYTICS_4_PURCHASE 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 utilizar cuando los eventos de conversión correspondientes a 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

Es 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, consulte https://support.google.com/google-ads/answer/3438531.

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

AttributionModelSettings

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. Es el estado del modelo de atribución basada en datos para 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 específica entre muchas interacciones anteriores.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. 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 cada vez más crédito 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 en la Búsqueda de Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 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 del modelo basado en datos.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. 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ó durante, al menos, 7 días. Todavía está en uso, pero vencerá si no se actualiza durante 30 días.
EXPIRED El modelo basado en datos venció. No se actualizó durante, al menos, 30 días y no se puede usar. Por lo general, esto se debe a que no hubo la cantidad necesaria de eventos en un período reciente de 30 días.
NEVER_GENERATED El modelo basado en datos nunca se generó. Por lo general, esto se debe a que nunca hubo la cantidad necesaria de eventos en un período de 30 días.

FirebaseSettings

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. Es el ID de la propiedad de Google Analytics de la conversión.
propertyName

string

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

string

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

string

Solo salida. 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. Es el nombre del proveedor de estadísticas de aplicaciones de terceros.
eventName

string

Solo salida. Es el nombre del evento de una conversión de analítica 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. Indica el nombre del evento de GA4.
propertyName

string

Solo salida. Indica el nombre de la propiedad GA 4.
propertyId

string (int64 format)

Solo salida. El ID de la propiedad GA 4.