Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
DFINERY Import API는 HTTP 응답 코드와 상세 응답 코드를 통해 요청의 성공과 실패를 판단합니다. HTTP 응답 코드가 200 이더라도, 요청은 실패할 수 있습니다.
200 - OK
서버에서 정상적으로 요청을 받았습니다.
400 - Bad Request
요청을 처리할 수 없습니다. 필수 파라미터를 보내지 않았거나, 파라미터 포맷이 잘못되었을 때 돌아오는 응답입니다. 요청 파라미터를 확인해 주세요.
429 - Too Many Requests
비정상적으로 많은 요청을 보냈습니다. 잠시 후 다시 시도해 주세요.
500 - Server Error
서버 내부에서 에러가 발생했습니다
API 호출이 실패한 경우, 상세 응답 코드를 통해 오류에 대해 상세한 정보를 얻을 수 있습니다.
200
20000
OK
요청 성공
200
40000
BAD_REQUEST
잘못된 요청
200
40001
VALIDATION_FAILURE
검증 실패
200
40101
INVALID_SERVICE_ID
잘못된 서비스 ID
200
40201
INVALID_TOKEN
잘못된 토큰 제공
200
40401
TOO_MANY_REQUEST
API 사용 한도 초과
200
40402
TOO_MANY_EVENTS
요청 내 이벤트 수 초과
200
40403
TOO_MANY_USER_PROFILES
단일 요청 내 유저 프로필 수 초과
200
50000
INTERNAL_SERVER_ERROR
서버 내부 에러 발생
POST
/api/v1/identities
고객의 통합 프로필을 생성 및 업데이트 할 수 있는 API 입니다.
service_id
String
서비스 ID
Content-Type
String
application/json
-
access_token
String
your-api-token-key
API 인증 토큰
identity
Object
이벤트 적재를 위한 공통 속성
request_datetime
Datetime
요청 시각, ISODate 8601 Format,
2024-06-24T06:42:25.394Z
유저 식별 정보입니다. 아래 필드 중 적어도 하나의 값을 넣어주어야 합니다.
external_id
String
외부 ID
phone_no
String
전화 번호
email
String
이메일
kakao_user_id
String
카카오 ID
line_user_id
String
라인 ID
자세한 내용은 상세 응답 참고하시면 됩니다.
POST
/api/v1/events
이벤트 적재 API를 통해 하나 혹은 여러 이벤트를 한번에 적재할 수 있습니다. 적재하고자 하는 이벤트는 콘솔에서 사전 등록되어 있어야 합니다.
한번의 요청에서 최대 100개의 이벤트를 적재할 수 있습니다. 또한, 한번의 요청에서 최대 100개의 이벤트 아이템을 적재할 수 있습니다.
많은 이벤트를 적재 해야 한다면, 개별로 이벤트 적재 API를 호출하는 것 보다 여러 이벤트를 모아두었다가 한번에 이벤트 적재 API를 호출하는 것이 속도 및 요청 제한 측면에서 좋습니다. 연동 시에는 항상 요청 제한을 고려해야 합니다.
service_id
String
서비스 ID
Content-Type
String
application/json
-
access_token
String
your-api-token-key
API 인증 토큰
Object
이벤트 적재를 위한 공통 속성
Array of Object
이벤트 정보
Object
유저 식별자
유저 식별자 정보입니다. 아래 필드 중 적어도 하나의 값을 넣어주어야 합니다.
external_id
String
외부 ID
phone_no
String
전화 번호
email
String
이메일
kakao_user_id
String
카카오 ID
line_user_id
String
라인 ID
event_log_id
String
이벤트 식별 ID, UUID Format,
xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx
event_name
String
이벤트명
event_datetime
Datetime
이벤트 발생 시각
Array of Object
상품 정보
Object
이벤트 속성
이벤트 아이템 속성입니다. 필드명은 콘솔에서 사전 등록된 아이템(df_item
) 의 하위 속성명을, 값은 해당 속성의 값을 넣어주어야 합니다. 이벤트 아이템은 한번에 최대 100개까지 적재 가능합니다.
${your-df-item-property-key}
String, Long, Double, Boolean, Datetime, Array
사전 등록된 이벤트 아이템 속성 정보
이벤트 속성입니다. 필드명은 아이템(df_item
) 을 제외한 콘솔에서 사전 등록된 이벤트 속성의 속성명을, 값은 해당 속성의 값을 넣어주어야 합니다.
${your-event-property-key}
String, Long, Double, Boolean, Datetime, Array
사전 등록된 이벤트 속성 정보
자세한 내용은 상세 응답 참고하시면 됩니다.
이벤트 수가 100개를 초과하거나, 이벤트 아이템 수가 100개를 초과한 경우입니다.
Profile API를 통해 유저의 속성을 생성하거나 업데이트 할 수 있습니다. API 연동을 위해서는 먼저 기본 세팅을 완료하여야 합니다. API 연동을 위한 기본 세팅을 아직 하지 못했다면, 시작하기 전에 를 참고해 주시면 됩니다.
유저 속성 생성 및 업데이트 API를 통해 온/오프라인 채널에 대한 유저의 수신 동의 정보 값을 설정할 수 있습니다.
오후 9시 부터 오전 8시 사이에는 별도의 수신 동의를 받아야 광고성 알림을 전송할 수 있습니다.
알림 수신 동의 정보에 대한 유저 프로필은 예외적으로 DFINERY에서 서비스 생성 시 이미 자동으로 등록되어 있어 DFINERY 콘솔에서 설정하지 않아도 설정이 가능합니다.
수신 동의 정보는 기본값을 통해 따로 설정하지 않아도 발송될 수 있습니다. 자세한 사항은 이용자 가이드의 를 참고하시면 됩니다.
POST
/api/v1/user-profile
고객의 유저 속성을 생성 및 업데이트할 수 있는 API입니다.
유저 속성의 생성 및 업데이트 API 호출은 유저의 속성의 변경 시점에만 호출하는 것이 좋습니다. 연동 시에는 항상 을 고려해야 합니다.
유저 식별자 정보입니다. 아래 필드 중 적어도 하나의 값을 넣어주어야 합니다.
유저 속성입니다. 필드명은 콘솔에서 사전 등록된 유저 속성의 속성명을, 값은 해당 속성의 값을 넣어주어야 합니다.
이벤트 정보입니다. 적재하고자 하는 이벤트는 콘솔에서 사전 등록되어 있어야 합니다. 표준 이벤트와 이벤트 속성에 대한 자세한 내용은 사용자 가이드의 를 참고해 주시면 됩니다.
자세한 내용은 참고하시면 됩니다.
이벤트 속성에 대한 자세한 내용은 를 참고하시면 됩니다.
자세한 내용은 참고하시면 됩니다.
유저 프로필 속성에 대한 자세한 내용은 을 참고하시면 됩니다.
자세한 내용은 참고하시면 됩니다.
성공 시 헤더를 포함한 csv포맷의 데이터를 응답으로 받게 됩니다. 자세한 사항은 각 를 참고하시면 됩니다.
${your-user-property-key}
String, Long, Double, Boolean, Datetime, Array
사전 등록된 유저 속성 정보
${your-standard-event-property-key}
표준 이벤트 속성
표준 이벤트 속성
${your-custom-event-property-key}
커스텀 이벤트 속성
커스텀 이벤트 속성
${your-df-item-property-key}
표준, 커스텀 이벤트 속성
이벤트 아이템 (표준, 커스텀) 속성
df_api_version
시스템 이벤트 속성
이벤트 API 버전
event_name
시스템 이벤트 속성
이벤트명
df_server_datetime
시스템 이벤트 속성
이벤트 로그 서버 도달 시각
df_correction_datetime
시스템 이벤트 속성
이벤트 발생 시각
df_event_detail_log_id
시스템 이벤트 속성
이벤트 로그 ID, 구매 이벤트에서 여러 아이템이 포함되어 있는 경우,
${df_event_log_id}:${n}
의 형태입니다.
df_event_log_id
시스템 이벤트 속성
이벤트 로그 ID
${your-standard-user-property-key}
표준 유저 프로필 속성
표준 유저 프로필 속성
${your-custom-user-property-key}
커스텀유저 프로필 속성
커스텀유저 프로필 속성
200 - OK
서버에서 정상적으로 요청을 받았습니다.
400 - Bad Request
요청을 처리할 수 없습니다. 필수 파라미터를 보내지 않았거나, 파라미터 포맷이 잘못되었을 때 돌아오는 응답입니다. 요청 파라미터를 확인해 주세요.
429 - Too Many Requests
비정상적으로 많은 요청을 보냈습니다. 잠시 후 다시 시도해 주세요.
500 - Server Error
서버 내부에서 에러가 발생했습니다
200
fail
client_connection_closed
클라이언트 연결이 종료되었습니다.
400
fail
invalid_parameter
제공된 요청 파라미터가 잘못되었거나 형식이 맞지 않습니다.
400
fail
exceed_date_range_limit
요청한 시작일이 허용된 범위를 초과하였습니다.
401
fail
unauthorized_token
유효하지 않은 Export 토큰입니다.
429
fail
too_many_api_requests
요청한 API 호출 수가 한도를 초과했습니다.
500
fail
unknown_error
시스템 내부에서 예기치 않은 오류가 발생했습니다.
500
fail
query_error
요청된 데이터베이스 쿼리가 실행되지 않고, 실패하였습니다.
service_id
String
서비스 ID
Content-Type
String
application/json
-
access_token
String
your-api-token-key
API 인증 토큰
Object
유저 식별자
Object
유저 속성
request_datetime
Datetime
요청 시각, ISODate 8601 Format,
2024-06-24T06:42:25.394Z
external_id
String
외부 ID
phone_no
String
전화 번호
email
String
이메일
kakao_user_id
String
카카오 ID
line_user_id
String
라인 ID
service_id
String
서비스 ID
Content-Type
String
application/json
-
Authorization
String
Bearer your-auth-token
API 인증 토큰
events
List of String
필터링 대상 이벤트명 리스트, 값이 존재하지 않을 경우 모든 이벤트 추출
events_condition_type
String
필터링 연산자, 아래 값을 지원합니다.
all
: 전체 이벤트,
include
: events
의 이벤트만 포함,
exclude
: events
의 이벤트 제외
from_date
Date
이벤트 조회 시작일, yyyy-MM-dd,
2024-12-05
to_date
Date
이벤트 조회 종료일, yyyy-MM-dd,
2024-12-05
service_id
String
서비스 ID
Content-Type
String
application/json
-
Authorization
String
Bearer your-auth-token
API 인증 토큰
properties
List of String
필터링 대상 유저 속성명 리스트, 값이 존재하지 않을 경우 모든 유저 속성 추출
properties_condition_type
String
필터링 연산자, 아래 값을 지원합니다.
all
: 전체 유저 속성,
include
: properties
의 유저 속성만 포함,
exclude
: properties
의 유저 속성 제외
audience
String
추출하고자 하는 유저가 포함된 오디언스ID, 값이 존재하지 않을 경우 모든 유저에 대해 추출