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