Chame Conversion.get()
para retornar uma lista de objetos de conversão que foram processados no Search Ads 360. É possível solicitar todas as conversões na conta de mecanismo de um anunciante ou restringir o escopo para uma campanha, um grupo de anúncios, um anúncio ou uma palavra-chave específicos.
Os IDs do Search Ads 360 especificados na solicitação determinam o escopo da resposta. Exemplo:
- Para ver todas as conversões em uma conta de mecanismo, especifique estes IDs:
agencyIdadvertiserIdengineAccountId
- Para ver as conversões de uma campanha específica, especifique estes IDs:
agencyIdadvertiserIdengineAccountIdcampaignId
- Para ver as conversões atribuídas a um anúncio e uma palavra-chave específicos, especifique
estes IDs:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(se a palavra-chave existir no nível do grupo de anúncios)adIdcriterionId
Para mais informações sobre como conseguir os IDs do Search Ads 360 do seu anunciante, consulte IDs e conversões do Search Ads 360.
Depois de enviar a solicitação, o Search Ads 360 valida a solicitação, gera a lista de objetos e a retorna como um recurso ConversionList no corpo da resposta.
Exemplo de solicitação Get
O exemplo a seguir solicita a lista de conversões que ocorreram de 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 os três primeiros parâmetros (agencyId,advertiserId e mecanismoId) como parte do caminho para o recurso de conversão. Especifique os parâmetros restantes como parâmetros de consulta do 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 Receber resposta
Se a validação da solicitação for bem-sucedida, o Search Ads 360 retornará um recurso ConversionList no 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á o erro "Não encontrado". Por exemplo, se o exemplo acima não especificar uma agência real:
Not Found