Conversion

O recurso de conversão tem métodos que permitem aos usuários criar, modificar e recuperar conversões do Floodlight em massa.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Uma lista de conversões.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}
Nome da propriedade Valor Descrição Observações
conversion[] list As conversões solicitadas.
conversion[].adGroupId long ID do grupo de anúncios do DS.
conversion[].adId long ID do anúncio do DS.
conversion[].adUserDataConsent string Representa o consentimento para as preferências dos serviços principais de plataforma (CPS) nas configurações. Nenhum valor padrão. Os valores aceitáveis são: GRANTED: o status de consentimento desejado é "concedido". Leia as preferências da CPS nas configurações de GTE. DENIED: o status de consentimento desejado é "negar". A lista de CPS está vazia.
conversion[].advertiserId long ID do anunciante do DS.
conversion[].agencyId long ID da agência do DS.
conversion[].attributionModel string Disponível para anunciantes somente após o contato com o suporte ao cliente do DoubleClick Search.
conversion[].campaignId long ID da campanha do DS.
conversion[].channel string Canal de vendas do produto. Os valores aceitáveis são:
  • "local": uma loja física
  • "online": uma loja on-line
conversion[].clickId string É o ID de clique do DS para a conversão.
conversion[].conversionId string Para conversões off-line, os anunciantes fornecem esse ID. Os anunciantes podem especificar qualquer ID que seja significativo para eles. Cada conversão em uma solicitação deve especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora deve ser exclusiva entre todas as conversões no anunciante.
No caso de conversões on-line, o DS copia o dsConversionId ou o floodlightOrderId para essa propriedade, dependendo das instruções do Floodlight do anunciante.
conversion[].conversionModifiedTimestamp unsigned long A hora em que a conversão foi modificada pela última vez, em milissegundos UTC.
conversion[].conversionTimestamp unsigned long O horário em que a conversão ocorreu, em milissegundos UTC.
conversion[].countMillis long Disponível para anunciantes somente após o contato com o suporte ao cliente do DoubleClick Search.
conversion[].criterionId long ID do critério (palavra-chave) do DS.
conversion[].currencyCode string O código da moeda da receita da conversão. Deve estar no formato alfabético ISO 4217 (3 caracteres). gravável
conversion[].customDimension[] list Dimensões personalizadas para a conversão, que podem ser usadas para filtrar dados em um relatório.
conversion[].customDimension[].name string Nome da dimensão personalizada.
conversion[].customDimension[].value string Valor da dimensão personalizada.
conversion[].customMetric[] list Métricas personalizadas para a conversão.
conversion[].customMetric[].name string Nome da métrica personalizada.
conversion[].customMetric[].value double Valor numérico da métrica personalizada.
conversion[].customerId string ID de cliente do novo Search Ads 360. Precisa ser uma conta de cliente. Quando esse campo está definido, todos os outros campos de ID precisam ser configurados para os novos IDs do Search Ads 360.
conversion[].deviceType string O tipo de dispositivo em que a conversão ocorreu.

Os valores aceitáveis são:
  • "DESKTOP"
  • "HIGH_END_MOBILE"
  • "OTHER_DEVICE"
  • "TABLET"
conversion[].dsConversionId long ID que o DoubleClick Search gera para cada conversão.
conversion[].engineAccountId long ID da conta de mecanismo do DS.
conversion[].floodlightOrderId string O ID do pedido do Floodlight fornecido pelo anunciante para a conversão.
conversion[].inventoryAccountId long Código que o DS gera e usa para identificar de forma exclusiva a conta de inventário que contém o produto.
conversion[].productCountry string O país registrado no feed do Google Merchant Center que contém o produto. Use um código ISO 3166 para especificar um país.
conversion[].productGroupId long ID do grupo de produtos do DS.
conversion[].productId string O ID do produto (SKU).
conversion[].productLanguage string O idioma registrado no feed do Merchant Center que contém o produto. Use um código ISO 639 para especificar um idioma.
conversion[].quantityMillis long A quantidade desta conversão, em milissegundos. gravável
conversion[].revenueMicros long O valor da receita dessa conversão de TRANSACTION, em micros (valor multiplicado por 1.000.000, sem decimal). Por exemplo, para especificar um valor de receita de "10" insira "10000000" (10 milhões) em sua solicitação. gravável
conversion[].segmentationId long O identificador de segmentação numérica (por exemplo, o código de atividade do Floodlight do DoubleClick Search).
conversion[].segmentationName string O identificador de segmentação simples (por exemplo, nome da atividade do Floodlight do DoubleClick Search).
conversion[].segmentationType string O tipo de segmentação dessa conversão (por exemplo, FLOODLIGHT).

Os valores aceitáveis são os seguintes:
  • "FLOODLIGHT"
conversion[].state string O estado da conversão, ou seja, ACTIVE ou REMOVED. Observação: o estado DELETED foi descontinuado.

Os valores aceitáveis são os seguintes:
  • "ACTIVE"
  • "DELETED":  (descontinuado)
  • "REMOVED"
 gravável
conversion[].storeId string ID da loja local para que o produto foi anunciado. Aplicável apenas quando o canal é "local".
conversion[].type string O tipo de conversão, ou seja, ACTION ou TRANSACTION. Uma conversão ACTION é uma ação do usuário que não tem valor monetariamente quantificável, enquanto uma conversão TRANSACTION é uma ação que tem um valor monetariamente quantificável. Por exemplo, inscrições em listas de e-mails (ACTION) em comparação com compras de e-commerce (TRANSACTION).

Os valores aceitáveis são os seguintes:
  • "ACTION"
  • "TRANSACTION"
kind string Identifica-o como um recurso ConversionList. Valor: a string fixa doubleclicksearch#conversionList.

Métodos

get
Recupera uma lista de conversões de uma conta de mecanismo do DoubleClick Search.
getByCustomerId
Recupera uma lista de conversões de uma conta de mecanismo do DoubleClick Search usando um novo ID de cliente do Search Ads 360.
inserir
Insere um lote de novas conversões no DoubleClick Search.
update
Atualiza um lote de conversões no DoubleClick Search.
updateAvailability
Atualiza as disponibilidades de um lote de atividades do Floodlight no DoubleClick Search.