Chiama Conversion.get()
per restituire un elenco di oggetti di conversione che sono stati elaborati in Search Ads 360. Puoi richiedere tutte le conversioni nell'account motore di un inserzionista o restringere l'ambito a una campagna, un gruppo di annunci, un annuncio o una parola chiave specifici.
Gli ID Search Ads 360 specificati nella richiesta determinano l'ambito della risposta. Ad esempio:
- Per visualizzare tutte le conversioni in un account motore, specifica questi ID:
agencyIdadvertiserIdengineAccountId
- Per visualizzare le conversioni di una campagna specifica, specifica questi ID:
agencyIdadvertiserIdengineAccountIdcampaignId
- Per visualizzare le conversioni attribuite a un annuncio e a una parola chiave specifici, specifica questi ID:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(se la parola chiave esiste a livello di gruppo di annunci)adIdcriterionId
Per informazioni su come ottenere gli ID di Search Ads 360 per il tuo inserzionista, consulta la sezione ID e conversioni di Search Ads 360.
Dopo aver inviato la richiesta, Search Ads 360 la convalida, genera un elenco di oggetti e la restituisce come risorsa ConversionList nel corpo della risposta.
Esempio di richiesta Get
L'esempio seguente richiede l'elenco delle conversioni che si sono verificate dal 15 novembre al 31 dicembre 2012 in una campagna specifica.
JSON
Quando crei un URL per il recupero di un elenco di conversioni, formatta i primi tre parametri (agencyId, inserzionistaId e EngineId) come parte del percorso della risorsa di conversione. Specifica i parametri rimanenti come parametri di ricerca degli 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())
Esempio Ricevi risposta
Se la convalida della richiesta ha esito positivo, Search Ads 360 restituisce una risorsa ConversionList nel corpo della risposta.
{
"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 la convalida non va a buon fine
Se il report non supera la convalida, Search Ads 360 restituisce un errore "Non trovato". Ad esempio, se la richiesta di esempio precedente non specifica un'agenzia reale:
Not Found