A API Search Ads 360 Reporting anterior será desativada em 30 de junho de 2024. A API Search Ads 360 Conversion não foi afetada e vai continuar compatível. Todo novo desenvolvimento de relatórios precisa usar a nova API Search Ads 360 Reporting.

A partir de abril de 2024, um erro supportedApiVersion será retornado ao solicitar um relatório. Veja os detalhes aqui.

Também é altamente recomendável migrar as implementações atuais do Search Ads 360 para a nova API. Consulte o Guia de introdução e o Guia de migração da nova API Search Ads 360 Reporting para saber mais informações.

Esta página foi traduzida pela API Cloud Translation.

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.