링크 생성 엔드포인트

Avatar
Product Team
Updated

링크 생성 엔드포인트

쿼리 매개변수

매개변수 설명 파트너 링크 참고 커스텀 링크 참고
app_id 링크를 생성하려는 앱의 ID. 앱 목록을 확인하려면 Get Apps 엔드포인트를 사용하세요. 필수 필수
link_type "partner" 또는 "custom" (파트너 링크와 커스텀 링크 비교 참고). 필수 필수
partner_id 링크를 생성하려는 파트너 네트워크의 ID. 특정 앱에 대해 구성된 파트너 목록을 확인하려면 Get Configured Partners 엔드포인트를 사용하세요. 필수
source_name "crosspromo", "email", "sms", "social", "affiliates" 또는 "influencers" 중 하나를 지정합니다.
필수
tracking_link_name Singular 리포트에서 나중에 식별할 수 있도록 Singular 링크에 부여하는 이름입니다. 대부분의 조직은 캠페인 이름 또는 캠페인 이름의 변형을 사용합니다. tracking_link_name은 Singular 리포트에서 "Tracker Name"으로 표시됩니다. 필수 필수
link_dns_zone Singular 추적 링크는 다음 구조를 가집니다: https://[SUBDOMAIN].[DNS_ZONE]/[PARAMETERS] DNS 존은 "sng.link"입니다. 필수 필수
link_subdomain Singular 추적 링크는 다음 구조를 가지며, [SUBDOMAIN]은 조직에서 선택합니다: https://[SUBDOMAIN].[DNS_ZONE]/[PARAMETERS] 조직에 대해 구성된 서브도메인 목록은 Get Link Domains를 호출하세요. 필수 필수
destination_fallback_url 딥 링크가 실패할 경우 사용자를 이동시킬 목적지입니다. 일반적으로 사용자가 앱 광고를 클릭하면 딥 링크는 앱 내부의 특정 화면으로 이동시킵니다. 그러나 사용자가 아직 앱을 설치하지 않은 경우 앱을 다운로드할 수 있도록 앱 스토어로 리디렉션해야 합니다. 필수 필수
android_redirection

Android 기기에서 링크가 어디로 이동할지 지정하는 매개변수가 포함된 객체:

  • app_site_id
  • destination_url
  • destination_deeplink_url (선택 사항, 기본값 null)
  • destination_deferred_deeplink_url (선택 사항, 기본값 null)

참고: android_redirection 또는 ios_redirection 중 하나는 반드시 지정해야 합니다. 네트워크 파트너가 하나의 Singular 링크에서 여러 OS를 허용하는 경우에만 두 가지 모두 지정할 수 있습니다.

필수 필수
ios_redirection

iOS 기기에서 링크가 어디로 이동할지 지정하는 매개변수가 포함된 객체:

  • app_site_id
  • destination_url
  • destination_deeplink_url (선택 사항, 기본값 null)
  • destination_deferred_deeplink_url (선택 사항, 기본값 null)

참고: android_redirection 또는 ios_redirection 중 하나는 반드시 지정해야 합니다. 네트워크 파트너가 하나의 Singular 링크에서 여러 OS를 허용하는 경우에만 두 가지 모두 지정할 수 있습니다.

필수 필수
enable_reengagement 이 링크를 리인게이지먼트 캠페인에 속하는 것으로 표시하려면 true로 설정합니다 (리인게이지먼트 FAQ 참고). 선택 사항. 모든 파트너가 이 옵션을 지원하는 것은 아닙니다. 특정 파트너가 지원하는 항목은 Get All Partners 쿼리를 사용하고 파트너 ID를 지정하여 확인할 수 있습니다. 선택 사항. 리인게이지먼트는 클릭에 대해 지원되며 딥 링크 리디렉션 구성이 필요합니다.
click_deterministic_window

결정론적 어트리뷰션을 사용한 클릭스루의 어트리뷰션 윈도우. 0~30일을 지정할 수 있습니다.

선택 사항. 파트너 링크의 경우 , 기본값은 Partner Configuration 페이지에서 각 앱 사이트 및 파트너에 대해 설정됩니다. 선택 사항. 커스텀 링크의 경우 , 기본값은 7일입니다.
click_probabilistic_window

확률론적 어트리뷰션을 사용한 클릭스루의 어트리뷰션 윈도우. 0~24시간을 지정할 수 있습니다.

선택 사항. 파트너 링크의 경우 , 기본값은 Partner Configuration 페이지에서 각 앱 사이트 및 파트너에 대해 설정됩니다. 선택 사항. 커스텀 링크의 경우 , 기본값은 24시간입니다.
View_deterministic_window

결정론적 어트리뷰션을 사용한 뷰스루(노출)의 어트리뷰션 윈도우. 0~24시간을 지정할 수 있습니다. 선택 사항. 파트너 링크의 경우 , 기본값은 Partner Configuration 페이지에서 각 앱 사이트 및 파트너에 대해 설정됩니다. 선택 사항. 커스텀 링크의 경우 , 기본값은 24시간입니다.
view_probabilistic_window

확률론적 어트리뷰션을 사용한 뷰스루(노출)의 어트리뷰션 윈도우. 기본값은 8시간입니다. 0~24시간을 지정할 수 있습니다. 선택 사항 선택 사항
click_reengagement_window

리인게이지먼트 캠페인에서 클릭스루의 어트리뷰션 윈도우. enable_reengagement가 true로 설정된 경우에만 관련이 있습니다. 0~30일을 지정할 수 있습니다. 선택 사항. 파트너 링크의 경우 , 파트너별 기본값이 설정되어 있지만 다른 값을 지정할 수 있습니다. 선택 사항. 커스텀 링크의 경우 , 기본값은 7일입니다.
enable_ctv

CTV 캠페인을 지원하려면 true로 설정합니다. 이는 네트워크 파트너가 CTV 캠페인을 지원하는 경우에만 관련이 있습니다. 파트너에 따라 enable_ctv의 값은 기본적으로 true일 수 있습니다. 선택 사항 선택 사항
og_tags 링크가 소셜 랜딩 페이지 미리보기를 표시할 수 있도록 합니다.
값 예시
{
"title": "my Title",
"description": "my Description",
"image_url": "https://www.wikipedia.org/portal/wikipedia.org/assets/img/Wikipedia-logo-v2@2x.png"
}

모든 필드에 값이 있어야 합니다. 		사용 불가 선택 사항
disable_short_link_parameters_overrides true로 설정하면, 기본 링크에 이미 설정된 리디렉션 및 딥 링크 매개변수는 클릭 시 짧은 링크에 추가하여 재정의할 수 없습니다. 기본 링크에 설정되지 않은 매개변수는 여전히 새 값으로 추가할 수 있습니다. false(기본값)인 경우, 추가된 매개변수가 저장된 링크 설정을 재정의할 수 있습니다. 자세한 내용은 짧은 링크에 대한 매개변수 재정의 비활성화를 참고하세요. 사용 불가 선택 사항. 기본값: false. 링크 단축이 활성화된 경우에만 적용됩니다.

출력 매개변수

Singular 링크가 성공적으로 생성된 경우 응답에는 다음 매개변수가 포함됩니다:

매개변수 설명
tracking_link_id 추적 링크의 내부 ID. 추적 링크 URL에도 포함됩니다.
tracking_link_name 추적 링크에 부여한 이름.
click_tracking_link 클릭스루 캠페인용 추적 링크 URL. URL에는 링크가 제공될 때 파트너 네트워크에서 실제 값으로 대체되는 매크로가 포함됩니다.
impression_tracking_link 지원되는 경우 뷰스루 캠페인용 추적 링크 URL.
short_link

링크의 단축 URL 버전 (커스텀 링크 전용).

참고: 이 링크는 리퍼럴 트래킹 서비스가 아닌 단축 링크 서비스를 사용하여 생성됩니다. 이러한 단축 링크는 만료되지 않습니다.

위 예시에서 단축 링크는 "https://prod_test.sng.link/D75p1/mbm7/961w"이며, 여기서 "961w"는 단축 링크 ID입니다.

disable_short_link_parameters_overrides 생성된 링크에 대한 이 설정의 값. true는 기본 링크에 이미 설정된 리디렉션 및 딥 링크 매개변수가 잠겨 있어 재정의할 수 없음을 의미하며, false(기본값)는 짧은 링크에 추가하여 재정의할 수 있음을 의미합니다.
extra_info 링크가 성공적으로 생성되었더라도 Singular에는 중요 및 설명이 있을 수 있습니다. 이는 extra_info에 수집됩니다.