Enumerar conversiones

Llamar al Conversion.get() para mostrar una lista de objetos de conversión que se procesaron en Search Ads 360. Tú puede solicitar todas las conversiones en la cuenta de motor de un anunciante o limitar el alcance a una una campaña, un grupo de anuncios, un anuncio o una palabra clave específica.

Los IDs de Search Ads 360 que especifiques en la solicitud determinan el alcance la respuesta. Por ejemplo:

  • Para ver todas las conversiones en una cuenta de motor, especifica estos IDs:
    • agencyId
    • advertiserId
    • engineAccountId
  • Para ver las conversiones en una campaña específica, especifica estos IDs:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
  • Para ver las conversiones que se atribuyen a un anuncio y una palabra clave específicos, especifica estos IDs:
    • agencyId
    • advertiserId
    • engineAccountId
    • campaignId
    • adGroupId (si la palabra clave existe a nivel del grupo de anuncios)
    • adId
    • criterionId

Para obtener información sobre cómo obtener los IDs de Search Ads 360 de tu anunciante, consulta IDs de Search Ads 360. y conversiones.

Después de enviar la solicitud, Search Ads 360 la valida y genera la lista de y muestra la lista como un recurso ConversionList en el cuerpo de respuesta.

Ejemplo de solicitud Get

En el siguiente ejemplo, se solicita la lista de conversiones que se produjeron a partir de noviembre del 15 al 31 de diciembre de 2012 en una campaña específica.

JSON

Cuando construyas una URL para recuperar una lista de conversiones, debes dar formato a las tres primeras de la empresa (agencyId, advertiserId yengineId) como parte de la ruta a la recurso de conversión. Especifica los 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())

Ejemplo de respuesta GET

Si la validación de la solicitud se realiza correctamente, Search Ads 360 muestra un recurso ConversionList en la cuerpo de respuesta. 

{
 "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"
  },
  ...
 ]
}

Si la validación falla

Si el informe no aprueba la validación, Search Ads 360 mostrará el mensaje "No se encuentra" . Por ejemplo, si la solicitud de ejemplo anterior no especifica un valor real agencia: 

Not Found