adjust-icon

딥링크 생성기 API

딥링크 생성기 API를 사용하여 앱에 대한 긴/단축 딥링크를 개별 또는 일괄로 생성할 수 있습니다. 이러한 맞춤형 딥링크는 다양한 플랫폼에서 사용자 경험을 향상시킵니다.

시작에 앞서

시작하기 전에 알아야 할 사항은 다음과 같습니다.

가용성

  • 딥링크 생성기 API에 액세스하려면 TrueLink Core 또는 Enterprise 패키지를 사용해야 합니다.
  • 딥링크 생성기 API를 사용하여 생성된 링크는 Campaign Lab 에 표시되지 않습니다.
  • 딥링크 생성기 API를 사용하여 생성된 단축 링크의 TTL(time-to-live)은 120일입니다.

요구 사항

인증

캠페인 API는 인증을 위해 베어러 토큰 을 사용합니다. 반드시 캠페인 API에 대한 각 요청과 함께 Authorization 헤더에 Adjust API 토큰을 포함해야 합니다.

Single Sign-On (SSO)를 활성화한 경우, Adjust 담당자에게 연락하거나 support@adjust.com 으로 이메일을 보내 API를 찾는 데 도움을 받으시기 바랍니다.

비 SSO 계정의 경우, API는 사용자의 프로필 에서 확인하실 수 있습니다. Adjust API 토큰을 확인하려면 다음 단계를 따르시기 바랍니다.

  1. 계정(사용자) 아이콘을 선택합니다.
  2. 계정 설정 을 선택합니다.
  3. 내 프로필 탭을 선택합니다.
  4. API 토큰 은 사용자 세부 사항 과 함께 표시됩니다. 시스템 클립보드에 토큰을 복사하기 위해 복사를 선택합니다.

Adjust API 토큰 재설정

Adjust API 토큰은 언제든지 재설정할 수 있습니다. 토큰을 재설정하면 이전의 토큰은 무효화됩니다. Adjust API 토큰을 재설정한 경우 기존 토큰이 사용되는 모든 곳에서 교체해야 합니다. 무효화된 토큰에 대한 요청은 Adjust에 의해 거부됩니다.

Adjust API 토큰 재설정

  1. 계정(사용자) 아이콘을 선택합니다.
  2. 계정 설정 을 선택합니다.
  3. 내 프로필 탭을 선택합니다.
  4. API 토큰 은 사용자 세부 사항 과 함께 표시됩니다.
  5. API 토큰 재설정 을 선택합니다.
  6. 모달에 계정 비밀번호를 입력한 후 API 토큰 재설정을 위해 재설정 을 선택합니다. 화면 우측 상단에 확인 메시지가 나타납니다.
  7. 시스템 클립보드에 API 토큰 을 복사하기 위해 복사를 선택합니다.

파라미터

파라미터데이터 유형In설명
adjust_auth_tokenString헤더Adjust API 토큰
link_tokenStringBody커스텀 링크의 링크 토큰. 결합된 링크에서 딥링크를 생성하는 경우, Campaign Lab에서 결합된 커스텀 링크로부터의 올바른 링크 토큰을 사용해야 합니다.
shorten_urlBooleanBody링크 단축 여부. 링크는 기본 설정에 따라 단축되지 않습니다. 기본값 - false
campaignString 또는 nullBody캠페인의 이름
adgroupString 또는 nullBody광고그룹의 이름
creativeString 또는 nullBody크리에이티브의 이름
deep_link_pathStringBody사용자가 이동되는 인앱 목적지를 지정합니다. 단일 플랫폼 앱에 사용하시기 바랍니다.
ios_deep_link_pathStringBody사용자가 이동되는 iOS 인앱 목적지를 지정합니다. 멀티 플랫폼 iOS 앱 또는 복합 링크에 사용하시기 바랍니다.
android_deep_link_pathStringBody사용자가 이동되는 Android 인앱 목적지를 지정합니다. 멀티 플랫폼 Android 앱 또는 복합 링크에 사용하시기 바랍니다.
fallbackStringBody오프 플랫폼 사용자를 보내는 랜딩 페이지. 폴백 URL을 지정할 때 macOS 사용자에 대해 redirect_macos 를 지정하는 것을 권장합니다.
redirect_macosStringBodymacOS에 대한 Adjust의 디폴트 리다이렉트를 오버라이드하기 위한 리다이렉트 URL. fallback 를 지정할 때, macOS 사용자를 위해 이 파라미터를 지정하는 것을 권장합니다.
labelStringBody링크에 커스텀 데이터를 추가합니다. 이 파라미터를 사용하여 사용자가 앱에서 짧은 링크를 공유할 때 자동으로 입력되는 고유한 사용자 리퍼러 ID 를 추가할 수 있습니다.
og_titleStringBody링크의 소셜 공유 미리보기 제목.
og_descriptionStringBody링크의 소셜 공유 미리보기에 대한 설명.
og_imageStringBody링크의 소셜 공유 미리보기를 위한 최소 200 x 200 픽셀 크기의 JPG 또는 PNG 이미지 URL.

POST 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 생성합니다.

엔드포인트

https://automate.adjust.com/engage/deep-links

예

단일 플랫폼 앱

요청 - cURL
curl --location 'https://automate.adjust.com/engage/deep-links' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
     "link_token": "1c52mluz",
     "redirect": "https://example.com/redirect",
     "fallback": "https://example.com/fallback",
     "deep_link_path": "/custom-path",
     "shorten_url": true
   }'
응답
{"url": "https://insights.go.link/fryYl"}

멀티 플랫폼 앱

요청 - cURL
curl --location 'https://automate.adjust.com/engage/deep-links' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
     "link_token": "2d41nkvy",
     "redirect": "https://example.com/redirect",
     "fallback": "https://example.com/fallback",
     "android_deep_link_path": "/custom-path",
     "redirect_macos": "https://www.example.com/redirectmacos",
     "shorten_url": true
   }'
응답
{ "url": "https://insights.go.link/jlbKj" }

복합 링크

딥링크 생성기 API를 사용하여 딥링크를 생성하기 전에 Campaign Lab에서 복합 커스텀 링크 를 생성해야 합니다.

요청 - cURL
curl --location 'https://automate.adjust.com/engage/deep-links' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
     "link_token": "1c2n7ybx_1cjet4nl",
     "redirect": "https://example.com/redirect",
     "fallback": "https://example.com/fallback",
     "ios_deep_link_path": "/custom-path-ios",
     "android_deep_link_path": "/custom-path-android",
     "redirect_macos": "https://www.example.com/redirectmacos",
     "shorten_url": true
   }'
응답
{"url": "https://insights.go.link/6JtQx"}

POST 요청을 전송하여 단일 또는 멀티 플랫폼 앱에 대해 긴/단축 딥링크를 일괄 생성합니다.

엔드포인트

https://automate.adjust.com/engage/deep-links/bulk

예

요청 - cURL
curl --location 'https://automate.adjust.com/engage/deep-links/bulk' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
"data": [
    {
    "link_token": "1doptv0c",
    "redirect": "https://example.com/redirect",
    "fallback": "https://example.com/fallback",
    "campaign": "custom-campaign",
    "shorten_url": true
    },
    {
      "link_token": "1df3xslh_1dsykkaa",
      "redirect": "https://example.com/redirect",
      "fallback": "https://example.com/fallback",
      "ios_deep_link_path": "/custom-path-ios",
      "android_deep_link_path": "/custom-path-android",
      "shorten_url": true
    },
    {
      "link_token": "1dzwtdjt",
      "redirect": "https://example.com/redirect",
      "fallback": "https://example.com/fallback",
      "android_deep_link_path": "/custom-path",
      "shorten_url": true
    }
  ]
}'
응답
{
   "data": [
      {
         "url": "https://kapp.go.link/4IlkC"
      },
      {
         "url": "https://kapp.go.link/6KnoE"
      },
      {
         "url": "https://insights.go.link/5JmnD"
      }
   ]
}

PUT 요청을 전송하여 딥링크의 기존 단축 링크 토큰을 긴 링크로 업데이트합니다.

엔드포인트

https://automate.adjust.com/engage/deep-links/{short_token}

예

요청 - cURL
curl --location --request PUT 'https://automate.adjust.com/engage/deep-links/4IlkC' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer adjustApiToken' \
--data '{
  "link_token": "1doptv0c",
  "redirect": "https://example.com/new-redirect",
  "fallback": "https://example.com/new-fallback",
  "deep_link_path": "/new-custom-path"
}'
응답
204 No Content