링크 작동 방식
모든 OneSignal 메시지(푸시, 이메일, 인앱 메시지, SMS 또는 RCS)에는 사용자가 클릭할 때 이동할 목적지 URL을 포함할 수 있습니다. 해당 목적지는 브라우저에서 열리는 웹 페이지이거나 앱에서 직접 열리는 딥 링크일 수 있습니다. URL 설정 방법은 채널에 따라 다릅니다:- 푸시: 대시보드의 Launch URL 필드 또는 API의
url파라미터를 사용합니다. - 이메일: 이메일 편집기 또는 HTML을 사용하여 링크를 추가합니다. OneSignal은 클릭을 자동으로 추적합니다.
- 인앱 메시지: 버튼, 이미지 또는 배경에 클릭 작업을 설정합니다.
- SMS/RCS: 링크를 인라인으로 추가합니다. 자동 단축 및 추적을 위해 대시보드에서 Insert Trackable Link를 사용합니다. SMS/RCS 추적 가능한 링크를 참조하세요.
딥 링크
브라우저 대신 앱 내부의 콘텐츠를 열려면 딥 링크를 사용합니다. 딥 링크 지원은 채널에 따라 다릅니다:- 푸시 및 인앱 메시지:
your-app://product/123과 같은 커스텀 URL 스킴과https://유니버설 링크 / 앱 링크를 지원합니다. - 이메일 및 SMS:
https://유니버설 링크 / 앱 링크만 지원됩니다. 이메일 클라이언트와 SMS 앱은 커스텀 URL 스킴을 처리하지 않으므로 사용할 수 없습니다.
딥 링킹
커스텀 URL 스킴, 유니버설 링크 및 앱별 라우팅을 위한 전체 설정 가이드.
푸시
Launch URL
Launch URL은 사용자가 푸시 알림을 클릭할 때 열립니다.https://로 시작해야 합니다.
Apple 기기에서
http:// URL을 사용하려면 앱의 Info.plist 파일에서 NSAppTransportSecurity 속성을 설정해야 합니다.url— 모든 플랫폼을 대상으로 합니다web_url— 웹 푸시 Subscription만 대상으로 합니다app_url— 모바일 Subscription만 대상으로 합니다

Additional data
Launch URL 대신 Additional Data 필드(API의data)를 사용하여 커스텀 키-값 쌍을 보낼 수 있습니다. 앱은 SDK의 알림 클릭 리스너를 통해 additionalData 속성으로 이 데이터를 읽습니다. 단일 URL보다 더 많은 유연성이 필요할 때 유용합니다.

Email link tracking
OneSignal은 이메일에 대해 Track link clicks가 활성화된 경우(기본적으로 켜져 있음) 이메일 내 링크 클릭을 자동으로 추적합니다. OneSignal은 이메일당 및 개별 링크당(이메일당 최대 30개 링크) 총 클릭 수와 고유 클릭 수를 추적합니다. 이메일 메시지 보고서에서 이 통계를 확인할 수 있습니다.수신 거부 링크에 대해서는 수신 거부 링크 및 이메일 구독을 참조하세요.

이메일 클릭 추적이 URL을 다시 쓰는 방법
이메일 클릭 추적이 URL을 다시 쓰는 방법
추적은 클릭 이벤트를 캡처하기 위해 URL을 다시 쓴 다음 사용자를 원래 목적지로 리디렉션하는 방식으로 작동합니다. 이는 거의 즉시 발생하지만 딥 링크에서 예상치 못한 동작을 일으킬 수 있습니다. 예를 들어:
https://some-domain.com/the-page는 다음과 같이 변환됩니다:https://some-domain/c/eJxU0D2uGzEMBODTrDoZJPW3...사용자는 의도한 URL로 즉시 리디렉션됩니다.disable_email_click_tracking: true로 설정합니다.

SMS/RCS trackable links
OneSignal은1sgnl.co 도메인을 사용하여 SMS/RCS 메시지에 대한 추적 가능한 단축 링크를 제공합니다. URL을 {{ "https://your-url.com" | track_link }}로 감싸기만 하면 메시지가 전송될 때 해당 링크가 추적 가능한 링크로 교체됩니다. API 사용 방법은 SMS/RCS 메시지 생성 API 참조를 참조하세요.
SMS/RCS 메시지당 추적 가능한 링크는 1개만 허용됩니다.
대시보드를 사용하는 경우 메시지 입력 상자 아래의 Insert Trackable Link 버튼을 클릭하고 URL을 입력합니다:

1sgnl.co/XXXX 추적 가능한 링크로 교체됩니다:

동적 URL
Liquid 구문을 사용하여 개인화된 사용자별 URL을 구성할 수 있습니다. 예를 들어 URL에 사용자 ID를 포함하여 각 사람이 자신의 프로필 페이지로 이동하거나, 최근 이벤트의 제품 ID를 삽입하여 관련 항목으로 직접 연결할 수 있습니다. 동적 URL은 다음 데이터를 가져올 수 있습니다:- 사용자 속성(예:
external_id,email) - OneSignal에 저장된 태그
- API를 통해 전송된
custom_data - 커스텀 이벤트(Journey에서)
- User properties
- custom_data
- Custom Events
external_id 또는 email과 같은 값을 URL에 직접 삽입합니다.external_id가 12345인 경우 최종 URL은 다음과 같습니다:john@example.com인 경우 최종 URL은 다음과 같습니다:UTM 매개변수
UTM 매개변수는 URL에source, medium 및 campaign 세부 정보를 추가하여 캠페인 성과를 추적합니다. 메시지의 URL에 UTM 매개변수를 직접 추가하면 됩니다.
대시보드에서 보낸 푸시 알림의 경우 OneSignal이 UTM을 자동으로 추가할 수 있습니다.
푸시 알림용 자동 UTM
푸시 알림용 자동 UTM
Settings > Push & In-app > UTM Settings으로 이동하여 Turn on automated UTM tagging을 활성화합니다.활성화되면 OneSignal은 다음 값을 추가합니다(편집 가능):
- Source =
utm_source— 기본값:onesignal - Medium =
utm_medium— 기본값:push - Campaign =
utm_campaign— 기본값:{{ sendDate }}-{{ title }}sendDate: 전송된 날짜title: 메시지 제목의 처음 15개 영숫자 문자, 밑줄 또는 하이픈
URL 처리 및 재정의
자동 태깅이 활성화된 상태에서 Launch URL에 UTM 매개변수를 수동으로 추가하면 수동 UTM이 자동 값을 재정의합니다.FAQ
앱 스토어에 링크하려면 어떻게 해야 합니까?
스토어 URL을 Launch URL로 사용합니다:- Android: Google Play 링크를 사용합니다(예:
https://play.google.com/store/apps/details?id=com.example.app). Google Play에 링크하기를 참조하세요. - iOS: 앱 스토어 링크를 사용하되
https://를itms-apps://로 바꿔 앱 스토어 앱을 직접 엽니다(예:itms-apps://apps.apple.com/app/id123456789).
다른 앱에 링크할 수 있습니까?
푸시 및 인앱 메시지의 경우 URL 스킴을 사용하여 다른 앱으로 딥 링크할 수 있습니다. 예를 들어 WhatsApp으로 딥 링크하려면whatsapp://wa.me/15551234567을 사용합니다.
이메일 및 SMS의 경우 https:// 링크를 사용하세요. 커스텀 URL 스킴은 지원되지 않습니다.
Launch URL이 작동하지 않는 이유는 무엇입니까?
일반적인 원인:- URL 불일치: URL은
https://로 시작해야 합니다. Apple 기기에서http://를 사용하는 경우 NSAppTransportSecurity를 설정해야 합니다. - 모바일의 커스텀 스킴:
your-app://path와 같은 딥 링크는 모든 플랫폼에서 Launch URL로 작동하지 않을 수 있습니다. Additional Data 필드를 사용하거나 안정적인 앱 라우팅을 위해 딥 링킹을 참조하세요. - 웹 푸시 기본값: Launch URL이 설정되지 않으면 웹 푸시는 홈페이지를 엽니다. 목적지를 제어하려면 Launch URL을 명시적으로 설정하세요.
- 클릭 추적 간섭: 이메일에서 클릭 추적을 위한 링크 재작성이 딥 링크를 손상시킬 수 있습니다. 해당 특정 링크에 대해 클릭 추적 비활성화를 시도해 보세요.
UTM 매개변수가 이메일 및 SMS에서 작동합니까?
아니요. 자동 UTM 태깅은 대시보드에서 보낸 푸시 알림에만 적용됩니다. 이메일 및 SMS의 경우 템플릿 또는 API 페이로드의 URL에 UTM 매개변수를 수동으로 추가하세요. 제한 사항 전체 목록은 UTM 매개변수를 참조하세요.푸시 알림이 URL을 열지 않도록 할 수 있습니까?
모바일에서는 푸시 알림을 클릭하면 항상 앱이 열립니다. 웹에서는 Launch URL에?_osp=do_not_open을 추가하면 페이지를 열지 않고 알림을 닫을 수 있습니다. 예시는 Launch URL 팁을 참조하세요.