요약: 앱스플라이어에 앱을 추가하여 인스톨 및 인앱 이벤트에 대한 어트리뷰션 데이터를 얻고, 다양한 도구를 사용하여 데이터를 분석하는 방법을 알아보세요.
개요
아직 대시보드에 앱을 추가하지 않았다면, 앱스플라이어에 로그인 시 앱 온보딩 페이지가 표시됩니다. 앱 온보딩은 앱을 추가하고 어트리뷰션 준비를 마칠 수 있도록 모든 단계를 안내합니다.
앱 추가 마법사 시작
플랫폼에서 앱 추가 마법사를 사용할 수 있으며, 안드로이드 및 iOS 앱의 경우, 앱 온보딩 페이지를 통해 앱을 추가할 수도 있습니다.
앱 온보딩 페이지에서 마법사를 시작하려면:
- 앱 추가 단계에서 앱 추가를 클릭하고, 앱 추가 지침을 따르세요.
참고
온보딩 페이지가 아직 열려 있지 않다면, 상단 메뉴 표시줄에서 이메일 주소 드롭다운으로 앱 온보딩을 클릭합니다.
플랫폼에서 앱 추가 마법사를 시작하려면:
- 상단 메뉴바에서 내 앱을 통해 + 앱 추가를 클릭합니다.
- 앱스플라이어 홈페이지에서 + 앱 추가를 클릭하세요.
- 상단 바에서 계정 메뉴(이메일 주소 드롭다운) >앱 온보딩을 열고 + 다른 앱 온보딩을 클릭합니다.
앱 추가
앱 추가 마법사에 들어간 후, 다음 단계를 따르세요.
- 앱 세부정보를 입력하세요.
- 추가 정보를 입력하세요.
- 내 앱 추가를 클릭하세요.
- SDK 연동에 사용할 개발 키를 복사합니다(나중에 앱 설정 페이지에서 다시 얻을 수 있습니다).
- 더 많은 앱을 추가하려면 완료 또는 + 다른 앱 추가를 클릭하세요. 추가적인 앱 추가를 위해 이 과정을 반복하세요.
참고
- 관리자와 필요한 권한이 있는 계정 사용자만 앱을 추가할 수 있습니다.
- 앱 추가 단계를 따르는 동안, 이전에 선택한 옵션에 따라 사용 가능한 옵션이 다를 수 있습니다.
앱을 등록하면 대시보드에 표시됩니다. 인스톨 및 인앱 이벤트를 기록하고 올바른 매체 소스에 할당하려면 다음을 해야 합니다:
- SDK를 연동합니다
- 파트너 마켓플레이스에서 앱을 파트너와 연결하세요
온보딩 프로세스를 완료하기 위한 모든 단계를 확인하세요.
앱 세부 정보를 입력하세요
아래 나열된 대로 앱 플랫폼을 선택하고 필요한 세부 정보를 입력하세요:
안드로이드, 안드로이드TV, 파이어
다음 플랫폼에 대해 이 옵션을 사용하세요:
- 안드로이드 (모바일)
- 안드로이드TV
- 아마존 파이어
- 아마존 파이어 TV
- 킨들
| 구글 플레이 상태 | 사용 시점 | 필요한 세부 정보 |
|---|---|---|
| 매장에서 | 귀사의 앱은 현재 구글 플레이 스토어에서 이용 가능합니다. |
Google Play URL (Google Play에서 복사)
|
| 승인 대기 중\/게시되지 않음 | 앱이 아직 게시되지 않았거나 구글 플레이의 승인 대기 중입니다. |
안드로이드 패키지 이름
자세한 내용은 안드로이드 개발자 문서를 참조하십시오. |
| 타사 스토어\/스토어 외부 | 앱이 구글 플레이가 아닌 안드로이드 앱 스토어에 있으며/또는 앱 스토어가 아닌 다른 위치에서 다운로드할 수 있습니다. |
중요!앱이 둘 이상의 소스(즉, 구글 플레이, 타사 스토어 또는 스토어 밖 위치의 조합)에서 제공되는 경우 다중 스토어 안드로이드 속성 설정 옵션을 고려하는 것이 중요합니다. 처음부터 제대로 구현하면 필요한 데이터에 필요한 형식으로 액세스할 수 있습니다. |
iOS, tvOS, MacOS
다음 플랫폼에 대해 이 옵션을 사용하세요:
- iOS
- tvOS
- MacOS
| 애플 앱 스토어에서의 상태 | 사용 시점 | 필요한 세부 정보 |
|---|---|---|
| 매장에서 | 귀사의 앱은 현재 애플 앱 스토어에서 이용 가능합니다. |
App Store URL(앱 스토어에서 복사함)
|
| 승인 대기 중\/게시되지 않음 |
앱이 아직 게시되지 않았거나 앱스토어에서 승인 대기 중입니다.
|
앱이 제출된 앱 스토어의 국가
앱 스토어에서 할당한 앱 ID, 접두사 id 없음
|
윈도우
다음 플랫폼에 대해 이 옵션을 사용하세요:
- 윈도우 폰
- 윈도우(데스크톱)
| Microsoft Store 상태 | 사용 시점 | 필요한 세부 정보 |
|---|---|---|
| 매장에서 | 귀사의 앱은 현재 Microsoft Store에서 이용 가능합니다. |
Microsoft Store URL (Microsoft Store에서 복사)
앱 ID: 최대 150자까지 입력 가능합니다. |
| 승인 대기 중\/게시되지 않음 |
앱이 아직 게시되지 않았거나 스토어에서 승인 대기 중입니다.
|
Microsoft Store에서 할당한 앱 ID
|
웹(PBA)
참고
웹 앱은 PBA(유저 중심 어트리뷰션) 기능을 위해 브랜드 번들에 포함할 웹사이트를 정의하는 곳입니다.
- 이 옵션은 PBA를 구독한 고객만 사용할 수 있습니다.
- 채널, 플랫폼 및 디바이스에 걸친 고객 이동 경로를 통합적으로 파악하기 위해 PBA와 웹 방문 어트리뷰션, 엡 이벤트 및 웹사이트 지원 인스톨에 대해 자세히 알아보십시오.
전체 URL: 전체 URL: 트래픽을 측정할 웹 사이트의 전체 URL입니다. 이 웹사이트는 PBA Web SDK를 구현한(또는 구현하려는) 웹사이트입니다.
– 포함
- 스킴
- 서브도메인 [선택사항]
- 도메인 이름
- 최상위 도메인
- path [선택 사항] – 웹 사이트의 특정 디렉토리 또는 페이지 주소
앱 이름: 귀사가 선택한 앱 이름입니다.
- 최대 길이: 100자
- XSS 태그는 허용되지 않습니다.
중요!
웹 앱을 만든 후에는 삭제했다가 다시 만들지 않으면 해당 속성(URL 및 앱 이름)을 편집할 수 없습니다. 즉, 웹 앱이 속한 브랜드 번들도 삭제해야 합니다.
다음 단계:
- 새로 만든 웹 앱을 PBA 브랜드 번들에 추가하여 PBA 대시보드에 표시되도록 합니다.
- 브랜드 번들에 포함하려는 모든 모바일 앱이 번들 생성 전에 계정에 추가되었는지 확인하십시오.
- 측정 데이터 흐름을 가져오려면 PBA 웹 SDK를 웹 앱에서 지정한 웹사이트에 연동하십시오.
웹
웹 플랫폼을 사용하여 새로운 웹 앱을 만들고 웹 방문 및 전환을 웹 귀속을 사용하여 측정하십시오.
시작하기 전에
- 구형 사람 기반 귀속(PBA) 웹 앱은 “웹 (PBA)” 로 표시됩니다.
- 구형 PBA 웹 앱에서 마이그레이션하는 경우 기존 PBA 웹 개발 키를 사용할 수 있습니다.
웹 앱 추가
- 내 앱 > 앱 추가로 이동하십시오.
- 웹사이트를 선택하십시오.
- 다음 정보를 입력하십시오:
앱 이름 귀사가 선택한 앱 이름입니다.
- 길이: 50자.
- 허용된 문자: 문자(모든 언어), 숫자, 공백(시작 또는 끝에 없음), 및 특수 문자: . - _ :
- 차단된 문자: ; { } $ < > ` \
예시: 내 온라인 상점, 기업 웹사이트 2024, 전자상거래_생산
기본 도메인 (전체 URL): 귀하의 웹사이트의 기본 도메인입니다. 이는 웹 앱 생성 중에 설정되며 이후에는 변경할 수 없습니다.
- 형식: 유효한 도메인 이름만 (프로토콜, 경로 또는 포트 없음)
- 길이: 최소 3자 이상
-
처리중 AppsFlyer가 자동으로
- http:// 또는 https://를 제거합니다.
- 후행 슬래시를 제거합니다.
- 도메인을 소문자로 변환합니다.
- 불변성: 앱 생성 후에는 편집할 수 없습니다.
[앱스플라이어] 중요: 기본 도메인을 변경하려면 웹 앱을 삭제하고 다시 생성해야 하며, 이로 인해 역사적 데이터 연속성이 손실됩니다.
예시:
- https://shop.example.com/checkout → shop.example.com로 저장됨 → 앱 ID: website-shop.example.com
- example.com/ → example.com로 저장됨 → 앱 ID: website-example.com
앱 ID AppsFlyer가 기본 도메인을 기반으로 웹 앱에 대해 생성하는 고유 ID입니다.
- 형식: website-<primary_domain>를 사용하여 자동으로 생성됩니다.
- 예: website-shop.example.com
웹 SDK ID 웹 SDK에서 귀속을 위해 사용하는 식별자 (이전에는 web_dev_key로 명명됨).
앱 생성 시 두 가지 옵션:
옵션 3 새로 생성(기본값)
- 새로운 웹 SDK ID를 자동으로 생성합니다.
- 형식: website-{yourdomain.com}
- 예: website-shop.example.com
- 사용 사례 새로운 웹 귀속 구현
옵션 3 기존 PBA 개발 키 재사용
- 기존 PBA(사람 기반 귀속) 웹 앱 개발 키의 드롭다운에서 선택합니다.
- 웹사이트 코드를 변경하지 않고 원활한 마이그레이션을 가능하게 합니다.
- 사용 사례 구형 PBA에서 새로운 웹 귀속 솔루션으로 마이그레이션 중입니다.
참고: PBA 개발 키를 재사용하면 웹사이트 구현을 변경하지 않고 PBA에서 새로운 웹 앱으로 마이그레이션할 수 있습니다.
각 PBA 개발 키는 하나의 웹 앱에만 할당될 수 있습니다. PBA 개발 키가 웹 앱에 사용되면 다른 웹 앱에서는 더 이상 사용할 수 없습니다.
- 길이: 50자.
- 불변성: 앱 생성 후에는 변경할 수 없습니다.
- PBA 마이그레이션: 계정의 PBA 웹 앱에서만 개발 키가 드롭다운에 표시됩니다.
통화: 앱 보고에 사용되는 통화입니다.
- 표준 ISO 4217 통화 코드(예: USD, EUR, GBP, ILS)
- 드롭다운에서 선택됨.
- 필수 필드
시간대: 앱 보고에 사용되는 시간대입니다.
- IANA 시간대 형식(예: America/New_York, Europe/London, Asia/Tokyo)
- 드롭다운에서 선택됨.
- 필수 필드
- 앱 만들기를 클릭하십시오.
제한 사항
- 앱이 생성된 후에는 기본 도메인을 변경할 수 없습니다.
- 기본 도메인은 자동으로 제외된 도메인에 유형 기본으로 추가됩니다.
각 구형 웹 개발 키는 하나의 새로운 웹 앱에만 재사용할 수 있습니다.
참고
웹 귀속 설정에 대한 전체 정보는 여기를 참조하십시오.
로쿠
앱 이름: 앱 이름 - Roku 개발자 대시보드/strong>에서 복사.
- 예시: 내 Roku 채널
-
형식:
- 최대 100자까지
- XSS 태그는 허용되지 않습니다.
채널 ID: 채널에 할당된 숫자 ID
-
형식:
- 숫자 (0-9)
- 최대 길이: 50자
-
어떻게 찾을 수 있나요?
- Roku 개발자 대시보드에서 앱스플라이어에 추가하는 채널의 이름을 클릭합니다. 채널에 대한 Roku 미리보기 및 게시 페이지가 열립니다.
-
URL 페이지 끝에 있는 숫자가 채널
Amazon Vega OS
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 앱의 ID. 역 DNS 표기법을 사용하여 찾음: <tld>.<company_name>.<app_name>
최소 2개의 세그먼트를 포함해야 합니다. 각 세그먼트는 문자로 시작하고 다음 문자에서 이어져야 합니다: A-Z a-z 0-9. -
예: com.company.myapp
자세한 내용은 Amazon Vega OS 문서의 "id" 필드를 참조하십시오.
Vizio SmartCast
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 앱 ID는 다음과 같이 인식됩니다 vz로 시작하고, A-Z a-z 0-9. -에서 2-20자의 문자가 뒤따릅니다. 앱 ID를 확인해야 하는 경우 Vizio 담당자에게 확인하십시오.
삼성 타이젠
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 앱 ID: Samsung에서 앱에 할당한 번들 ID입니다. G로 시작하고, 8-15자리 숫자가 뒤따릅니다. 앱 ID를 얻으려면:
-
삼성 TV 판매 사무소에 로그인하십시오.
- 여기에서 인앱 광고 정보 아래의 가이드를 참조하십시오.
- 개발자 URL을 입력하십시오.
- 귀하의 번들 ID는 자동으로 생성되어 표시됩니다. 이것은 앱 스토어 URL에 접근하는 데 사용될 수 있습니다.
- 앱-ads.txt 검증을 지원하기 위해 광고 태그나 입찰 요청에 귀하의 번들 ID와 앱 스토어 URL을 사용하십시오.
- 문제가 발생하면 판매 사무소에서 문제 보드 티켓을 열어주십시오.
LG WebOS
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: LG WebOS 앱 ID.
-
형식:
- 최대 길이 50자
- 번들 형식으로
A-Za-z._의 문자입니다. 반드시 문자로 시작해야 합니다.
- 예시: com.my-company.app
앱 ID를 확인해야 하는 경우 LG WebOS 담당자에게 문의하세요.
플레이스테이션
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 앱 ID: 게임 또는 기타 콘텐츠 개념에 할당된 고유 식별자인 PlayStation 개념 ID, PlayStation 스토어 URL에 5~9자리 숫자로 표시됩니다. 앱의 앱 스토어 URL 끝에서 찾을 수 있습니다.
비다
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: Vidaa 앱 ID. 최대 150자까지 입력 가능합니다.
Steam
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: Steam 앱 ID. 이것은 Steam 스토어 URL에 표시되는 5~8자리 숫자입니다.
Meta Quest (Oculus)
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 메타 퀘스트 앱 ID는 앱이 다운로드된 메타 앱 스토어 URL의 끝에 나타나는 것입니다. A-Z A-Z에서 3-50자의 문자를 포함합니다.
닌텐도 스위치
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 닌텐도 스위치 앱 ID는 앱이 다운로드된 스토어의 URL 끝에 나타나는 것입니다. 14자리 숫자로 구성됩니다.
- 예시: 70010000012345
엑스박스
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 엑스박스 앱 ID는 앱이 다운로드된 엑스박스 스토어 URL의 끝에 나타나는 것입니다. 12자의 문자와 숫자만 포함됩니다 (A-Z a-z0-9).
참고: 앱 ID는 대소문자를 구분합니다.
에픽 게임즈
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 앱 ID: Epic Games 앱 ID(앱이 다운로드된 스토어에 표시됨) a-z0-9._- A-Za-z0-9._-에서 3-50자의 문자를 포함합니다.
네이티브 PC
앱 이름: 귀사가 선택한 앱 이름입니다.
앱 ID: 네이티브 PC 앱 ID입니다. a-z0-9._- A-Za-z0-9._-에서 3-50자의 문자를 포함합니다.
추가 정보를 입력하세요(웹 앱에는 해당되지 않음):
통화 선택
대시보드에 표시될 앱의 데이터 통화를 선택하세요. 수익 및 지출 이벤트는 이벤트 시점의 환율을 사용하여 이 통화로 변환됩니다. 더 보기: 앱의 통화 설정과 그 영향에 대해
중요!
앱에 사용할 통화를 선택할 때 주의하세요. 비용과 수익이 기록되면 변경이 불가능합니다.
시간대 선택
여기서 선택한 시간대를 다른 어트리뷰션 파트너(예: Meta Ads 및 Google Ads)에서 설정한 시간대와 맞춥니다. 이를 통해 앱스플라이어 대시보드에 보고된 데이터와 해당 파트너에서 수신한 데이터 간의 일치도를 최대로 높일 수 있습니다.
참고
- 시간대가 설정되면 잠금 상태가 유지되어 다음 날까지 변경할 수 없습니다.
- 앱 시간대 설정과 그 영향에 대해 더 보기.
앱 오디언스 정의
귀사의 앱이 어린이 또는 혼합 오디언스(어린이와 성인 모두)를 대상으로 하는지 여부를 표시하려면 예 또는 아니요를 선택하세요.
예를 선택한 경우:
- 아동 대상 앱의 준수 구현에 대한 가이드를 열어 읽어보세요.
- 가이드를 읽었고 명시된 제어를 구현했음을 확인하려면 상자를 선택하세요.
참고
- 앱을 추가한 후 2주 후에, 아동 대상 앱의 개인정보 보호 설정을 완료했는지 확인하는 알림을 받게 됩니다. 확인 후 확인 메시지를 받게 됩니다. 알림 센터에서 언제든지 확인 메시지에 액세스할 수 있으며, 감사 로그에서 확인 세부 정보를 볼 수 있습니다.
- 아동 대상 앱에 관한 자주 묻는 질문을 참조하세요.
API를 통해 귀사의 앱을 대량으로 관리하세요
계정 관리자는 UI의 주요 기능을 지원하는 전용 API를 사용하여 여러 앱을 대량으로 관리할 수 있습니다. 여기에는 앱 추가 및 삭제, 앱 설정 업데이트가 포함됩니다. API는 동일한 오류 검증 메커니즘도 포함하고 있습니다.
참고
이 단계에서는 API를 통해 앱을 추가하고 앱 설정을 업데이트하는 것이 모바일 앱에서만 가능합니다. 모든 플랫폼에서 앱을 삭제할 수 있습니다.
디버그 또는 테스트 앱을 추가하십시오.
개발자가 디버그, 샌드박스 또는 테스트 앱을 생성하는 경우, 해당 앱을 대시보드에 추가해야 합니다. 개발자가 앱으로 테스트를 시작하면, 데이터가 앱의 대시보드에 표시됩니다.
참고
앱 스토어에 게시되지 않았고 유효한 앱 스토어 ID가 없는 iOS 앱의 경우, 더미 iOS 앱 스토어 ID를 사용하여 SDK 테스트를 계속 진행할 수 있습니다. 이것은 실제 앱 스토어 목록이 필요 없이 SDK 통합 및 테스트를 가능하게 합니다.
디버그 앱을 생성하고 대시보드에 추가하는 방법에 대한 개발자 지침은 다음을 참조하십시오:
보류 중인 앱에 대하여
보류 상태의 앱은 앱스플라이어 SDK를 시험하거나 디버깅할 때 유용할 수 있습니다.
대시보드에서 앱 상태가 보류 중으로 표시되어도 데이터 수집 및 측정에는 영향을 미치지 않습니다. 앱이 앱 스토어에 보류 중이든 출시 중이든, 사용자가 앱을 인스톨 하고 상호작용하면 인스톨 및 인앱 이벤트 데이터는 대시보드에 동일하게 기록됩니다.
귀사의 보류 중인 앱이 공개되면 앱스플라이어가 해당 앱의 상태를 감지하고 자동으로 업데이트하므로, 앱을 다시 추가할 필요가 없습니다. 보류 중인 앱과 관련된 정보 및 상태를 수동으로 새로 고치는 절차에 대해 더 보기.
문제 해결
일반적인 문제에 대한 해결책을 찾아보세요.
앱이 추가되지 않았습니다
이 오류가 발생하면 귀사의 CSM에 문의하거나 hello@appsflyer.com으로 이메일을 발송하세요.
앱이 앱 스토어에 없습니다
적절한 앱 이름/ID를 사용하여 스토어 URL을 올바르게 복사했는지 확인하세요.
마켓플레이스에 액세스할 수 없습니다.
이 오류는 비미국 스토어에서 안드로이드 앱을 추가할 때 가끔 발생합니다. 이 문제를 해결하려면 다음 단계를 따르세요.
- 위에 설명한 대로 승인 대기/게시되지 않음 상태로 앱을 추가합니다.
- 앱스플라이어 앱 설정 페이지로 이동합니다.
- 앱 스토어 국가를 올바른 국가로 변경하세요(예: 일본).
문제가 발생했습니다. 다시 시도해 보세요.
이 오류가 발생할 수 있는 이유 중 하나는 미국 구글 플레이 스토어에 나열되지 않은 앱을 국가 코드 없이 추가하려고 하기 때문입니다. 이 문제를 해결하기 위한 자세한 내용은 위에서 확인하세요.
내 iOS 앱이 App Store에서 제거되었습니다. 왜 아직도 설치가 보이나요?
이것은 사용자가 이전에 장치에 존재했던 앱을 운영 체제를 통해 다시 설치할 수 있기 때문에 발생합니다. 앱이 더 이상 App Store에서 제공되지 않더라도, 사용자는 여전히 설치할 수 있으며, 이러한 설치는 AppsFlyer에 기록됩니다.
기타 정보
제품 라인
제품 라인에서 앱을 추가하거나 제거할 수 있습니다. 제품 라인 및 제공하는 내용에 대한 자세한 정보는 여기를 참조하십시오.