Gọi Conversion.get() để trả về danh sách các đối tượng chuyển đổi đã được xử lý trong Search Ads 360. Bạn
có thể yêu cầu tất cả lượt chuyển đổi trong tài khoản công cụ của nhà quảng cáo hoặc thu hẹp phạm vi của
một chiến dịch, nhóm quảng cáo, quảng cáo hoặc từ khoá cụ thể.
Các mã Search Ads 360 mà bạn chỉ định trong yêu cầu sẽ xác định phạm vi của nội dung phản hồi. Ví dụ:
- Để xem tất cả lượt chuyển đổi trong tài khoản công cụ, hãy chỉ định những mã sau:
agencyIdadvertiserIdengineAccountId
- Để xem số lượt chuyển đổi của một chiến dịch cụ thể, hãy chỉ định những mã sau:
agencyIdadvertiserIdengineAccountIdcampaignId
- Để xem các lượt chuyển đổi được phân bổ cho một quảng cáo và từ khóa cụ thể, hãy chỉ định
các mã sau:
agencyIdadvertiserIdengineAccountIdcampaignIdadGroupId(nếu từ khóa tồn tại ở cấp nhóm quảng cáo)adIdcriterionId
Để biết thông tin về cách lấy mã Search Ads 360 cho nhà quảng cáo, hãy xem bài viết Mã nhận dạng Search Ads 360 và Lượt chuyển đổi.
Sau khi bạn gửi yêu cầu, Search Ads 360 sẽ xác thực yêu cầu đó, tạo danh sách các đối tượng và trả về danh sách dưới dạng tài nguyên ConversionList trong nội dung phản hồi.
Ví dụ về nhận yêu cầu
Ví dụ sau đây yêu cầu danh sách các lượt chuyển đổi đã xảy ra từ ngày 15 tháng 11 đến ngày 31 tháng 12 năm 2012 trong một chiến dịch cụ thể.
JSON
Khi bạn tạo một URL để truy xuất danh sách lượt chuyển đổi, hãy định dạng 3 thông số đầu tiên – agentId,advertiserId và engineId – như một phần trong đường dẫn đến tài nguyên chuyển đổi. Bạn có thể chỉ định các tham số còn lại dưới dạng tham số truy vấn 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())
Ví dụ về Nhận phản hồi
Nếu yêu cầu được xác thực thành công, Search Ads 360 sẽ trả về một tài nguyên ConversionList trong phần nội dung phản hồi.
{
"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"
},
...
]
}
Nếu xác thực không thành công
Nếu báo cáo không vượt qua quy trình xác thực, Search Ads 360 sẽ trả về lỗi "Không tìm thấy". Ví dụ: nếu yêu cầu mẫu nêu trên không chỉ định một đại lý thực tế:
Not Found