Nova experiência do

O novo Search Ads 360 atribui novos IDs a contas de usuário, campanhas, grupos de anúncios, palavras-chave (critérios) e anúncios. Há duas outras mudanças de comportamento para esses IDs:

  • O novo Search Ads 360 atribui um ID de cliente globalmente exclusivo a contas de administrador, subadministrador e cliente, formalmente conhecidas como agências, anunciantes e contas de mecanismo, respectivamente.

  • O novo Search Ads 360 não atribui mais IDs exclusivos a palavras-chave e anúncios.

A API Conversion agora aceita novos IDs de cliente do Search Ads 360 sempre que os IDs de agência, de anunciante e de conta de mecanismo são aceitos. Se você especificar uma API do cliente, ela espera que os IDs da campanha, do grupo de anúncios, da palavra-chave e do anúncio sejam IDs do novo Search Ads 360. Ao usar os novos IDs de anúncios ou palavras-chave do Search Ads 360, é preciso especificar os IDs associados da campanha e do grupo de anúncios sempre que sua solicitação usar um ID de anúncio ou palavra-chave.

Quando você usa um novo ID do Search Ads 360 na solicitação, a resposta também utiliza os IDs desse novo sistema.

Listar conversões

Há um novo endpoint para a solicitação de lista com o novo ID do Search Ads 360. É necessário fornecer um ID de cliente da conta do cliente. Além disso, você ainda pode especificar o ID da campanha e o ID do grupo de anúncios a serem listados nos parâmetros de consulta. Além disso, endDate, rowCount, startDate e startRow ainda são obrigatórios.

Solicitação HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

Inserir/atualizar conversão

Oferecemos suporte à seguinte solicitação que usa o novo ID do Search Ads 360:

  • Atribuir uma conversão a uma palavra-chave e a um anúncio
  • Atribuir uma conversão somente a uma palavra-chave
  • Atualizar conversão com o criterionId da conversão (ID de palavra-chave) especificado

Os endpoints ainda são os mesmos. Informe o novo ID do Search Ads 360 em cada recurso de conversão: em vez de definir agencyId, advertiserId e engineAccountId, informe customerId e use o novo ID do Search Ads 360 em campaignId, adGroupId, criterionId, adId, quando necessário.

Este é um exemplo de solicitação de como usar o ID do novo Search Ads 360 para atribuir uma conversão a uma palavra-chave. 

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}

Especificar a disponibilidade

Também é possível usar o novo ID do Search Ads 360 no método Conversion.updateAvailability() . Você precisa usar um ID de cliente de subadministrador. Confira um exemplo: 

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}