Advanced Deepview Configurations

Configure advanced settings for your Branch Deepviews.

고급 설정

The default Deepview template simply displays the content from three of the link's control parameters. You can specify the content of these parameters when creating your link to control what will display in that link’s Deepview. If nothing is set for a particular link, we will gracefully fall back to the OG values set for your entire app in Configuration > General > Social Media Preview.

$og_title

Deepview에 표시할 제목

$og_description

Deepview에 표시할 설명

$og_image_url

Deepview에 표시할 이미지의 URL

$uri_redirect_mode

Branch가 URI scheme을 사용하여 앱을 여는 방법과 시기를 제어할 수 있습니다.

0 - This is the default value that yields the standard behavior where we don't try to open the app if the user can see an error.

1 - Smart redirect mode. Same behavior as 0 until we know the user has the app installed through Branch persona data. In that case, force URI schemes to open the app.

2 - Forceful redirect mode. Always try to force open the app, even if it risks showing an error message when the app is not installed.

📘

OG 태그 호스팅

다른 곳에서 호스트하는 OG 태그를 사용하려면 이 파라미터를 비워 두고 링크를 만들 때 $desktop_url 제어 파라미터를 지정하십시오. Branch는 유저가 지정한 URL의 OG 태그를 사용하여 Deepview를 채우기 위해 일회성 스크래핑을 수행할 것입니다.

쿼리 파라미터를 추가하여 링크를 만드는 경우, URL에 파라미터만 추가하시면 됩니다. 링크가 깨지지 않도록 모든 것을 URL로 인코드하십시오.

"https://[branchsubdomain]?%24og_title=MyApp%20is%20disrupting%20apps&$og_image_url=http%3A%2F%2Fmyapp.com%2Fimage.png"

When you create links via a mobile SDK, you simply need to set the OG tag parameters..

BranchUniversalObject *branchUniversalObject = [[BranchUniversalObject alloc] initWithCanonicalIdentifier:@"item/12345"];
// Facebook OG tags -- this will overwrite any defaults you set up on the Branch Dashboard
branchUniversalObject.title = @"My Content Title";
branchUniversalObject.contentDescription = @"My Content Description";
branchUniversalObject.imageUrl = @"https://example.com/mycontent-12345.png";

// Add any additional custom OG tags here
[branchUniversalObject addMetadataKey:@"$og_video" value:@"http://mysite/video.mpg"];
let branchUniversalObject: BranchUniversalObject = BranchUniversalObject(canonicalIdentifier: "item/12345")
// Facebook OG tags -- this will overwrite any defaults you set up on the Branch Dashboard
branchUniversalObject.title = "My Content Title"
branchUniversalObject.contentDescription = "My Content Description"
branchUniversalObject.imageUrl = "https://example.com/mycontent-12345.png"

// Add any additional custom OG tags here
branchUniversalObject.addMetadataKey("$og_video", value: "http://mysite/video.mpg")
BranchUniversalObject branchUniversalObject = new BranchUniversalObject()
                 .setCanonicalIdentifier("item/12345")
 // Facebook OG tags -- This will overwrite any defaults you have set on the Branch Dashboard
                 .setTitle("My Content Title")
                 .setContentDescription("My Content Description")
                 .setContentImageUrl("https://example.com/mycontent-12345.png")

 // Add any additional custom OG tags here
                 .setContentMetadata(new ContentMetadata().addCustomMetadata("$og_video", "http://mysite/video.mpg"));

Note: The Deep Link section accepts most link control parameters, but $og_title, $og_description and $og_image_url cannot be specified there.

링크 별 Deepview 활성화

If you don't want to enable Deepviews globally, you can do it for each platform on a per-link basis by inserting custom link control parameters link control parameters.

쿼리 파라미터를 추가하여 데스크톱 Deepview를 활성화합니다.

"https://[branchsubdomain]?%24desktop_deepview=default_template&%24ios_deepview=default_template"

Enable iOS and Android Deepviews through the SDK.

BranchLinkProperties *linkProperties = [[BranchLinkProperties alloc] init];
 linkProperties.feature = @"sharing";
 linkProperties.channel = @"facebook";
 [linkProperties addControlParam:@"$ios_deepview" withValue:@"default_template"];
 [linkProperties addControlParam:@"$android_deepview" withValue:@"default_template"];
let linkProperties: BranchLinkProperties = BranchLinkProperties()
 linkProperties.feature = "sharing"
 linkProperties.channel = "facebook"
 linkProperties.addControlParam("$ios_deepview", withValue: "default_template")
 linkProperties.addControlParam("$android_deepview", withValue: "default_template")
LinkProperties linkProperties = new LinkProperties()
               .setChannel("facebook")
               .setFeature("sharing")
               .addControlParameter("$ios_deepview", "default_template")
               .addControlParameter("$android_deepview", "default_template");

링크 별 Deepview 비활성화

If you've enabled Deepviews globally, it's likely that you'll want to disable them now and again for specific use cases. To do so, just follow the instructions for enabling Deepviews for one link and set one or more of the key values to false.

$ios_deepview

false

$android_deepview

false

$desktop_deepview

false


What’s Next