가이드

AppsFlyer 연결

AppsFlyer 연결

AppsFlyer를 연결하면 모바일 앱의 인스톨·이벤트·LTV·코호트·리텐션 데이터를 광고비와 매칭해 자동 분석합니다. AppsFlyer의 V2 API Token을 발급받아 워크스페이스에 연결합니다.

한 워크스페이스에는 iOS 앱 1개, Android 앱 1개까지 연결할 수 있습니다. 같은 플랫폼의 앱 두 개를 한 워크스페이스에 동시에 연결할 수는 없습니다. 동일 제품의 iOS/Android 쌍을 비교하는 용도이며, 별도 제품·브랜드는 워크스페이스를 분리하세요.

준비물

  • AppsFlyer 관리자(Admin) 권한 — V2 API Token의 조회·발급은 관리자 이상만 가능합니다. 권한이 없다면 계정 관리자에게 발급을 요청하세요.

  • AppsFlyer에 등록된 앱 1개 이상

1단계 — V2 API Token 발급

  1. AppsFlyer 대시보드 우측 상단 계정 메뉴를 열어 Security Center로 이동합니다.

appsflyer-account-menu.png
우측 상단 계정 메뉴 → Security center
  1. AppsFlyer tokens 섹션에서 Manage your AppsFlyer tokens를 엽니다.

appsflyer-security-tokens.png
Security Center → AppsFlyer tokens
  1. New token으로 새 토큰(API V2)을 만들거나 기존 토큰을 복사합니다.

appsflyer-tokens-new.png
Tokens 화면 → New token
  1. 토큰은 아주 긴 문자열입니다. 화면을 닫으면 다시 볼 수 없으니 바로 복사해 안전한 곳(비밀번호 관리자 등)에 저장해 두세요.

공식 안내: Managing AppsFlyer tokens

2단계 — API Allowlist에 뉴로 IP 등록 (Allowlist 사용 시 필수)

AppsFlyer의 API allowlist(허용 IP 목록)는 계정 보안 설정으로, 켜 두면 등록된 주소에서만 데이터를 가져갈 수 있습니다. 기본값은 비활성이지만 보안상 켜둔 계정이 많습니다. Allowlist가 활성 상태라면 아래 IP를 등록하지 않는 한 토큰이 유효해도 앱 목록 조회·연동이 실패합니다.

뉴로는 아래 주소 하나로 접속하니 이 주소만 Allowlist에 추가하면 됩니다.

등록할 IP: 3.39.125.53

등록 방법

  1. AppsFlyer 우측 상단 계정 메뉴(이메일 드롭다운) → Security Center로 이동합니다.

  2. API allowlist 섹션에서 Manage allowlist를 클릭합니다.

appsflyer-security-allowlist.png
Security Center → API allowlist
  1. + Add를 눌러 위 IP를 입력합니다.

  2. Active 토글이 켜져 있는지 확인하고 Save list로 저장합니다. (Save list만으로는 활성 상태가 바뀌지 않으니 토글을 따로 확인하세요.)

appsflyer-allowlist-page.png
① + Add → ② 뉴로 IP 입력 → ③ Active 확인 → ④ Save list
Allowlist는 계정 단위 설정이라 계정의 모든 앱에 한 번에 적용됩니다(토큰별이 아닙니다). 조회·활성화는 관리자(Admin)만 할 수 있습니다.

Allowlist를 사용하지 않는(비활성) 계정이라면 이 단계는 건너뛰어도 연동됩니다. 다만 토큰만으로 모든 IP에서 호출 가능하므로, 보안을 위해 Active 유지 + 위 IP 등록을 권장합니다.

공식 안내: Set up your API allowlist

3단계 — 뉴로에서 연결

  1. 워크스페이스의 서비스 연동 → AppsFlyer 카드를 클릭합니다.

  2. 1단계에서 발급받은 V2 API Token을 입력하고 앱 목록 조회를 누릅니다.

neuro-connect-appsflyer.png
뉴로 AppsFlyer 연결 창 — 토큰 입력 후 앱 목록 조회
  1. 토큰이 유효하면 계정의 앱 목록이 표시됩니다. 분석할 앱을 여러 개 동시에 선택할 수 있습니다 (예: 동일 앱의 iOS / Android).

  2. N개 앱 연결을 누르면 끝입니다. 토큰은 워크스페이스 안에 한 번만 암호화 저장되고, 선택한 앱 모두에 함께 쓰입니다.

사용 예시

연결 후에는 채팅에서 자연어로 분석을 요청할 수 있습니다. AI가 연결된 앱 목록을 자동 인지하므로 앱 ID를 따로 알려줄 필요가 없습니다.

  • “이번달 앱 인스톨 매체별로 보여줘.”

  • “iOS와 Android의 7일 리텐션 비교해줘.”

  • “이번 분기 LTV가 가장 높은 매체 / 캠페인.”

  • “리타게팅 캠페인의 ROAS 추이.”

Cohort · Master API는 별도 권한. V2 API Token은 Cohort API · Master API 권한과 연결되는데, 이 둘은 플랜에 포함돼야 쓸 수 있는 프리미엄 기능입니다. 포함 여부는 AppsFlyer “My Plan” 페이지의 feature list에서 확인할 수 있습니다. 플랜에 이 기능이 없으면 코호트·LTV·리텐션 리포트를 불러올 수 없습니다. AppsFlyer 담당자(integration manager / CSM)에게 기능을 켜 달라고 요청하세요. 설치·이벤트·매출 기본 리포트는 그대로 볼 수 있습니다.

문제 해결

코호트·LTV·리텐션 리포트가 안 나옵니다

계정 플랜에 Cohort API / Master API add-on이 포함돼 있지 않은 경우입니다. 요청 내용을 바꿔도 해결되지 않습니다. AppsFlyer “My Plan”에서 feature list를 확인하고, 필요하면 AppsFlyer 담당자에게 add-on 활성화를 요청하세요. (인스톨·이벤트 집계는 add-on 없이도 정상 동작합니다.)

토큰이 유효하지 않다고 나옵니다

오래전에 발급한 토큰은 쓸 수 없습니다. Security Center에서 새 토큰을 발급해 다시 입력하세요.

이 토큰은 앱 목록 조회 권한이 없습니다

대부분 계정의 API Allowlist에 뉴로 IP가 빠져 있어서 발생합니다. 2단계대로 Security Center → API allowlist에 위 IP를 추가하고 Active 토글과 Save list까지 했는지 확인하세요. 그래도 반복되면 토큰을 발급한 사용자가 관리자(Admin) 권한인지 확인하세요.

토큰을 교체하고 싶어요

AppsFlyer에서 새 토큰을 발급한 뒤 기존 AppsFlyer 연결들을 해제하고 새 토큰으로 다시 연결하세요. 같은 토큰을 다시 넣어도 중복 저장되지 않습니다.

연동·사용 중 문제가 있다면 pango_plat@pango-gy.com으로 연락 주세요. 영업일 기준 1-2일 내 회신합니다.