Adicionar novas conversões

Chame o método Conversion.insert() para adicionar uma ou mais conversões. Para atribuir a conversão corretamente, sua solicitação precisa especificar o nome de uma atividade do Floodlight que o anunciante está usando para gerar relatórios de conversões off-line, além do ID da palavra-chave, do anúncio e, possivelmente, do clique que resultou na conversão. Para informações sobre como conseguir IDs do Search Ads 360, consulte IDs e conversões do Search Ads 360.

Informações sobre as restrições ao envio de conversões históricas podem ser encontradas na Central de Ajuda do Search Ads 360.

Se a solicitação Conversion.insert() especificar várias conversões, o Search Ads 360 tentará fazer o upload de cada uma da melhor forma possível, em vez de enviar todo o lote como uma transação "tudo ou nada". Se algumas conversões de um lote não forem enviadas, talvez outras sejam. Os uploads de conversão podem falhar devido a uma solicitação inválida ou a falhas temporárias de rede ou sistema. Por isso, recomendamos que você leia a resposta de cada conversão inserida para garantir que o upload foi concluído.

Quando posso usar os dados enviados?

Se você especificar um conversionTimestamp de hoje ou ontem para uma conversão, as métricas dela vão aparecer na interface do Search Ads 360 em até uma hora após o upload. Se você especificar um conversionTimestamp anterior a ontem, as métricas serão atualizadas em várias horas.

Converta todos os carimbos de data/hora das conversões para horário de época (também conhecido como horário Unix).

Posso criar atividades do Floodlight usando a API?

Se o anunciante ainda não tiver criado uma atividade do Floodlight para rastrear conversões off-line, use a API do Campaign Manager para criar uma. Não é possível usar a API para especificar que uma atividade do Floodlight é usada principalmente para conversões off-line, o que é uma prática recomendada quando as estratégias de lances usam dados da conversão.

Recomendamos que, depois de usar a API para criar uma atividade do Floodlight, um usuário do Search Ads 360 faça login na plataforma e mude a configuração da atividade para indicar que a principal fonte de conversões é a atividade off-line.

Práticas recomendadas para adicionar conversões

Recomendamos as seguintes práticas recomendadas para adicionar conversões:

  1. Peça para um usuário do Search Ads 360 fazer login na plataforma e mudar as configurações de cada atividade do Floodlight usada para gerar relatórios de conversões off-line. As configurações precisam indicar que a origem principal das conversões é a atividade off-line. Consulte a Central de Ajuda do Search Ads 360 para conferir instruções.

  2. Faça o upload das conversões assim que elas estiverem disponíveis. Se você estiver atribuindo conversões a visitas específicas, aguarde pelo menos 6 horas após a visita antes de fazer upload da conversão. Talvez o Search Ads 360 não reconheça o ID de clique de uma visita se você fizer upload em menos de 6 horas após o acesso. Em casos raros, talvez seja necessário aguardar até 24 horas para que o Search Ads 360 reconheça o clickId.

    Verifique se cada upload contém as conversões mais recentes. Em uma única solicitação de upload, não há problema se as entradas estiverem fora da ordem cronológica. No entanto, uma estratégia de lances talvez não considere as conversões mais antigas que você enviar por upload mais tarde em outra solicitação.

Enviar uma solicitação de inserção

Você pode enviar uma solicitação Conversion.insert() para fazer o seguinte:

  • Atribuir uma conversão a uma visita específica
  • Atribuir uma conversão somente a uma palavra-chave

Os campos obrigatórios em uma solicitação Conversion.insert() dependem do evento ou item a que você está atribuindo a conversão. As seções a seguir listam os campos obrigatórios e opcionais para cada evento ou item a que você pode atribuir uma conversão.

Atribuir uma conversão a uma visita específica

Quando um cliente clica em um ou mais anúncios e acessa o site de um anunciante, o Search Ads 360 considera a sessão do usuário no site do anunciante como uma visita. Para atribuir uma conversão a uma visita, especifique o seguinte na solicitação Conversion.insert():

Campos obrigatórios

  • clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Procure nos registros da Web do anunciante o ID de clique ou listar conversões e use um ID de clique de outra conversão. O Search Ads 360 atribui a conversão à palavra-chave, ao anúncio e a outros objetos do Search Ads 360 que geraram a visita.
    Aguarde pelo menos 6 horas depois que o Search Ads 360 gerar um ID de clique para fazer upload das conversões. Se você receber um erro "ID do clique não encontrado", aguarde 24 horas e faça o upload das conversões novamente. Todas as conversões precisam ser enviadas em até 90 dias após a geração do ID de clique. Caso contrário, a API Search Ads 360 talvez não reconheça a visita.
  • conversionId: em conversões off-line, esse ID é fornecido pelos anunciantes. Os anunciantes podem especificar qualquer ID que seja relevante para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões do anunciante. Em conversões on-line, o Search Ads 360 copia o dsConversionId ou floodlightOrderId para essa propriedade, dependendo das instruções do Floodlight fornecidas pelo anunciante.
  • conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer em 05 de agosto de 2016, às 11h53min22s, no horário de verão do leste dos EUA (GMT -4:00), especifique o carimbo de data/hora em milissegundos de época: 1470412402000.
  • segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. No momento, apenas as conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificar FLOODLIGHT.
  • segmentationName: o nome da atividade do Floodlight que o anunciante está usando para informar a conversão.

    Se o anunciante tiver atividades com o mesmo nome (isso pode acontecer se elas pertencerem a grupos diferentes do Floodlight), a ação recomendada é renomear uma das atividades.

    Se você souber o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, especifique-o em segmentationId em vez de especificar o nome no campo segmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas ele é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversões. Para conferir o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API de relatórios. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 vai aparecer nele.

  • type: o tipo de conversão, ou seja, ACTION ou TRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO tem. Por exemplo, inscrições em listas de e-mail (ACTION) e compras de e-commerce (TRANSACTION).

    Se você especificar TRANSACTION, também precisará especificar o seguinte campo:

    • revenueMicros: o valor monetário da conversão.

Campos opcionais

  • quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões de ACTION, o Search Ads 360 vai inserir automaticamente um valor de 1000.
  • currencyCode: a moeda da receita de uma transação. Por padrão, a receita é considerada na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 vai converter o valor da receita especificado para a moeda do anunciante. Saiba mais
    Use o formato alfabético (três caracteres) do ISO 4217 para especificar a moeda.
    Aplicável somente a conversões de TRANSAÇÃO.
  • customMetric e customDimension: fazem upload de dados adicionais sobre uma conversão, como o país para onde um item comprado é enviado, IDs de produtos ou até mesmo a duração de uma ligação telefônica. Saiba mais sobre como fazer upload de dados para variáveis personalizadas do Floodlight.
  • deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Atribuir uma conversão somente a uma palavra-chave

Se sua principal preocupação for atribuir conversões a palavras-chave, e não a anúncios, omita a maioria dos identificadores do Search Ads 360 e especifique apenas o identificador da palavra-chave com alguns outros campos:

Campos obrigatórios

  • criterionId: é o identificador da palavra-chave. Para conseguir o criterionId, adicione a macro TrackerId aos URLs da página de destino. Para informações sobre como conseguir IDs de palavras-chave, consulte IDs e conversões do Search Ads 360.
  • conversionId: em conversões off-line, esse ID é fornecido pelos anunciantes. Os anunciantes podem especificar qualquer ID que seja relevante para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões do anunciante. Em conversões on-line, o Search Ads 360 copia o dsConversionId ou floodlightOrderId para essa propriedade, dependendo das instruções do Floodlight fornecidas pelo anunciante.
  • conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer em 05 de agosto de 2016, às 11h53min22s, no horário de verão do leste dos EUA (GMT -4:00), especifique o carimbo de data/hora em milissegundos de época: 1470412402000.
  • segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. No momento, apenas as conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificar FLOODLIGHT.
  • segmentationName: o nome da atividade do Floodlight que o anunciante está usando para informar a conversão.

    Se o anunciante tiver atividades com o mesmo nome (isso pode acontecer se elas pertencerem a grupos diferentes do Floodlight), a ação recomendada é renomear uma das atividades.

    Se você souber o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, especifique-o em segmentationId em vez de especificar o nome no campo segmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas ele é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversões. Para conferir o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API de relatórios. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 vai aparecer nele.

  • type: o tipo de conversão, ou seja, ACTION ou TRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO tem. Por exemplo, inscrições em listas de e-mail (ACTION) e compras de e-commerce (TRANSACTION).

    Se você especificar TRANSACTION, também precisará especificar o seguinte campo:

    • revenueMicros: o valor monetário da conversão.

Campos opcionais

  • quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões de ACTION, o Search Ads 360 vai inserir automaticamente um valor de 1000.
  • currencyCode: a moeda da receita de uma transação. Por padrão, a receita é considerada na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 vai converter o valor da receita especificado para a moeda do anunciante. Saiba mais
    Use o formato alfabético (três caracteres) do ISO 4217 para especificar a moeda.
    Aplicável somente a conversões de TRANSAÇÃO.
  • customMetric e customDimension: fazem upload de dados adicionais sobre uma conversão, como o país para onde um item comprado é enviado, IDs de produtos ou até mesmo a duração de uma ligação telefônica. Saiba mais sobre como fazer upload de dados para variáveis personalizadas do Floodlight.
  • deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "criterionId": "43700003491981017", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'criterionId': '43700004289911004', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Fazer upload de dados de um modelo de atribuição de terceiros

Um modelo de atribuição distribui o crédito de uma conversão entre todas as atividades de um caminho de conversão. Por exemplo, se um cliente clica em um anúncio de pesquisa paga, de display e outro de pesquisa paga antes da conversão, o modelo de atribuição linear concede 33% do crédito da conversão a cada clique.

Embora o Search Ads 360 forneça modelos de atribuição, caso você use um serviço de terceiros ou de desenvolvimento próprio para distribuir crédito por cliques, é possível fazer o upload dos dados de atribuição de terceiros no Search Ads 360 e usá-los em relatórios e estratégias de lances do Search Ads 360.

Antes de começar

No Campaign Manager, crie um modelo de atribuição personalizado e importe-o para o Search Ads 360. Dê a ele o nome Modelo de atribuição externa. Isso permite que os recursos do Search Ads 360 reconheçam que um modelo de atribuição foi aplicado aos dados de conversão enviados por upload. Saiba mais

Campos obrigatórios

Para aplicar um modelo de atribuição de terceiros a uma conversão, especifique todos os itens a seguir na solicitação Conversion.insert():

  • clickId: o ID de clique da visita, que diferencia maiúsculas de minúsculas. Procure nos registros da Web do anunciante o ID de clique ou listar conversões e use um ID de clique de outra conversão. O Search Ads 360 atribui a conversão à palavra-chave, ao anúncio e a outros objetos do Search Ads 360 que geraram a visita.
    Aguarde pelo menos 30 minutos depois que o Search Ads 360 gerar um ID de clique antes de fazer upload de uma conversão com o ID. Caso contrário, a API Search Ads 360 talvez não reconheça a visita.
  • attributionModel: defina como Modelo de atribuição externa. Saiba mais
  • countMillis: a quantidade de crédito de conversão a ser distribuída para esse clique. Aplicável apenas se a solicitação também incluir o campo attributionModel.

    Não confunda isso com quantityMillis, um campo opcional que especifica o número de itens em uma conversão, como o número de itens em uma compra de carrinho de compras.

  • conversionId: em conversões off-line, esse ID é fornecido pelos anunciantes. Os anunciantes podem especificar qualquer ID que seja relevante para eles. Cada conversão em uma solicitação precisa especificar um ID exclusivo, e a combinação de ID e carimbo de data/hora precisa ser exclusiva entre todas as conversões do anunciante. Em conversões on-line, o Search Ads 360 copia o dsConversionId ou floodlightOrderId para essa propriedade, dependendo das instruções do Floodlight fornecidas pelo anunciante.
  • conversionTimestamp: indica a data e a hora em que a conversão ocorreu. Por exemplo, se a conversão ocorrer em 05 de agosto de 2016, às 11h53min22s, no horário de verão do leste dos EUA (GMT -4:00), especifique o carimbo de data/hora em milissegundos de época: 1470412402000.
  • segmentationType: especifica o tipo de sistema de conversão para o qual você está fazendo o upload da conversão. No momento, apenas as conversões do Floodlight são compatíveis. Portanto, esse campo é sempre obrigatório para especificar FLOODLIGHT.
  • segmentationName: o nome da atividade do Floodlight que o anunciante está usando para informar a conversão.

    Se o anunciante tiver atividades com o mesmo nome (isso pode acontecer se elas pertencerem a grupos diferentes do Floodlight), a ação recomendada é renomear uma das atividades.

    Se você souber o ID que o Search Ads 360 atribuiu a uma atividade do Floodlight, especifique-o em segmentationId em vez de especificar o nome no campo segmentationName. O Campaign Manager também atribui um ID à atividade do Floodlight, mas ele é diferente do ID do Search Ads 360 e não pode ser usado para atribuir conversões. Para conferir o ID do Search Ads 360 de uma atividade do Floodlight, faça o download de um relatório de conversões na interface do Search Ads 360 ou na API de relatórios. Se pelo menos uma conversão tiver sido atribuída à atividade do Floodlight durante o período do relatório, o ID do Search Ads 360 vai aparecer nele.

  • type: o tipo de conversão, ou seja, ACTION ou TRANSACTION. Uma conversão de AÇÃO não tem valor monetário, enquanto uma conversão de TRANSAÇÃO tem. Por exemplo, inscrições em listas de e-mail (ACTION) e compras de e-commerce (TRANSACTION).

    Se você especificar TRANSACTION, também precisará especificar o seguinte campo:

    • revenueMicros: o valor monetário da conversão.

Se você rastrear a receita de conversão, verifique se o modelo distribui receita em cada ponto de contato no caminho de conversão. Por exemplo, se o modelo usar uma abordagem linear (distribuindo a receita uniformemente aos pontos de contato) em um caminho de conversão que inclui três cliques no anúncio, cada clique terá 33% da conversão atribuída a ele. Se a conversão gerou US $100 de receita, verifique se o modelo distribui US $33 para cada clique e se revenueMicros especifica apenas US $33 de receita por clique.

Campos opcionais

  • quantityMillis: o número de itens nesta conversão. Por exemplo, o número de pessoas que se inscreveram em uma newsletter por e-mail ou a quantidade total de itens vendidos. Se você não especificar esse campo para conversões de ACTION, o Search Ads 360 vai inserir automaticamente um valor de 1000.
  • currencyCode: a moeda da receita de uma transação. Por padrão, a receita é considerada na moeda do anunciante. Se você especificar uma moeda diferente, o Search Ads 360 vai converter o valor da receita especificado para a moeda do anunciante. Saiba mais
    Use o formato alfabético (três caracteres) do ISO 4217 para especificar a moeda.
    Aplicável somente a conversões de TRANSAÇÃO.
  • customMetric e customDimension: fazem upload de dados adicionais sobre uma conversão, como o país para onde um item comprado é enviado, IDs de produtos ou até mesmo a duração de uma ligação telefônica. Saiba mais sobre como fazer upload de dados para variáveis personalizadas do Floodlight.
  • deviceType: especifica o tipo de dispositivo em que a conversão ocorreu. Consulte a lista de valores aceitos para esse campo.

Exemplo

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}

Processar respostas do Search Ads 360

A resposta do Search Ads 360 indica sucesso somente se todas as conversões na solicitação forem validadas e enviadas corretamente.

Se a solicitação for bem-sucedida

Se a solicitação for bem-sucedida, a resposta vai incluir a representação interna completa do Search Ads 360 para cada conversão enviada, como ID da campanha, ID do grupo de anúncios e ID da palavra-chave (critério).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

Se a solicitação não for concluída

Se uma ou mais conversões não forem validadas ou enviadas, a resposta vai incluir mensagens para cada upload de conversão com falha. A resposta não contém mensagens sobre conversões que foram enviadas com sucesso.

Confira um exemplo de resposta a uma solicitação que não foi totalmente concluída:

{
 "error": {
    "errors": [
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
       },
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details:  [0x00000101: Click ID ..."
       }
    ]
  }
}

Cada mensagem de falha contém dois campos importantes: um motivo e uma mensagem de erro detalhada. O campo "reason" pode conter requestValidation, internalError, transactionFailed ou lateStageRequestError.

requestValidation errors

Os erros de requestValidation indicam problemas de dados na solicitação de upload de conversão (por exemplo, a conversão já foi enviada ou o clickId não foi encontrado). Nesse tipo de erro, os detalhes da mensagem contêm dois itens:

  • Um código hexadecimal que identifica o tipo de erro. Você pode usar o código nos seus próprios scripts para identificar os erros.
  • Uma descrição do erro de validação.

Para mais informações, consulte a lista de códigos e descrições que o Search Ads 360 pode retornar para erros de upload de conversão.

Outros tipos de erros

Todos os outros tipos de erros (internalError, transactionFailed ou lateStageRequestError) indicam que há um problema interno no Search Ads 360.

Responder a um erro

Se a solicitação falhar, tente reenviar toda a chamada mais tarde. O Search Ads 360 vai informar erros de requestValidation para conversões que já foram enviadas, mas tentará fazer o upload das conversões restantes.

Se os erros persistirem após o reenvio, consulte a seção de solução de problemas para saber como proceder.