Вызовите Conversion.get() чтобы вернуть список объектов конверсий, которые были обработаны в Search Ads 360. Вы можете запросить все конверсии в системном аккаунте рекламодателя или сузить область до конкретной кампании, группы объявлений, объявления или ключевого слова.
Идентификаторы Search Ads 360, которые вы указываете в запросе, определяют объем ответа. Например:
- Чтобы просмотреть все конверсии в системном аккаунте, укажите следующие идентификаторы:
-
agencyId -
advertiserId -
engineAccountId
-
- Чтобы увидеть конверсии в конкретной кампании, укажите следующие идентификаторы:
-
agencyId -
advertiserId -
engineAccountId -
campaignId
-
- Чтобы просмотреть конверсии, связанные с конкретным объявлением и ключевым словом, укажите следующие идентификаторы:
-
agencyId -
advertiserId -
engineAccountId -
campaignId -
adGroupId(если ключевое слово существует на уровне группы объявлений) -
adId -
criterionId
-
Информацию о получении идентификаторов Search Ads 360 для вашего рекламодателя см. в разделе «Идентификаторы и конверсии Search Ads 360» .
После отправки запроса Поисковая реклама 360 проверяет запрос, генерирует список объектов и возвращает этот список в виде ресурса ConversionList в теле ответа.
Пример запроса на получение
В следующем примере запрашивается список конверсий, произошедших с 15 ноября по 31 декабря 2012 года в конкретной кампании.
JSON
При создании URL-адреса для получения списка конверсий отформатируйте первые три параметра — AgencyId, AdvertiserId и EngineId — как часть пути к ресурсу конверсии. Остальные параметры укажите в качестве параметров 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
Чтобы отправить этот запрос, используйте служебный скрипт Search Ads 360.
Чтобы отправить необработанный запрос JSON GET, вы можете использовать сценарий sa360Api.py следующим образом:
sa360Api.py --cred CREDENTIALS --get --server " server URL with parameters "
В приведенной выше команде замените строку CREDENTIALS на строку, которую вы собрали на предыдущем шаге.
Например:
sa360Api.py --cred 123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
--get --server "https://www.googleapis.com/doubleclicksearch/v2/agency/12300000000000456
/advertiser/45600000000010291/engine/700000000042441/conversion
?campaign=71700000001899732&startDate=20121115&endDate=20121231&startRow=0&rowCount=10"
Ява
/**
* 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());
}
}
}
Питон
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())
Пример Получить ответ
Если проверка запроса прошла успешно, Search Ads 360 возвращает ресурс ConversionList в теле ответа.
{
"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"
},
...
]
}Если проверка не удалась
Если отчет не проходит проверку, Search Ads 360 возвращает ошибку «Не найден». Например, если в приведенном выше примере запроса не указано реальное агентство:
Not Found