딥링크 생성

Overview

Journeys(웹-투-앱 스마트배너), Universal Ads(광고 어트리뷰션), Quick Link 및 Universal Email(이메일-투-앱)에서 딥링크(Deep Link)를 사용할 수 있습니다. 이 가이드에서는 기본 및 맞춤형 링크 동작을 구성하는 방법과 숏링크 및 롱링크를 만드는 방법을 안내합니다.

기본 링크 동작

앱이 설치되지 않은 경우

  • Branch 딥링크를 유저가 클릭

  • 디바이스가 폴백 navigates(예: 앱 스토어 또는 웹사이트)

    • 지원되는 앱 스토어:
      • 애플 앱 스토어
      • 구글 플레이
      • Huawei 앱 스토어
      • Vivo 앱 스토어
      • Oppo 앱 스토어
      • Baidu Mobile Assistant
  • 유저가 앱을 설치 및 오픈

  • Branch는 딥링크 data를 앱으로 전달합니다

앱이 설치된 경우

  • Branch 딥링크를 유저가 클릭

  • 디바이스가 앱을 opens 하거나 예상 링크 동작에 따라 이동

  • Branch는 딥링크 data를 앱으로 전달합니다

예상 링크 동작

Mobile

  • 예상 링크 동작은 앱이 딥링크를 지원하는지 여부에 따라 달라집니다.

  • *Able to force app open $uri_redirect_mode 사용 또는 Deepview 활성화 시 강제 딥링크 가능

Platform

iOS

Android

Facebook Newsfeed

폴백; Facebook 앱 링크를 통해 딥 링크 가능

Facebook Browser

Facebook Messenger

폴백; Facebook 앱 링크를 통해 딥 링크 가능

Facebook Messenger Browser

Instagram Profile

폴백; 다음을 사용하여 앱을 강제로 오픈할 수 있습니다. $uri_redirect_mode=2

Instagram Browser

Instagram Stories

폴백; 앱을 강제로 오픈할 수 있습니다.

Twitter Feed

폴백; 앱을 강제로 오픈할 수 있습니다. $ios_url 또는 $fallback_url 리디렉션 폴백과 연결된 링크에는 웹사이트에 웹 SDK 2.48.0+ 초기화가 필요합니다.

Twitter Browser

Snap Messages

Snap Stories

폴백; Snap 스토리에서 Branch를 사용하기 위한 맞춤형 지침 검토

Reddit

폴백; 앱 스토어로 폴백하려면 링크에서 $use_https_app_store: true를 사용해야 합니다.

폴백

Pinterest

폴백

폴백

Pinterest Browser

Google+

폴백; 앱 스토어 리다이렉션이 작동하지 않습니다.

폴백

Chrome Browser

Chrome Address Bar

폴백

폴백; 딥링크(Deep Link) 데이터가 앱으로 전달되지 않습니다.

Safari Browser

해당 없음

Safari Address Bar

폴백; Apple에 의해 차단됨

해당 없음

Firefox Browser

폴백

Firefox Address Bar

폴백

UC Browser

해당 없음

Naver Browser

해당 없음

Kakao Browser

해당 없음

Opera Browser

Ghostery Browser

폴백; 쿼리 string을 인코딩해야 합니다($ = %24).

Google Hangouts

폴백; 앱을 강제로 오픈할 수 있습니다.

Samsung SMS

해당 없음

Samsung SMS Browser

해당 없음

Apple iMessage

해당 없음

Apple Business Chat

해당 없음

Slack

앱; Safari로 링크를 오픈하려면 Slack을 구성해야 합니다.

WeChat

폴백; WeChat 폴백 URL 맞춤 설정

폴백; WeChat 폴백 URL 맞춤 설정

WhatsApp

앱; 클릭할 수 있기 위해 app.link에 https/http가 필요합니다.

앱; 클릭할 수 있기 위해 app.link에 https/http가 필요합니다.

LINE

폴백; 앱을 강제로 오픈할 수 있습니다.

Discord

Apple Mail

해당 없음

Gmail

Yahoo Mail

폴백; 앱을 강제로 오픈할 수 있습니다.

TikTok

앱을 홍보하는 광고가 유저를 앱 스토어로 안내합니다.

앱을 홍보하는 광고가 유저를 앱 스토어로 안내합니다.

TikTok

유저를 앱 스토어가 아닌 랜딩 페이지로 안내하는 광고가 인앱 브라우저에서 오픈됩니다.

유저를 앱 스토어가 아닌 랜딩 페이지로 안내하는 광고가 인앱 브라우저에서 오픈됩니다.

데스크탑

  • 예상 링크 동작은 앱이 딥링크를 지원하는지 여부에 따라 달라집니다.

  • 기본적으로 URI scheme을 통해 앱을 실행하고 백그라운드에서 데스크탑으로 리다이렉션하는 폴백을 불러옵니다.

  • *Only launches background desktop web fallbacks 사용 $afterclick_desktop_url

Platform

Mac

Windows

Safari

App; Supports Universal Linking

Firefox

앱*

앱*

Chrome

앱*

앱*

Edge

Internet Explorer

해당 없음

앱*

Slack

App; Supports Universal Linking

커스텀 링크 동작

링크에서 앱으로 데이터 전달

  • 각 딥링크(Deep Link)에 링크 데이터 추가

  • Quick Link에 키 및 해당 값 추가

  • 쿼리 문자열 추가 https://example.app.link/fzmLEhobLD?$custom_data=123&hello=world

특정 URL로 폴백

  • 딥링크(Deep Link)가 어디로 이동하는지 결정

    • 앱이 설치되지 않은 경우

    • [또는] 다른 앱은 링크가 앱 외부에서 딥 링크되지 않도록합니다.

  • 폴백 재정의 (우선 순위 순)

    • 쿼리 문자열 추가 https://example.app.link?$ios_url=https://example.com
    • 링크 데이터 $ios_url = 'https://example.com' 추가(문서)
    • Deep View를 위한 링크 데이터 $ios_deepview = 'deepviewId' 추가(문서)
    • Branch Dashboard에서 전역적으로 Deep View 활성화
    • 링크 데이터 $fallback_url = 'https://example.com' 추가(문서)
    • Branch Dashboard에서 iOS/Android Custom URL 추가
    • Branch Dashboard에서 Default URL ($fallback_url) 추가

앱 대신 웹 오픈

  • 앱이 설치되지 않은 경우
    • 디바이스가 fallback navigates(예: 앱 스토어 또는 웹사이트)
  • 앱이 설치된 경우
    • iOS : Universal Links 를 재정의해야합니다.
      • $web_only = true 추가(문서)
      • 리다이렉션 $ios_url = 'https://google.com' 추가(문서)
      • [또는] 딥 링크에 /e/ 추가
        • 예: https://example.app.link/fzmLEhobLD -> https://example.app.link/e/fzmLEhobLD
    • 안드로이드 : App Links 를 재정의해야합니다.
      • Enable App Links를 선택 취소하고 Branch Dashboard에서 Save를 누릅니다.
      • 리다이렉션 $android_url = 'https://google.com' 추가(문서)
      • $android_deeplink_path = 'random'을 사용하여 손상된 URI 스키마 추가(문서)
  • 링크 도메인에 -web 추가 : 예 : branch.app.link > branch-web.app.link
    • Custom Alias와 함께 사용하면 커스텀 링크 도메인에서 작동하지 않습니다.

소셜 링크 행동

  • OG 태그를 사용하여 Facebook, Twitter, Pinterest, iMessage 등에서 콘텐츠를 미리보기 카드로 표시
    • 기본은 $og_title, $og_description, 및 $og_image_url입니다.
  • Deep View를 사용하여 콘텐츠를 웹사이트로 표시

UTM 동작

❗️

기본적으로 활성화됨

이 기능을 비활성화하려면 Link Settings -> Advance Settings -> Analytics mapping with UTM으로 이동합니다.

imageimage

  • 웹 URL로 리디렉션하면 Branch는 다음 Branch 링크 분석 태그의 값을 UTM 파라미터로 자동으로 전달합니다.
    • ~campaign -> utm_campaign
    • ~channel -> utm_source
    • ~feature -> utm_medium
  • 이는 다음 $fallback_url , $ios_url , $android_url , $desktop_url , $original_url$canonical_url 중 하나를 사용하여 정의된 웹 URL에 적용됩니다.
  • 리디렉션되는 URL에서 이러한 UTM 매개 변수가 이미 검색된 경우 Branch는 이를 덮어 쓰지 않습니다.
  • UTM 파라미터에 대한 자세한 내용은 Google Analytic의 맞춤형 캠페인 문서를 참조하십시오.

딥링크(Deep Link) 만들기

짧은 링크(Short Links)

  • 짧은 링크는 가장 일반적인 딥링크(Deep Link)입니다
  • 하위 도메인을 example.app.link 맞춤 설정하거나 자신의 개인 도메인으로 변경할 수 있습니다 ( links.yoursite.com )
  • 생성하는 중에 단문 코드의 모양을 맞춤형 alias로 맞춤화할 수 있습니다.
    • 별칭은 짧은 문자열 일 수 있습니다. 예 : https://example.app.link/october-sale
    • 또는 전체 링크 경로가 될 수 있습니다. 예: https://example.app.link/product/id1234
  • 단문 링크는 링크 생성 시 링크 데이터를 내부에 캡슐화합니다.
    • 예: 기존 링크 https://example.app.link/fzmLEhobLD
  • 짧은 링크에는 추가 데이터가 추가 될 수 있습니다
    • 예 : 동적 링크 https://example.app.link/fzmLEhobLD?content_id=123
  • 짧은 링크를 만드는 방법
    • Quick Link 생성 및 쉬운 추적을 위해 Quick Link 사용
    • 앱 SDK를 사용하여 앱 내에서 링크 생성 및 공유
    • Web SDK를 사용하여 웹 유저를 앱 유저로 전환하는 데 도움이 되는 링크를 만듭니다.
    • HTTP API를 사용하여 서버에서 프로그래밍 방식으로 링크를 만듭니다.
    • Chrome 확장 프로그램을 사용하여 브라우저에서 링크를 생성합니다.

긴 링크(Long Links)

  • Branch에 대한 네트워크 호출 없이 긴 링크를 만들 수 있습니다
  • 장문 링크는 링크 데이터를 쿼리 string으로 추가해야 합니다. 링크의 모든 URL을 URI 인코딩해야 합니다.
    • 예: 기존 링크 https://example.app.link/fzmLEhobLD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
    • 예 : 동적 링크 https://example.app.link/?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 다음을 사용하는 경우 장문 링크에는 /a/Branch 키가 필요합니다. custom link domain
    • 예: 기존 링크 https://link.example.com/5NPh/p4M09KRLrD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
    • 예 : 동적 링크 https://link.example.com/a/key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Swt?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 다음을 사용하는 경우 장문 링크에는 /a/Branch 키가 필요합니다. bnc.lt
    • 예: 기존 링크 https://bnc.lt/5NPh/p4M09KRLrD?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
    • 예 : 동적 링크 https://bnc.lt/a/key_live_kaFuWw8WvY7yn1d9yYiP8gokwqjV0Swt?foo=bar&baz=456&$fallback_url=https%3A%2F%2Fbranch.io%2F
  • 동적 링크에 tags를 추가할 때 각 태그를 개별적으로 입력하십시오.

딥링크(Deep Link) 구성

Branch 링크에 자체적인 key-value 파라미터를 자유롭게 추가할 수 있습니다. 이러한 파라미터는 Branch SDK를 통해 앱에 전달되지만 일부 키에는 특정 추가 효과가 있습니다.

예약된 접두사

  • Branch는 딥링크(Deep Link) 데이터에 추가 속성을 추가하여 링크를 설명합니다.
접두사Usage
$Branch 예약 키워드
~Branch 분석 데이터
+Branch 추가 값

분석 라벨

  • 이 레이블을 사용하면 딥링크(Deep Link)를 필터링하고 구성할 수 있습니다
기본값Usage
~channel채널을 사용하여 링크가 유저에게 도달하는 경로에 태그를 지정하십시오. 예를 들어, 클릭 수를 추적하고 해당 경로를 통해 개별적으로 설치하는 데 도움이 되도록 'Facebook' 또는 'LinkedIn'로 링크에 태그
~feature링크가 연결될 수 있는 앱의 기능입니다. 예를 들어 추천 프로그램을 구축한 경우 기능 '추천' 링크에 레이블을 지정합니다.
~campaign이 필드를 사용하여 실제 캠페인별로 링크를 구성하십시오. 예를 들어, 새로운 기능이나 제품을 출시했으며 그 주위에 캠페인을 진행하려는 경우
~campaign_id이 필드를 사용하여 실제 캠페인 ID별로 링크를 구성합니다. 예를 들어 새로운 기능이나 제품을 출시하고 이를 중심으로 캠페인을 운영하려는 경우
~customer_campaign라스트 어트리뷰션 터치에서 확인된 고객 캠페인입니다. 클라이언트가 링크에 지정할 수 있습니다.
~stage이를 사용하여 링크가 생성될 때 유저의 진행률 또는 범주를 분류하십시오. 예를 들어, 레벨 1, 레벨 3 및 5에서 초대 시스템에 액세스할 수 있는 경우 이 매개 변수를 사용하여 각 레벨에서 생성된 링크를 구별할 수 있습니다.
~tags무제한 값이 ['string'] 자유 양식 항목입니다. 이를 사용하여 위의 범위 내에 적합하지 않은 레이블로 링크 데이터를 구성하십시오.
~secondary_publisher마지막으로 터치 한 것으로 지정된 보조 게시자. 광고 네트워크에 의해 전달됩니다.
~customer_secondary_publisher라스트 어트리뷰션 터치에서 확인된 하위 퍼블리셔의 ID입니다. 클라이언트가 링크에 지정할 수 있습니다.
~creative_name라스트 어트리뷰션 터치에서 확인된 크리에이티브 이름입니다.
~creative_id라스트 어트리뷰션 터치에서 확인된 크리에이티브 ID입니다.
~ad_set_name라스트 어트리뷰션 터치에서 확인된 광고 세트 이름입니다.
~ad_set_id라스트 어트리뷰션 터치에서 확인된 광고 세트 ID입니다.
~customer_ad_set_name라스트 어트리뷰션 터치에서 확인된 고객 광고 세트 이름입니다. 클라이언트가 링크에 지정할 수 있습니다.
~ad_name라스트 어트리뷰션 터치에서 확인된 광고 이름입니다.
~ad_id라스트 어트리뷰션 터치에서 확인된 광고 ID입니다.
~customer_ad_name라스트 어트리뷰션 터치에서 확인된 고객 광고 이름입니다. 클라이언트가 링크에 지정할 수 있습니다.
~keyword라스트 어트리뷰션 터치에서 확인된 키워드입니다.
~keyword_id마지막 터치의 키워드에 대한 고유 ID
~customer_keyword마지막 터치의 고객 키워드입니다. 클라이언트가 링크에 지정할 수 있습니다.
~placement분석 태그로 설정된 마지막 터치의 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.
~placement_id분석 태그로 설정된 마지막 터치의 게재 위치 ID입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다.
~customer_placement분석 태그로 설정된 마지막 터치의 고객 지정 게재 위치입니다. 디스플레이 캠페인에 광고가 표시되는 실제 앱 또는 웹사이트입니다. 클라이언트가 링크에 지정할 수 있습니다.
~sub_site_name광고가 표시된 사이트에 대한 참조입니다.
~customer_sub_site_name광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다.
  • 이 레이블을 사용하면 단일 링크에 대한 어트리뷰션 윈도우를 유저 정의할 수 있습니다
기본값Usage
$click_install_window_days7클릭 또는 웹에서 앱으로의 자동 리다이렉션과 설치 또는 재설치 사이의 시간입니다.(예: https://branchster.app.link/hpNVE52gxE?$click_install_window_days=3)
$click_session_start_window_days1클릭 또는 웹에서 앱으로의 자동 리다이렉션과 오픈 또는 웹 세션 시작 사이의 시간입니다.(예: https://branchster.app.link/hpNVE52gxE?$click_session_start_window_days=7)
$click_conversion_window_days30클릭 또는 웹에서 앱으로의 자동 리다이렉션과 전환 이벤트 사이의 시간입니다. 전환 이벤트에는 상거래 이벤트(예: 구매, 장바구니에 추가), 모든 맞춤형 이벤트, 페이지 조회 및 콘텐츠 조회와 같은 모든 조회 이벤트가 포함됩니다.(예: https://branchster.app.link/hpNVE52gxE?$click_session_start_window_days=30)
$impression_install_window_days1광고 임프레션과 설치 또는 재설치 사이의 시간입니다.(예: https://branchster.app.link/hpNVE52gxE?$impression_install_window_days=3)
$impression_session_start_window_days1광고 임프레션과 오픈 또는 웹 세션 시작 사이의 시간입니다.(예: https://branchster.app.link/hpNVE52gxE?$impression_session_start_window_days=1)
$impression_conversion_window_days7광고 임프레션과 전환 이벤트 사이의 시간입니다. 전환 이벤트에는 상거래 이벤트(예: 구매, 장바구니에 추가), 모든 맞춤형 이벤트, 페이지 조회 및 콘텐츠 조회와 같은 모든 조회 이벤트가 포함됩니다.(예: https://branchster.app.link/hpNVE52gxE?$impression_session_start_window_days=7)

맞춤형 데이터

  • 앱 내에서 읽을 맞춤형 데이터 전달
Usage
random123모든 key-value pair
custom_datatrue모든 key-value pair
any_value{ 'random': 'dictionary' }모든 key-value pair
look_at[1,2,3,4,5,6]모든 key-value pair
nav_herecontent/123모든 key-value pair

리다이렉션

  • 디바이스 정보에 따라 다른 위치로 이동
  • 탐색 URL은 딥링크(Deep Link)가 아닌 웹사이트 여야합니다
기본값Usage
$fallback_url모든 플랫폼에 대한 리다이렉션 엔드 포인트를 변경하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch는 모든 로봇을 이 URL로 전달하며, 이는 링크에 입력된 모든 OG 태그보다 우선합니다. 시스템 전체 기본 URL (링크 설정에서 설정)
$fallback_url_xx소문자 Alpha-2 국가 코드를 기준으로 모든 플랫폼에 대한 리다이렉션 엔드포인트를 변경합니다. 예를 들어 $fallback_url_de="..."는 독일 딥링크(Deep Link) 클릭을 리다이렉션합니다. 또한 $fallback_url을 국가별 리다이렉션 외에 전역적 리다이렉션으로 작동하도록 설정해야 합니다. 경고: 플랫폼별 리다이렉션(예: $ios_url 또는 $ desktop_url)이 설정되면 국가별 리다이렉션을 무시하게 됩니다. 따라서 국가별 리다이렉션에는 $fallback_url_xx만 사용하고 기타 모든 유저를 포착하려면 $fallback_url을 사용할 것을 권장합니다.
$desktop_url데스크톱 Text-Me-The-App 페이지에서 리다이렉션 엔드포인트 변경(Link Settings에서 설정)
$ios_url앱의 iOS App Store 페이지에 대한 리다이렉션 엔드포인트 변경 (링크 설정에서 설정)
$ios_url_xx소문자 Alpha-2 국가 코드를 기반으로 iOS용 리다이렉션 엔드 포인트를 변경합니다. 예를 들어 $ios_url_de="..."는 독일 딥링크 (Deep Link) 클릭을 리다이렉션합니다. 또한 국가별 리다이렉션 외에도 전역 리다이렉션으로 작동하도록 $ios_url를 설정해야 합니다.
$ipad_urliPad $ios_url 의 리다이렉션 엔드포인트 값 변경
$android_url앱의 Android Play 스토어 페이지에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$android_url_xx소문자 Alpha-2 국가 코드를 기반으로 안드로이드용 리다이렉션 엔드 포인트를 변경합니다. 예를 들어 $android_url_de="..."는 독일 딥링크 (Deep Link) 클릭을 리다이렉션합니다. 또한 국가별 리다이렉션 외에도 전역 리다이렉션으로 작동하도록 $android_url를 설정해야 합니다.
$samsung_urlSamsung 디바이스에서 Samsung Galaxy Store로 리다이렉션합니다. 링크 레벨 제어 전용입니다. 형식은 다음과 같습니다. http://www.samsungapps.com/appquery/appDetail.as?appId=YOUR.PACKAGE.NAME
$windows_phone_urlWindows OS Windows Phone 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$blackberry_urlBlackberry OS BlackBerry 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$fire_urlAmazon Fire OS Fire 기본 URL에 대한 리다이렉션 엔드 포인트 변경 (링크 설정에서 설정)
$ios_wechat_urliOS 디바이스에서 WeChat에 대한 리다이렉션 엔드포인트 $ios_url 값 변경
$android_wechat_urlAndroid 디바이스에서 WeChat에 대한 리다이렉션 엔드 포인트 $android_url 값 변경
$web_onlyfalse앱 대신 $fallback_url을 강제로 오픈
$desktop_web_onlyfalse앱 대신 이 우선순위 순서로 $windows_desktop_url, $mac_desktop_url, $desktop_url또는 $fallback_url 을 강제로 오픈합니다.
$mobile_web_onlyfalse앱 대신 이 우선순위 순서로$ios_url, $android_url또는 $fallback_url 을 강제로 오픈합니다.
$after_click_urlfalseWhen a user returns to the browser after going to the app, take them to this URL. iOS only; Android coming soon
$afterclick_desktop_urlfalseWhen a user on desktop returns to the desktop browser after going to the desktop app, take them to this URL.

강제 리다이렉션

  • Branch 딥링크(Deep Link)를 클릭할 때 다른 앱의 오류 메시지 방지
Usage
$uri_redirect_mode0이것은 유저에게 오류가 발생했을 때 앱을 오픈하려 하지 않는 표준 동작을 발생시키는 기본값입니다.
$uri_redirect_mode1스마트 리다이렉션 모드. 유저가 Branch 페르소나 데이터를 통해 앱을 설치했음을 알 때까지 0과 동일한 동작입니다. 이 경우 URI 스킴이 앱을 열도록합니다.
$uri_redirect_mode2강제 리다이렉션 모드입니다. 앱이 설치되지 않았을 때 오류 메시지가 표시될 위험이 있더라도 항상 앱을 강제로 오픈하려고 시도합니다.
  • OS 레벨 리다이렉션 모드는 $ios_uri_redirect_mode$android_uri_redirect_mode 파라미터를 사용하여 활성화할 수 있습니다.

  • 지원되는 앱

    • Facebook 뉴스피드 iOS
    • Instagram iOS
    • Twitter iOS
    • Safari iOS
    • Firefox iOS 및 Android

딥링킹

  • 디바이스 정보에 따라 다른 위치로 이동
기본값Usage
$deeplink_pathopen?link_click_id=1234모든 플랫폼의 딥링크(Deep Link) 경로를 설정하므로 플랫폼을 통해 활성화할 필요는 없습니다. Branch SDK는 이 매개 변수 집합이 포함된 링크를 받으면 포함된 유저 지정 URI 경로를 자동으로 로드합니다.
$android_deeplink_pathAndroid 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 Android URI 경로를 로드합니다.
$ios_deeplink_pathiOS 앱의 딥링크(Deep Link) 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 iOS URI 경로를 로드합니다.
$ios_nativelinkSet to true to make links route to a NativeLink™ used for enabling deferred deep linking on iOS 15+ & Private Relay
$desktop_deeplink_path데스크톱 앱의 딥링크(Deep Link) 경로를 설정하십시오. 이 매개 변수를 가져와 유저를 적절히 라우팅해야합니다.
$match_duration7200어트리뷰션 윈도우라고도 하는 스냅샷 매칭 타임아웃(앱이 매칭하도록 오픈될 때까지 클릭이 기다리는 시간)을 제어할 수 있습니다. 초 단위로 지정됩니다.
$always_deeplinktrue링크를 항상 모바일 사이트로 돌아가도록 하려면 false로 설정합니다. 유니버설 링크(Universal Links) 또는 Android 앱 링크에는 적용되지 않습니다.
$ios_redirect_timeout750앱 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$android_redirect_timeout750Play 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$custom_sms_text데스크톱 클릭에 대해 SMS 링크 텍스트가 이 링크로 전송되었습니다. 설정의 앱 페이지에 {{ link }}의 텍스트 값을 포함해야 합니다.
$marketing_title딥링크(Deep Link)의 마케팅 제목을 설정하십시오.
$deeplink_no_attribution링크가 해당 링크에 대한 속성 없이 딥링크(Deep Link)만 지원하도록하려면 true로 설정하십시오.

콘텐츠

  • 콘텐츠 속성 처리
기본값Usage
$publicly_indexable1여기서 수정할 수 없습니다. Branch Universal Object에서 설정해야 합니다.
~keyword이 콘텐츠를 검색할 키워드입니다. 사용하려는 키워드로 string 배열을 지정하십시오.
$canonical_identifier이는 Branch가 동일한 항목의 여러 인스턴스에서 중복을 제거하는 데 도움이 되는 콘텐츠의 고유 식별자입니다. 적합한 옵션: 경로가 있는 웹사이트 또는 엔티티에 대한 식별자가 있는 데이터베이스
$content_type존재하는 콘텐츠 유형에 대한 레이블입니다. Apple은 여기에 설명된 대로 균일한 유형의 식별자를 사용할 것을 권장합니다.
$do_not_processfalse이렇게 하면 클릭 트래킹 및 링크 분석 저장이 방지됩니다. 딥링크(Deep Link) 데이터는 링크 클릭에서 앱 오픈까지 계속해서 앱으로 유입됩니다.

Deepview

기본값Usage
$ios_deepviewbranch_defaultiOS에 사용할 deepview 템플릿의 이름
$android_deepviewbranch_defaultAndroid에 사용할 deepview 템플릿의 이름
$desktop_deepviewbranch_default데스크톱에 사용할 deepview 템플릿의 이름
기본값
$ios_passive_deepviewiOS에 사용할 템플릿의 이름branch_default
$android_passive_deepviewAndroid에 사용할 템플릿의 이름branch_default

링크 모양

  • 짧은 링크의 외관을 유저 정의하십시오
기본값Usage
alias없음표준 인코딩된 단문 URL을 대체할 링크 별칭(Alias)을 지정합니다(예: https://example.app.link/aQXXDHaxKF -> https://example.app.link/october-campaign 또는 https://example.app.link/product/id1234). 링크 별칭(Alias)은 앱마다 고유해야 합니다(이미 존재하는 별칭을 생성하면 409 error가 발생합니다). 또한 도메인 다음의 단일 문자 경로 세그먼트는 현재 지원되지 않습니다(/a/, /b/, /c/ 등).

오픈 그래프

  • Facebook 속성 처리
기본값Usage
$og_title대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 제목을 설정합니다.
$og_description대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 설명을 설정하십시오.
$og_image_url대시보드에 설정소셜 미디어 디스플레이에 표시될 링크 이미지를 설정하십시오.
$og_image_width소셜 미디어 디스플레이를 위해 이미지 너비를 픽셀 단위로 설정합니다.
$og_image_height소셜 미디어 디스플레이를 위해 이미지 높이를 픽셀 단위로 설정합니다.
$og_video소셜 미디어 디스플레이에 표시될 동영상을 설정합니다.
$og_url소셜 미디어 디스플레이에 표시될 링크의 기본 URL을 설정하십시오.
$og_type소셜 미디어 디스플레이에 표시될 유저 정의 카드 형식 링크 유형을 설정합니다. Facebook에 딥링크(Deep Link)를 공유할 때는 이 속성을 설정하지 마세요.
$og_redirect(고급, 권장되지 않음) 적절한 태그를 모두 검색하기 위해 소셜 미디어 로봇을 리다이렉션할 맞춤형 URL을 설정합니다.
$og_app_id대시보드에 설정(거의 사용되지 않음) 앱 ID 태그를 설정합니다.

Twitter

  • Twitter 속성 처리
기본값Usage
$twitter_card링크의 Twitter 카드 유형을 설정합니다.(예: player)(Twitter 카드 검사기로 딥링크(Deep Link)를 화이트리스트에 추가해야 함)
$twitter_title대시보드에 설정Twitter 카드의 제목 설정
$twitter_description대시보드에 설정Twitter 카드에 대한 설명 설정
$twitter_image_url대시보드에 설정Twitter 카드의 이미지 URL 설정
$twitter_siteTwitter에 대한 사이트 설정
$twitter_app_country앱 카드의 앱 국가 설정
$twitter_player동영상 플레이어의 URL을 설정합니다. 기본값은 $og_video입니다.
$twitter_player_width플레이어의 너비를 픽셀 단위로 설정
$twitter_player_height플레이어의 높이를 픽셀 단위로 설정

기타 예약된 키

Usage
access_token or AccessTokenBranch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
auth_tokenor AuthTokenBranch에서 딥링크(Deep Link)가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
data최상위 링크 정보를 포함하기 위해 Branch에서 사용합니다. 이 매개 변수가 쿼리 매개 변수를 추가하여 Branch 링크에 추가되면 삭제됩니다. 대시 보드를 통해 수동으로 링크를 만들 때 안전하게 사용할 수 있습니다.

커스텀 태그

  • 커스텀 메타 태그 처리
$custom_meta_tags태그 키 및 값의 유효한 문자열화된 JSON 사전
  • 유효한 사전적 정의: "{"twitter:player:stream": "https://branch.io\"}" . 그러면 다음 메타 태그가 생성됩니다: <meta property="twitter:player:stream" content="https://branch.io" />
  • 대시 보드를 통해 링크를 만들면 사전을 분류할 염려가 없습니다. 자동으로 수행됩니다.
  • apple_touch_icon은 사전의 특수 키입니다. 설정하면 스크랩 된 HTML 페이지에 <link rel="apple-touch-icon" href="<url>" /> 태그가 추가됩니다. iMessage, Safari 책갈피, 슬랙 등에서 미리보기를위한 유저 정의 아이콘을 표시 할 수 있습니다.

Universal Object

  • 앱 연동 내의 Branch Universal Object에 대한 속성
기본값Usage링크 속성
canonicalIdentifier(필수) 이는 Branch가 동일한 항목의 여러 인스턴스에서 중복을 제거하는 데 도움이 되는 콘텐츠의 고유 식별자입니다. 적합한 옵션: 경로가 있는 웹사이트 또는 엔티티에 대한 식별자가 있는 데이터베이스$canonical_identifier
canonicalUrlSEO 목적으로 사용되는 표준 URL$canonical_url
title콘텐츠의 이름$og_title
contentDescription콘텐츠에 대한 설명$og_description
contentImageUrl콘텐츠의 이미지 URL입니다. 절대 경로여야 합니다.$og_image_url
price항목의 가격$amount
currencyISO 4217 통화 코드로 가격을 나타내는 통화$currency
contentIndexingMode"public"다음 값 중 하나로 설정할 수 있습니다. "public" 또는 "private". Public은 이 콘텐츠를 다른 앱에서 검색할 수 있도록 설정하는 것입니다.$publicly_indexable
contentMetadata모든 맞춤형 key-value 데이터(예: { "custom": "data" }

BUO 모범 사례

  • 권장 사항
    • canonicalIdentifier을 앱 인스턴스 간에 중복되지 않은 고유한 값으로 설정합니다.
    • title, contentDescriptionimageUrl이 객체를 올바르게 표시하는지 확인합니다.
    • 페이지 로드의 VIEW_ITEM 이벤트를 사용하여 Branch Universal Object를 초기화하고 logEvent를 호출합니다.
    • 유저가 링크가 필요한 작업을 수행할 때 수명주기 후반에 showShareSheet 및 createShortLink를 호출하십시오.
    • 해당 유저 조치가 수행 될 때 추가 오브젝트 이벤트 (구매, 공유 완료 등)를 호출하십시오.
  • 금지 사항
    • 모든 객체에 동일한 title, contentDescriptionimageUrl을 설정합니다.
    • 유저가 공유할 때까지 객체 초기화 및 뷰 등록을 기다립니다.
    • 편리하게 링크가 필요할 때까지 객체를 초기화하십시오.
    • 한 번에 여러 객체를 만들고 for 루프에 뷰를 등록합니다.

딥링크(Deep Link) 읽기

  • 딥링크(Deep Link) 데이터는 링크에서 앱 통합으로 전송됩니다.

데이터 구조

  • 딥링크(Deep Link) 데이터 구조 예
{
          "identity_id": "427469360685348303",
          "link": "https://example.app.link?%24identity_id=427469360685348303",
          "session_id": "429691081177874743",
          "data": {
            "$canonical_identifier": "item/1503684554354.28",
            "$canonical_url": "https://example.com/home?utm_campaign=test&deeplink=value",
            "$desktop_url": "http://example.com/home",
            "$identity_id": "427469360685348303",
            "$og_description": "My Content Description",
            "$og_image_url": "http://lorempixel.com/200/200/",
            "$og_title": "46D6D28E-0390-40E4-A856-BD74F34D24C8",
            "$publicly_indexable": 1,
            "+click_timestamp": 1503684563,
            "+clicked_branch_link": true,
            "+is_first_session": false,
            "+match_guaranteed": true,
            "custom": "blue",
            "random": "FE848A5B-78F7-42EC-A253-9F795FE91692",
            "added": "1503684554354.33",
            "~campaign": "new launch",
            "~channel": "facebook",
            "~creation_source": 3,
            "~feature": "sharing",
            "~id": 429691043152332059,
            "~referring_link": "https://example.app.link/X7OsnWv9TF",
            "~stage": "new person",
            "~tags": [
              "one",
              "two"
            ]
          }
        }

콜백 값

  • 앱 및 웹사이트 연동 내의 initSession에서 읽어들인 추가 속성

Usage

~id

설치/열기를 유도한 Branch 링크에 대해 자동으로 생성된 18자리 ID 번호 (동적 및 3P 링크의 경우 0)

~referring_link

설치/열기를 유도한 리퍼링(Referring) 링크 (있는 경우)

~creation_source

링크가 작성된 위치 ( 0 API, 1 Quick Link, 2 SDK, 3 iOS SDK, 4 Android SDK, 5 웹 SDK, 6 동적, 7 타사)

+match_guaranteed

100 % 정확도로 일치 한 경우

+referrer

링크를 클릭한 경우 링크 클릭에 대한 리퍼러(Referrer)

+is_first_session

true 첫 세션(설치)인 경우, false: 다른 모든 세션(오픈)인 경우.

기본값은 false입니다.

+clicked_branch_link

유저가 이 세션을 트리거한 Branch 링크를 클릭했는지 여부를 나타냅니다.

기본값은 false입니다.

+non_branch_link

Branch 링크가 아닌 경우 앱이 오픈되었습니다(써드파티, 유효하지 않은 Branch 딥링크(Deep Link) 또는 Branch 키 불일치).

약 1개월 전에 업데이트 됨



딥링크 생성


제안된 편집은 API 참조 페이지에서 제한됩니다.

Markdown 본문 콘텐츠에 대한 편집만 제안할 수 있지만 API 사양에는 제안할 수 없습니다.


필터