REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa uma origem de conversão de uma conta do comerciante. Uma conta do comerciante pode ter até 200 origens de conversão.

Representação 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

Apenas saída. Identificador. Gerado pela API Content na criação de um novo ConversionSource. Formato: [a-z]{4}:.+ Os quatro caracteres antes dos dois pontos representam o tipo de origem da conversão. O conteúdo após os dois pontos representa o ID da origem da conversão nesse tipo. O ID de duas origens de conversão diferentes pode ser o mesmo em tipos diferentes. Os seguintes tipos de prefixo são suportados: - galk: para origens do GoogleAnalyticsLink. - mcdn: para origens do MerchantCenterDestination.

state

enum (State)

Apenas saída. Estado atual dessa origem de conversão. Não pode ser editado por meio da API.

expireTime

string (Timestamp format)

Apenas saída. O horário em que uma origem de conversão arquivada é excluída permanentemente e não está mais disponível para cancelamento.

controller

enum (Controller)

Apenas saída. Controlador da origem da conversão.

Campo de união source_data. Obrigatório. Dados de origem da conversão específicos para cada tipo diferente de origem. source_data pode ser apenas de um dos tipos a seguir:
merchantCenterDestination

object (MerchantCenterDestination)

Origem da conversão do tipo "Destino da tag do Merchant Center".

AttributionSettings

Representa as configurações de atribuição das origens de conversão que recebem dados de pré-atribuição.

Representação JSON
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Campos
attributionLookbackWindowDays

integer

Obrigatório. Janelas de lookback (em dias) usadas para atribuição nesta fonte. Os valores aceitos são 7, 30, 40.

attributionModel

enum (AttributionModel)

Obrigatório. Modelo de atribuição.

conversionType[]

object (ConversionType)

Imutável. Lista não ordenada. Lista de diferentes tipos de conversão em que um evento de conversão pode ser classificado. Uma "compra" padrão tipo será criado automaticamente se esta lista estiver vazia no momento da criação.

AttributionModel

O modelo de atribuição usado para esta fonte. Oferecemos suporte ao mesmo conjunto de modelos oferecido pelo Google Analytics 4, conforme descrito em: https://support.google.com/analytics/answer/10596866.

Enums
ATTRIBUTION_MODEL_UNSPECIFIED Modelo não especificado.
CROSS_CHANNEL_LAST_CLICK Modelo de último clique em vários canais.
ADS_PREFERRED_LAST_CLICK Modelo de último clique com preferência pelo Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Modelo baseado em dados cross-channel.
CROSS_CHANNEL_FIRST_CLICK Modelo de primeiro clique em vários canais.
CROSS_CHANNEL_LINEAR Modelo linear cross-channel.
CROSS_CHANNEL_POSITION_BASED Modelo com base na posição cross-channel.
CROSS_CHANNEL_TIME_DECAY Modelo de iminência da conversão em vários canais.

ConversionType

Mensagem que representa os tipos de evento de conversão

Representação JSON
{
  "name": string,
  "report": boolean
}
Campos
name

string

Apenas saída. Nome do evento de conversão, como será informado pelo cliente.

report

boolean

Apenas saída. Opção que indica se o tipo deve ser incluído nos relatórios do Merchant Center.

MerchantCenterDestination

"Destino no Merchant Center" origens podem ser usadas para enviar eventos de conversão de uma loja on-line usando uma tag do Google diretamente para uma conta do Merchant Center em que a origem foi criada.

Representação JSON
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Campos
destination

string

Apenas saída. ID de destino do Merchant Center.

attributionSettings

object (AttributionSettings)

Obrigatório. Configurações de atribuição usadas para o destino do Merchant Center.

displayName

string

Obrigatório. Nome de exibição especificado pelo comerciante para o destino. É o nome que identifica a origem da conversão na interface do Merchant Center. com até 64 caracteres.

currencyCode

string

Obrigatório. Código de moeda de três letras (ISO 4217). O código da moeda define em qual moeda as conversões enviadas a esse destino serão informadas no Merchant Center.

Estado

Representa o estado da origem da conversão.

Enums
STATE_UNSPECIFIED A origem da conversão não tem um estado.
ACTIVE A origem da conversão é totalmente funcional.
ARCHIVED A origem da conversão foi arquivada nos últimos 30 dias e não está funcionando no momento. Elas podem ser restauradas usando o método de cancelamento de exclusão.
PENDING A criação da origem de conversão começou, mas ainda não foi concluída.

Controlador

Entidade que controla a origem da conversão.

Enums
CONTROLLER_UNSPECIFIED Valor padrão. Esse valor não é usado.
MERCHANT Controlada pelo comerciante proprietário da origem da conversão.
YOUTUBE_AFFILIATES Controlado pelo programa de afiliados do YouTube.

Métodos

create

Cria uma nova origem da conversão.

delete

Arquiva uma origem de conversão existente.

get

Busca uma origem de conversão.

list

Recupera a lista de origens de conversão a que o autor da chamada tem acesso.

patch

Atualiza as informações de uma origem de conversão existente.

undelete

Reativa uma origem de conversão arquivada.