원링크 API로 대규모 캠페인을 위한 링크 생성하기

프리미엄

한눈에 보기: 원링크 API를 통해 SMS 문자 메시지 등 다양한 경로에서 활용할 수 있는 대규모 캠페인의 개인화된 링크를 생성하여 엔드 유저의 참여를 유도하고 온드 미디어(owned media) 활용도를 높입니다. 원링크 API는 광고주와 개발자가 함께 구현해야 합니다.

원링크 API로 대규모 캠페인을 위한 링크 생성하기

원링크 API는 다음과 같이 사용됩니다.

  • 커스텀 파라미터를 사용해 원링크 숏 URL을 자동으로 생성호출업데이트삭제합니다.
    파라미터 종류:
    • 미디어 소스, 캠페인, 광고 애셋 같은 마케팅 성과 측정 및 모니터링에 사용되는 어트리뷰션 관련 파라미터 참고: 미디어 소스(pid) 파라미터는 필수입니다.  
    • 관련 링크에서 앱을 여는 경우, 맞춤형 사용자 경험을 설정할 수 있도록 개인화된 파라미터. 파라미터로 맞춤형 인앱 콘텐츠를 사용자에게 보낼 수 있습니다. (예: 특정 제품 페이지, 쿠폰 코드, 프로모션)
  • 모바일 사용자에게 웹사이트 및 앱 콘텐츠를 직접 공유할 수 있습니다. (이를 통해 모바일 인게이지먼트 및 인스톨이 증가함)
  • 원링크 커스텀 어트리뷰션 링크를 대량으로 빠르게 생성합니다.
    참고: 추천 링크에 대해서는 사용자 초대 어트리뷰션 문서를 참조하세요.

 예시

식품 배달 기업, Feed Me에서 기존 회원 고객에게 SMS 문자 메시지로 개인화된 링크를 전송하여 Feed Me 앱을 다운로드하고 바나나를 구매하도록 마케팅 하고자 합니다. Feed Me는 원링크 REST API를 사용해 고객의 국가, 신원, 바나나 세일 정보를 포함한 커스텀 원링크 URL을 생성할 수 있습니다.

사용자의 원링크 API 쿼리 수 제한은 계정 유형에 따라 다릅니다. 원링크 API 대시보드에서 생성한 쿼리 수와 남아 있는 쿼리 수를 확인할 수 있습니다. 

고객 성공 매니저에 문의하여 API 쿼리 제한을 늘릴 수 있습니다.  

설정

원링크 API 설정하려면:

  1. 원링크 템플릿을 생성하세요.
  2. 원링크 템플릿 ID를 복사합니다. 

  3. 원링크 API 토큰을 복사합니다. 보안을 위해 “관리자” 사용자가 API 키를 가져와야 하며 계정 사용자는 접근 권한이 없습니다. 
  4. 개발자에게 원링크 ID와 원링크 API 토큰을 제공합니다.
  5. 개발자에게 개발 허브 지침을 따르도록 안내하세요.

대시보드

원링크 API 대시보드는일일, 월간, 3개월 API 사용량을 표시합니다.

원링크 API 대시보드를 보려면

앱스플라이어 플랫폼의 사이드 메뉴에서 Engage > 원링크 API를 선택합니다.

특징 및 제약 사항

특징

비고

API 할당량 제한

  • 원링크 API를 사용하여 원링크 링크를 생성, 편집 또는 삭제할 수 있는 한도는 계정당 월(UTC 시간대) 750만 개입니다.
  • 이 한도를 초과한 이후에 발생하는 요청은 처리되지 않으며 링크가 생성되지 않습니다. 한도 초과 후 API를 호출할 경우, 오류 상태 코드 429와 함께 “월 한도 초과"라는 메시지가 뜹니다.
  • 사용량/잔여량 정보는 원링크 API 대시보드에 표시됩니다. 

호출 제한

  • 기준 시간 내 API 최대 호출 횟수는 초당 500회(분당 30,000회)입니다.
  • 초당 500건의 호출(분당 30000건)을 초과하는 모든 호출은 처리되지 않으며 링크가 생성되지 않습니다. 기준 시간 내 최대 호출 횟수를 초과한 뒤의 API 호출을 할 경우, "Rate limit exceeded"라는 메시지와 함께 오류 상태 코드 429를 수신하게 됩니다.

링크 가시성

  • API를 통해 작성된 링크는 앱스플라이어 대시보드의 원링크 커스텀 링크 목록에 나타나지 않습니다.
  • 모범 사례: API로 생성한 링크를 로컬에 표로 저장하여 향후 필요시 사용하세요.

TTL 

  • 원링크 API로 생성된 원링크 짧은 URL의 기본 유효 기간(TTL)은 31일입니다. 링크를 클릭할 때마다 유효 기간이 31일씩 늘어납니다. TTL이 만료된 링크를 클릭해도 원링크 기본 구성에서 정의된대로 작동되지만 어트리뷰션으로 집계되지는 않습니다.
    • TTL이 만료된 후 원링크의 단축 URL이 삭제되는 데 최대 48시간이 걸릴 수 있습니다.
  • 최대 TTL은 31일입니다. 31일을 초과하는 모든 TTL 값은 TTL 기본값인 31일로 대체됩니다.
  • 파라미터 ttl={value} 를 추가하여 TTL 기본값을 일, 시간 또는 분 단위로 변경할 수 있습니다. 예를 들어, ttl=7d, ttl=12h, 혹은 ttl=10m 로 설정 가능합니다.
  • TTL 값을 구체적으로 변경하려면 업데이트 요청을 보낼 수 있습니다. 업데이트 요청을 하시면 (기존 링크에 대한) TTL이 요청서 본문에 정의된대로 재설정됩니다.
    • 이는 TTL이 대체된다는 것을 의미합니다. 예를 들어 현재 TTL이 29일인 링크를 TTL 2일로 업데이트를 요청하면 TTL = 2d (TTL = 31d가 아님)로 변경됩니다.
    • TTL 업데이트 요청으로 어트리뷰션 링크의 수명을 연장할 수 있습니다. 예를 들어, 현재 잔여 유효 기간이 20일 남은 링크에 대해 TTL을 31일로 업데이트하도록 요청했으나 5일이 경과되면 TTL은 업데이트 시점에 31일이 됩니다.
  • 링크 TTL이 자동으로 연장되지 않도록 하려면, 링크에 파라미터renew_ttl=false를 추가하세요. 이 파라미터의 값은 true (기본값) 또는 false인 boolean입니다.
  • 파라미터 renew_ttl 는 실제 URL에 표시되지 않습니다.

특수 문자

특수 문자를 API 생성 링크에 사용하는 경우 다음 문자를 인코딩해야 합니다. ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, /
이러한 문자를 인코딩하지 않으면 공백으로 바뀌고 링크와 링크의 기능이 중단될 수 있습니다.


참고: 다음 3개 매개변수는 링크를 클릭해도 디코딩되지 않으며, 인코딩된 상태로 유지됩니다.

  • af_dp
  • deep_link_value
  • deep_link_sub1

페이로드

페이로드의 쿼리 문자열은 2,048자를 초과할 수 없습니다.

URL ID

URL ID(또는 숏링크 ID)를 편집하여 캠페인 콘텐츠를 강조할 수 있습니다. 예시: https://myapp.onelink.me/abc123/apples. URL ID는 50자를 초과할 수 없으며 문자와 숫자를 조합할 수 있습니다. 기본값은 8자입니다.

참고:

  • 현재 ID가 사용되고 있지 않은 경우에만 URL ID를 편집할 수 있습니다.
  • URL ID가 이미 사용 중이면 링크를 생성할 수 없고, 오류 응답(400)이 반환됩니다. 앱 소유주와 개발자는 이러한 이벤트가 발생할 경우 어떻게 처리할지 미리 결정하고 구현해야 합니다.
  • 호출이 실패하더라도 월간 API 할당량이 소진됩니다.