Singular와 통합

글로서리

Singular

모바일 어트리뷰션 및 마케팅 분석 플랫폼인 Singular를 사용하면 애플리케이션 개발자, 마케터, 브랜드가 다양한 채널과 장치에서 마케팅 캠페인의 효과를 추적, 측정, 최적화할 수 있습니다.

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

애플리케이션 ID

각 플랫폼별 고유 모바일 애플리케이션 ID(Android, iOS)입니다. 이는 Bundle ID 값에 해당하는 값으로, 필수 애플리케이션 창 Settings > Apps 섹션의 Singular에서 찾을 수 있습니다.

인앱 이벤트

애플리케이션 내에서의 사용자 활동. 인앱 이벤트에 대한 자세한 내용은 Singular 문서를 참조하십시오. 웹샵 솔루션에서의 사용자 활동도 S2S 통합의 경우 인앱 이벤트로 간주되어 엑솔라 백엔드에서 Singular로 전송됩니다.

사용자 확보

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

리타겟팅

광고 캠페인을 통해 현재 또는 과거 사용자에게 도달하는 것을 의미합니다. 이전에 애플리케이션이나 사이트와 상호 작용한 적 있는 사용자의 참여를 유도하는 전략을 말합니다. 자세한 내용은 Singular 문서를 참조하십시오.

고객 사용자 ID(CUID)

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

주의

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

Postback

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

SDK 키

Singular에 이벤트 데이터를 전송하기 위해 호출을 승인하는 데 사용하는 토큰입니다. Singular 측에서 생성됩니다. 자세한 내용은 Singular 문서를 참조하십시오.

통합 절차

Singular 및 엑솔라는 모바일 애플리케이션 S2S 통합을 지원하므로 웹샵 솔루션으로 트래픽을 끌어 모으기 위해 사용자 확보 및 리타게팅 캠페인의 효과를 측정하고 평가할 수 있습니다. 엑솔라는 웹샵 솔루션 구매 정보를 모바일 인앱 이벤트로 Singular에 전송하면 Singular가 해당 소스에 어트리뷰션합니다.

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

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

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

작동 방식

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

  %%{init: {'themeVariables': { 'noteBkgColor': 'transparent', 'noteBorderColor': 'transparent', 'noteTextColor': '#495C6B' }}}%%
sequenceDiagram
    participant User
    participant Mobile App
    participant Web Shop
    participant Xsolla Backend
    participant Singular
    User->>Mobile App: 1. Logs in
    Mobile App->>Singular: 2. Sends CUID
    Singular->>Xsolla Backend: 3. Sends postback
    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->>Singular: 7. Sends xsolla-billing-payment event

1. 사용자(플레이어)가 모바일 애플리케이션에 가입하거나 로그인합니다.
2. 애플리케이션이 인앱 이벤트를 Singular에 전송합니다. 이 이벤트에 대한 예로, login 또는 CUID를 포함하는 다른 이벤트를 들 수 있습니다.
3. Singular는 사용자 장치에 대한 CUID 및 기타 데이터를 포함하는 Postback을 엑솔라에 전송합니다.
4. 사용자가 CUID를 사용하여 웹샵 솔루션에 로그인합니다.
5. 사용자가 Web Shop에서 구매를 합니다.
6. 구매 이벤트는 엑솔라 서버로 전송되어 Singular에서 수신한 데이터와 매칭됩니다.
7. 엑솔라 서버는 매핑에 필요한 매개 변수가 포함된 인앱 이벤트를 Singular로 전송합니다.

Singular는 새로운 이벤트, 구매 및 수익을 사용자 확보 또는 사용자 재참여를 유도한 미디어 소스에 귀속시킵니다.

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

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

3. 모바일 앱 S2S 통합 창에서 구성을 클릭합니다.
4. 창이 열리면 이 통합 활성화 상자가 체크 표시되는지 확인합니다.
5. 다음과 같은 데이터를 제공합니다:
   1. Singular SDK 키.
   2. 각 플랫폼(Android/iOS)에 대해 고유한 애플리케이션 ID. 플랫폼을 추가하려면 애플리케이션 ID 추가를 클릭하십시오.
6. 저장을 클릭합니다.
7. Singular에서 통합을 활성화합니다.

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

연결된 통합을 변경하는 방법:

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

Singular에서 설정하는 방법

Singular에서 다음을 수행해야 합니다.

1. S2S 키를 받아야 합니다.
2. 엑솔라와 통합 기능을 활성화해야 합니다.

SDK 키 받기

1. Singular 계정에 로그인합니다.
2. Developer Tools > SDK Integration 섹션을 엽니다.
3. SDK Keys 탭으로 이동합니다.
4. Show Keys를 클릭합니다.
5. SDK Key 필드에 값을 복사합니다.

엑솔라와 통합 활성화

1. Singular 계정에 로그인합니다.
2. Attribution Setup > Partner Configuration 섹션으로 이동합니다.
3. Add Partner를 클릭합니다.
4. 검색 창에 Xsolla를 입력하고 선택합니다.

5. 창이 열리면 통합을 구성할 애플리케이션을 선택합니다.
6. Next를 클릭합니다.
7. Events Postbacks 블록에서, Login 이벤트를 선택해야 합니다.
8. Save를 클릭합니다.

이벤트 값 구조

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

아이템 구매

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

추가 데이터

엑솔라는 xsolla-billing-payment 이벤트에서 전달된 매개 변수 외에도 다음과 같은 데이터를 전송합니다: