Gọi cho 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 xuống
chiến dịch, nhóm quảng cáo, quảng cáo hoặc từ khoá cụ thể.
Các mã nhận dạng 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 một tài khoản công cụ, hãy chỉ định các mã sau:
agencyId
advertiserId
engineAccountId
- Để xem lượt chuyển đổi trong một chiến dịch cụ thể, hãy chỉ định các mã sau:
agencyId
advertiserId
engineAccountId
campaignId
- Để xem các lượt chuyển đổi được phân bổ cho một quảng cáo và từ khoá cụ thể, hãy chỉ định
các mã nhận dạng sau:
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(nếu từ khoá tồn tại ở cấp nhóm quảng cáo)adId
criterionId
Để biết thông tin về cách lấy mã nhận dạng Search Ads 360 cho nhà quảng cáo của bạn, hãy xem 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
đố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ề yêu cầu Get
Ví dụ sau đây yêu cầu danh sách lượt chuyển đổi đã diễn ra từ tháng 11 từ ngày 15 đế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 URL để truy xuất danh sách lượt chuyển đổi, hãy định dạng 3 lượt chuyển đổi đầu tiên các tham số –agencyId, advertiserId và EngineId – như một phần của đường dẫn đến nguồn chuyển đổi. Hãy chỉ định các tham số còn lại làm 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 xác thực thành công, Search Ads 360 sẽ trả về một tài nguyên ConversionList
trong
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 không xác thực được
Nếu báo cáo không vượt qua quy trình xác thực, Search Ads 360 sẽ trả về thông báo "Không tìm thấy" . Ví dụ: nếu yêu cầu ví dụ ở trên không chỉ định một thực đại lý:
Not Found