앱스플라이어와 엑솔라(Xsolla) 연동

한눈에 보기: 엑솔라(Xsolla)는 앱스플라이어 연동 파트너로, 전통적인 앱 플랫폼의 외부에서 발생하는 결제 처리를 전문으로 하는 게임 커머스 기술 파트너입니다. 엑솔라와 앱스플라이어의 연동을 통해, 엑솔라는 웹샵(Web Shop)에서 이루어진 구매 및 수익을 자동으로 앱스플라이어에 전송할 수 있으며, 이를 통해 엑솔라 웹샵에서 이루어진 구매를 포함한 게임의 전체 ROAS 및 LTV를 확인할 수 있습니다.

중요!

일부 미디어소스는 써드 파티와의 데이터 공유를 제한합니다. 따라서 포스트백 전송 설정에 관계없이 제한된 이벤트 포스트백은 이 파트너에게 전송되지 않습니다.

연동 유형

엑솔라와의 연동 방법에는 두 가지가 있습니다.

  • 기술 파트너 연동: 이 연동을 통해 엑솔라의 웹샵 구매 및 수익을 모바일 인앱 이벤트로 전송할 수 있으며 이는 즉, 앱 스토어 내 구매에만 국한되지 않고, 웹샵 수익까지 포함한 보다 확장된 수익 데이터를 바탕으로 모바일 앱 캠페인의 ROAS와 LTV를 향상시킬 수 있습니다.
  • PBA 웹 SDK 연동: 이 연동을 통해 엑솔라는 웹샵에서 발생한 구매 및 수익을 웹 이벤트로 전송할 수 있으며, 이를 통해 앱스플라이어는 게임 유저를 웹샵으로 직접 유도하는 웹 캠페인의 성과를 측정할 수 있습니다.

선행 조건: 

  • 연동을 설정하기 전에 파트너에게 연락하여 계정을 개설하세요.
  • 연동이 제대로 작동하도록 하려면 고객 사용자 ID(CUID)를 앱스플라이어와 공유하고, 엑솔라와 공유된 사용자 ID가 일치하는지 확인해야 합니다. 이 과정을 통해 사용자가 엑솔라의 웹샵에 원활히 로그인할 수 있으며, 사용자 데이터가 앱스플라이어에 정확하게 전송됩니다.

기술 파트너 연동 설정

연동 활성화 또는 편집 방법:

  1. 활성화 방법: 앱스플라이어에서, 측면 메뉴에서 협업 > 파트너 마켓플레이스를 선택하세요.
    편집 방법: 앱스플라이어의 사이드 메뉴에서 협업 > 활성화된 연동을 선택하세요.
  2. 파트너를 검색하고 선택합니다.
  3. 연동 설정을 클릭하십시오. 연동 설정 페이지로 이동합니다.
  4. 연동 탭에서 연동할 앱을 선택하고 파트너 활성화를 켭니다.
    참고: 파트너와 작업하는 동안 토글이 켜져(활성화됨) 있어야 합니다.
  5. 아래 설명된 대로 관련 탭을 사용하여 설정을 완료하십시오.

설정 창에서는 연동 탭만 활용합니다.

파트너 설정 창 헤더에 대한 자세한 설명은 여기를 클릭하십시오.

연동 탭

파트너 활성화

연동 탭에 처음으로 들어간 경우, 파트너 활성화 토글을 켜서 연동을 설정해야 합니다. 엑솔라와 작업하는 동안, 토글이 켜져 있어야 합니다. 파트너 활성화에 대해 더 알아보십시오. 

고급 개인정보 보호

iOS 앱의 경우, 고급 개인정보 보호 토글이 나타납니다. 이 기능을 켜면 파트너와의 사용자 식별자 공유가 제한됩니다. 앱 설정에서 집약형 프라이버시 강화(Aggregated Advanced Privacy ) 토글을 켜면, Advanced Privacy(iOS 14.5+ 이상의 경우)가 기본적으로 켜지고 잠깁니다.

기본 포스트백

앱스플라이어는 사용자 설치 후 기본 포스트백을 엑솔라에 전송합니다. 이 섹션을 통해 다음과 같은 포스트백을 정의할 수 있습니다.

  • 끄기: 인스톨 포스트백은 엑솔라에 전송되지 않습니다.
    참고: 엑솔라의 앱스플라이어와의 연동은 설치 포스트백을 전송할 필요가 없습니다. 따라서, 해당 포스트백을 꺼두는 것을 권장드립니다.
  • 오가닉을 포함한 모든 미디어 소스: 인스톨 포스트백은 파트너에 어트리뷰트된 이벤트와 오가닉 이벤트 모두에 대해 전송됩니다.

default_postbacks.png

인앱 이벤트 포스트백

이 섹션에서는 포스트백을 통해 앱스플라이어 이벤트를 파트너와 매핑할 수 있습니다. 

xsolla-af-login-3.jpg

  1. 인앱 이벤트 포스트백을 활성화하세요.
  2. 이벤트 추가를 클릭하여 목록에 SDK 또는 서버-투-서버 이벤트를 추가합니다.
  3. 다음 파라미터를 완성하세요.
    파라미터 이름 설명
    AppsFlyer event

    앱에 연동된 SDK 또는 서버 간 이벤트를 통해 앱스플라이어에서 수신하는 이벤트의 이름입니다.

    참고:

    • 엑솔라의 경우, 위 스크린샷에 표시된 대로 모바일 앱에 대한 사용자 로그인을 나타내는 af_login 이벤트 또는 기타 이벤트를 추가해야 합니다.
    • 엑솔라는 너무 자주 발생하는 이벤트를 전송하지 않고, CUID(예: af_app_opened)를 포함하지 않도록 권장하고 있습니다. 연동 기능이 정상적으로 작동하지 않을 수 있기 때문입니다.
    mapped to partner event 엑솔라에 전송할 해당 이벤트 이름을 입력하세요. 엑솔라의 명명 규칙은 유연하며 이 필드에서 어떤 이름이든 사용할 수 있습니다.
    for users from 모든 파트너에게 기여된 이벤트 및 오가닉 이벤트에 대한 포스트백을 전송하려면, 오가닉을 포함한 모든 미디어 소스를 선택하세요.
    포함
    • 값 없음 및 수익 없음: 파라미터 없이 이벤트 자체만 발송합니다 (값이나 수익).
    • 값 있음 및 수익 없음: 수익 값을 제외한 모든 파라미터를 전송합니다.
    • 값 있음 & 수익 있음: 이벤트에 수익 값이 포함되어 있다면, 수익 값을 포함한 모든 이벤트 파라미터를 전송해 주세요.
    참고: 엑솔라와 앱스플라이어의 연동에서는 값 또는 수익 데이터를 전송할 필요가 없습니다. 따라서 선택된 모든 옵션이 적용 가능합니다. 
  4. 연동 저장을 클릭합니다.

어트리뷰션 링크 탭

엑솔라에 대한 어트리뷰션 링크는 제공되지 않습니다.

비용 탭

비용 데이터는 엑솔라와의 연동에서 지원되지 않습니다.

광고 수익 탭

광고 수익 데이터는 엑솔라와의 연동에서 지원되지 않습니다.

권한 탭

Xsolla에 대한 권한이 없습니다.

PBA 웹 SDK 통합 설정하기

이 연동을 통해, PBA 대시보드 내에서 앱 성과 분석에 활용할 수 있는 LTV 데이터와 인사이트를 얻을 수 있습니다.

연동을 설정하려면:

  1. 앱스플라이어에서 할일: Xsolla 앱을 추가하세요. 플랫폼으로 Web (PBA)를 선택하고 다음 세부정보를 입력하세요:
    • 웹 앱 URL로 웹 샵 도메인을 사용하세요. 예를 들어, 웹 샵 도메인이 www.webshop.com인 경우, 이를 웹 앱 URL로 사용하세요.
    • 앱 이름으로 원하는 앱 이름을 입력하세요. (아무 값이나 가능)
  2. 앱스플라이어에서 할일: 엑솔라 번들을 추가할 때 다음 세부사항을 확인하세요:
    1.  
      1. 번들 이름으로 원하는 번들 이름을 입력하세요. (아무 값이나 가능)
      2. 이전 단계에서 생성한 웹 앱을 번들의 웹 앱으로 선택하세요.
  3. 엑솔라에서 할 일: 앱스플라이어를 엑솔라 퍼블리셔 계정과 연결하세요:
    1. 퍼블리셔 계정에서 프로젝트를 엽니다.
    2. 귀하의 사이트를 선택하고 Configure를 클릭하세요.
    3. Site settings 탭에서 Apps 섹션으로 이동하세요.
    4. AppsFlyer 블록에서, Connect를 클릭하세요.
      xsolla-connect.jpg
    5. AppsFlyer Dev Key 필드에 앱스플라이어 웹 개발 키를 입력하세요. 앱스플라이어에서 웹 개발 키를 찾는 방법은 아래에서 확인하세요.
    6. Connect를 클릭하세요.

앱스플라이어에서 웹 개발 키 찾기

  1. 나의 앱 페이지에서, View brand bundles를 클릭합니다.
  2. 엑솔라 번들 행에서 복사 아이콘을 클릭합니다.

xsolla-brand-bundle2.jpg

앱스플라이어에서 엑솔라의 이벤트 식별하기

기술 파트너(S2S) 연동:

엑솔라는 앱스플라이어에 2개의 인앱 이벤트를 보냅니다:

  • xsolla-billing-payment - 구매한 항목
  • xsolla-billing-refund - 구매 환불한 황목

두 이벤트 모두 모바일 앱 인앱 이벤트의 일부입니다.

웹 SDK 연동:

엑솔라는 특정 광고주 활동에 맞게 사용자 정의된 여러 웹 이벤트를 앱스플라이어에 보냅니다. 가장 중요한 항목은 'PURCHASE'라는 이름이며, 수익 정보를 포함하고 있습니다.
엑솔라의 웹 이벤트는 PBA의 웹 어트리뷰션 및 “웹 이벤트” 데이터 락커 로리포트에 표시됩니다.

특징 및 제약 사항

PC / 콘솔 지원 - 이 단계에서 엑솔라와 앱스플라이어의 연동은 PC / 콘솔 앱을 지원하지 않습니다.

참고 항목