딥링크 생성

Overview

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

기본link 동작

앱이 설치되지 않음

  • 지점 딥 링크의 사용자 clicks

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

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

  • 지점은 앱에 딥 링크 data 을 전달합니다.

앱이 설치됨

  • 지점 딥 링크의 사용자 clicks

  • 디바이스가 앱을 opens하거나 예상 링크 동작 탐색

  • 지점은 앱에 딥 링크 data 을 전달합니다.

예상되는 링크 동작

Mobile

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

  • *Able to force app open $uri_redirect_mode 사용 또는 Deepview 활성화

Platform

iOS

Android

페이스 북 뉴스 피드

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

Facebook 브라우저

페이스북 메신저

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

Facebook Messenger 브라우저

Instagram 프로필

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

Instagram 브라우저

인스 타 그램 스토리

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

Twitter 피드

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

Twitter 브라우저

Snap 메시지

Snap 스토리

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

Reddit

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

폴백

Pinterest

폴백

폴백

Pinterest 브라우저

Google+

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

폴백

크롬 브라우저

Chrome 주소 표시줄

폴백

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

Safari 브라우저

해당 없음

사파리 주소 표시 줄

폴백; Apple에 의해 차단됨

해당 없음

Firefox 브라우저

폴백

Firefox 주소 표시 줄

폴백

UC 브라우저

해당 없음

네이버 브라우저

해당 없음

카카오 브라우저

해당 없음

오페라 브라우저

Ghostery 브라우저

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

Google 행 아웃

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

삼성 SMS

해당 없음

삼성 SMS 브라우저

해당 없음

애플 아이 메시지

해당 없음

애플 비즈니스 채팅

해당 없음

느슨하게

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

WeChat

폴백; WeChat 대체 URL 맞춤 설정

폴백; WeChat 대체 URL 맞춤 설정

싸이 월드, 미투데이

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

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

LINE

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

불일치

Apple Mail

해당 없음

Gmail

야후 메일

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

TikTok

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

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

TikTok

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

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

데스크탑

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

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

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

Platform

Mac

Windows

Safari

App; Supports Universal Linking

Firefox

App*

App*

Chrome

App*

App*

Edge

Internet Explorer

해당 없음

App*

느슨하게

App; Supports Universal Linking

맞춤 링크 동작

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

  • 각 딥링크에 링크 데이터 추가

  • 빠른 링크에 키-값 쌍 추가

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

특정 URL로 폴백

  • 딥 링크가 어디로 이동하는지 결정

    • 앱이 설치되지 않음

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

  • 대체 대체 (우선 순위 순)

    • 쿼리 문자열 추가 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로 리디렉션하면 지점은 다음 지점 링크 분석 태그의 값을 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의 맞춤형 캠페인 문서를 참조하십시오.

딥 링크 만들기

짧은 링크

  • 짧은 링크는 가장 일반적인 딥 링크입니다
  • 하위 도메인을 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 확장 프로그램을 사용하여 브라우저에서 링크를 생성합니다.

긴 링크

  • 지점에 대한 네트워크 호출없이 긴 링크를 만들 수 있습니다
  • 장문 링크는 링크 데이터를 쿼리 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
  • 동적link에 tags 을 추가 할 때 각 태그를 개별적으로 입력하십시오

딥링크 구성

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

예약된 접두사

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

분석 라벨

  • 이 레이블을 사용하면 딥링크를 필터링하고 구성 할 수 있습니다
기본값Usage
~channel채널을 사용하여link가 유저에게 도달하는 경로에 태그를 지정하십시오. 예를 들어, 클릭 수를 추적하고 해당 경로를 통해 개별적으로 설치하는 데 도움이되도록 'Facebook' 또는 'LinkedIn' 로link에 태그
~feature링크가 연결될 수있는 앱의 기능입니다. 예를 들어 추천 프로그램을 구축 한 경우 기능 ' 추천 'link에 레이블을 지정합니다.
~campaign이 필드를 사용하여 실제 캠페인별로link를 구성하십시오. 예를 들어, 새로운 기능이나 제품을 출시했으며 그 주위에 캠페인을 운영하려는 경우
~campaign_id이 필드를 사용하여 실제 캠페인 ID별로 링크를 구성합니다. 예를 들어 새로운 기능이나 제품을 출시하고 이를 중심으로 캠페인을 운영하려는 경우
~customer_campaign라스트 어트리뷰션 터치에서 확인된 고객 캠페인입니다. 클라이언트가 링크에 지정할 수 있습니다.
~stage이를 사용하여link가 생성 될 때 유저의 진행률 또는 범주를 분류하십시오. 예를 들어, 레벨 1, 레벨 3 및 5에서 초대 시스템에 액세스 할 수있는 경우이 매개 변수를 사용하여 각 레벨에서 생성 된link를 구별 할 수 있습니다.
~tags무제한 값이 ['string'] 자유 양식 항목입니다. 이를 사용하여 위의 범위 내에 ' t 적합하지 않은 레이블로link 데이터를 구성하십시오.
~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광고가 표시된 사이트에 대한 고객 참조. 클라이언트가 링크에 지정할 수 있습니다.
  • 이 레이블을 사용하면 단일link에 대한 어트리뷰션 윈도우를 유저 정의 할 수 있습니다
기본값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은 딥링크가 아닌 웹 사이트 여야합니다
기본값Usage
$fallback_url모든 플랫폼에 대한 리다이렉션 엔드 포인트를 변경 - 당신이 돈 때문에 ' T는 플랫폼을 활성화해야합니다. Branch는 모든 로봇을이 URL로 전달합니다. 은Link에 입력 된 OG 태그 보다 우선합니다. 시스템 전체 기본 URL (링크 설정에서 설정)
$fallback_url_xx소문자 Alpha-2 국가 코드를 기준으로 모든 플랫폼에 대한 리다이렉션 엔드포인트를 변경합니다. 예를 들어 $fallback_url_de="..."는 독일 딥링크 클릭을 리다이렉션합니다. 또한 $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 딥링크를 클릭할 때 다른 앱의 오류 메시지 방지
Usage
$uri_redirect_mode0이것은 Branch가 돈 표준 행동 산출 기본값입니다 ' 유저가 오류를 볼 수있는 경우 응용 프로그램을 열 수 t의 시도.
$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모든 플랫폼의 딥링크 경로를 설정합니다 - 당신이 돈 때문에 ' T는 플랫폼을 활성화해야합니다. Branch SDK는이 매개 변수 집합이 포함 된link를 받으면이 내에 포함 된 유저 지정 URI 경로를 자동으로로드합니다.
$android_deeplink_pathAndroid 앱의 딥링크 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 Android URI 경로를 로드합니다.
$ios_deeplink_pathiOS 앱의 딥링크 경로를 설정합니다. Branch SDK가 이 파라미터가 설정된 링크를 받으면 자동으로 포함된 맞춤형 iOS URI 경로를 로드합니다.
$desktop_deeplink_path데스크톱 앱의 딥링크 경로를 설정하십시오. 이 매개 변수를 가져와 유저를 적절히 라우팅해야합니다.
$match_duration7200어트리뷰션 윈도우라고도 하는 스냅샷 매칭 타임아웃(앱이 매칭하도록 오픈될 때까지 클릭이 기다리는 시간)을 제어할 수 있습니다. 초 단위로 지정됩니다.
$always_deeplinktrue링크를 항상 모바일 사이트로 돌아가도록 하려면 false로 설정합니다. 유니버설 링크(Universal Links) 또는 Android 앱 링크에는 적용되지 않습니다.
$ios_redirect_timeout750앱 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$android_redirect_timeout750Play 스토어로 리다이렉션하기 전에 앱을 오픈하려고 시도한 후 클라이언트 측 JS가 기다리는 타임아웃을 제어합니다. 밀리초 단위로 지정됩니다.
$custom_sms_text데스크톱 클릭에 대해 SMSlink 텍스트가이link로 전송되었습니다. 설정의 앱 페이지에 {{ link }} 의 텍스트 값을 포함해야합니다.
$marketing_title딥링크의 마케팅 제목을 설정하십시오.
$deeplink_no_attribution링크가 해당link에 대한 속성없이 딥링크 만 지원하도록하려면 true 설정하십시오.

콘텐츠

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

Deepview

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

링크 모양

  • 짧은link의 외관을 유저 정의하십시오
기본값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대시보드에 설정소셜 미디어 디스플레이에 표시 될link 설명을 설정하십시오.
$og_image_url대시보드에 설정소셜 미디어 디스플레이에 표시 될link 이미지를 설정하십시오.
$og_image_width소셜 미디어 디스플레이를 위해 이미지 너비를 픽셀 단위로 설정합니다.
$og_image_height소셜 미디어 디스플레이를 위해 이미지 높이를 픽셀 단위로 설정합니다.
$og_video소셜 미디어 디스플레이에 표시될 동영상을 설정합니다.
$og_url소셜 미디어 디스플레이에 표시 될link의 기본 URL을 설정하십시오.
$og_type소셜 미디어 디스플레이에 표시 될 유저 정의 카드 형식link 유형을 설정하십시오. 돈은 ' 페이스 북에 깊은link를 공유 할 때 t이 속성을 설정
$og_redirect(고급, 권장되지 않음) 적절한 태그를 모두 검색하기 위해 소셜 미디어 로봇을 리다이렉션할 맞춤형 URL을 설정합니다.
$og_app_id대시보드에 설정(거의 사용되지 않음) 앱 ID 태그를 설정합니다.

Twitter

  • Twitter 속성 처리
기본값Usage
$twitter_card링크의 Twitter 카드 유형을 설정합니다.(예: player)(Twitter 카드 검사기로 딥링크를 화이트리스트에 추가해야 함)
$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 또는 AccessTokenBranch에서 딥링크가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
auth_token또는 AuthTokenBranch에서 딥링크가 유효한 Branch 링크인지 여부를 확인하는 데 사용됩니다.
data최상위link 정보를 포함하기 위해 Branch에서 사용합니다. 이 매개 변수가 쿼리 매개 변수를 추가하여 Branch Link에 추가되면 삭제됩니다. 대시 보드를 통해 수동으로link를 만들 때 안전하게 사용할 수 있습니다.

맞춤형 태그

  • 맞춤형 메타 태그 처리
$custom_meta_tags태그 키 및 값의 유효한 문자열화된 JSON 사전
  • 유효한 사전적 정의: "{"twitter:player:stream": "https://branch.io\"}" . 그러면 다음 메타 태그가 생성됩니다: <meta property="twitter:player:stream" content="https://branch.io" />
  • 대시 보드를 통해link를 만들면 사전을 분류 할 염려가 없습니다. 자동으로 수행됩니다.
  • 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를 호출합니다.
    • 유저가link가 필요한 작업을 수행 할 때 수명주기 후반에 showShareSheet 및 createShortLink를 호출하십시오.
    • 해당 유저 조치가 수행 될 때 추가 오브젝트 이벤트 (구매, 공유 완료 등)를 호출하십시오.
  • 금지 사항
    • 모든 객체에 동일한 title, contentDescriptionimageUrl을 설정합니다.
    • 유저가 공유할 때까지 객체 초기화 및 뷰 등록을 기다립니다.
    • 편리하게link가 필요할 때까지 객체를 초기화하십시오.
    • 한 번에 여러 객체를 만들고 for 루프에 뷰를 등록합니다.

딥링크 읽기

  • 딥링크 데이터는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 Link에 대해 자동으로 생성 된 18 자리 ID 번호 (동적 및 3Plink의 경우 0)

~referring_link

설치 / 열기를 유도 한 참조link (있는 경우)

~creation_source

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

+match_guaranteed

100 % 정확도로 일치 한 경우

+referrer

Branch Link를 클릭했을 경우 클릭에 대한 referrer 값을 나타냅니다.

+is_first_session

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

기본값은 false입니다.

+clicked_branch_link

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

기본값은 false입니다.

+non_branch_link

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

약 1개월 전에 업데이트 됨



딥링크 생성


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

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