Conversion.insert() 메서드를 호출하여 전환을 하나 이상 추가합니다. 전환 기여도를 적절하게 부여하려면 요청에 광고주가 오프라인 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름과 키워드, 광고, 전환으로 이어진 클릭의 ID를 지정해야 합니다. Search Ads 360 ID를 가져오는 방법에 관한 자세한 내용은 Search Ads 360 ID 및 전환을 참고하세요.
이전 전환 업로드에 대한 제한사항에 관한 정보는 Search Ads 360 고객센터에서 확인할 수 있습니다.
Conversion.insert() 요청에 여러 전환이 지정된 경우 Search Ads 360은 전체 일괄 처리를 '전부 또는 전혀' 거래로 업로드하는 대신 각 전환을 최선의 방식으로 업로드하려고 시도합니다. 일괄 처리의 일부 전환이 업로드되지 않더라도 다른 전환은 업로드될 수 있습니다. 잘못된 요청 또는 일시적인 네트워크 또는 시스템 오류로 인해 전환 업로드가 실패할 수 있습니다. 따라서 업로드가 완료되었는지 확인하려면 삽입된 모든 전환에 대해 응답을 읽으세요.
업로드된 데이터는 언제 사용할 수 있나요?
전환에 오늘이나 어제의
conversionTimestamp를 지정하는 경우, 업로드 후 한 시간 이내에 전환 측정항목이 Search Ads 360 UI에 표시됩니다. 이틀 이전의 conversionTimestamp를 지정하면 측정항목이 몇 시간 후에 업데이트됩니다.
모든 전환 타임스탬프를 에포크 시간 (Unix 시간이라고도 함)으로 변환합니다.
API에서 플러드라이트 활동을 만들 수 있나요?
광고주가 아직 오프라인 전환 추적을 위한 플러드라이트 활동을 만들지 않은 경우 Campaign Manager API를 사용하여 만들 수 있습니다. API를 사용하여 플러드라이트 활동이 주로 오프라인 전환에 사용된다고 지정할 수는 없습니다. 이는 입찰 전략에서 전환 데이터를 사용할 때 권장되는 방법입니다.
API를 사용하여 플러드라이트 활동을 만든 후 Search Ads 360 사용자가 Search Ads 360에 로그인하여 활동 설정을 변경하여 전환의 기본 소스가 오프라인 활동임을 나타내도록 하는 것이 좋습니다.
전환 추가 권장사항
전환을 추가할 때는 다음 권장사항을 따르는 것이 좋습니다.
Search Ads 360 사용자에게 Search Ads 360에 로그인하여 오프라인 전환을 보고하는 데 사용하는 각 플러드라이트 활동의 설정을 변경해 달라고 요청합니다. 설정은 전환의 주요 소스가 오프라인 활동임을 나타내야 합니다. 자세한 내용은 Search Ads 360 고객센터를 참고하세요.
전환이 제공되는 즉시 업로드합니다. 특정 방문에 전환 기여도를 부여하는 경우 방문 후 최소 6시간이 지난 후에 전환을 업로드하세요. 방문 후 6시간 이내에 업로드하면 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 드물지만 Search Ads 360에서 clickId를 인식하기까지 최대 24시간이 걸릴 수 있습니다.
각 업로드에 최신 전환이 포함되어 있는지 확인합니다. 단일 업로드 요청 내에서 항목이 시간순으로 정렬되지 않아도 됩니다. 하지만 입찰 전략에서는 나중에 다른 요청으로 업로드하는 이전 전환을 고려하지 못할 수 있습니다.
삽입 요청 보내기
Conversion.insert() 요청을 전송하여 다음 작업 중 하나를 실행할 수 있습니다.
- 특정 방문에 전환 기여도 부여
- 키워드에만 전환 기여도 부여
Conversion.insert() 요청에 필요한 필드는 전환 기여도를 부여하는 이벤트 또는 항목에 따라 다릅니다. 다음 섹션에는 전환 기여도를 부여할 수 있는 각 이벤트 또는 항목의 필수 및 선택 필드가 나와 있습니다.
특정 방문에 전환 기여도 부여
고객이 하나 이상의 광고를 클릭하고 광고주의 사이트에 도달하면 Search Ads 360에서는 광고주의 사이트에서 발생한 사용자 세션을 방문으로 간주합니다.
방문에 전환 기여도를 부여하려면 Conversion.insert() 요청에 다음을 지정합니다.
필수 입력란
clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 광고주의 웹 로그에서 클릭 ID를 찾거나 전환 목록을 확인하고 다른 전환의 클릭 ID를 사용합니다. Search Ads 360은 방문을 생성한 키워드, 광고, 기타 Search Ads 360 객체에 전환 기여도를 부여합니다.
Search Ads 360에서 클릭 ID를 생성한 후 6시간 이상 기다린 후 전환을 업로드합니다. '클릭 ID를 찾을 수 없음' 오류가 표시되면 24시간 후에 전환을 다시 업로드하세요. 모든 전환은 클릭 ID가 생성된 후 90일 이내에 업로드해야 합니다. 그렇지 않으면 Search Ads 360 API에서 방문을 인식하지 못할 수 있습니다.conversionId: 오프라인 전환의 경우 광고주가 이 ID를 제공합니다. 광고주는 의미 있는 ID를 지정할 수 있습니다. 요청의 각 전환은 고유한 ID를 지정해야 하며, ID와 타임스탬프의 조합은 광고주 내의 모든 전환에서 고유해야 합니다. 온라인 전환의 경우 Search Ads 360은 광고주의 플러드라이트 지침에 따라dsConversionId또는floodlightOrderId를 이 속성에 복사합니다.conversionTimestamp: 전환이 발생한 날짜와 시간을 나타냅니다. 예를 들어 변환이 2016년 8월 5일 금요일 오전 11시 53분 22초(동부 일광 절약 시간, GMT -4:00)에 발생하는 경우 타임스탬프를 에포크 밀리초(1470412402000)로 지정합니다.segmentationType: 전환을 업로드할 전환 시스템의 유형을 지정합니다. 현재 플러드라이트 전환만 지원되므로 이 필드는 항상FLOODLIGHT를 지정해야 합니다.segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.광고주에 동일한 이름의 활동이 포함된 경우 (활동이 서로 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.
또는 Search Ads 360에서 플러드라이트 활동에 할당한 ID를 알고 있다면
segmentationName필드에 이름을 지정하는 대신segmentationId에 ID를 지정할 수 있습니다. Campaign Manager에서도 플러드라이트 활동에 ID를 할당하지만, Campaign Manager ID는 Search Ads 360 ID와 다르며 전환 기여도를 부여하는 데 사용할 수 없습니다. 플러드라이트 활동의 Search Ads 360 ID를 보려면 전환 보고서 (Search Ads 360 UI 또는 보고 API)를 다운로드하세요. 보고서 기간 동안 플러드라이트 활동에 기여한 전환이 하나 이상 있는 경우 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형입니다(ACTION또는TRANSACTION). ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환에는 금전적 가치가 있습니다. 이메일 목록 가입 (액션)과 전자상거래 구매 (거래)를 예로 들 수 있습니다.TRANSACTION를 지정하는 경우 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금액입니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사용자 수 또는 판매된 상품의 총 수량입니다. ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000값을 삽입합니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 간주됩니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자) 형식을 사용하여 통화를 지정합니다.
거래 전환에만 적용됩니다.customMetric및customDimension: 구매한 상품이 배송되는 국가, 제품 ID, 전화 통화 시간 등 전환에 관한 추가 데이터를 업로드합니다. 맞춤 플러드라이트 변수의 데이터 업로드에 대해 자세히 알아보세요.deviceType: 전환이 발생한 기기의 유형을 지정합니다. 이 필드의 허용되는 값 목록을 참고하세요.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue "currencyCode": "USD" }] }
자바
/** * Instantiate the Doubleclicksearch service, create conversions, and upload them. */ public static void main(String[] args) throws Exception { Doubleclicksearch service = getService(); // See Set Up Your Application. // Set up a List to keep track of each conversion you create. List<Conversion> conversions = new Vector<Conversion>(); // Add a conversion to the List. addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L); // Upload the List and handle the response. uploadConversions(conversions, service); } /** * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes * the segmentation name and currency. You probably wouldn't want your production code to be so brittle. */ private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions, String clickId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion().setClickId(clickId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; } /** * Convert the List of conversions to a DS ConversionList, send an insert request to DS, * and output the response to a file. */ private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service) throws IOException { FileOutputStream outputStream = new FileOutputStream(new File("./", "InsertConversionsResponse.txt")); final PrintStream printStream = new PrintStream(outputStream); try { // Convert the List to a ConversionList. ConversionList conversionList = new ConversionList().setConversion(conversions); // Insert an upload request and download the response to a file. service.conversion().insert(conversionList).executeAndDownloadTo(printStream); printStream.close(); } 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()); } }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a visit. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site 'conversionId': 'test_20140206_00', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
키워드에만 전환 기여도 부여
키워드에 전환 기여도를 부여하는 것이 주된 관심사이고 광고에 기여도를 부여하는 것은 중요하지 않다면 대부분의 Search Ads 360 식별자를 생략하고 키워드의 식별자와 몇 가지 다른 필드만 지정하면 됩니다.
필수 입력란
criterionId: 키워드 식별자입니다. 방문 페이지 URL에TrackerId매크로를 추가하여criterionId를 가져올 수 있습니다. 키워드 ID를 가져오는 방법에 관한 자세한 내용은 Search Ads 360 ID 및 전환을 참고하세요.conversionId: 오프라인 전환의 경우 광고주가 이 ID를 제공합니다. 광고주는 의미 있는 ID를 지정할 수 있습니다. 요청의 각 전환은 고유한 ID를 지정해야 하며, ID와 타임스탬프의 조합은 광고주 내의 모든 전환에서 고유해야 합니다. 온라인 전환의 경우 Search Ads 360은 광고주의 플러드라이트 지침에 따라dsConversionId또는floodlightOrderId를 이 속성에 복사합니다.conversionTimestamp: 전환이 발생한 날짜와 시간을 나타냅니다. 예를 들어 변환이 2016년 8월 5일 금요일 오전 11시 53분 22초(동부 일광 절약 시간, GMT -4:00)에 발생하는 경우 타임스탬프를 에포크 밀리초(1470412402000)로 지정합니다.segmentationType: 전환을 업로드할 전환 시스템의 유형을 지정합니다. 현재 플러드라이트 전환만 지원되므로 이 필드는 항상FLOODLIGHT를 지정해야 합니다.segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.광고주에 동일한 이름의 활동이 포함된 경우 (활동이 서로 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.
또는 Search Ads 360에서 플러드라이트 활동에 할당한 ID를 알고 있다면
segmentationName필드에 이름을 지정하는 대신segmentationId에 ID를 지정할 수 있습니다. Campaign Manager에서도 플러드라이트 활동에 ID를 할당하지만, Campaign Manager ID는 Search Ads 360 ID와 다르며 전환 기여도를 부여하는 데 사용할 수 없습니다. 플러드라이트 활동의 Search Ads 360 ID를 보려면 전환 보고서 (Search Ads 360 UI 또는 보고 API)를 다운로드하세요. 보고서 기간 동안 플러드라이트 활동에 기여한 전환이 하나 이상 있는 경우 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형입니다(ACTION또는TRANSACTION). ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환에는 금전적 가치가 있습니다. 이메일 목록 가입 (액션)과 전자상거래 구매 (거래)를 예로 들 수 있습니다.TRANSACTION를 지정하는 경우 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금액입니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사용자 수 또는 판매된 상품의 총 수량입니다. ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000값을 삽입합니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 간주됩니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자) 형식을 사용하여 통화를 지정합니다.
거래 전환에만 적용됩니다.customMetric및customDimension: 구매한 상품이 배송되는 국가, 제품 ID, 전화 통화 시간 등 전환에 관한 추가 데이터를 업로드합니다. 맞춤 플러드라이트 변수의 데이터 업로드에 대해 자세히 알아보세요.deviceType: 전환이 발생한 기기의 유형을 지정합니다. 이 필드의 허용되는 값 목록을 참고하세요.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "criterionId": "43700003491981017", // Replace with your ID "conversionId": "customerTransaction73126", "conversionTimestamp": "1351196386000", "segmentationType": "FLOODLIGHT", "segmentationName": "Offline Purchase", "type": "TRANSACTION", "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue "currencyCode": "USD" }] }
자바
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service): """Create and upload a TRANSACTION conversion that is attributed to a keyword only. Args: service: An authorized Doubleclicksearch service. See Set Up Your Application. """ request = service.conversion().insert( body= { 'conversion': [{ 'criterionId': '43700004289911004', // Replace with your ID 'conversionId': 'test_1378710000000', 'conversionTimestamp': '1378710000000', 'segmentationType': 'FLOODLIGHT', 'segmentationName': 'Test', 'type': 'TRANSACTION', 'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue 'currencyCode': 'USD' }] } ) pprint.pprint(request.execute())
서드 파티 기여 분석 모델의 데이터 업로드
기여 분석 모델은 전환 경로의 모든 활동에 전환 기여도를 배분합니다. 예를 들어 소비자가 전환하기 전에 유료 검색 광고, 디스플레이 광고, 다른 유료 검색 광고를 클릭하는 경우 선형 기여 분석 모델은 각 클릭에 전환 기여도의 33% 를 부여합니다.
Search Ads 360은 기여 분석 모델을 제공하지만 서드 파티 서비스를 사용하거나 클릭에 기여도를 부여하기 위해 개발한 서비스를 사용하는 경우 서드 파티 기여 분석 데이터를 Search Ads 360에 업로드하고 보고서 및 Search Ads 360 입찰 전략에서 데이터를 사용할 수 있습니다.
시작하기 전에
Campaign Manager에서 맞춤 기여 분석 모델을 만들고 Search Ads 360으로 모델을 가져옵니다. 모델 이름을 외부 기여 분석 모델로 지정해야 합니다. 이렇게 하면 Search Ads 360 기능이 업로드한 전환 데이터에 기여 분석 모델이 적용되었음을 인식할 수 있습니다. 자세히 알아보기
필수 입력란
전환에 서드 파티 기여 분석 모델을 적용하려면 Conversion.insert() 요청에서 다음을 모두 지정합니다.
clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 광고주의 웹 로그에서 클릭 ID를 찾거나 전환 목록을 확인하고 다른 전환의 클릭 ID를 사용합니다. Search Ads 360은 방문을 생성한 키워드, 광고, 기타 Search Ads 360 객체에 전환 기여도를 부여합니다.
Search Ads 360에서 클릭 ID를 생성한 후 ID가 포함된 전환을 업로드하기 전에 30분 이상 기다립니다. 그렇지 않으면 Search Ads 360 API에서 방문을 인식하지 못할 수 있습니다.attributionModel: 외부 기여 분석 모델로 설정합니다. 자세히 알아보기countMillis: 이 클릭에 배분할 전환 기여도를 나타냅니다. 요청에attributionModel필드도 포함된 경우에만 적용됩니다.전환의 상품 수를 지정하는 선택적 필드인
quantityMillis(예: 장바구니 구매의 상품 수)와 혼동하지 마세요.conversionId: 오프라인 전환의 경우 광고주가 이 ID를 제공합니다. 광고주는 의미 있는 ID를 지정할 수 있습니다. 요청의 각 전환은 고유한 ID를 지정해야 하며 ID와 타임스탬프의 조합은 광고주 내의 모든 전환에서 고유해야 합니다. 온라인 전환의 경우 Search Ads 360은 광고주의 플러드라이트 지침에 따라dsConversionId또는floodlightOrderId를 이 속성에 복사합니다.conversionTimestamp: 전환이 발생한 날짜와 시간을 나타냅니다. 예를 들어 변환이 2016년 8월 5일 금요일 오전 11시 53분 22초(동부 일광 절약 시간, GMT -4:00)에 발생하는 경우 타임스탬프를 에포크 밀리초(1470412402000)로 지정합니다.segmentationType: 전환을 업로드할 전환 시스템의 유형을 지정합니다. 현재 플러드라이트 전환만 지원되므로 이 필드는 항상FLOODLIGHT를 지정해야 합니다.segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.광고주에 동일한 이름의 활동이 포함된 경우 (활동이 서로 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.
또는 Search Ads 360에서 플러드라이트 활동에 할당한 ID를 알고 있다면
segmentationName필드에 이름을 지정하는 대신segmentationId에 ID를 지정할 수 있습니다. Campaign Manager에서도 플러드라이트 활동에 ID를 할당하지만, Campaign Manager ID는 Search Ads 360 ID와 다르며 전환 기여도를 부여하는 데 사용할 수 없습니다. 플러드라이트 활동의 Search Ads 360 ID를 보려면 전환 보고서 (Search Ads 360 UI 또는 보고 API)를 다운로드하세요. 보고서 기간 동안 플러드라이트 활동에 기여한 전환이 하나 이상 있는 경우 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형입니다(ACTION또는TRANSACTION). ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환에는 금전적 가치가 있습니다. 이메일 목록 가입 (액션)과 전자상거래 구매 (거래)를 예로 들 수 있습니다.TRANSACTION를 지정하는 경우 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금액입니다.
전환 수익을 추적하는 경우 모델이 전환 경로의 각 터치 포인트에 수익을 분배해야 합니다. 예를 들어 모델에서 선형 접근 방식(각 터치 포인트에 수익을 균등하게 분배)을 사용하는 경우 3개의 광고 클릭이 포함된 전환 경로에서 각 클릭에 전환의 33% 가 기여한 것으로 간주됩니다. 전환으로 100달러의 수익이 발생한 경우 모델이 각 클릭에 33달러의 수익을 분배하고 revenueMicros가 각 클릭에 33달러의 수익만 지정하는지 확인합니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사용자 수 또는 판매된 상품의 총 수량입니다. ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000값을 삽입합니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 간주됩니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자) 형식을 사용하여 통화를 지정합니다.
거래 전환에만 적용됩니다.customMetric및customDimension: 구매한 상품이 배송되는 국가, 제품 ID, 전화 통화 시간 등 전환에 관한 추가 데이터를 업로드합니다. 맞춤 플러드라이트 변수의 데이터 업로드에 대해 자세히 알아보세요.deviceType: 전환이 발생한 기기의 유형을 지정합니다. 이 필드의 허용되는 값 목록을 참고하세요.
예
POST https://www.googleapis.com/doubleclicksearch/v2/conversion Authorization: Bearer your OAuth 2.0 access token Content-type: application/json { "kind": "doubleclicksearch#conversionList", "conversion" : [{ "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site "conversionId" : "test_20130906_04", "conversionTimestamp" : "1378710000000", "segmentationType" : "FLOODLIGHT", "segmentationName" : "Test", "type": "TRANSACTION", "attributionModel": "External Attribution Model", "countMillis": "330", "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue "currencyCode": "USD" }] }
Search Ads 360 응답 처리
Search Ads 360의 응답은 요청의 모든 전환이 유효성 검사를 거쳐 업로드된 경우에만 성공을 나타냅니다.
요청이 성공한 경우
요청이 성공하면 응답에 업로드된 각 전환의 전체 Search Ads 360 내부 표현(예: 캠페인 ID, 광고 그룹 ID, 키워드(기준) ID)이 포함됩니다.
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700004289911004",
"adId": "0",
"dsConversionId": "48719131694768384",
"conversionId": "test_1383157331951",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368"
},
...
]
}
요청이 실패한 경우
하나 이상의 전환 검증 또는 업로드에 실패하면 응답에 실패한 각 전환 업로드에 관한 메시지가 포함됩니다. 응답에 업로드된 전환에 관한 메시지가 포함되어 있지 않습니다.
다음은 완전히 성공하지 못한 요청에 대한 응답 예입니다.
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
각 실패 메시지에는 이유와 자세한 오류 메시지라는 두 가지 중요한 입력란이 포함됩니다. 이유 필드에는 requestValidation, internalError, transactionFailed 또는 lateStageRequestError가 포함될 수 있습니다.
requestValidation 오류
requestValidation 오류는 전환 업로드 요청에 데이터 문제가 있음을 나타냅니다 (예: 전환이 이미 업로드되었거나 clickId를 찾을 수 없음). 이 유형의 오류에서 메시지 세부정보에는 두 가지 항목이 포함됩니다.
- 오류 유형을 식별하는 16진수 코드입니다. 자체 스크립트에서 이 코드를 사용하여 오류를 식별할 수 있습니다.
- 유효성 검사 오류에 대한 설명입니다.
자세한 내용은 Search Ads 360에서 전환 업로드 오류로 반환할 수 있는 코드 및 설명 목록을 참고하세요.
기타 오류 유형
다른 모든 유형의 오류 (internalError, transactionFailed 또는 lateStageRequestError)는 Search Ads 360에 내부 문제가 있음을 나타냅니다.
오류에 응답
요청에 실패하면 나중에 전체 요청 호출을 다시 제출해 보세요. Search Ads 360은 이미 업로드된 전환에 대해 requestValidation 오류를 보고하지만 나머지 전환은 업로드하려고 시도합니다.
다시 제출한 후에도 오류가 계속 표시되면 문제 해결 섹션에서 계속 진행하는 방법을 확인하세요.