새 전환 추가

Conversion.insert() 메서드를 호출하여 하나 이상의 전환을 추가합니다. 전환 기여도를 올바르게 부여하려면 요청에서 광고주가 오프라인 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름과 함께 방문의 클릭 ID 또는 전환으로 이어진 키워드의 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에 로그인하고 활동 설정을 변경하여 전환의 기본 소스가 오프라인 활동임을 나타내는 것이 좋습니다.

광고 전환 추가 권장사항

전환을 추가할 때는 다음 권장사항을 따르는 것이 좋습니다.

  1. Search Ads 360 사용자에게 Search Ads 360에 로그인하여 오프라인 전환을 보고하는 데 사용하는 각 플러드라이트 활동의 설정을 변경하도록 요청합니다. 설정에서 전환의 기본 소스가 오프라인 활동임을 나타내야 합니다. 자세한 내용은 Search Ads 360 고객센터를 참고하세요.

  2. 전환이 발생하면 최대한 빨리 업로드합니다. 특정 방문에 전환 기여도를 부여하는 경우 방문 후 최소 6시간이 지난 후에 전환을 업로드하세요. 방문 후 6시간 이내에 업로드하면 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 드물지만 Search Ads 360에서 clickId를 인식할 때까지 최대 24시간을 기다려야 할 수도 있습니다.

    각 업로드에 가장 최근의 전환이 포함되어야 합니다. 단일 업로드 요청 내에서 항목이 시간순이 아니어도 괜찮습니다. 하지만 입찰 전략은 나중에 다른 요청에서 업로드하는 이전 전환을 고려하지 못할 수 있습니다.

삽입 요청 전송

Conversion.insert() 요청을 전송하여 다음 중 하나를 수행할 수 있습니다.

  • 특정 방문에 전환 기여도 부여
  • 키워드에만 전환 기여도 부여

Conversion.insert() 요청에 필요한 필드는 전환 기여도를 부여하는 이벤트 또는 항목에 따라 다릅니다. 다음 섹션에는 전환 기여도를 부여할 수 있는 각 이벤트 또는 항목의 필수 및 옵션 필드가 나와 있습니다.

특정 방문에 전환 기여도 부여

고객이 하나 이상의 광고를 클릭하고 광고주의 사이트를 방문하면 Search Ads 360은 광고주 사이트의 사용자 세션을 방문으로 간주합니다. 전환을 방문에 기여하려면 Conversion.insert() 요청에 다음을 지정합니다.

필수 입력란

  • clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 광고주의 웹 로그에서 클릭 ID를 찾거나 새 Search Ads 360 Reporting API를 사용하여 다른 전환의 conversion.click_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)에 발생한 경우 타임스탬프를 Epoch 밀리초(1470412402000)로 지정합니다.
  • segmentationType: 전환을 업로드하는 전환 시스템의 유형을 지정합니다. 현재는 플러드라이트 전환만 지원되므로 이 필드는 항상 FLOODLIGHT를 지정해야 합니다.
  • segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.

    광고주에 이름이 동일한 활동이 포함된 경우(활동이 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.

    또는 segmentationName 필드에 이름을 지정하는 대신 segmentationId 필드에 플러드라이트 활동의 ID를 지정할 수 있습니다. Campaign Manager에서 플러드라이트 활동에 할당한 ID를 사용합니다. 새 Search Ads 360 Reporting API의 conversion_action.floodlight_settings.activity_id 필드를 사용하여 이 ID를 가져올 수 있습니다. Search Ads 360이 전환 요청에 대한 응답으로 반환하는 segmentationId도 허용됩니다.

  • 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())

키워드에만 전환 기여도 부여

클릭 ID가 없는 경우 전환을 키워드에 직접 기여할 수 있습니다. 새 Search Ads 360에서 키워드 ID는 광고 그룹 내에서만 고유하므로 키워드를 식별하는 새 Search Ads 360 ID의 전체 집합과 몇 가지 다른 필드를 지정해야 합니다.

필수 입력란

  • customerId: 키워드가 포함된 고객 계정의 고객 ID입니다(예: 123-456-7890).
  • campaignId: 키워드가 포함된 캠페인의 ID입니다.
  • adGroupId: 키워드가 포함된 광고 그룹의 ID입니다.
  • criterionId: 키워드의 ID입니다.

    변환에서 customerId, campaignId, adGroupId 없이 criterionId를 지정하면 오류 코드 0x0000012E와 함께 실패합니다. 이러한 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)에 발생한 경우 타임스탬프를 Epoch 밀리초(1470412402000)로 지정합니다.
  • segmentationType: 전환을 업로드하는 전환 시스템의 유형을 지정합니다. 현재는 플러드라이트 전환만 지원되므로 이 필드는 항상 FLOODLIGHT를 지정해야 합니다.
  • segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.

    광고주에 이름이 동일한 활동이 포함된 경우(활동이 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.

    또는 segmentationName 필드에 이름을 지정하는 대신 segmentationId 필드에 플러드라이트 활동의 ID를 지정할 수 있습니다. Campaign Manager에서 플러드라이트 활동에 할당한 ID를 사용합니다. 새 Search Ads 360 Reporting API의 conversion_action.floodlight_settings.activity_id 필드를 사용하여 이 ID를 가져올 수 있습니다. Search Ads 360이 전환 요청에 대한 응답으로 반환하는 segmentationId도 허용됩니다.

  • 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" : [{
    "customerId": "123-456-7890", // Replace with your ID
    "campaignId": "14660344555", // Replace with your ID
    "adGroupId": "105138634255", // Replace with your ID
    "criterionId": "948710340465", // 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,
      String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId,
      Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCustomerId(customerId)
        .setCampaignId(campaignId)
        .setAdGroupId(adGroupId)
        .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': [{
              'customerId': '123-456-7890', // Replace with your ID
              'campaignId': '14660344555', // Replace with your ID
              'adGroupId': '105138634255', // Replace with your ID
              'criterionId': '948710340465', // 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 입찰 전략에서 데이터를 사용할 수 있습니다.

시작하기 전에

캠페인 관리자에서 맞춤 기여도 모델을 생성하고 해당 모델을 검색 광고 360으로 가져옵니다. 모델 이름을 외부 기여 분석 모델로 지정해야 합니다. 이렇게 하면 Search Ads 360 기능에서 업로드한 전환 데이터에 기여 분석 모델이 적용되었음을 인식할 수 있습니다. 자세히 알아보기

필수 입력란

전환에 서드 파티 기여 분석 모델을 적용하려면 Conversion.insert() 요청에 다음을 모두 지정하세요.

  • clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 광고주의 웹 로그에서 클릭 ID를 찾거나 새 Search Ads 360 Reporting API를 사용하여 다른 전환의 conversion.click_id를 검색합니다. Search Ads 360은 방문을 생성한 키워드, 광고, 기타 Search Ads 360 객체에 전환 기여도를 부여합니다.
    Search Ads 360에서 클릭 ID를 생성한 후 최소 30분 동안 기다렸다가 해당 ID로 전환을 업로드합니다. 그렇지 않으면 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)에 발생한 경우 타임스탬프를 Epoch 밀리초(1470412402000)로 지정합니다.
  • segmentationType: 전환을 업로드하는 전환 시스템의 유형을 지정합니다. 현재는 플러드라이트 전환만 지원되므로 이 필드는 항상 FLOODLIGHT를 지정해야 합니다.
  • segmentationName: 광고주가 전환을 보고하는 데 사용하는 플러드라이트 활동의 이름입니다.

    광고주에 이름이 동일한 활동이 포함된 경우(활동이 다른 플러드라이트 그룹에 속하는 경우 발생할 수 있음) 활동 중 하나의 이름을 바꾸는 것이 좋습니다.

    또는 segmentationName 필드에 이름을 지정하는 대신 segmentationId 필드에 플러드라이트 활동의 ID를 지정할 수 있습니다. Campaign Manager에서 플러드라이트 활동에 할당한 ID를 사용합니다. 새 Search Ads 360 Reporting API의 conversion_action.floodlight_settings.activity_id 필드를 사용하여 이 ID를 가져올 수 있습니다. Search Ads 360이 전환 요청에 대한 응답으로 반환하는 segmentationId도 허용됩니다.

  • type: 전환 유형(ACTION 또는 TRANSACTION) 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자) 형식을 사용하여 통화를 지정합니다.
    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의 응답은 요청의 모든 전환이 성공적으로 검증되고 업로드된 경우에만 성공을 나타냅니다.

요청이 성공한 경우

thought 요청이 성공하면 응답에 업로드된 각 전환에 대한 전체 Search Ads 360 내부 표현이 포함됩니다. 이 표현은 새 Search Ads 360 ID(고객 계정의 고객 ID, 전환이 기여한 캠페인 ID, 광고 그룹 ID, 키워드(기준) ID, 광고 ID)를 사용합니다.

다음은 방문에 기여한 전환에 대한 응답 예시입니다.

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "customerId": "123-456-7890",
   "campaignId": "14660344555",
   "adGroupId": "105138634255",
   "criterionId": "948710340465",
   "adId": "562719339005",
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
   "conversionId": "test_20130906_04",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "10000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368",
   "floodlightOrderId": "test_20130906_04",
   "countMillis": "1000",
   "deviceType": "DESKTOP"
  },
  ...
 ]
}

응답에는 전환에 적용되는 ID만 포함됩니다. 예를 들어 키워드에만 기여도가 부여된 전환에 대한 응답에는 clickId 및 adId가 포함되지 않습니다.

요청이 성공하지 못한 경우

하나 이상의 전환을 검증하거나 업로드하지 못하면 응답에 실패한 각 전환 업로드에 대한 메시지가 포함됩니다. 응답에는 성공적으로 업로드된 전환에 대한 메시지가 포함되지 않습니다.

다음은 완전히 성공하지 못한 요청에 대한 응답 예시입니다.

{
 "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 ..."
       }
    ]
  }
}

각 실패 메시지에는 이유와 자세한 오류 메시지라는 두 가지 중요한 필드가 포함됩니다. reason 필드에는 requestValidation, internalError, transactionFailed 또는 lateStageRequestError가 포함될 수 있습니다.

requestValidation 오류

requestValidation 오류는 전환 업로드 요청의 데이터 문제(예: 전환이 이미 업로드되었거나 clickId를 찾을 수 없음)를 나타냅니다. 이 유형의 오류에서 메시지 세부정보에는 다음 두 항목이 포함됩니다.

  • 오류 유형을 식별하는 16진수 코드입니다. 자체 스크립트에서 코드를 사용하여 오류를 식별할 수 있습니다.
  • 검증 오류에 대한 설명입니다.

자세한 내용은 Search Ads 360에서 전환 업로드 오류에 대해 반환할 수 있는 코드 및 설명 목록을 참고하세요.

기타 오류 유형

다른 모든 유형의 오류(internalError, transactionFailed 또는 lateStageRequestError)는 Search Ads 360에 내부 문제가 있음을 나타냅니다.

오류에 대응하기

요청이 실패하면 나중에 전체 요청 호출을 다시 제출해 보세요. Search Ads 360은 이미 업로드된 전환에 대해 requestValidation 오류를 보고하지만 나머지 전환은 업로드를 시도합니다.

다시 제출한 후에도 오류가 계속 표시되면 문제 해결 섹션에서 진행 방법을 확인하세요.