Listar conversões

Ligar para Conversion.get() para retornar uma lista de objetos de conversão que foram processados no Search Ads 360. Você pode solicitar todas as conversões na conta de mecanismo de um anunciante ou restringir o escopo a uma campanha, grupo de anúncios, anúncio ou palavra-chave específica.

Os IDs do Search Ads 360 especificados na solicitação determinam o escopo do a resposta. Exemplo:

  • Para acessar todas as conversões em uma conta de mecanismo, especifique estes IDs:
    • agencyId
    • advertiserId
    • engineAccountId
  • Para acessar as conversões em uma campanha específica, especifique estes IDs:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Para acessar as conversões atribuídas a um anúncio e uma palavra-chave específicos, especifique esses IDs:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (se a palavra-chave existir no nível do grupo de anúncios)
    • adId
    • criterionId

Para informações sobre como obter IDs do Search Ads 360 para seu anunciante, consulte IDs do Search Ads 360 e conversões.

Depois que você envia a solicitação, o Search Ads 360 a valida, gera a lista de objetos e retorna a lista como um recurso ConversionList na corpo da resposta.

Exemplo de solicitação GET

O exemplo a seguir solicita a lista de conversões ocorridas em novembro 15 a 31 de dezembro de 2012 em uma campanha específica.

JSON

Ao criar um URL para recuperar uma lista de conversões, formate as três primeiras parâmetros—agencyId, advertiserId e engineId—como parte do caminho até o recurso de conversão. Especifique os parâmetros restantes como parâmetros de consulta de URL.

GET https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456/advertiser/45600000000010291/engine/700000000042441/conversion?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10
          

Java

  /**
   * Instantiate the Doubleclicksearch service, request a list of conversions in a specific campaign,
   * and print the list to standard out.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.
    ConversionList conversionList = listConversions(service);
    outputList(conversionList);
  }


  /**
   * Request a list of the first 10 conversions in a specific campaign.
   */
  private static ConversionList listConversions(Doubleclicksearch service) throws IOException {
    try {
      Get getRequest = service.conversion().get(
          new Long(12300000000000456L), // Replace with your agency ID
          new Long(45600000000010291L), // Replace with your advertiser ID
          new Long(700000000042441L), // Replace with your engine account ID
          new Integer(20121231), // End date
          new Integer(10), // Number of rows
          new Integer(20121115), // Start date
          new Long(0L)); // Starting row
      getRequest.setCampaignId(71700000002044839L); // Optional parameter

      return getRequest.execute();
    } 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());
      return null; // Unreachable code.
    }
  }

 /**
  * Print to standard out.
  */
  privte static void outputList(ConversionList conversionList) {
    for (Conversion conversion : conversionList.getConversion()) {
      if (null != conversion) {
        System.out.println(conversion.toString());
      }
    }
  }
          

Python

def get_conversion(service):
  """Request the first 10 conversions in a specific campaign
     and print the list.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().get(
      agencyId='12300000000000456', // Replace with your ID
      advertiserId='45600000000010291', // Replace with your ID
      engineAccountId='700000000042441', // Replace with your ID
      campaignId='71700000002044839', // Replace with your ID
      startDate=20131115,
      endDate=20131231,
      startRow=0,
      rowCount=10
  )

  pprint.pprint(request.execute())

Exemplo Obter resposta

Se a validação da solicitação for bem-sucedida, o Search Ads 360 retornará um recurso ConversionList na corpo da resposta.

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700003491981017",
   "adId": "0",
   "dsConversionId": "48752623802180029",
   "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
   "currencyCode": "USD",
   "quantityMillis": "0",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001081555",
   "segmentationName": "Customer Call",
   "conversionTimestamp": "1355776573000",
   "conversionModifiedTimestamp": "1355776580813"
  },
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700003491981017",
   "adId": "44700000155906860",
   "dsConversionId": "48752623802180029",
   "conversionId": "ag5zfmV2ZW50YXBpZGVtb3ITCxILVHJhbnNhY3Rpb24YgfQDDA",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "quantityMillis": "0",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001081555",
   "segmentationName": "Customer Call",
   "conversionTimestamp": "1355776573000",
   "conversionModifiedTimestamp": "1355776580813"
  },
  ...
 ]
}

Se a validação falhar

Se o relatório não for aprovado na validação, o Search Ads 360 retornará um erro "Não encontrado". erro. Por exemplo, se o exemplo de solicitação acima não especificasse um endereço agência:

Not Found