REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa una fuente de conversiones que pertenece a 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 del dos puntos representan el tipo de fuente de conversiones. 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 fuentes de MerchantCenterDestination.

state

enum (State)

Solo salida. Es el estado actual de esta fuente de conversiones. No se pueden editar a través de la API.

expireTime

string (Timestamp format)

Solo salida. Es el momento en que una fuente de conversiones archivada se borra de forma definitiva y ya no está disponible para deshacer la eliminación.

controller

enum (Controller)

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

Campo de unión source_data. Obligatorio. Datos de la fuente de conversiones específicos de cada tipo 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 para las fuentes de conversiones que reciben datos previos a la atribución.

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

integer

Obligatorio. Son las 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 conversiones en los que se puede clasificar un evento de conversión. Se creará automáticamente un tipo de "compra" estándar si esta 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.

Enumeraciones
ATTRIBUTION_MODEL_UNSPECIFIED Modelo no especificado.
CROSS_CHANNEL_LAST_CLICK Modelo de último clic en múltiples 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 en varios canales.
CROSS_CHANNEL_LINEAR Modelo lineal de varios canales
CROSS_CHANNEL_POSITION_BASED Modelo basado en la posición en varios canales
CROSS_CHANNEL_TIME_DECAY Modelo de decaimiento temporal de varios canales

ConversionType

Mensaje que representa un tipo de evento 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 el tipo se debe incluir en los informes de Merchant Center.

MerchantCenterDestination

Las fuentes de "Destino de Merchant Center" se pueden usar para enviar eventos de conversión de una tienda en línea con 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 usa para el destino de Merchant Center

displayName

string

Obligatorio. Es el nombre visible especificado por el comercio para el destino. Es el nombre que identifica la fuente de conversiones en la IU de Merchant Center. Tiene un límite de 64 caracteres.

currencyCode

string

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

Estado

Representa el estado de la fuente de conversiones.

Enumeraciones
STATE_UNSPECIFIED La fuente de conversiones tiene un estado no especificado.
ACTIVE La fuente de conversiones es completamente funcional.
ARCHIVED La fuente de conversiones se archivó en los últimos 30 días y no está disponible en este momento. Se pueden restablecer con el método para deshacer la eliminación.
PENDING Se inició la creación de la fuente de conversiones, pero aún no se completó.

Controlador

Entidad que controla la fuente de conversiones.

Enumeraciones
CONTROLLER_UNSPECIFIED Valor predeterminado Este valor no se usa.
MERCHANT Es controlado por el comercio propietario de la fuente de conversiones.
YOUTUBE_AFFILIATES Está controlado por el programa de Afiliados de YT.

Métodos

create

Crea una fuente de conversiones nueva.

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 llamador.

patch

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

undelete

Vuelve a habilitar una fuente de conversiones archivada.