새 전환 추가

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

전환의 경우 오늘 또는 어제의 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. 전환이 발생하는 즉시 업로드합니다. 특정 방문이 전환에 기여했다고 간주하려면 전환을 업로드할 수 있습니다 다음과 같은 경우 Search Ads 360에서 방문의 clickID를 인식하지 못할 수 있습니다. 방문 후 30분보다 일찍 업로드하는 것이 좋습니다 드물지만, 다음과 같은 조치를 취해야 할 수도 있습니다. 최대 4시간이 지나야 Search Ads 360에서 clickId를 인식할 수 있습니다.

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

3. 플러드라이트 활동에 대한 전환을 업로드하기 전에 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: 전환이 발생한 기기의 유형을 지정합니다. 자세한 내용은 이 항목에 허용되는 값 목록 필드를 확인합니다.

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: 키워드 식별자입니다. 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: 전환이 발생한 기기의 유형을 지정합니다. 자세한 내용은 이 항목에 허용되는 값 목록 필드를 확인합니다.

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를 찾을 수 없는 경우입니다. 이 메시지 세부정보에 다음 두 가지 항목이 포함됩니다.

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

자세한 내용은 코드 목록과 설명을 포함해야 합니다.

기타 오류 유형

그 외의 모든 유형의 오류 (internalError, transactionFailed, 또는 lateStageRequestError)를 구분하면 내부 문제가 발생했음을 Search Ads 360

오류에 대응

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

다시 제출한 후에도 오류가 계속 발생하면 문제 해결 섹션을 참조하세요.