REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa una fuente de conversiones que pertenece a una cuenta de Merchant Center. 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. Content API lo genera 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 que aparece 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 distintos tipos. Se admiten los siguientes prefijos de tipo: - galk: para fuentes GoogleAnalyticsLink. - mcdn: Para las fuentes de MerchantCenterDestination.

state

enum (State)

Solo salida. El estado actual de esta fuente de conversiones. No se pueden editar con la API.

expireTime

string (Timestamp format)

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

controller

enum (Controller)

Solo salida. Controlador de la fuente de conversiones.

Campo de unión source_data. Obligatorio. Son los datos de la fuente de conversiones específicos de cada tipo diferente. 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. Ventanas de visualización (en días) usadas 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. Lista de diferentes tipos de conversión en los que se puede clasificar un evento de conversión. Una "compra" estándar se creará automáticamente 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 múltiples canales.
CROSS_CHANNEL_LINEAR Modelo lineal de varios canales.
CROSS_CHANNEL_POSITION_BASED Modelo basado en la posición en múltiples canales.
CROSS_CHANNEL_TIME_DECAY Modelo de decaimiento temporal en múltiples canales.

ConversionType

Mensaje que representa un tipo de eventos de conversión

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

string

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

report

boolean

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

MerchantCenterDestination

“Destino de Merchant Center” Las fuentes 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. Es la configuración de atribución que se usa para el destino de Merchant Center.

displayName

string

Obligatorio. Es el nombre visible que especifica el comercio para el destino. 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 registrarán en Merchant Center las conversiones que se envíen a este destino.

Estado

Representa el estado de la fuente de conversiones.

Enumeraciones
STATE_UNSPECIFIED La fuente de la conversión 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 por el momento. Se pueden restablecer con el método de recuperación.
PENDING Comenzó la creación de la fuente de conversiones, pero aún no ha finalizado por completo.

Controlador

Entidad que controla la fuente de conversiones.

Enumeraciones
CONTROLLER_UNSPECIFIED Valor predeterminado Este valor no se usa.
MERCHANT La controla 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.