Pango NeuroPango Neuro
무료 체험

가이드

AppsFlyer 연결

AppsFlyer 연결

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

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

준비물

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

  • AppsFlyer에 등록된 앱 1개 이상

1단계 — V2 API Token 발급

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

  2. AppsFlyer tokens 섹션에서 Manage your AppsFlyer API tokens를 엽니다.

  3. API V2 Token을 새로 생성하거나 기존 토큰을 복사합니다. (V1 토큰은 2023-09부로 지원 종료)

  4. 생성된 토큰은 700자 이상의 JWT 문자열입니다. 화면을 닫기 전에 안전한 곳(비밀번호 관리자 등)에 저장해두세요.

공식 안내: Managing AppsFlyer tokens

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

AppsFlyer의 API allowlist (by IP address)는 계정 보안 설정으로, 켜면 등록된 IP에서 온 API 요청만 허용하고 나머지는 거부합니다. 기본값은 비활성이지만 보안상 켜둔 계정이 많습니다. Allowlist가 활성 상태라면 아래 IP를 등록하지 않는 한 토큰이 유효해도 앱 목록 조회·연동이 실패합니다.

Pango Neuro의 모든 AppsFlyer API 호출은 단일 고정 IP에서 나가므로, 그 IP 하나만 Allowlist에 추가하면 됩니다.

등록할 IP: 3.39.125.53

등록 방법

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

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

  3. + Add를 눌러 위 IP를 입력하고 Apply를 누릅니다. (단일 IP는 3.39.125.53/32 형식으로도 입력할 수 있습니다.)

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

Allowlist는 계정 단위 설정이라 계정의 모든 앱에 한 번에 적용됩니다(토큰별이 아닙니다). 조회·활성화는 관리자(Admin)만 할 수 있습니다.

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

공식 안내: Set up your API allowlist

3단계 — Pango Neuro에서 연결

  1. 워크스페이스의 연결된 계정 → AppsFlyer 카드를 클릭합니다.

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

  3. 토큰이 유효하면 계정의 앱 목록이 표시됩니다. 분석할 앱을 여러 개 동시에 선택할 수 있습니다 (예: 동일 앱의 iOS / Android).

  4. N개 앱 연결을 누르면 끝입니다. 토큰은 워크스페이스 안에 한 번만 암호화 저장되고, 선택한 모든 앱이 그 토큰을 공유 참조합니다.

사용 예시

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

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

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

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

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

문제 해결

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

2026-03-10 이전에 생성된 V2 토큰은 일괄 무효화되었습니다. Security Center에서 새 토큰을 발급받아 다시 입력하세요.

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

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

토큰을 교체하고 싶어요

AppsFlyer에서 새 토큰을 발급한 뒤 기존 AppsFlyer 연결들을 해제하고 새 토큰으로 다시 연결하세요. 워크스페이스의 토큰 저장소는 토큰 fingerprint 기준으로 자동 dedup됩니다.

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