REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa uma origem da conversão de propriedade 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 após a 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 pode ser o mesmo em tipos diferentes. Os seguintes tipos de prefixo são suportados: - galk: para origens GoogleAnalyticsLink. - mcdn: para origens do MerchantCenterDestination.

state

enum (State)

Apenas saída. Estado atual dessa origem de conversão. Não pode ser editado pela 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 só pode ser de um dos seguintes tipos:
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

Representa as configurações de atribuição para 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 com os diferentes tipos de conversão em que um evento de conversão pode ser classificado. Um tipo "compra" padrão será criado automaticamente se a 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.

Tipos enumerados
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 em vários canais.
CROSS_CHANNEL_POSITION_BASED Modelo baseado na posição em vários canais.
CROSS_CHANNEL_TIME_DECAY Modelo de iminência da conversão em vários canais.

ConversionType

Mensagem que representa um tipo 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 vai 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

As origens de "Destino do Merchant Center" podem ser usadas para enviar eventos de conversão de uma loja on-line com uma tag do Google diretamente à 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. Esse nome 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 para esse destino serão informadas no Merchant Center.

Estado

Representa o estado da origem da conversão.

Tipos enumerados
STATE_UNSPECIFIED A origem da conversão não tem um estado não especificado.
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. Podem ser restaurados usando o método de cancelamento de exclusão.
PENDING A criação da origem da conversão começou, mas ainda não foi concluída.

Controlador

Entidade que controla a origem da conversão.

Tipos enumerados
CONTROLLER_UNSPECIFIED Valor padrão. Esse valor não é usado.
MERCHANT Controlado pelo comerciante que é 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 da conversão.

list

Recupera a lista de origens de conversão às quais 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.