메인 콘텐츠로 건너뛰기
Adjust는 마케팅 채널 전반에서 설치, 세션 및 인앱 이벤트를 어트리뷰션하는 모바일 측정 파트너(MMP)입니다. 이 통합은 OneSignal의 External ID를 onesignal_customer_id 파트너 파라미터로 Adjust에 전달하여, Adjust가 OneSignal로 전달하는 이벤트를 올바른 사용자와 연결할 수 있도록 합니다.

​
요구 사항

  • OneSignal 모바일 SDK 버전 5.5.0 이상.
  • OneSignal 사용자에 설정된 External ID. Adjust와 OneSignal 간 데이터 동기화는 이 ID를 키로 사용하므로, 익명 사용자에 대해서는 이벤트를 연결할 수 없습니다.

​
설정

Adjust 콜백이 올바른 OneSignal 사용자에게 도달하려면 두 가지 조건이 필요합니다. Adjust가 이벤트를 OneSignal로 전달하도록 구성되어 있어야 하고, 앱은 매 세션마다 External ID를 파트너 파라미터로 첨부해야 합니다.

​
1. Adjust 대시보드에서 데이터 공유 활성화

Adjust 대시보드에서 OneSignal 통합을 활성화하고 전달할 이벤트를 선택합니다. Adjust는 기본적으로 install 및 session 활동을 보내며, 추가로 커스텀 이벤트와 인앱 매출을 매핑할 수 있습니다. 정확한 단계는 Adjust의 Set up OneSignal 가이드를 참고하세요.
이 대시보드 단계를 완료하지 않으면 Adjust는 OneSignal로 콜백을 보내지 않으며, 다음 단계의 SDK 코드가 onesignal_customer_id 파라미터를 첨부할 콜백 자체가 존재하지 않게 됩니다.

​
2. External ID를 파트너 파라미터로 전달

사용자가 앱에 로그인하면 OneSignal의 login 메서드를 호출하여 External ID를 설정한 다음, Adjust의 addGlobalPartnerParameter 메서드를 키 onesignal_customer_id와 동일한 External ID를 값으로 하여 호출합니다. Adjust는 이후 모든 콜백에서 이 키–값 쌍을 전달하고, OneSignal은 onesignal_customer_id를 사용하여 콜백을 올바른 사용자와 매칭합니다.
iOS를 제외한 모든 Adjust SDK는 (key, value) 인수 순서를 사용합니다. iOS Swift 및 Objective-C는 (value, forKey: key)를 사용합니다. External ID를 실수로 키로 전달하면 통합은 조용히 실패합니다. Adjust는 사용자 ID 문자열이 이름인 파라미터를 전달하게 되고, OneSignal은 onesignal_customer_id를 볼 수 없습니다.
val externalId = "your_user_id"
OneSignal.login(externalId)
Adjust.addGlobalPartnerParameter("onesignal_customer_id", externalId)
기반이 되는 Adjust SDK 레퍼런스는 Adjust의 Global Partner Parameters 문서를 참고하세요: Android 및 iOS.

​
Deep linking

Adjust는 푸시 탭을 앱의 특정 화면으로 라우팅하기 위해 iOS Universal Links와 Android App Links를 사용합니다. Adjust 딥링크를 열어야 하는 OneSignal 알림을 보낼 때는, Adjust의 Push Notifications 가이드에 설명된 대로 알림의 Launch URL을 Adjust 딥링크로 설정하세요. 플랫폼별 Launch URL 처리 방식은 OneSignal의 Deep linking 가이드를 참고하세요.

​
FAQ

​
onesignal_customer_id 파트너 파라미터는 무엇인가요?

onesignal_customer_id는 OneSignal이 Adjust 콜백에서 읽어 Adjust 이벤트를 OneSignal 사용자와 연결하는 데 사용하는 정확한 키입니다. 값은 OneSignal.login에 전달하는 것과 동일한 External ID로 설정하세요. 다른 어떤 키 이름도 인식되지 않습니다.

​
Adjust.addGlobalPartnerParameter는 언제 호출해야 하나요?

OneSignal.login을 호출할 때마다 호출하세요. 앱 시작 시 사용자 ID를 알게 되는 시점, 그리고 계정 전환 시입니다. 이는 OneSignal의 로그인 가이드를 반영하며, Adjust 파트너 파라미터가 현재의 OneSignal 사용자와 동기화된 상태를 유지하게 합니다.

​
사용자가 로그아웃하거나 계정을 전환하면 어떻게 되나요?

Adjust는 변경하거나 제거할 때까지 글로벌 파트너 파라미터를 메모리에 유지합니다. 로그아웃 시 Adjust.removeGlobalPartnerParameter("onesignal_customer_id")를 호출하거나 다음 로그인에서 값을 덮어쓰세요. 그렇지 않으면 Adjust는 이후 이벤트를 이전 사용자의 External ID에 계속 어트리뷰션합니다.

​
Adjust는 OneSignal에 어떤 데이터를 보내나요?

기본적으로 Adjust는 install 및 session 활동과 함께 Adjust 대시보드에서 매핑한 이벤트를 전달합니다. 전달되는 필드의 전체 목록은 Adjust의 OneSignal 통합 문서에서 확인할 수 있습니다.

​
관련 페이지

External ID

파트너 통합이 데이터를 연결할 수 있도록 OneSignal 사용자에 안정적인 식별자를 설정합니다.

Mobile SDK: login

호출 시점과 재시도 동작을 포함한 OneSignal.login 레퍼런스.

Deep linking

푸시, 인앱, 이메일, SMS용 Universal Links, App Links 및 URI 스킴을 구성합니다.

Keys & IDs

Adjust 대시보드 설정에 사용할 OneSignal App ID와 REST API Key를 확인합니다.