Appelez Conversion.get() pour renvoyer la liste des objets de conversion traités dans Search Ads 360. Vous pouvez demander toutes les conversions du compte de moteur d'un annonceur ou limiter la portée à une campagne, un groupe d'annonces, une annonce ou un mot clé spécifique.
Les ID Search Ads 360 que vous spécifiez dans la requête déterminent le champ d'application de la réponse. Exemple :
- Pour afficher toutes les conversions d'un compte de moteur, spécifiez les ID suivants :
agencyIdadvertiserIdengineAccountId
- Pour afficher les conversions dans une campagne spécifique, spécifiez les ID suivants :
agencyIdadvertiserIdengineAccountIdcampaignId
- Pour voir les conversions attribuées à une annonce et à un mot clé spécifiques, spécifiez les ID suivants :
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(si le mot clé existe au niveau du groupe d'annonces)adIdcriterionId
Pour savoir comment obtenir des ID Search Ads 360 pour votre annonceur, consultez ID Search Ads 360 et Conversions.
Une fois la requête envoyée, Search Ads 360 la valide, génère la liste des objets, puis la renvoie sous forme de ressource ConversionList dans le corps de la réponse.
Exemple de requête Get
L'exemple suivant demande la liste des conversions qui se sont produites du 15 novembre au 31 décembre 2012 dans une campagne spécifique.
JSON
Lorsque vous créez une URL pour récupérer une liste de conversions, mettez en forme les trois premiers paramètres (agencyId, advertiserId et engineId) dans le chemin d'accès à la ressource de conversion. Spécifiez les autres paramètres en tant que paramètres de requête d'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())
Exemple de réponse Get
Si la validation de la requête aboutit, Search Ads 360 renvoie une ressource ConversionList dans le corps de la réponse.
{
"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 validation échoue
Si la validation du rapport échoue, Search Ads 360 affiche une erreur "Introuvable". Par exemple, si l'exemple de requête ci-dessus ne spécifie pas d'agence réelle:
Not Found