[2020년 11월 1일] Monthly Update

1. S3 덤프 포맷 변경

S3 덤프가 11월 1일부로 버전 1.2.1로 일괄 업그레이드 됩니다. 대상 버전을 확인해주세요. 11월 7일까지는 Migration 기간으로 기존 버전과 v1.2.1 모두 덤프가 진행될 예정이며, 11월 8일 부터는 v1.2.1만 덤프가 진행됩니다.

포맷 변경

변경 전

v1.2.1 변경 후

Header의 컬럼들은 Double Quotes(")로 감싸져 있지 않았습니다.

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)

Header의 컬럼들은 항상 Double Quotes(")로 감싸집니다.

컬럼 타입 구분없이 모든 컬럼이 double quote(")로 감싸져 있었습니다.

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)
  • 문자열 타입(string)의 컬럼은 NULL이 아닐 경우 항상 Double Quotes(“)로 감싸집니다. Double Quotes(“)가 포함된 문자열일 경우 Double Quotes(“)를 Double Quotes(“)로 escape 합니다. 개행 문자가 포함된 문자열일 경우 Line Break 후 값이 이어집니다.
  • 숫자 타입(int, float)의 컬럼은 Double Quotes(")로 감싸지지 않습니다. NULL 값일 경우 빈 칸이 됩니다.
  • 불리언(boolean) 타입의 컬럼은 Double Quotes(")로 감싸지지 않습니다. NULL 값일 경우 빈 칸이 됩니다.

float 타입의 정수에 .0이 붙어있었습니다. (ex. 72000.0)

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)
  • v1.2 (parquet)

float 타입의 정수에 .0이 제거됩니다. (ex. 72000)

Product Position, Product Price, Product Quantity 컬럼이 STRING 타입으로 제공되었습니다.

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)
  • v1.2 (parquet)

Product Position, Product Price, Product Quantity 컬럼이 값이 INT, FLOAT, INT 타입으로 제공됩니다.

Target Event Category 값이 시스템 숫자값(9161,9162)으로 제공되고 있었습니다. (버그)

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)
  • v1.2 (parquet)

Target Event Category 값이 Install (App), Deeplink Open (App)으로 제공됩니다. (버그 수정)

Touchpoint Event Category 값이 시스템 숫자값(9100,9200)으로 제공되고 있었습니다. (버그)

<대상 버전>

  • v1.1 (csv)
  • v1.2 (csv)
  • v1.2 (parquet)

Target Event Category 값이 Impression, Click으로 제공됩니다. (버그 수정)

컬럼 추가 및 변경 (기존 v1.1 대상 변경)

v1.1 컬럼 개수

v1.2, v1.2.1 컬럼 개수

트래킹링크

46

52

68

80

114

129

변경 사항 요약

제거된 컬럼

추가된 컬럼

트래킹링크

OS Full String

Client IP Country
Client IP Country Code
Client IP Cloud Provider
Client IP Cloud Provider Service
Campaign ID
Ad Group ID
Ad Creative ID

OS Full String

Custom User Properties
Client IP Country
Client IP Country Code
Client IP Cloud Provider
Client IP Cloud Provider Service
Total Revenue
Currency
Product List
Total Quantity
Is First Event per User ID
Campaign ID
Ad Group ID
Ad Creative ID

OS Full String
Is First Event
Is First Event Category
Target Event Type

Custom User Properties
Private IP
Client IP Country
Client IP Country Code
Client IP Cloud Provider
Client IP Cloud Provider Service
Total Revenue
Currency
Product List
Total Quantity
Is First Event per User ID
Is First Event per Device ID
Campaign ID
Ad Group ID
Ad Creative ID
Is First Target Event per Device
Touchpoint Fraud Tag
Conversion Fraud Tag
Target Event Fraud Tag

  • OS Full String => OS Raw, OS Version으로 구분 가능
  • Is First Event => Is First Per Device ID, Is First Per User ID로 대체
  • Is First Event Category => Is First Per Device ID, Is First Per User ID로 대체
  • Target Event Type => Target Event Category로 대체

FAQ

Q. v1.2 덤프를 받고 있었는데, v1.2.1도 컬럼이 추가되나요?

A. 아니오. v1.2와 v1.2.1은 동일한 컬럼을 제공하며, 위 안내된 포맷 변경만 있습니다.




2. 웹 Open (Web) 이벤트 기본 어트리뷰션 채널명 변경

airbridge.websdk 기본 채널명 unattributed로 변경

WEB SDK init시 defaultChannel 옵션(어떤 채널에도 기여되지 않았을때 사용하는 채널명)에 airbridge.websdk로 값을 넣어준 경우, unattributed로 변경됩니다.

// channel을 'unattributed'로 처리
airbridge.init({
  // ...
  defaultChannel: 'airbridge.websdk'
})

단, defaultParams 옵션 값이 적용되어 다른 캠페인 파라미터에 값이 들어간 경우 defaultChannel은 airbridge.websdk로 유지됩니다.

// channel은 'airbridge.websdk', campaign은 'banner'로 처리
airbridge.init({
  // ...
  defaultChannel: 'airbridge.websdk',
  defaultParams: {
    campaign: 'banner'
  }
})