REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa una fuente de conversiones que es propiedad de una cuenta de comerciante. Una cuenta de comerciante puede tener hasta 200 fuentes de conversiones.

Representación JSON
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
Campos
name

string

Solo salida. Identificador. Lo genera Content API cuando se crea un ConversionSource nuevo. Formato: [a-z]{4}:.+ Los cuatro caracteres antes de los dos puntos representan el tipo de fuente de conversión. El contenido después de los dos puntos representa el ID de la fuente de conversiones dentro de ese tipo. El ID de dos fuentes de conversiones diferentes puede ser el mismo en diferentes tipos. Se admiten los siguientes prefijos de tipo: - galk: para fuentes de GoogleAnalyticsLink. - mcdn: Para las fuentes de MerchantCenterDestination.

state

enum (State)

Solo salida. Es el estado actual de esta fuente de conversiones. No se pueden editar mediante la API.

expireTime

string (Timestamp format)

Solo salida. El momento en que una fuente de conversiones archivada se borra de forma permanente y ya no está disponible para recuperarla.

controller

enum (Controller)

Solo salida. Es el controlador de la fuente de conversiones.

Campo de unión source_data. Obligatorio. Son datos específicos de la fuente de conversiones para cada tipo diferente de fuente. Las direcciones (source_data) solo pueden ser una de las siguientes opciones:
merchantCenterDestination

object (MerchantCenterDestination)

Fuente de conversiones del tipo “Destino de la etiqueta de Merchant Center”.

AttributionSettings

Representa la configuración de atribución de las fuentes de conversiones que reciben datos de atribución previa.

Representación JSON
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Campos
attributionLookbackWindowDays

integer

Obligatorio. Ventanas de visualización (en días) que se usan para la atribución en esta fuente Los valores admitidos son 7, 30 y 40.

attributionModel

enum (AttributionModel)

Obligatorio. Modelo de atribución.

conversionType[]

object (ConversionType)

Inmutable. Lista sin ordenar. Es una lista de los diferentes tipos de conversión con los que se puede clasificar un evento de conversión. Se creará automáticamente un tipo de "compra" estándar si la lista está vacía en el momento de la creación.

AttributionModel

Es el modelo de atribución que se usa para esta fuente. Admitimos el mismo conjunto de modelos que ofrece Google Analytics 4, como se describe en https://support.google.com/analytics/answer/10596866.

Enumeradores
ATTRIBUTION_MODEL_UNSPECIFIED Modelo no especificado.
CROSS_CHANNEL_LAST_CLICK Modelo de último clic de varios canales
ADS_PREFERRED_LAST_CLICK Modelo de último clic con preferencia de Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Modelo basado en datos de varios canales.
CROSS_CHANNEL_FIRST_CLICK Modelo de primer clic de varios canales.
CROSS_CHANNEL_LINEAR Modelo lineal de varios canales.
CROSS_CHANNEL_POSITION_BASED Modelo según la posición de varios canales.
CROSS_CHANNEL_TIME_DECAY Modelo de decaimiento temporal de varios canales

ConversionType

Mensaje que representa los tipos de eventos de conversión

Representación JSON
{
  "name": string,
  "report": boolean
}
Campos
name

string

Solo salida. Es el nombre del evento de conversión, tal como lo informará el cliente.

report

boolean

Solo salida. Es una opción que indica si se debe incluir el tipo en los informes de Merchant Center.

MerchantCenterDestination

Las fuentes de "Destino de Merchant Center" se pueden usar para enviar eventos de conversión desde una tienda en línea mediante una etiqueta de Google directamente a una cuenta de Merchant Center en la que se crea la fuente.

Representación JSON
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Campos
destination

string

Solo salida. ID de destino de Merchant Center.

attributionSettings

object (AttributionSettings)

Obligatorio. Configuración de atribución que se utiliza para el destino de Merchant Center.

displayName

string

Obligatorio. Es el nombre visible que especifica el comercio para el destino. Este es el nombre que identifica la fuente de conversiones en la IU de Merchant Center. Límite de 64 caracteres.

currencyCode

string

Obligatorio. Es el código de moneda de tres letras (ISO 4217). El código de moneda define en qué moneda se informarán las conversiones que se envíen a este destino en Merchant Center.

Estado

Representa el estado de la fuente de conversiones.

Enumeradores
STATE_UNSPECIFIED La fuente de conversiones tiene un estado no especificado.
ACTIVE La fuente de conversiones funciona correctamente.
ARCHIVED La fuente de conversiones se archivó en los últimos 30 días y no funciona en este momento. Se puede restablecer con el método de recuperación.
PENDING Se inició la creación de la fuente de conversiones, pero aún no se completó por completo.

Controlador

Es la entidad que controla la fuente de conversiones.

Enumeradores
CONTROLLER_UNSPECIFIED Valor predeterminado Este valor no se usa.
MERCHANT Controlado por el comercio propietario de la fuente de conversiones
YOUTUBE_AFFILIATES Controlado por el programa de afiliados de YT

Métodos

create

Crea una nueva fuente de conversiones.

delete

Archiva una fuente de conversiones existente.

get

Recupera una fuente de conversiones.

list

Recupera la lista de fuentes de conversiones a las que tiene acceso el emisor.

patch

Actualiza la información de una fuente de conversiones existente.

undelete

Vuelve a habilitar una fuente de conversiones archivada.