REST Resource: accounts.conversionSources

Recurso: ConversionSource

Representa uma origem de conversão pertencente a uma conta de comerciante. Uma conta de 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 diferentes pode ser o mesmo em tipos diferentes. Os seguintes prefixos de tipo são aceitos: - galk: para origens do Google Analytics Link. - mcdn: para origens MerchantCenterDestination.

state

enum (State)

Apenas saída. Estado atual dessa origem de conversão. Não podem ser editados pela API.

expireTime

string (Timestamp format)

Apenas saída. O período em que uma origem de conversão arquivada é excluída permanentemente e não pode ser restaurada.

controller

enum (Controller)

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

Campo de união source_data. Obrigatório. Dados da origem da conversão específicos para cada tipo 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 para fontes 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 e 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. Um tipo "compra" padrão será criado automaticamente se essa lista estiver vazia no momento da criação.

AttributionModel

O modelo de atribuição usado para essa origem. Oferecemos suporte ao mesmo conjunto de modelos oferecidos 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 preferencial do Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Modelo baseado em dados em vários canais.
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 com base na posição em vários canais.
CROSS_CHANNEL_TIME_DECAY Modelo de redução de tempo 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, conforme 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 "Destino do Merchant Center" 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. Limitado a 64 caracteres.

currencyCode

string

Obrigatório. Código de moeda de três letras (ISO 4217). O código de 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.

Enums
STATE_UNSPECIFIED A origem da conversão tem um estado não especificado.
ACTIVE A origem da conversão está totalmente funcional.
ARCHIVED A origem da conversão foi arquivada nos últimos 30 dias e não está funcional no momento. Pode ser restaurado usando o método de restauração.
PENDING A criação da origem de conversão foi iniciada, 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 que é proprietário da origem da conversão.
YOUTUBE_AFFILIATES Controlado pelo programa de afiliados do YouTube.

Métodos

create

Cria uma nova origem de conversão.

delete

Arquiva uma origem de conversão.

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.

undelete

Reativar uma origem de conversão arquivada.