Wywołaj Conversion.get(), aby wyświetlić listę obiektów konwersji przetworzonych w Search Ads 360. Możesz żądać wszystkich konwersji na koncie wyszukiwarki reklamodawcy lub zawęzić zakres do konkretnej kampanii, grupy reklam, reklamy lub słowa kluczowego.
Identyfikatory Search Ads 360 określone w żądaniu określają zakres odpowiedzi. Na przykład:
- Aby wyświetlić wszystkie konwersje na koncie wyszukiwarki, określ te identyfikatory:
agencyIdadvertiserIdengineAccountId
- Aby wyświetlić konwersje w konkretnej kampanii, określ te identyfikatory:
agencyIdadvertiserIdengineAccountIdcampaignId
- Aby zobaczyć konwersje przypisane do konkretnej reklamy i słowa kluczowego, podaj te identyfikatory:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(jeśli słowo kluczowe istnieje na poziomie grupy reklam)adIdcriterionId
Informacje o uzyskiwaniu identyfikatorów Search Ads 360 dla reklamodawcy znajdziesz w artykule Identyfikatory i konwersje w Search Ads 360.
Po wysłaniu żądania Search Ads 360 go weryfikuje, generuje listę obiektów i zwraca listę jako zasób ConversionList w treści odpowiedzi.
Przykładowe żądanie pobrania
W poniższym przykładzie użyto listy konwersji, które wystąpiły w konkretnej kampanii w okresie od 15 listopada do 31 grudnia 2012 r.
JSON
Podczas tworzenia adresu URL do pobierania listy konwersji sformatuj pierwsze 3 parametry – identyfikator agencji, reklamodawcy i identyfikator wyszukiwarki w ramach ścieżki do zasobu konwersji. Pozostałe parametry określ jako parametry zapytania z adresu 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())
Przykładowa odpowiedź na pytanie
Jeśli żądanie się powiedzie, Search Ads 360 zwróci zasób ConversionList w treści odpowiedzi.
{
"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"
},
...
]
}
Jeśli weryfikacja się nie powiedzie
Jeśli raport nie przejdzie weryfikacji, Search Ads 360 zwróci błąd „Nie znaleziono”. Jeśli na przykład w powyższym żądaniu nie podano prawdziwej agencji:
Not Found