원링크 문제 해결 및 FAQ

유니버설 링크: iOS 사용자의 98% 이상에게 필요

URI 스킴: 삼성 기기에서 앱을 여는 열기 위한 기본 방법. 그렇지 않으면 이는 앱을 여는 레거시 및 폴백 방법입니다. 사용 분야:

• 6.0 이전 버전을 사용하는 안드로이드 사용자(안드로이드 사용자의 15% 미만)에게 사용
• 유니버설 링크와 앱 링크가 작동하지 않거나 설정되지 않았기 때문에 유니버설 링크와 앱 링크가 앱을 열지 못할 경우 폴백으로 사용 가능합니다.

  참고: URI 스킴을 유니버설 링크에 대한 폴백으로 사용하는 것은 iOS 기반 제한에 따릅니다. 더 알아보기

참고: 삭제된 템플릿에 기반한 기존 원링크 URL이 있는 경우 사용자는 앱 스토어에도 들어갈 수 없습니다. 이런 이유로, 템플릿을 사용하는 원링크 URL이 없는지 먼저 확인한 다음 템플릿을 삭제하는 것이 특히 중요합니다. 또는 기존 템플릿의 설정을 삭제하는 대신 변경하여 필요한 결과를 얻을 수 있는지 고려하십시오.

예, 앱스플라이어에 템플릿을 기반으로 하는 기존 사용자정의 링크가 없는 한 가능합니다.

앱스플라이어에 원링크 템플릿을 기반으로 한 사용자정의 링크가 이미 있는 경우 하위 도메인을 변경할 수 없습니다. 이 제한은 라이브 링크의 리디렉션/딥링킹 작동 중단을 방지하기 위해 설계되었습니다.

기존 사용자정의 링크가 있는 템플릿에서 하위 도메인을 변경해야 하는 경우 다음 중 하나를 수행할 수 있습니다. 

• 새 하위 도메인으로 원링크 템플릿을 새로 만들고, 이 새 템플릿을 이용하여 링크를 생성하십시오.
• 하위 도메인을 변경해야 하는 템플릿에 따라 기존의 모든 사용자정의 링크를 삭제합니다. 템플릿 기반의 모든 연결을 삭제하면 하위 도메인을 편집할 수 있습니다.

아닙니다. 특정 템플릿 및 템플릿 ID로 구성된 하위 도메인/도메인을 가져와서 다른 템플릿 ID에 수동으로 연결하면 유니버설 링크 및 앱 링크의 기능이 손상되고 보안 위협이 발생합니다.

예시:

• 템플릿 1ABC는 하위 도메인 bank.onelink.me로 구성됩니다.
• 템플릿 D123은 하위 도메인 game.onelink.me로 구성됩니다.
• bank.onelink.me/1ABC/shorturl 링크 는 템플릿 1ABC를 기반으로 생성되며 작동합니다.
• game.onelink.me/D123/exampleurl 링크는 템플릿 D123을 기반으로 생성되어 작동합니다.
• bank.onelink.me/1ABC/shorturl 링크는 작동하지 않음
• bank.onelink.me/D123/exampleurl 링크는 작동하지 않음

예. 그러나 하위 도메인을 사용하여 별도의 템플릿을 작성해야 합니다. 템플릿 ID에 하위 도메인을 수동으로 추가하지 마십시오. 

데스크톱 사용자는 예를 들어 이메일 캠페인을 통해 원링크 사용자정의 링크에 참여할 수 있습니다. 그러나 데스크톱 사용자가 이러한 링크를 클릭하면 모바일 사이트, 앱 스토어 또는 앱으로 리디렉션될 수 없습니다.

그러면 데스크톱 사용자에게 좋은 사용자 환경을 제공하고 모바일 사용자로 전환하려면 어떻게 해야 합니까?

원링크 URL 또는 템플릿에서 데스크톱 사용자(Windows 또는 Mac)를 다른 URL로 리디렉션할 수 있습니다. 이 웹 URL은 af_web_dp 파라미터의 링크에 추가됩니다. 참고: 링크에 af_web_dp가 포함된 경우 앱스플라이어는 데스크톱의 클릭을 등록하지 않습니다.

Chromebooks 앱은 안드로이드 앱으로 간주됩니다.

Chromebook의 경우, 앱을 다른 웹 URL에 인스톨하지 않고 새 사용자를 리디렉트하려면 다음을 수행합니다.

1. 원링크 템플릿 설정에서 링크 작동 설정 > 앱이 인스톨되지 않은 경우 > Android에서 다른 URL로 변경을 클릭하십시오.
   혹은
   원링크 링크 설정의 딥링킹 및 리디렉션 > 리디렉션 > 앱이 설치되지 않은 경우 > 안드로이드에서 웹 URL을 선택하세요.
2. URL을 입력하십시오.
   링크 설정을 통해 추가되면 af_android_url 파라미터의 링크에 URL이 추가됩니다.

예. 그러나 부분적으로만 작동합니다.

앱스플라이어 SDK를 연동할 수 없을지라도, 모바일 웹 방문자를 모바일 앱 유저로 빠르게 전환시키는 것이 가능합니다.

앱스플라이어 SDK가 앱에 구현되어 있지 않더라도 기본 사용자 리디렉션과 앱 실행이 작동합니다. 스마트 배너는 SDK가 필요 없고, SDK 없이도 정상 작동합니다.

그러나 SDK가 없다는 것은 다음을 의미합니다.

• 초기 앱 실행 이후로는 사용자를 클릭할 때 딥링크가 될 수 없습니다.
• 어트리뷰션 데이터를 기록할 수 없습니다.
• 인앱 이벤트를 기록할 수 없습니다.

다음 표에서는 원링크 사용자정의 링크를 만드는 데 사용할 수 있는 여러 방법을 비교합니다.

예, 그러나 유니버설 링크 및 앱 링크는 클릭(예를 들어, 웹 페이지 또는 이메일의 링크 클릭)할 때만 작동합니다. 링크를 브라우저 주소창에 붙여넣고서는 앱을 열 수 없습니다. 링크를 브라우저 URL 상자에 붙여넣지 않고 URL을 클릭하여 테스트합니다.

좋은 의도에도 불구하고, 일부 경우에 있어서, 원링크 URL은 의도된 딥링킹을 수행하지 않을 수 있습니다. 이런 상황이 발생하면 사용자가 앱 내의 특정 액티비티에 딥링크되는 대신, 앱 스토어 또는 심지어 오류 페이지로 리디렉션됩니다.

그 이유는 다음과 같은 여러 가지가 있을 수 있습니다. 

• 호스트 애플리케이션: 어트리뷰션 링크를 공유하게 되는 앱(예를 들어, WhatsApp, Gmail, WeChat)이 자체 내부 브라우저와 같은 클릭된 링크를 활성화하는 다른 방법을 사용하고 있습니다. 이들 중 일부는 모든 어트리뷰션 링크를 차단하는 것으로 알려져 있습니다.
• 브라우저: 특정 브라우저와 OS 플랫폼이 링크에 다르게 동작합니다. 예를 들어 특정 브라우저에서는 링크 붙여넣기가 작동하지 않습니다. 링크를 실제로 클릭해야 합니다. 
• OS 업데이트: 새로운 OS 업데이트(iOS와 안드로이드 모두)로 인해 딥링킹을 방해하는 예기치 않은 버그가 발생할 수 있습니다.
• 기기: 서로 다른 버전의 iOS, 안드로이드, Windows 모바일 및 기타 운영 체제를 실행하는 스마트폰, 태블릿, 노트북 및 기타 장치의 어트리뷰션 링크 처리 방식은 매우 다양할 수 있습니다.
• 구성 오류: 딥링킹 값에 특수 문자를 사용하면 링크가 끊어집니다.

사용자 환경을 개선하기 위한 두 가지 솔루션은 폴백 URL과 강제 딥링킹입니다.

폴백 URL

어떤 이유로든 앱 열기 또는 딥링킹이 실패할 경우 폴백 URL은 사용자를 지정된 웹 페이지로 보냅니다. 주의! 또한 앱을 설치하지 않은 사용자를 올바른 앱 스토어 대신 폴백 URL로 보냅니다. 따라서 앱을 이미 설치한 사용자를 리타케팅하는 경우에만 이 옵션을 사용하십시오.

폴백 URL을 구현하려면 원링크 템플릿 또는 사용자정의 링크 설정에서 앱이 설치되지 않은 경우의 링크 동작을 설정하여 다른 URL로 리디렉션하십시오.

이 설정을 사용하면 af_ios_url 및 af_android_url이 폴백의 대상 파라미터로 추가되므로 iOS 사용자는 af_ios_url에서 지정한 페이지로, 안드로이드 사용자는 af_android_url에서 지정한 페이지로 리디렉션됩니다.  

https://go.onelink.ly/qwerty?pid=source&af_dp=greatapp%3A%2F%2F&af_ios_url=www.yoursite.com/ios-bonus
&af_android_url=www.yoursite.com/android-bonus

강제 딥링킹

강제 딥링킹을 사용하면 URI 스킴을 폴백으로 사용하여 앱을 열고 사용자를 딥링킹할 수 있습니다.

이 솔루션은 앱을 설치해둔 사용자에게 적합합니다. 그러나 iOS의 경우 URI 스킴을 사용하여 앱을 여는 데는 제한이 있으며 URI 스킴에 지정된 활동에 강제로 딥링킹하려면 원링크 URL에 af_force_deeplink=true를 추가해야 할 수 있습니다(af_dp 파라미터). iOS의 URI 스킴 폴백에 대해 자세히 알아보십시오.

target 어트리뷰트가 포함된 HTML 태그를 사용하지 않는지 확인하십시오. 원링크 URL이 태그 안에 target="_blank" 어트리뷰트로 있으면 Chrome(iOS와 안드로이드 모두에서)에서 빈 페이지가 열리고 사용자는 앱 스토어 또는 Google Play로 리디렉션되지 않습니다.

af_r, af_ios_url, af_android_url, af_web_dp는 어트리뷰션 링크 또는 원링크의 파라미터를 리디렉션된 페이지로 전달합니다. 이 동작을 방지하려면 어트리뷰션 링크에 af_param_forwarding=false를 추가하십시오.

경우에 따라 URL에 여러 PID가 있을 수 있습니다. 앱스플라이어가 리디렉션 URL에 PID 및 C 파라미터를 추가하고 클라이언트가 자체 PID 파라미터를 추가할 수도 있기 때문에 이런 것이 발생합니다. 예를 들어 클라이언트 웹 사이트 URL에서 '제품 ID'는 'pid'일 수 있습니다.

일반적으로 어트리뷰션 링크에 af_param_forwarding=false를 추가하면 모든 파라미터가 제거됩니다.

그러나 데스크톱에서 링크를 클릭하면 클라이언트가 필수 CRM 파라미터를 유지하기를 원할 수 있습니다. 앱스플라이어 PID 및 C 파라미터만 제거하고 다른 모든 파라미터는 유지하려면 af_base_params_forward=false를 어트리뷰션 링크에 추가하십시오.

이제 원링크가 온드 미디어(owned media)에 사용하는 커스텀 어트리뷰션 링크를 생성하는 유일한 방식입니다.

과거에는 앱 소유주가 원링크 없이 (특정 앱 중심) 단일 플랫폼 커스텀 링크를 사용했습니다. 단일 플랫폼 커스텀 링크 방식은 더 이상 운영되지 않으며 이제 새 커스텀 링크는 원링크 템플릿을 이용해서만 만들 수 있습니다.

그러나 이전에 만든 단일 플랫폼 사용자정의 링크는 기존과 같이 작동합니다. 원링크 사용자정의 링크 페이지의 오른쪽 상단 모서리에 있는 레거시 단일 플랫폼 링크 보기를 클릭하여 레거시 링크를 보고 편집할 수도 있습니다.

아니요, 짧은 URL ID는 링크가 생성됨과 동시에 설정할 수 있습니다.

외부 링크 단축기 또는 원링크 사용자정의 링크를 래핑하면 유니버설 링크 및 앱 링크의 앱 열기 기능이 중단됩니다.

유니버설 링크 또는 앱 링크를 활성화하려면 OS가 앱과 연결된 URL의 도메인을 인식해야 하지만, 어떤 유형의 외부 래핑, 단축 또는 사용자 대상 링크로의 리디렉션에 의해 불가능합니다. 여기에는 bit.ly, 비-앱스플라이어 브랜드 링크 또는 클릭 기록이 활성화된 ESP(이메일 서비스 제공업체) 사용이 포함됩니다.

리디렉션이 정상적으로 작동할 수 있도록 링크를 래핑하거나 단축하는 법: 

• 원링크 사용자정의 링크를 생성할 때 (bit.ly와 같은 외부 단축기 대신) 앱스플라이어에서 생성된 짧은 URL을 사용합니다.
  팁! 링크에 짧은 브랜드 도메인을 만들어 URL을 더 짧게 만드세요. 앱스플라이어 UI에서 링크를 생성하는 경우 URL ID를 최대한 짧게 편집할 수 있습니다. 예: https://brand.com/a1b2/a(brand.com이 사용자의 브랜드 도메인인 경우 a1b2는 항상 4문자인 템플릿 ID이고 a는 한 문자로 편집되는 URL ID입니다.  
  장점:
  • 이 방법은 원링크 템플릿에 설정된 원링크 하위 도메인(subdomain)을 이용하므로 잘 동작합니다.
  • 잠재 고객에게 어트리뷰션 링크가 배포된 이후이거나 링크 운영 중에도, 딥링킹 설정을 포함한 파라미터를 변경할 수 있습니다.
  • 링크에 대한 모바일 디바이스에서의 모든 클릭이 앱스플라이어 대시보드에 집계되므로, 다른 서비스를 확인할 필요가 없습니다.
  • 단축 URL의 마지막 부분을 사용자 정의하여 브랜드 도메인으로 만들 수 있습니다.
• URI 스킴을 폴백으로 사용하여 유니버설 링크 및 앱 링크가 실패할 때 앱을 열고 다음 파라미터를 링크에 추가합니다. af_force_deeplink=true.
• ESP 작업 옵션을 참조하십시오.

예, 그러나 ESP(이메일 서비스 제공업체)와 함께 작업할 때는 특별히 고려해야 합니다. 수행한 클릭 횟수를 계산하기 위해 ESP는 이메일 안에 있는 모든 링크를 래핑합니다. 이 경우 URL을 클릭하는 사용자에 대한 앱 열기/딥링킹 흐름이 중단됩니다.

이를 방지하려면 다음 옵션 솔루션 중 하나를 사용하십시오.

• ESP 설정에서 클릭 기록을 비활성화합니다.
  (팁: 이것이 일반적으로 가장 쉬운 솔루션입니다.)
• 어트리뷰션 링크에 af_dp 플래그를 추가하여 af_esp=true 파라미터에 지정된 URI 스킴으로 앱을 강제로 엽니다. 이 솔루션은 앱을 설치해둔 사용자에게 적합합니다.
• 앱스플라이어 솔루션을 지원하는 ESP를 사용하여 앱을 열고 유니버설 링크와 딥링킹합니다. 더 알아보세요.

원링크는 사용자의 IP 주소를 기반으로 올바른 지역 앱 스토어로 사용자를 리디렉트합니다.

앱스플라이어에서 리디렉션 허용 목록을 활성화했는지 확인하십시오. 활성화된 경우 원하는 웹 URL 도메인 또는 서브도메인을 기재해야 합니다. 리디렉션 허용 목록에 대해 자세히 알아보기

다음과 같은 이유로 Google Play로 리디렉션되는 대신 '찾고 있는 앱을 사용할 수 없습니다.' 오류가 발생할 수 있습니다.

• 앱이 현재 Google Play에서 '보류 중' 상태입니다. 위에 언급된 오류 메시지를 방지하려면 Google Play 대신 웹 URL을 가리키도록 링크의 리디렉션을 설정하세요. 앱이 승인되면 리디렉션을 다시 Google Play로 다시 변경할 수 있습니다. 이러한 구성 변경은 링크의 템플릿 페이지에서 수행됩니다.
• 앱이 타사 스토어를 통해서만 제공되는 경우, AppsFlyer에서 잘못된 구글 플레이 상태가 할당되어 문제가 발생할 수 있습니다. 이 문제를 해결하려면 내 앱 설정 페이지에서 구글 플레이 상태를 스토어 외부에 게시됨으로 설정해야 합니다.

예 - 브랜드 도메인과 원링크 하위 도메인이 제대로 매핑된 경우에는 가능합니다. 다음을 참조하세요. 앱스플라이어에서 브랜드 도메인 설정

예:
원링크 하위 도메인: demo.onelink.me
템플릿 ID: A1r4
demo.onelink.me 하위 도메인에 매핑된 브랜드 도메인은 다음과 같습니다.

• app.simulatorapp.com
• click.simulatorapp.com

원링크 UI에서 다음 브랜드 링크를 생성했습니다.
app.simulatorapp.com/A1r4/simulationlink
위의 브랜드 링크를 다른 브랜드 도메인 링크 또는 원링크 하위 도메인 링크로 교체할 수 있습니다.
다음 링크는 기능적으로 동일하며 모든 곳에서 동일하게 작동합니다.

• app.simulatorapp.com/A1r4/simulationlink
• demo.onelink.me/A1r4/simulationlink
• click.simulatorapp.com/A1r4/simulationlink