트래킹 링크 API 토큰 활용클라이언트에서 트래킹 링크를 생성하고자 하는 경우 ‘트래킹 링크 API 토큰’ 활용을 권장합니다.
POST
Request
Headers
string
API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
string
리소스의 미디어 타입을 나타냅니다. 기본값으로
application/json을 사용합니다.string
API 요청에 사용하는 키값입니다. 키값 생성 및 조회 방법을 확인하여 획득할 수 있습니다.
Body Params
string
필수
터치포인트와 컨버젼이 발생한 채널명.에어브릿지의 채널은 S2S 형태의 포스트백이 연동된 Integrated 채널과 직접 생성할 수 있는 Custom 채널로 나뉘어집니다.Integrated 채널은 [Integrated Channel] 에서 확인할 수 있습니다. Integrated 채널 이외에 모든 채널은 Custom 채널입니다.
object
트래킹 링크에 들어갈 캠페인 파라미터.
enum
Re-engagement 파라미터.
string
리다이렉트할 딥링크 URL.deeplinkUrl이 없거나 null일 경우 deeplink가 설정되지 않습니다.포멧은 다음과 같습니다 :
URLScheme://path?key=value올바르지 않은 deeplink URL을 사용할 경우, 딥링크가 정상적으로 동작하지 않거나 예상치 못한 동작으로 인해 문제가 발생할 수 있습니다.object
딥링크 옵션
object
플랫폼별 리다이렉트 경로.URL을 직접 입력할 때는
https URL만 사용할 수 있습니다.object
트래킹 링크를 공유 혹은 게시하면 노출되는 썸네일의 미리보기(Open Graph).
string
Custom 채널의 트래킹 링크 생성 시 축약된 숏 링크 ID. [커스텀 도메인] 설정을 해야 사용할 수 있습니다. 입력하지 않으면 랜덤하게 생성되며, 트래킹 링크 생성 완료 후에는 변경할 수 없습니다.트래킹 링크를 생성할 때 한 번 사용한 숏 링크 ID는 해당 트래킹 링크를 삭제해도 재사용할 수 없습니다.숏 링크 ID는 커스텀 도메인으로 생성하는 트래킹 링크에만 사용할 수 있습니다.
- 대표 도메인이 지정된 경우:
domain을 입력하지 않아도 대표 도메인으로 생성됩니다. - 대표 도메인이 지정되지 않은 경우: 사용할 커스텀 도메인을
domain에 함께 입력해야 하며, 입력하지 않으면400에러가 반환됩니다.
- 영문 소문자:
a–z - 한글:
가-힣 - 숫자:
0–9 - 특수문자: 하이픈(
-), 언더스코어(_) - 최대 길이: 45자
string
Custom 채널의 트래킹 링크를 생성할 커스텀 도메인.앱에 추가하고 인증이 완료된 커스텀 도메인을
link.example.com처럼 scheme과 path 없이 입력합니다.입력하지 않으면 대표 도메인을 사용하고, 대표 도메인이 없으면 abr.ge를 사용합니다.앱에 추가되지 않았거나 인증이 완료되지 않은 도메인을 입력하면 400 에러가 반환됩니다.boolean
true로 설정하면 대표 도메인이 지정되어 있어도 abr.ge로 트래킹 링크를 생성합니다.기본값은 false입니다.customShortId와 함께 사용할 수 없습니다.Response
200
400
요청한 값으로 트래킹 링크를 생성할 수 없습니다. 응답의detail에서 원인을 확인할 수 있습니다.