딥링크 생성기 API

딥링크 생성기(DLG) API를 사용하여 Adjust 딥링크를 프로그래밍 방식으로 생성하고 관리할 수 있습니다. Adjust 대시보드에서 수동으로 링크를 생성하는 대신 API를 사용하여 단일 또는 대량 링크 생성을 지원하는 유연하고 확장 가능한 링크 생성 워크플로우를 구축할 수 있습니다.

• 수동 워크플로우가 아닌 API를 통한 링크 생성 자동화로 링크 생성 확장
• 딥링크 생성을 CRM 시스템이나 캠페인 관리 플랫폼 등의 기존 툴에 연동
• 짧은 링크 또는 긴 링크를 개별 또는 일괄로 생성 및 관리
• 내부 사용 사례에 대한 커스텀 링크 생성 대시보드 또는 스크립트 구축

기능

DLG API는 Adjust 딥링크 생성기의 기능을 모방하여 링크 생성에 대한 프로그래매틱 제어를 지원합니다. 이를 통해 다음이 가능합니다.

• 단일 요청으로 하나 또는 여러 개의 딥링크 생성
• 캠페인의 필요에 따라 짧은 링크 또는 긴 링크 생성
• 기존의 짧은 링크 토큰 업데이트
• Adjust의 자동화 엔드포인트에 직접 연결할 수 있는 툴이나 워크플로우 구축

API를 사용하면 팀에서 반복적인 링크 생성 과정을 자동화하고, 캠페인 측정의 정확성과 일관성을 유지할 수 있습니다.

사용 사례

솔루션 작동 방식

DLG API는 HTTPS 요청을 통해 Adjust 자동화 엔드포인트를 사용합니다. 모든 콜은 기존 Adjust API 토큰을 사용하여 승인됩니다.

엔드포인트 개요:

• 단일 딥링크 생성: POST https://automate.adjust.com/engage/deep-links
• 딥링크 일괄 생성: POST https://automate.adjust.com/engage/deep-links/bulk
• 단축 링크 토큰 업데이트: PUT https://automate.adjust.com/engage/deep-links/{short_token}
• 단축 링크 데이터 조회: GET https://automate.adjust.com/engage/deep-links/short-link?short_token={short_token}&app_token={app_token}

시작하기

요구 사항

• TrueLink Core 또는 TrueLink Enterprise 패키지
• iOS 및 Android용 브랜드 도메인
• 딥링크 생성기 API 액세스가 가능한 Adjust API 토큰

설정 요약

1. iOS 및 Android용 브랜드 도메인을 구성합니다.
2. Adjust API 토큰과 링크 토큰을 획득합니다.
3. Adjust 개발자 문서에 따라 API 콜을 빌드하고 테스트합니다.
4. 자동화 스크립트 또는 매크로를 연동하여 대규모로 링크를 생성합니다.

자세한 시작 방법은 딥링크 생성기 API와 관련한 공식 Adjust 개발자 문서 가이드를 참조하시기 바랍니다.

모범 사례

• 단축 링크 해석과의 호환성을 위해 Adjust SDK를 최신 버전으로 유지합니다.
• 대규모 캠페인의 경우 일괄 엔드포인트를 사용하여 속도 제한 문제(초당 요청 최대 200개) 방지합니다.
• 캠페인 메타데이터를 중앙에 저장하고 매크로나 스크립트를 통해 링크 생성을 자동화합니다.
• API 응답을 검증하고 실패한 요청을 재시도합니다.
• 일관된 리다이렉트를 위해 두 플랫폼 모두에서 하나의 브랜드 도메인을 사용합니다.
• API 토큰은 비밀로 유지하고, 보안을 위해 주기적으로 교체합니다.

사용량 보고 및 모니터링

딥링크 생성기 API는 생성할 수 있는 단축 링크 수에 한도가 적용되며, Adjust 대시보드와 API 응답을 통해 사용량을 모니터링할 수 있습니다.

단축 링크 할당량

• 단축 링크 한도는 계정 수준에서 적용됩니다.
• 할당량 한도는 생성된 고유한 단축 토큰의 수에 기반합니다.
• 동일한 요청은 기존 링크를 반환하며, 사용량을 늘리지 않습니다.

한도 계산

할당량은 다음에 대해서만 적용됩니다.

• API를 통해 생성된 단축 링크

다음의 경우에는 할당량이 적용되지 않습니다.

• 긴 링크
• 대시보드를 통해 생성된 단축 링크

Adjust 대시보드에서 사용량 확인

Adjust Suite에서 사용량 데이터를 확인할 수 있습니다.

1. 계정 설정 으로 이동합니다.
2. 요금제 & 사용량 을 선택합니다.

이 섹션은 다음을 표시합니다.

• 총 단축 링크 할당량
• 남은 단축 링크 수
• 계약 상세 내용

Datascape에서 사용량 데이터 확인 및 날짜 범위 변경, 앱별 사용량 데이터를 확인하려면 이 다이렉트 링크를 사용하실 수 있습니다.

API 헤더를 통한 사용량 확인

각 API 응답은 할당량과 계약 정보가 포함된 헤더를 포함합니다. API 페이로드 구조에 대한 자세한 내용은 개발자 허브의 딥링크 생성기 문서를 참조하시기 바랍니다.

다음은 헤더입니다.

x-shortlink-quota-limit
x-shortlink-quota-remaining
x-contract-status
x-contract-start-date
x-contract-end-date