새 전환 추가

업로드된 데이터는 언제 사용할 수 있나요?

전환에 오늘 또는 어제의 conversionTimestamp를 지정하면 업로드 후 1시간 이내에 전환 측정항목이 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. 전환이 발생하는 즉시 업로드합니다. 특정 방문이 전환에 기여한 것으로 분석하려면 방문 후 최소 30분 이상 기다린 후에 전환을 업로드하세요. 방문 후 30분 이전에 업로드하면 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 드물지만 Search Ads 360에서 clickId를 인식할 수 있을 때까지 최대 4시간을 기다려야 할 수도 있습니다.

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

3. 플러드라이트 활동의 전환을 업로드하기 전에 24시간 넘게 기다린 경우 가용성 타임스탬프를 전송합니다.

   가용성 타임스탬프는 다음 중 하나여야 합니다.

   • 지난 24시간 동안 전환을 기록했지만 아직 업로드하지 않은 경우 타임스탬프는 마지막으로 업로드된 전환이 발생한 시간이어야 합니다. 이렇게 하면 지난 24시간 동안 전환이 발생했을 수 있지만 아직 데이터를 제공하지 않았다고 Search Ads 360에 알립니다. 입찰 전략 및 기타 자동화 시스템에서는 마지막으로 업로드한 전환까지의 실적 내역만 고려합니다.
   • 지난 24시간 동안 전환이 발생하지 않은 경우 타임스탬프는 현재 시간 및 날짜여야 합니다. 이렇게 하면 Search Ads 360에 지난 24시간 동안 발생한 전환이 없음을 알 수 있습니다. 입찰 전략 및 기타 자동화 시스템에는 최근 24시간(전환이 발생하지 않은 하루 2일)이 실적 내역의 일부로 포함됩니다.

삽입 요청 보내기

Conversion.insert() 요청을 전송하여 다음 작업을 할 수 있습니다.

• 특정 방문에 전환 기여도 부여
• 키워드에 대해서만 전환 기여 분석

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

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

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

필수 입력란

• clickId: 방문의 대소문자를 구분하는 클릭 ID입니다. 광고주의 웹 로그에서 클릭 ID 또는 전환 나열을 확인하고 다른 전환의 클릭 ID를 사용합니다. Search Ads 360은 방문 생성을 담당하는 키워드, 광고 및 기타 Search Ads 360 객체가 전환에 기여한 것으로 간주합니다.
  Search Ads 360에서 클릭 ID를 생성하여 전환을 업로드한 후 최소 30분 동안 기다리세요. '클릭 ID를 찾을 수 없음' 오류가 발생하면 4시간 후에 전환을 다시 업로드하세요. 모든 전환은 클릭 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 또는 reporting 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: 전환이 발생한 기기의 유형을 지정합니다. 이 필드는 허용되는 값 목록을 참고하세요.

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());
    }
  }
            

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 또는 reporting 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: 전환이 발생한 기기의 유형을 지정합니다. 이 필드는 허용되는 값 목록을 참고하세요.

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;
  }        

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

예시

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

requestValidation 오류

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

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

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

기타 오류 유형

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

오류에 대응

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

다시 제출한 후에도 오류가 계속 발생하면 문제 해결 섹션에서 진행 방법에 대한 정보를 확인하세요.