Conversion.get()
를 호출하여 Search Ads 360에서 처리된 전환 객체 목록을 반환합니다. 광고주의 엔진 계정에서 모든 전환을 요청하거나 범위를 특정 캠페인, 광고그룹, 광고 또는 키워드로 좁힐 수 있습니다.
요청에 지정한 Search Ads 360 ID에 따라 응답 범위가 결정됩니다. 예를 들면 다음과 같습니다.
- 엔진 계정의 모든 전환을 보려면 다음 ID를 지정하세요.
agencyId
advertiserId
engineAccountId
- 특정 캠페인의 전환을 보려면 다음 ID를 지정하세요.
agencyId
advertiserId
engineAccountId
campaignId
- 특정 광고 및 키워드에 기여한 전환을 보려면
다음 ID를 지정하세요.
agencyId
advertiserId
engineAccountId
campaignId
adGroupId
(키워드가 광고그룹 수준에 있는 경우)adId
criterionId
광고주의 Search Ads 360 ID를 가져오는 방법은 Search Ads 360 ID 및 전환을 참고하세요.
요청을 보내면 Search Ads 360에서 요청을 검증하고 객체 목록을 생성한 후 응답 본문에서 목록을 ConversionList
리소스로 반환합니다.
Get 요청 예시
다음 예에서는 특정 캠페인에서 2012년 11월 15일부터 12월 31일까지 발생한 전환 목록을 요청합니다.
JSON
전환 목록을 가져올 URL을 작성할 때 처음 세 매개변수(agencyId, 광고주 ID, 엔진 ID)의 형식을 전환 리소스 경로의 일부로 지정합니다. 나머지 매개변수를 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
자바
/** * 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())
Get 응답 예
요청 유효성 검사에 성공하면 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