Tenjin와 통합

글로서리

Tenjin

모바일 어트리뷰션 및 마케팅 분석 플랫폼입니다. 이를 통해 애플리케이션 개발자와 마케터는 다양한 채널과 기기에서 마케팅 캠페인을 추적, 측정 및 최적화할 수 있습니다.

플랫폼에 대한 자세한 내용은 Tenjin 문서를 참조하십시오.

애플리케이션 ID

Tenjin에 애플리케이션을 추가할 때 자동으로 생성되는 모바일 애플리케이션 ID입니다. 이는 Bundle ID에 해당합니다. 값을 확인하는 방법:

1. Tenjin 계정에서 Configure > All apps 섹션으로 이동하세요.
2. 필요한 애플리케이션의 페이지를 엽니다.
3. Add details 섹션에서 Bundle ID를 복사하세요.

SDK 키

Tenjin에 애플리케이션을 추가할 때 자동으로 생성되는 모바일 애플리케이션 ID입니다. 이는 Bundle ID에 해당합니다. 값을 확인하는 방법:

1. Tenjin 계정에서 Configure > All apps 섹션으로 이동하세요.
2. 필요한 애플리케이션의 페이지를 엽니다.
3. Add details 섹션에서 Bundle ID를 복사하세요.

참고

애플리케이션을 iOS 및 Android 플랫폼 모두에 게시한 경우 계정 수준의 키를 받아야 합니다. 계정 수준의 키를 받으려면 Tenjin 담당자에게 문의하십시오.

계정 수준의 키

애플리케이션을 iOS 및 Android 플랫폼에 게시할 때 서버 간(S2S) 호출을 인증하는 데 사용되는 토큰입니다. Tenjin에서 수동으로 생성됩니다. 이 토큰을 획득하려면 Tenjin 담당자에게 문의하십시오.

각 플랫폼마다 번들 ID가 고유하다는 점을 명심하십시오.

Tenjin ID

Tenjin에서 생성한 사용자 ID(analytics_installation_id).

평생 가치(LTV)

애플리케이션을 사용하는 동안 사용자가 생성한 평균 수익입니다. LTV에 대한 자세한 내용은 Tenjin 문서를 참조하십시오.

광고 투자 대비 수익(ROAS)

광고 지출 단위당 벌어들인 수익을 계산하여 광고 캠페인의 효과를 측정하는 지표입니다. ROAS에 대한 자세한 내용은 Tenjin 문서를 참조하십시오.

투자 수익률(ROI)

총 비용 대비 획득한 이익의 비율을 계산하여 투자 수익률을 측정하는 지표입니다. ROI에 대한 자세한 내용은 Tenjin 문서를 참조하십시오.

인앱 이벤트

애플리케이션 내의 사용자 작업입니다. S2S 통합의 경우 웹샵 솔루션 내 사용자 작업도 인앱 이벤트로 간주되어 엑솔라 백엔드에서 Tenjin로 전송됩니다.

사용자 확보

마케팅 활동을 통해 사이트, 서비스, 플랫폼 또는 애플리케이션에 새로운 사용자를 끌어들이는 프로세스입니다.

고객 사용자 ID(CUID)

사용자 등록 시 애플리케이션 소유자가 생성하고 설정한 사용자 ID입니다. СUID는 웹샵 솔루션과 Tenjin에서 동일해야 합니다. 이 매개 변수는 사용자 매칭 및 어트리뷰션을 지원합니다.

알림

웹 스토어와 모바일 애플리케이션의 CUID가 일치하지 않는 경우 웹샵 솔루션에서 사용자 유효성 검사 웹훅 또는 딥링크를 통한 인증을 실행하려면 고객 성공 관리자에게 연락하거나 csm@xsolla.com으로 이메일을 보내세요.

콜백

인앱 이벤트에 대한 데이터를 수신하는 프로세스입니다. 자세한 내용은 Tenjin 문서를 참조하십시오.

통합 시나리오

Tenjin과 엑솔라는 애플리케이션 내에서 그리고 웹샵 솔루션에서 구매를 위해 전체 LTV, ROAS, ROI 측정 완료를 허용하는 모바일 애플리케이션 S2S 통합을 지원합니다. 엑솔라는 웹샵 솔루션의 구매 정보를 모바일 인앱 이벤트로 Tenjin에 전송합니다.Tenjin는 이벤트를 모바일 애플리케이션 설치 수, 사용자 획득 캠페인에 귀속시킵니다.

다음과 같은 경우 모바일 애플리케이션 통합을 구성하여 고급 이벤트 분석을 얻을 수 있습니다:

• Android/iOS 플랫폼에 모바일 애플리케이션이 있는 경우.
• Tenjin을 사용하는 경우.
• 인게임 아이템을 판매하는 데 웹샵 솔루션을 사용하는 경우.

엑솔라와 Tenjin S2S 통합을 통해 다음 이벤트를 이용할 수 있습니다:

작동 방식

이 통합에는 엑솔라와 Tenjin 간의 양방향 데이터 흐름이 포함됩니다. 다음은 사용자가 구매할 때 시스템이 상호 작용하는 시나리오입니다.

  sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Tenjin
    User->>Mobile App: 1. Logs in
    Mobile App->>Tenjin: 2. Sends CUID
    Tenjin-->>Xsolla Backend: 3. Sends callback
    User->>Web Shop: 4. Logs in using CUID
    User->>Web Shop: 5. Makes a purchase
    Web Shop->>Xsolla Backend: 6. Sends purchase event
    Xsolla Backend->>Tenjin: 7. Sends xsolla-billing-payment event

1. 사용자가 모바일 애플리케이션에 가입하거나 로그인합니다.
2. 사용자의 애플리케이션은 CUID를 포함하는 인앱 이벤트를 Tenjin으로 전송합니다.
3. Tenjin은 콜백을 엑솔라에 전송합니다. 여기에는 애플리케이션 ID, Tenjin ID, CUID, 기타 관련 데이터 매개 변수가 포함됩니다.
4. 사용자가 CUID를 사용하여 웹샵 솔루션에 로그인합니다.
5. 사용자가 Web Shop에서 구매를 합니다.
6. 구매 이벤트는 엑솔라 서버로 전송되어 Tenjin에서 수신한 데이터와 매칭됩니다.
7. 엑솔라 서버는 Tenjin에서 받은 Tenjin ID, 애플리케이션 ID 및 기타 매개 변수가 포함된 S2S 인앱 이벤트를 Tenjin에 전송합니다.

Tenjin은 새로운 이벤트, 구매 및 수익을 미디어 소스로 다시 어트리뷰트합니다.

관리자 페이지에서 설정하는 방법

1. 관리자 페이지에서 프로젝트를 열고 통합 섹션으로 이동합니다.
2. Tenjin 창을 클릭합니다.

3. 모바일 앱 S2S 통합 창에서 구성을 클릭합니다.
4. 이 통합 활성화 확인란을 선택합니다.
5. 다음 데이터를 입력하십시오:
   • 플랫폼별로 Tenjin 측에서 생성된 SDK 키입니다. iOS 및 Android 플랫폼 모두에 애플리케이션을 게시한 경우, Tenjin으로부터 받은 계정 수준의 키를 지정해야 합니다.
   • 애플리케이션 ID.
6. 저장을 클릭합니다.
7. Tenjin에서 통합을 활성화합니다.

설정을 저장하면 S2S 통합 창에 녹색 표시등이 표시됩니다.

활성화 통합을 변경하는 방법:

1. Tenjin 창을 클릭합니다.
2. 창이 열릴 경우 필요한 사항을 변경합니다.
3. 저장을 클릭합니다.

Tenjin에서 설정하는 방법

Tenjin에서 다음을 수행해야 합니다:

1. Tenjin에 CUID 전달 구성.
2. 엑솔라를 광고 채널로 추가.
3. 콜백 구성.

CUID 전달

setCustomerUserId 메서드를 호출하여 다음과 같이 모바일 애플리케이션에서 Tenjin으로 CUID 전송을 구성하십시오:

1TenjinSDK instance = TenjinSDK.getInstance(this, "<TENJIN_SDK_KEY>");
2instance.setCustomerUserId(cuid);   // CUID generated by your backend
3instance.connect();

1TenjinSDK.initialize("<TENJIN_SDK_KEY>")
2TenjinSDK.setCustomerUserId(userId: cuid);  // CUID used for Web Shop
3TenjinSDK.connect();

1BaseTenjin instance = Tenjin.getInstance("<TENJIN_SDK_KEY>");
2instance.SetCustomerUserId(cuid);   // CUID used for Web Shop
3instance.Connect();

엑솔라를 추가 채널로 추가

1. Tenjin 계정에 로그인합니다.
2. Configure > Channels 섹션으로 이동합니다.
3. Add a channel을 클릭합니다.

4. 검색창에 엑솔라를 입력하고 선택합니다.
5. Xsolla 창을 클릭합니다.

6. Add ad account을 클릭합니다.

콜백 구성

1. Tenjin 계정에 로그인합니다.
2. Configure > Channels 섹션으로 이동합니다.
3. 필요한 애플리케이션의 페이지로 이동합니다.
4. Callbacks 탭으로 이동합니다.
5. 광고 채널 드롭다운 목록에서 Xsolla를 선택합니다.

6. Channel callbacks 섹션에서 Add events를 클릭하고 Xsolla login을 선택합니다.

7. 모달 창에서 CUID를 포함하는 이벤트를 선택하고 Save을 클릭합니다.

이벤트 값 구조

특정 이벤트를 설정하거나 현재 통합 옵션이 요구 사항을 충족하지 못하는 경우에는 고객 성공 관리자에게 문의하거나 csm@xsolla.com으로 이메일을 전송하십시오.

아이템 구매

사용자가 Web Shop에서 구매하면 엑솔라는 Tenjin에 xsolla-billing-payment 이벤트를 전송합니다. 이벤트 매개 변수에 다음과 같은 구매 정보가 전달됩니다:

추가 데이터

또한 콜백에서 다음 매개 변수를 전달할 수 있습니다: