Branch iOS / 안드로이드 / Web SDK 테스트하기

iOS / Android

링크 사용자 경험

  1. 딥링크가 되는 quick link를 생성하기 (vs. 메인 페이지 오픈)
  2. 자신에게 링크를 이메일로 보내기
  3. 브라우저 표시줄에 링크를 붙여넣기 하지 마세요.
  4. 이메일이 링크를 '랩핑'하지 않는지 확인하세요(예: 트래킹 또는 보안 도메인).
  5. 테스트 디바이스에서 링크를 클릭하세요(시뮬레이터는 안됩니다).
  6. 테스트된 앱 버전이 링크와 동일한 API 키를 사용하는지 확인하세요(테스트 vs. 라이브)
  7. Click link in these scenarios

SDK 초기화

  1. Enable debug mode for Branch SDK by calling the setDebug()/enableLogging() before the SDK is initialized. You can find examples in the above videos, and in our iOS or Android documentation.
  2. 애플리케이션을 시작하고 로그 콘솔 (예: Logcat)에서 디버그 로그를 확인합니다.
  3. SDK가 v1/open 또는 v1/install endpoint에 요청했는지 확인하여 Branch SDK가 올바르게 초기화되었는지 확인합니다.
  4. 애플리케이션을 닫고 SDK가 v1/close endpoint에 요청을 보냈는지 확인합니다.
  5. 애플리케이션을 처음 실행할 때뿐만 아니라 모든 조치에서 요청이 전송되는지 확인하려면 2~4단계를 반복하세요.
  6. Create a Branch link through either of the available Branch methods, some of which are: Quick Links, API, or any of the SDK methods.
  7. Use the following methods for iOS or Android to test the link, and make sure that it is all set up. Make sure to verify that link data is passed into the application every time, and your application is able to parse the data correctly via initSession() callback.

SDK 커스텀 이벤트 로깅

참조되지 않은 이벤트:

  1. Trigger the custom event via SDK (iOS / Android)
  2. Verify that each event is sent to Branch by verifying the Logs (with debug/logging enabled, you should see a v1/event call) and Dashboard Liveview events.
  3. If you are a Data Feeds user, you should see this event attributed in a Custom Event export.
  4. If it is a commerce event (iOS / Android) - make sure all the commerce data is also passed to Branch through the same sources.

참조된 이벤트

  1. 링크 클릭하기
  2. Trigger the custom event via SDK (iOS / Android)
  3. If it is a commerce event iOS / Android) - make sure all the commerce data is also passed to Branch through the same sources
  4. 각 이벤트가 Branch로 전송되는지 확인하세요.
  5. SDK: 로그를 확인합니다 (setDebug()/enableLogging()을 호출한 후 v1/event 호출이 표시되어야 함).
  6. Data Feeds: You should see this event attributed with link ID in the last_attributed_touch_data_tilde_id data (Export API, CSVs, Webhooks)
  7. Dashboard Liveview events: You should see the event triggered and the link in the Session Referring Link URL

디퍼드 딥링킹(Deferred Deep Linking)

  1. 컴퓨터에 테스트 디바이스 연결
  2. 디바이스에서 모든 앱 버전(테스트 및 프로덕션)을 제거합니다.
  3. 디바이스에서 Branch 링크를 클릭
  4. 링크를 앱 스토어로 경로 재지정하지만 앱은 다운로드하지 마세요.
  5. xcode|android 스튜디오를 통해 디바이스에 앱 빌드하기
  6. 앱 빌드에 Branch SDK및 링크와 동일한 API키가 포함되어 있는지 확인합니다.
  7. 링크를 클릭하는 2시간 이내에 발생해야 합니다(Branch 매칭 창은 기본적으로 2시간으로 설정됩니다).
  8. 가장 최근 발생한 클릭을 기준으로 브라우저<>디바이스를 매칭하는 브랜치 SDK 초기화를 앱 오픈을 통하여 진행하세요.
  9. 디바이스가 이전에 Branch 링크를 클릭한 경우 매치가 보장됩니다. --- 그렇지 않은 경우 Branch는 매치를 위해 핑거프린팅을 사용합니다.
  10. 브라우저<>디바이스 간 앱 설치 이력을 Branch가 확인한다면 +is_first_session 파라미터값은 '0' 이 됩니다.
  11. 테스트 중에+is_first_session을 '1'로 강제 설정하려면 SDK에서 디버그 모드를 활성화하세요.

Web SDK

SDK 초기화

  1. Adblocker를 실행하고 있지 않은지 확인하세요. (웹 SDK를 차단할 가능성이 있습니다)
  2. brch-latest.min.js가 네트워크 호출에 로드되어 있는지 확인합니다.
  3. 다음과 같이 app.link 요청을 확인합니다.
  4. 응답이 200 OK인지 확인하세요.
  5. branch_key 에 올바른 분기 키가 있는지 확인하십시오.
  6. Example: https://app.link/_r?sdk=web2.33.1&_t=446772116780734172&branch_key=key_live_hkDytPACtipny3N9XmnbZlapBDdj4WIL&callback=branch_callback__0

Journeys (웹-투-앱 스마트 배너)

  1. 웹 SDK에 사용된 API 키가 앱에서 사용되는 API 키와 정렬되는지 확인합니다.
  2. 딥링크 라우팅 설정 확인
  3. If not using $canonical_url, confirm keys accounted for via banner template, .setBranchViewData, or Metatags
  4. 앱이 app.link 대체 도메인을 인식하는지 확인합니다.
  5. 배너 활성화 및 필터 유효성 검증
  6. 배너가 표시되어야 하는 웹 SDK가 포함된 URL 확인
  7. 배너가 표시되지 않아야 할 웹 SDK를 포함하는 URL도 확인합니다.
  8. 이러한 상황에서는 웹페이지에 립링크 할 배너를 로드합니다(홈 화면이 아님).
  9. iOS-Safari(앱이 설치되지 않음)
  10. iOS-Safari(앱 설치됨-완전 시작)
  11. iOS-Safari(앱 설치됨-웜 스타트)
  12. iOS-Chrome(앱이 설치되지 않음)
  13. iOS-Chrome(앱 설치됨-완전 시작)
  14. iOS-Chrome(앱 설치됨-웜 스타트)
  15. Android-Chrome(앱이 설치되지 않음)
  16. Android-Chrome(앱 설치됨-콜드 스타트)
  17. Android-Chrome(앱 설치됨-웜 스타트)

권장 사항

  1. Test on actual devices, and utilize Test Mode to imitate fresh installs, otherwise - Branch will be able to identify that device previously had the application installed, and will not send the install event.
  2. When testing on multiple devices at the same time - it is best to use different links, and not identify with the same ID. Otherwise, Branch will consider both devices to be used by the same user. In that case - links clicked on one device will be able to pass data to another device.
    We also recommend testing on different networks, or on one device at a time to prevent flaky behavior.
  3. During testing, you may run into Error messages containing the following text, or its variation: “can't open the page because the address is invalid.” This is an indicator that you used to have your application installed, and used it recently. You then uninstalled the application and clicked on a Branch link.
    This happens when our forced URI redirect mode tries to forcefully open the application via a URI scheme. When the application is not available on the device - it will result in the given error.
    This scenario will almost never happen to regular users, as our research has shown, however it will greatly improve app opening through deep linking.
    If you would rather be on a safe side - you may change the forcefulness of the mode at the top of your Link Settings page. We recommend keeping it at the intelligent mode setting.

영상 워크 스루


이 페이지가 도움이 되었습니까?