OneLink API

요약: 원링크(OneLink) API는 SMS 문자메시지와 다른 경로를 통해 대규모 캠페인에서 개인화된 링크를 생성하여 최종 사용자를 인게이지하고 온드 미디어를 활용하는 데 도움을 줍니다. 광고주와 개발사가 같이 구현해야 합니다.

OneLink API

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

  • 자동으로 사용자정의된 파라미터를 사용해 원링크 단축 URL을 생성시작업데이트삭제합니다. 
    파라미터는 다음 중 하나일 수 있습니다.
    • 미디어소스, 캠페인, 광고 세트 같은 마케팅 노력의 측정 및 모니터링에 사용되는 어트리뷰션 관련 파라미터.
    • 관련 링크에서 앱을 여는 경우 사용자정의 사용자 경험을 설정할 수 있도록 개인화된 파라미터. 파라미터로 사용자정의 인앱 콘텐츠를 사용자에게 보낼 수 있습니다(예: 특정 제품 페이지, 쿠폰 코드, 프로모션).
  • 모바일 사용자에게 웹사이트 및 앱 콘텐츠를 직접 공유할 수 있습니다(이를 통해 모바일 인게이지먼트 및 인스톨이 증가함).
  • 많은 수의 원링크 어트리뷰션 사용자정의 링크를 즉시 생성합니다.
    일러두기: 추천 링크는 사용자 초대 어트리뷰션 문서를 참조하십시오. 
  • 원링크 URL을 사용자의 브랜드로 맞춤 설정. URL을 생성할 때, 원링크 대신 브랜드 도메인을 가진다는 의미입니다.

 예

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

절차

원링크 API 설정:

  1. 원링크 템플릿 생성.
  2. 원링크 ID 기록. 

  3. 원링크 API 키 기록: 계정 관리자가 API 키를 확인해야 합니다. 팀 멤버는 API 키에 접근 권한이 없습니다. 
    • 앱스플라이어 대시보드에서 연동 > API 액세스로 이동하고 원링크 API 섹션까지 내려갑니다.
    • 원링크 API 키가 관리자용이 아니라면 필요한 패키지를 가지고 있지 않다는 의미이며, CMS로 문의해야 합니다.  

      OL_API_key.png

  4. 원링크 ID와 원링크 API 키를 개발사에 제공합니다.
  5. 개발사가 개발 허브 지침을 따르도록 하세요.

제한 사항

제약 사항

참고

API 횟수

  • API를 통해 원링크 어트리뷰션 링크를 생성하는 횟수 제한은 일별, 계정별로 250,000회입니다.
  • 250,000회를 초과해 제공되지 않고 링크가 생성되지 않은 다음 생성한 모든 요청은 API 호출 시 "제한된 한계를 초과하였습니다" 메시지와 에러 상태 코드 429를 받게 됩니다.
  • 사용/남은 횟수 제한에 관련된 정보는 현재 사용할 수 없습니다. 

사용자정의 링크 가시성

  • 이 API를 통해 작성된 링크는 앱스플라이어 대시보드의 원링크 커스텀 링크 목록에 나타나지 않습니다.
  • 현재 API를 사용하여 생성한 모든 원링크를 나열하는 API는 없습니다.
  • 모범 사례: 로컬 표에서 API 생성 링크를 저장하면 향후 목적에 따라 링크에 액세스할 수 있습니다. 

TTL 

  • API에 의해 생성된 각 원링크 어트리뷰션 링크는 31일의 기본 TTL(Time to Live) 기간을 가집니다. 31일이 지나면, 해당 어트리뷰션 링크 기록은 시스템에서 삭제됩니다. TTL이 만료된 링크를 클릭해도 여전히 원링크 기본 설정에서 정의된 동작이 기본값으로 설정되지만, 어트리뷰션이 작동하지는 않습니다.
  • 최대 TTL은 31일 입니다. 31일을 초과하는 모든 TTL은 기본 TTL인 31일로 대체됩니다.
  • TTL 값은 일자(기본값) 또는 분, 시간으로 지정될 수 있습니다(예: 10m, 20h, 14d).
  • 업데이트 요청을 보내서 TTL을 특정할 수 있습니다. 모든 업데이트 요청은 TTL(기존 링크의 경우)을 요청 본문에 있는 특정한 TTL로 리셋합니다.
    • TTL은 대체할 수 있지만 확장되지 않습니다. 예: 현재 TTL 29d인 링크의 경우 TTL 2d 요청을 업데이트하면 TTL = 2d(TTL = 31d가 아님)로 변경됩니다. 

 

도움이 되었습니까?