Conversion.insert()를 호출합니다.
메서드를 사용하여 하나 이상의 전환을 추가할 수 있습니다. 전환에 대한 기여도를 제대로 부여하려면 요청
광고주가 보고하는 데 사용하는 플러드라이트 활동의 이름을 지정해야 함
오프라인 전환수, 그리고 전환으로 이어진 키워드, 광고 및 클릭의 ID 대상
Search Ads 360 ID를 얻는 방법에 대한 자세한 내용은 Search Ads 360 ID 및
전환수
이전 전환의 업로드에 대한 제한사항에 대한 정보는 Search Ads 360 고객센터
Conversion.insert() 요청에서 여러 전환을 지정하는 경우
Search Ads 360에서는
전체 배치를 '전부 아니면 전무' 트랜잭션으로 업로드합니다. 캠페인에서 일부 전환이
일괄 업로드에 실패하는 경우 나머지는 성공적으로 업로드할 수 있습니다. 전환 업로드가 실패할 수 있음
잘못된 요청이나 일시적인 네트워크 또는 시스템 장애로 인해
발생하지 않을 수 있습니다. 따라서
Google Cloud에 삽입된 전환마다 응답을 확인하는 것이 좋습니다
업로드가 정상적으로 완료되었는지 확인합니다.
업로드된 데이터는 언제 사용할 수 있나요?
전환의 경우 오늘 또는 어제의 conversionTimestamp, 다음에 대한 측정항목
업로드 후 1시간 이내에 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 고객센터 를 참조하세요.
전환이 발생하는 즉시 업로드합니다. 특정 방문이 전환에 기여했다고 간주하려면 전환을 업로드할 수 있습니다 다음과 같은 경우 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 방문 후 30분보다 일찍 업로드하는 것이 좋습니다 드물지만, 다음과 같은 조치를 취해야 할 수도 있습니다. 최대 4시간이 지나야 Search Ads 360에서 clickId를 인식할 수 있습니다.
각 업로드에 가장 최근의 전환이 포함되어 있는지 확인하세요. 단일 시간순으로 정렬되어 있지 않아도 괜찮습니다. 하지만 입찰 전략은 나중에 다른 요청에서 업로드하는 이전 전환을 고려할 수 없습니다.
플러드라이트 활동에 대한 전환을 업로드하기 전에 24시간 넘게 대기하는 경우 가용성 타임스탬프입니다.
가용성 타임스탬프는 다음 중 하나여야 합니다.
- 지난 24시간 동안 전환을 기록했지만 업로드하지 않은 경우 타임스탬프는 마지막에 전환이 업로드된 시간과 발생합니다. 이렇게 하면 Search Ads 360에 전환이 발생했을 수 있다는 사실을 알 수 있습니다. 아직 데이터를 제공하지 않았습니다. 입찰 전략 다른 자동화 시스템은 이전 시점까지의 실적 기록만 고려합니다. 확인할 수 있습니다
- 지난 24시간 동안 전환이 발생하지 않은 경우 타임스탬프는 현재 시간 및 날짜입니다. 이렇게 하면 Search Ads 360에 최근 24시간 동안 발생한 전환수 입찰 전략 및 기타 자동 지난 24시간(전환이 발생하지 않은 하루)이 확인할 수 있습니다
삽입 요청 보내기
Conversion.insert() 요청을 전송하여 다음 작업을 실행할 수 있습니다.
- 특정 방문에 전환 기여도 부여
- 키워드에 대해서만 전환 기여 분석
Conversion.insert() 요청에 필요한 필드는
전환 기여 요인이 된 이벤트 또는 항목을
파악할 수 있습니다 다음 섹션에는 필수 항목인
전환 기여도를 부여할 수 있는 각 이벤트 또는 상품에 대한 선택 필드를 제공합니다.
특정 방문에 전환 기여 분석하기
고객이 하나 이상의 광고를 클릭하고 광고주의 사이트를 방문하면
Search Ads 360에서는 광고주 사이트의 사용자 세션을 방문으로 간주합니다.
방문으로 전환 기여도를 부여하려면 Conversion.insert()에 다음을 지정합니다.
요청:
필수 입력란
clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 이 전환을 나열하거나 다른 전환의 클릭 ID Search Ads 360에서는 전환에 기여도를 부여합니다. 광고를 게재했던 키워드, 광고, 기타 Search Ads 360 개체를 확인할 수 있습니다.
기기 설치 후 최소 30분 동안 대기하세요. Search Ads 360에서는 전환을 업로드하기 위한 클릭 ID를 생성합니다. '클릭 ID를 찾을 수 없습니다'라는 메시지가 표시되는 경우 4시간을 기다린 다음 있습니다. 모든 전환은 생성됩니다. 그렇지 않으면 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를 알고 있는 경우
segmentationId에 ID를 지정하는 대신segmentationName필드 또한 Campaign Manager는 플러드라이트 활동에 ID를 할당하므로 Campaign Manager ID는 Search Ads 360 ID와 다르고 conversions.) 플러드라이트 활동의 Search Ads 360 ID를 보려면 다음을 다운로드하세요. 전환 보고서( Search Ads 360 UI 또는 보고서 API)를 사용합니다. 다음 기간 동안 하나 이상의 전환이 플러드라이트 활동으로 인해 발생한 경우 보고서의 기간을 선택하면 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형(ACTION)입니다. 또는TRANSACTION. ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환은 가능합니다. 예: 이메일 목록 가입 (ACTION) 또는 전자상거래 구매 (TRANSACTION)TRANSACTION를 지정하면 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금전적 가치입니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사람 수 또는 판매된 품목의 총 수량 ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000의 값입니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 가정합니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자)을 사용하세요. 형식을 사용해야 합니다.
TRANSACTION 전환에만 적용됩니다.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: 키워드 식별자입니다.TrackerId를 추가하여criterionId를 가져올 수 있습니다. 매크로를 방문 페이지 URL에 추가합니다. 키워드 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를 알고 있는 경우
segmentationId에 ID를 지정하는 대신segmentationName필드 또한 Campaign Manager는 플러드라이트 활동에 ID를 할당하므로 Campaign Manager ID는 Search Ads 360 ID와 다르고 conversions.) 플러드라이트 활동의 Search Ads 360 ID를 보려면 다음을 다운로드하세요. 전환 보고서( Search Ads 360 UI 또는 보고서 API)를 사용합니다. 다음 기간 동안 하나 이상의 전환이 플러드라이트 활동으로 인해 발생한 경우 보고서의 기간을 선택하면 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형(ACTION)입니다. 또는TRANSACTION. ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환은 가능합니다. 예: 이메일 목록 가입 (ACTION) 또는 전자상거래 구매 (TRANSACTION)TRANSACTION를 지정하면 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금전적 가치입니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사람 수 또는 판매된 품목의 총 수량 ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000의 값입니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 가정합니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자)을 사용하세요. 형식을 사용해야 합니다.
TRANSACTION 전환에만 적용됩니다.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 Search Ads 360에서는 전환에 기여도를 부여합니다. 광고를 게재했던 키워드, 광고, 기타 Search Ads 360 개체를 확인할 수 있습니다.
최소 30분 후 Search Ads 360에서는 이 ID로 전환을 업로드하기 전에 클릭 ID를 생성합니다. 그렇지 않으면 Search Ads 360 API에서 방문을 인식하지 못할 수 있습니다.attributionModel: 외부 기여 분석 모델로 설정합니다. 자세히 알아보기countMillis: 이 클릭에 할당할 전환 기여도 금액입니다. 요청에attributionModel필드도 포함된 경우에만 적용됩니다.이를 지정하는 선택 필드인
quantityMillis과 혼동하지 마세요. 전환 1회에 포함된 상품 수 (예: 장바구니에 담긴 상품 수) 합니다.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를 알고 있는 경우
segmentationId에 ID를 지정하는 대신segmentationName필드 또한 Campaign Manager는 플러드라이트 활동에 ID를 할당하므로 Campaign Manager ID는 Search Ads 360 ID와 다르고 conversions.) 플러드라이트 활동의 Search Ads 360 ID를 보려면 다음을 다운로드하세요. 전환 보고서( Search Ads 360 UI 또는 보고서 API)를 사용합니다. 다음 기간 동안 하나 이상의 전환이 플러드라이트 활동으로 인해 발생한 경우 보고서의 기간을 선택하면 보고서에 Search Ads 360 ID가 표시됩니다.type: 전환 유형(ACTION)입니다. 또는TRANSACTION. ACTION 전환에는 금전적 가치가 없지만 TRANSACTION 전환은 가능합니다. 예: 이메일 목록 가입 (ACTION) 또는 전자상거래 구매 (TRANSACTION)TRANSACTION를 지정하면 다음 필드도 지정해야 합니다.revenueMicros: 전환의 금전적 가치입니다.
전환 수익을 추적하는 경우 모델이 수익을 각 전환 경로의 터치 포인트예를 들어 모델에서 선형 접근 방식을 사용하는 경우 (각 터치 포인트에 수익을 균등하게 배분) 광고 클릭이 3회 발생하는 경우 각 클릭에는 전환의 33% 가 기여합니다. 전환 모델이 클릭 1회당 33달러의 수익을 분배하도록 하세요 revenueMicros가 클릭 1회에 대해 33달러의 수익만 지정하도록 합니다.
선택적 필드
quantityMillis: 이 전환의 항목 수입니다. 예를 들어 이메일 뉴스레터에 가입한 사람 수 또는 판매된 품목의 총 수량 ACTION 전환에 이 필드를 지정하지 않으면 Search Ads 360에서 자동으로1000의 값입니다.currencyCode: 거래 수익의 통화입니다. 기본적으로 수익은 광고주의 통화로 가정합니다. 다른 통화를 지정하면 Search Ads 360에서 지정된 수익 금액을 광고주의 통화로 변환합니다. 자세히 알아보기
ISO 4217 알파벳 (영문 기준 3자)을 사용하세요. 형식을 사용해야 합니다.
TRANSACTION 전환에만 적용됩니다.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진수 코드입니다. 코드를 직접 사용할 수도 있습니다. 스크립트를 사용하여 오류를 식별합니다.
- 유효성 검사 오류에 대한 설명입니다.
자세한 내용은 코드 목록과 설명을 포함해야 합니다.
기타 오류 유형
그 외의 모든 유형의 오류 (internalError, transactionFailed, 또는 lateStageRequestError)를 구분하면 내부 문제가 발생했음을 Search Ads 360
오류에 대응
요청이 실패하면 나중에 전체 요청 호출을 다시 제출해 보세요. Search Ads 360 requestValidation 오류를 보고한 모든 전환에 대해 이미 업로드되었지만 나머지 전환의 업로드를 시도합니다.
다시 제출한 후에도 오류가 계속 발생하면 문제 해결 섹션을 참조하세요.