요약: 이메일 전송 및 분석 플랫폼인 Oracle Responsys는 이메일에 앱스플라이어 원링크를 내장하고 있습니다.링크를 클릭하는 이메일 수신자는 앱에 딥 링크됩니다.
ESP(이메일 서비스 제공업체)는 세분화된 사용자 트래픽을 위한 훌륭한 소스가 될 수 있습니다.
ESP의 과제 중 하나는 올바른 어트리뷰션과 딥링킹을 수행하는 것입니다.ESP는 딥링킹 URL을 자신의 ESP의 클릭 기록 도메인으로 래핑합니다.이 절차는 종종 iOS 유니버설 링크 및 Android 앱 링크의 기능을 중단합니다.
그러나 딥링킹과 클릭 기록은 클릭 기록 도메인 위에 유니버셜 링크와 앱링크를 지원하는 ESP를 통해 여전히 가능합니다.또한 클릭 기록 도메인 역할을 하도록 고유한 클릭 도메인을 설정할 수 있습니다.
선행 조건
- 원링크로 딥링킹을 지원하도록 앱을 설정합니다.
- SDK 버전 확인(Android 및 iOS 모두)
- 앱스플라이어 iOS SDK 버전 4.9.0 (또는 그 이상)
- 앱스플라이어 안드로이드 SDK 버전 4.9.0 (또는 그 이상)
Oracle Responsys 클릭 도메인 설정
이 절에 따라 Oracle Responsys에서 클릭 도메인(클릭 기록 도메인)을 설정합니다.
1단계: Oracle Responsys에서 클릭 도메인 설정
클릭 도메인을 설정하려면 클릭 도메인을 생성하는 방법에 대한 Oracle Responsys 공식 가이드를 따르십시오.Oracle Responsys는 링크 테이블을 사용하여 특정 캠페인에 대한 클릭을 기록합니다
링크 테이블에서 IOS 링크 URL을 링크 URL 과 동일하게 정의할 수 있습니다.
링크 테이블에서 클릭 도메인을 설정하면 Responsys는 이러한 도메인을 사용하여 이메일 캠페인에 포함된 OneLink를 래핑합니다.이러한 방식으로 Responsys는 원링크 및 딥링킹 기능을 유지하면서 시스템에서 클릭을 기록할 수 있습니다.
2단계: Responsys에 AASA(iOS) 및 자산 링크 파일(Android) 제공
iOS용 AASA
Responsys가 iOS 유니버셜 링크를 지원하려면 AASA 파일이 필요합니다. 다음 설명을 참조하십시오.
유니버설 링크로 원링크를 설정하면 이미 원링크와 연결된 AASA가 있습니다.AASA를 받으려면:
- 원링크 구성으로 이동하여 유니버설 링크로 구성된 원링크를 찾습니다.
- 원링크 URL 끝에 /. well-known/apple-app-site-association 을 추가합니다.
- 브라우저 주소 표시줄에 원링크를 붙여넣고 Enter 키를 누릅니다. 예: <OneLinkSubdomain>.onelink.me/.well-known/apple-app-site-association. 이렇게 하면 AASA 파일이 컴퓨터에 다운로드됩니다. 간단한 텍스트 편집기를 사용하여 열 수 있습니다.
- 이 AASA 파일을 Responsys로 보냅니다. 자세한 내용과 이 파일의 내용에 대한 자세한 내용은 Oracle 가이드의 11페이지를 참조하십시오.
Android용 자산 링크
앱 링크로 원링크를 설정할 때, 원링크와 연결된 에셋 링크 파일이 이미 있습니다. 자산 링크 파일을 가져옵니다. 자산 링크 파일을 가져오려면:
- 원링크 구성으로 이동하여 앱 링크로 구성된 원링크를 찾습니다.
- 원링크 URL 끝에 /. well-known/assetlinks.json 을 추가합니다.
- 브라우저 주소 표시줄에 원링크를 붙여넣고 Enter 키를 누릅니다. 예:<OneLinkSubdomain>.onelink.me/.well-known/assetlinks.json. 이렇게 하면 자산 링크 파일이 컴퓨터에 다운로드됩니다. 간단한 텍스트 편집기를 사용하여 열 수 있습니다.
- 이 자산 링크 파일을 Responsys로 보냅니다. 자세한 내용과 이 파일의 내용에 대한 자세한 내용은 이 가이드를 참조하세요.
앱 설정
Android용 1단계: 앱 링크를 지원하도록 앱 설정
Android 매니페스트의 활동에 클릭 도메인 추가
Android 매니페스트에서 클릭 도메인 호스트와 딥링크하려는 활동의 활동 태그에 접두사를 추가합니다.
<activity android:name=".DeepLinkActivity">
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https"
android:host="click.example.com"
android:pathPrefix="/campaign" />
</intent-filter>
</activity>
클릭 도메인을 확인하도록 앱 설정
SDK는 캠페인 세부 정보를 얻기 위해 클릭 도메인 뒤에 있는 원링크를 확인해야 합니다. 세부 정보는 onAppOpenAttribution
메서드에 반환됩니다.
클릭 도메인을 확인하려면:
- SDK 버전이 4.9.0 이상인지 확인합니다.
- SDK API
setResolveDeepLinkURLs
에 클릭 도메인을 나열합니다. 이 API는 SDK 초기화 전에 호출해야 합니다. 자세한 내용은 여기에서 SDK 설명서를 참조하세요.
AppsFlyerLib.getInstance().setResolveDeepLinkURLs("click.example.com");
-
중요!Oracle과 함께 MI(Movable Ink)를 사용하는 경우 MI 계정 관리자로부터 MI CNAME 및 내부 도메인을 가져와 Oracle에 대한 클릭 링크 외에도
setResolveDeepLinkURLs
에 추가해야 합니다.예시:AppsFlyerLib.getInstance()를 호출합니다.setResolveDeepLinkURLs("oracle-click.example.com", "mi.example.com", "example.micpn.com");
-
중요!Oracle과 함께 MI(Movable Ink)를 사용하는 경우 MI 계정 관리자로부터 MI CNAME 및 내부 도메인을 가져와 Oracle에 대한 클릭 링크 외에도
2단계: 클릭 도메인을 확인하도록 앱 설정
SDK는 캠페인 세부 정보를 얻기 위해 클릭 도메인 뒤에 있는 원링크를 확인해야 합니다. 세부 정보는 onAppOpenAttribution
메서드에 반환됩니다.
클릭 도메인을 확인하려면:
- SDK 버전이 4.9.0 이상인지 확인합니다.
- SDK 속성에
resolveDeepLinkURLs
클릭 도메인을 나열합니다 .이 속성은 SDK 초기화 전에 설정해야 합니다.자세한 내용은 여기에서 SDK 설명서를 참조하세요.
[AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];
앱스플라이어트래커.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
-
중요!Oracle과 함께 MI(Movable Ink)를 사용하는 경우 MI 계정 관리자로부터 MI CNAME 및 내부 도메인을 가져와 Oracle에 대한 클릭 링크 외에도
setResolveDeepLinkURLs
에 추가해야 합니다.도메인 예시:- Oracle 도메인: oracle-click.example.com
- MI CNAME 도메인: mi.example.com
- MI 내부 도메인: example.micpn.com
-
중요!Oracle과 함께 MI(Movable Ink)를 사용하는 경우 MI 계정 관리자로부터 MI CNAME 및 내부 도메인을 가져와 Oracle에 대한 클릭 링크 외에도
- SDK가 클릭 기록 도메인을 확인할 수 있도록 다음 코드를 추가합니다.
AppDelegate.m에 다음 코드를 추가하세요.
- (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL { if ([URL.host isEqual: @"click.example.com"]) { return [NSDictionary dictionary]; } else { return nil; } }
AppDelgate.swift에 이 코드를 추가합니다.
func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! { if (URL.host == "click.example.com") { /// Change User-Agent return [:] } else { return nil; } }
첫 번째 이메일 보내기
- 링크 관리 페이지에서(또는 수동으로) 원링크 URL을 생성합니다.
- 원링크 URL을 생성할 때 모든 파라미터 값을 URL로 인코딩해야 합니다.
- 다음 매개 변수를 사용하는 것이 좋습니다.
- pid(미디어 원본) - 이 사용을 나타내는 미디어 원본(예: 이메일)을 사용합니다.
- c (campaign) - 측정하려는 캠페인의 이름입니다.
- af_dp - 사용자를 딥링크하려는 딥링크 URI 체계입니다.
- af_web_dp - 데스크톱에서 링크를 클릭하는 사용자를 리디렉션하는 위치입니다.
- af_ios_url - iOS 장치에서 링크를 클릭하는 앱이 없는 사용자를 리디렉션하는 위치입니다.
- af_android_url - 앱이 없는 사용자를 리디렉션할 위치: Android 기기에서 링크를 클릭합니다.
- Responsys에서 생성한 이메일에 원링크 URL을 입력합니다. 예시:
이 단계에서 Responsys는 위의 링크를 이전 단계에서 설정한 클릭 도메인으로 래핑합니다. 시나리오 : 세 개의 클릭 도메인이 귀하의 원링크 https://mysubdomain.onelink.me/abCD로 리디렉션됩니다. 앱이 사용자의 기기에 설치되어 있는 경우 클릭 도메인은 앱에 딥 링크됩니다.<a href="greatapp.onelink.me/abcd/1234567">다운로드 나의 좋은 애플리케이션입니다!</a>
예시
URL 매개변수는 가독성을 위해 이 예제에서 URL로 인코딩되지 않습니다.
https://greatapp.onelink.me/abcd?pid=Email&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content
링크 테스트
위에서 언급한 모든 필수 단계를 수행하고, 적절한 원링크 URL을 생성하고, 이를 이메일에 넣은 후, 자신에게 테스트 이메일을 보냅니다.
무엇을 기대할 수 있을까요?
앱이 설치되어 있는 경우 앱을 호출해야 합니다.관련 앱스플라이어 SDK 딥링킹 API가 구현된 경우 관련 콘텐츠에 딥링크되어야 합니다.
또한 클릭은 제공된 미디어 소스 및 캠페인에 어트리뷰션된 앱스플라이어 대시보드와 Responsys 데이터 모두에 나타나야 합니다.