다음 도구들을 사용 중이라면 Singular와의 웹 SDK 통합을 구성하여 고급 이벤트 분석을 얻을 수 있습니다:

• Singular 모바일 측정 플랫폼
• 엑솔라 웹사이트 빌더

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

작동 방식

다음은 사용자 확보 및 리타겟팅 캠페인 구현 시 시스템 상호 작용에 대한 시나리오입니다. 사용자가 광고 배너를 통해 웹샵 솔루션으로 이동하여 구매를 진행합니다. 이 과정에서 Singular로 전송되는 일련의 이벤트를 통해:

• 얼마나 많은 사용자가 각 배너를 클릭했는지 그리고 어떤 배너를 통해 유입되었는지
• 사용자가 결제한 금액
• 리타게팅 캠페인의 효과 여부

  sequenceDiagram
    participant User
    participant Promo as Web Shop<br>promotional campaign<br>(ad banner)
    participant Shop as Web Shop
    participant SG as Singular
    User->>Promo: 1. Clicks banner
    Promo->>Shop: 2. Redirect with URL parameters
    Shop->>SG: 3. load event
    User->>Shop: 4. Logs in with CUID
    Shop->>SG: 5. identify event
    User->>Shop: 6. Makes purchase
    Shop->>SG: 7. event

사용자 절차:

1. 사용자가 광고 캠페인 배너를 클릭합니다.
2. 사용자는 웹샵 솔루션으로 리디렉션되며, 이 거래의 URL에는 Singular 매개 변수 및 매크로가 포함되어 사용자가 어떤 배너와 웹 사이트에서 유입되었는지 명시합니다.
3. 웹샵 솔루션 클라이언트 측에서 방문 이벤트가 Singular로 전송됩니다.
4. 사용자가 CUID를 사용하여 웹샵 솔루션에 로그인합니다.
5. 인증 이벤트가 Singular로 전송됩니다.
6. 사용자가 웹샵 솔루션에서 구매를 완료합니다.
7. 구매 이벤트가 Singular로 전송됩니다.

Singular에서 설정하는 방법

1. Singular 계정에 로그인합니다.
2. 설정 > 앱 섹션으로 이동합니다.

3. 새로운 단계 추가를 클릭합니다.

4. 웹 애플리케이션 이름을 지정합니다.

5. 운영 체제로 웹을 선택합니다.
6. URL 입력란에서 웹샵 솔루션의 도메인(예: yourapp.yourcompany.com)을 지정합니다.
7. 번들 ID 입력란에서 역 DNS 형식(예: com.yourcompany)으로 번들 ID를 지정합니다.
8. 저장을 클릭합니다.

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

1. 관리자 페이지에서 프로젝트를 엽니다.
2. 다음 방법 중 하나로 웹사이트 빌더로 이동합니다:
   • 사이드 메뉴에서 스토어프론트 > 웹사이트를 클릭하고, 사이트를 선택한 후 구성을 클릭합니다.
   • 사이드 메뉴에서 통합을 클릭합니다. 열린 섹션에서:
     1. Singular 창을 클릭합니다.

1. • 2. 웹 SDK(웹사이트 빌더) 창에서 구성을 클릭합니다.

2. • 3. 사이트를 선택하고 구성을 클릭합니다.
     4. 사이트 설정 탭에서 앱 섹션으로 이동합니다.
     5. Singular 창에서 연결을 클릭합니다.

3. Singular 연결 양식에서 SDK 키, SDK 비밀 키 및 번들 ID 입력란을 기입합니다:

3. Singular 계정에서 이러한 정보를 찾는 방법:
   1. Singular 계정에 로그인합니다.
   2. 개발자 도구 > SDK 통합 섹션으로 이동합니다.
   3. SDK 키 탭으로 이동합니다.
   4. 키 표시를 클릭합니다.
   5. SDK 키 입력란의 값을 복사합니다.
   6. SDK 비밀 키 입력란의 값을 복사합니다.

3. 7. 번들 ID를 찾으려면 설정 > 앱 > 웹 애플리케이션으로 이동하여 번들 ID를 복사하십시오.

4. 연결을 클릭합니다.

웹샵 솔루션을 위한 웹 및 인앱 광고 캠페인 실행 방법

엑솔라 웹샵 솔루션을 위한 사용자 확보 및 리타게팅 광고 캠페인을 실행하고 추적하려면 다음 지침을 따르십시오. 다음 두 가지 모두에 적용됩니다:

• 웹-웹샵 솔루션 캠페인(웹 소스에서 웹샵 솔루션으로 사용자를 유도하는 광고)
• 인앱-웹샵 리타게팅 캠페인(앱에서 웹샵 솔루션으로 사용자를 타겟팅하는 광고)

1. Singular 계정에 로그인합니.
2. 특성 설정 섹션으로 이동하여 웹 링크 생성을 선택합니다.
3. 대상(앱) 입력란에서 엑솔라 웹샵 솔루션과 관련된 웹 앱을 선택합니다.
4. 파트너 입력란에서 광고 네트워크 파트너를 선택합니다.

5. 필요할 경우 랜딩 페이지 경로를 입력합니다(선택 사항).
6. 캠페인 세부 정보를 수집하려면 UTM 입력란을 업데이트하십시오(선택 사항).
7. 링크 생성을 클릭합니다.

웹 캠페인 최종 목적지 URL이 선택 항목에 따라 생성됩니다. 웹 캠페인에 이 링크를 연동하십시오.

더 자세한 캠페인 추적(세분화)을 위해 생성된 URL에 매크로를 추가할 수 있습니다. Singular 웹 SDK용 매크로 매개 변수를 추가하려면 매크로 추가 가이드를 참고하여 캠페인 수준 데이터 수집을 활성화하십시오. 링크에 이미 존재하는 매개 변수를 덮어쓰지 않도록 주의하십시오.

선택한 특정 광고 네트워크에 따라 지침이 업데이트될 수 있습니다. 웹 URL 빌더에 표시되는 광고 네트워크별 참고 사항을 항상 따르십시오.

Singular에서 웹/웹샵 솔루션 이벤트 추가 방법

1. Singular 계정에 로그인합니다.
2. 설정 > 이벤트 섹션으로 이동합니다.
3. 웹 SDK로 캡처한 이벤트를 추가합니다:
   1. 앱별 이벤트를 선택합니다.
   2. 해당 애플리케이션을 선택합니다.
   3. 코호트 이벤트 섹션에서 보고서에 표시될 이벤트 이름을 추가합니다.
   4. 다음에 매핑되는 이벤트 입력란에서 SDK 이벤트를 선택합니다.
   5. 저장을 클릭합니다.

Singular에서 웹샵 솔루션 광고 캠페인 성과 보고서 확인 방법

웹-웹 및 인앱-웹 광고 캠페인 보고서 생성 방법:

1. Singular 계정에 로그인합니다.
2. Reports > Insights 섹션으로 이동합니다.
3. 필터를 구성합니다:
   • 원하는 날짜 범위를 설정합니다.
   • 분석할 앱을 선택합니다.

4. 데이터를 세분화하려면 차원을 추가하세요:
   • 출처
   • 캠페인 이름
   • 필요에 따라 추가 차원

5. 웹 지표를 선택합니다:
   • 웹 신규 방문자
   • 웹 재참여 방문자

6. 코호트 데이터를 포함합니다:
   • 수익
   • 투자수익률(ROI)
   • 설정 > 이벤트 페이지에서 이전에 구성한 모든 사용자 지정 코호트 이벤트

7. 오른쪽 상단 모서리 부분에 있는 보고서 실행을 클릭합니다.

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

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

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

작동 방식

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

  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 이벤트에서 전달된 매개 변수 외에도 다음과 같은 데이터를 전송합니다: