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:
agencyIdadvertiserIdengineAccountId
- Para ver las conversiones de una campaña específica, especifique estos ID:
agencyIdadvertiserIdengineAccountIdcampaignId
- Para ver las conversiones que se atribuyen a un anuncio y una palabra clave específicos, especifique estos ID:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(si la palabra clave existe a nivel del grupo de anuncios)adIdcriterionId
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