Rufen Sie Conversion.get() auf, um eine Liste der Conversion-Objekte zurückzugeben, die in Search Ads 360 verarbeitet wurden. Sie können alle Conversions im Suchmaschinenkonto eines Werbetreibenden anfordern oder den Umfang auf eine bestimmte Kampagne, Anzeigengruppe, Anzeige oder ein bestimmtes Keyword einschränken.
Die Search Ads 360-IDs, die Sie in der Anfrage angeben, bestimmen den Umfang der Antwort. Beispiel:
- Wenn Sie alle Conversions in einem Engine-Konto sehen möchten, geben Sie diese IDs an:
agencyIdadvertiserIdengineAccountId
- Wenn Sie die Conversions in einer bestimmten Kampagne sehen möchten, geben Sie diese IDs an:
agencyIdadvertiserIdengineAccountIdcampaignId
- Wenn Sie die Conversions sehen möchten, die einer bestimmten Anzeige und einem bestimmten Keyword zugeordnet sind, geben Sie diese IDs an:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(wenn das Keyword auf der Anzeigengruppenebene vorhanden ist)adIdcriterionId
Informationen zum Abrufen von Search Ads 360-IDs für Werbetreibende finden Sie unter Search Ads 360-IDs und -Conversions.
Nachdem Sie die Anfrage gesendet haben, validiert Search Ads 360 die Anfrage, generiert die Liste der Objekte und gibt die Liste als ConversionList-Ressource im Antworttext zurück.
Beispiel einer Get-Anfrage
Im folgenden Beispiel wird die Liste der Conversions angefordert, die zwischen dem 15. November und dem 31. Dezember 2012 in einer bestimmten Kampagne aufgetreten sind.
JSON
Wenn Sie eine URL zum Abrufen einer Liste mit Conversions erstellen, formatieren Sie die ersten drei Parameter – Agentur-ID, Werbetreibenden-ID und Suchmaschinen-ID – als Teil des Pfads zur Conversion-Ressource. Geben Sie die verbleibenden Parameter als URL-Suchparameter an.
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())
Beispiel für eine Antwort vom Typ „Get“
Wenn die Anfragevalidierung erfolgreich ist, gibt Search Ads 360 eine ConversionList-Ressource im Antworttext zurück.
{
"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"
},
...
]
}
Wenn die Überprüfung fehlschlägt
Wenn der Bericht die Validierung nicht besteht, gibt Search Ads 360 den Fehler „Nicht gefunden“ zurück. Wenn in der Beispielanfrage oben keine echte Agentur angegeben wurde:
Not Found