Llama a Conversion.get()
para mostrar una lista de objetos de conversión que se procesaron en Search Ads 360. Puede solicitar todas las conversiones en la cuenta de motor de un anunciante o limitar el alcance a una campaña, un grupo de anuncios, un anuncio o una palabra clave específicos.
Los ID de Search Ads 360 que especificas en la solicitud determinan el alcance de la respuesta. Por ejemplo:
- Para ver todas las conversiones en una cuenta de motor, especifique estos ID:
agencyId
advertiserId
engineAccountId
- Para ver las conversiones de una campaña específica, especifique estos ID:
agencyId
advertiserId
engineAccountId
campaignId
- Para ver las conversiones que se atribuyen a un anuncio y una palabra clave específicos, especifique estos ID:
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 ID de Search Ads 360 de tu anunciante, consulta ID y conversiones de Search Ads 360.
Después de enviar la solicitud, Search Ads 360 valida la solicitud, genera la lista de objetos y la muestra como un recurso ConversionList
en el cuerpo de la respuesta.
Ejemplo de solicitud Get
En el siguiente ejemplo, se solicita la lista de conversiones que se produjeron del 15 de noviembre al 31 de diciembre de 2012 en una campaña específica.
JSON
Cuando creas una URL para recuperar una lista de conversiones, dale formato a los primeros tres parámetros (agencyId, advertiserId y motorId) como parte de la ruta al recurso de conversión. Especifique 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 mostrará un recurso ConversionList
en el cuerpo de la 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 pasa la validación, Search Ads 360 mostrará el error "No encontrado". Por ejemplo, si en la solicitud de ejemplo anterior no se especificó una agencia real:
Not Found