기본 SDK 연동 가이드

앱스플라이어 ID는 새 앱을 인스톨할 때마다 자동으로 생성됩니다. 마케터는 아무런 액션도 필요하지 않습니다.

이 식별자를 사용하여 다음 액션을 수행할 수 있습니다.

• 서버 간 인앱이벤트(server-to-server in-app events)를 보냅니다.
• 백엔드 시스템의 사용자 기록을 앱스플라이어 ID와 맞추기.
• 로데이터 인앱이벤트 보고서를 다운로드하고 appsflyer_id를 사용하여 사용자 행동 및 여정을 분석합니다.

앱스플라이어 SDK에서 자체 고객 사용자 ID(CUID)를 설정하여 BI 시스템의 고유 ID를 앱스플라이어 ID 및 기타 식별자와 상호 참조합니다. CUID는 앱스플라이어 로데이터 리포트에서 이용할 수 있습니다. 또한, 포스트백 API에서 해당 ID를 확보하여 귀사 내부 ID와 상호 참조할 수 있습니다.

CUID에 대한 자세한 내용은 이 문서를 참조하십시오.

GOOGLE PLAY 인스톨 리퍼러

구글 플레이 인스톨 리퍼러 API는 어트리뷰션 정확도를 개선하고 인스톨 사기로부터 보호를 제공하며 구글 플레이에서 참조 데이터를 안전하게 검색할 수 있게 합니다(예를 들어, 앱이 처음 설치된 시점의 앱 버전). 

개발자에게 Google Play Install Referrer API를 추가하기 위한 지침을 제공하는 것이 좋습니다.

GAID

SDK V4.8.0부터는 앱스플라이어가 이 기기 식별자를 자동으로 수집합니다.

앱스플라이어를 사용하면 Amazon, Opera, GetJar, Baidu, Huawei와 같은 서드파티 앱 스토어에서 발생한 인스톨을 어트리뷰션할 수 있습니다. 이를 통해 구글 플레이 스토어를 사용할 수 없는 시장에서도 앱을 홍보하고 더 많은 잠재 고객에게 도달할 수 있습니다.

앱스플라이어는 타사 앱 스토어의 맥락에서 다음과 같은 어트리뷰션을 지원합니다.

• IMEI 또는 Android ID: SDK는 IMEI 또는 Android ID를 자동으로 수집하지 않습니다. 그러나 이러한 식별자를 수집해야 할 필요가 있는 경우(예: 중국 국내 시장의 앱) 개발자는 다음 수집 유형 중 하나를 구현할 수 있습니다.
  • 수동 수집: 앱은 또는 API를 사용하여 IMEI 또는 setAndroidIdData Android ID를 setImeiData SDK에 전달합니다(아래 탭의 함수 참조 참조). SDK는 데이터를 앱스플라이어 서버로 전송합니다. 
    Android 네이티브Unity

    자세한 내용은 Android SDK 참조를 참조하세요.

    • setImeiData 
    •  setAndroidIdData 

    Unity SDK 레퍼런스에서 다음을 확인하세요.

    • setImeiData
    • setAndroidIdData
  • 기기 ID 수집 옵트인: SDK가 setCollectIMEI 및 setCollectAndroidID를 사용하여 IMEI 또는 Android ID를 수집하도록 강제합니다(아래 탭의 함수 참조 참조).
    Android 네이티브UnityReact Native

    자세한 내용은 Android SDK 참조를 참조하세요.

    • setCollectIMEI
    • setCollectAndroidID

    Unity SDK 레퍼런스에서 다음을 확인하세요.

    • setCollectIMEI
    • setCollectAndroidID

    다음에 대한 React Native 참조를 참조하세요.

    • setCollectIMEI
    • setCollectAndroidID

• 오에이드: 속성은 타사 Android 앱 스토어에서 설치합니다. 자세한 내용은 OAID 구현 가이드를 참조하십시오.
• 인스톨 리퍼러: SDK는 Samsung Gallery 및 Huawei AppGallery에서 추천 데이터 검색을 지원합니다.

배경

iOS 14.5부터, IDFA를 수집하려면 사용자의 동의가 필요합니다. 이는 실제로 IDFA 액세스를 앱 추적 투명성(ATT) 프레임워크가 통제한다는 의미입니다. 기기가 iOS 14 이상일 경우, SDK는 ATT 프레임워크를 사용하여 기기 IDFA 액세스 권한을 얻습니다.  ATT에 대한 소개는 ATT 원칙을 참조하십시오.

IDFA를 사용하여 어트리뷰션이 발생하는 경우, 첫 번째 실행 시 IDFA를 전송하는 것이 중요합니다.이러한 이유로 SDK는 waitForATTUserAuthorization 메서드를 제공합니다.

waitForATTUserAuthorization overview

waitForATTUserAuthorization SDK가 앱스플라이어 서버로 데이터를 전송하기 전에 ATT 상태를 연기하고 대기해야 하는 시간을 구성할 수 있습니다.

유저가 앱을 실행하면 ATT 상태는 NotDetermined입니다. waitForATTUserAuthorization 시간 초과 기간에 SDK는 앱 실행 이벤트와 연속적인 인앱 이벤트 인메모리(in-memory)를 오프라인 이벤트가 기록되는 방식과 유사하게 순차적으로 기록합니다.

• 유저가 ATT 프롬프트(IDFA 수집)에 동의 하는 경우:
  • SDK가 IDFA를 임시 저장된(cached) 이벤트에 추가합니다.
  • SDK가 (타임아웃을 기다리지 않고) 바로 구동되어 임시 저장된 이벤트를 IDFA와 함께 전송합니다.

• 유저가 ATT 프롬프트를 거부하는 경우: SDK가 시작되고 IDFA 없이 캐시된 이벤트를 전송합니다(타임아웃이 끝날 때까지 기다리지 않음).
• 타임아웃이 종료되고 ATT 상태가 notDetermined로 유지되는 경우: SDK가 시작되고 IDFA 없이 캐시된 이벤트를 전송합니다.

고려 사항 

• 설정waitForATTUserAuthorization없이 호출하면  requestTrackingAuthorization iOS 14+ 기기에서 IDFA 없이 실행 및 이벤트가 전송됩니다. 
• 사용자가 타임아웃 중간에 앱을 백그라운드로 이동시키면,
  • 앱이 휴대폰 화면(foreground)에 표시될 때까지 타이머가 일시 중지됩니다.
  • 이벤트는 인-메모리에 캐시됩니다.

• 사용자가 앱을 종료하면 제한 시간 동안 종료됩니다.
  • 다음 앱 실행 시점에 타이머가 재시작합니다.
  • 캐시 이벤트가 손실됩니다.

ATT 프롬프트를 사용자 지정할 수 있습니다. 요청의 목적을 명확히 설명하는 메시지는 사용자의 선택 비율을 높이는 데 도움이 될 수 있습니다.

메시지를 작성할 때 다음 사항을 고려하십시오.

• 앱이 사용자 동의를 요청하는 이유를 가장 잘 설명하는 표현을 사용합니다.
• 사용자에게 데이터가 어떻게 사용되는지 알립니다. 사용자 프라이버시 및 데이터 사용에 대해 자세히 알아보십시오.

메시지가 완료되면 개발자에게 텍스트와 구현 지침을 제공합니다.

ATT 프롬프트의 몇 가지 외부 예시를 참조하세요.

SKAN은 iOS에서 광고주 주도 앱 설치를 검증하는 데 사용하는 클래스입니다. 앱 설치 유효성 검사 프로세스에는 원본 앱과 광고된 앱이 포함됩니다.

소스 앱은 광고 네트워크의 광고를 표시하여 광고 캠페인에 참여하는 앱입니다. 광고를 게재하도록 앱을 구성하는 작업은 앱스플라이어 SDK 범위 내에 없습니다. 광고 게재를 위한 작업은Apple 가이드를 따르십시오.

광고된 앱(앱스플라이어 SDK가 있는 앱)의 경우, 앱스플라이어 SKAN 솔루션은 SKAN 을 사용하여 어트리뷰션 포스트백을 제공하는 반면, 앱스플라이어는 사용자 개인 정보를 유지하면서 데이터를 수집, 번역 및 집계합니다. 앱이 처음 실행되면 앱스플라이어 플랫폼은 마케터가 설정한 구성을 사용하여 SDK에 SKAN 전환 값을 설정하는 방법을 지시합니다.

SKAN 솔루션을 사용하는 방법은 다음과 같습니다.

• 마케터는 앱스플라이어에서 SKAN 측정을 구성해야 합니다. 개발자는 작업을 수행할 필요가 없습니다.
• 앱스플라이어 SDK는 필요한 SKAN API를 자동으로 호출합니다.
• 앱스플라이어에 의존하여 SKAN 어트리뷰션을 사용할 때 다른 SDK에서 SKAN 호출을 사용하지 않도록 설정해야 합니다.
• App Store에서 개발자나 마케터가 요구하는 다른 조치나 등록 절차는 없습니다.

SKAN 어트리뷰션을 비활성화하려면 SDK에서 비활성화하도록 개발자에게 지시하십시오.

모든 인앱 이벤트로 수익을 보낼 수 있습니다. 수익을 포함하려면 af_revenue 파라미터를 사용해야 합니다. 앱스플라이어가 대시보드와 로데이터 리포트에서 실제 수익으로 계산하는 유일한 이벤트 파라미터입니다.더 알아보기.

앱스플라이어의 SDK는 인앱 구매에 대해서 서버 확인 기능을 제공합니다. 구매 검증을 통과하면 앱스플라이어로 인앱 구매 이벤트가 자동 전송됩니다. 그러므로 이 이벤트를 따로 직접 전송하면 인앱 구매 내역이 중복되어 기록됩니다.

카테고리별로 추천하는 인앱 이벤트 목록(예: 여행, 게임 또는 전자상거래)을 참조하세요.

앱을 설치하지 않은 사용자의 경우, 원링크는 장치 유형을 감지하여 올바른 대상(예: Google Play, Apple App Store, 타사 앱 스토어 또는 웹 페이지)으로 리디렉션합니다. 이것은 원링크 템플릿 설정에 기반합니다.더 알아보기

앱이 설치된 사용자의 경우, 원링크가 앱을 엽니다. 앱을 열 뿐만 아니라 앱 내의 특정 활동이나 페이지로 사용자를 딥링킹할 수도 있습니다. 이렇게 하려면 개발사가 통합 딥링킹(UDL)을 구현해야 합니다.

일러두기:

• UDL은 SDK V6.1 이상을 요구합니다.
• 이미 딥링킹을 위해 원링크를 사용하고 있는 고객은 UDL 대신 레거시 방식을 사용하고 있을 수 있습니다.

딥링킹(Deep Linking)과 디퍼드 딥링킹(Deferred Deep Linking) 설정에 대한 가이드를 참조하세요.

앱을 설치하지 않은 사용자의 경우 원링크는 장치 유형을 검색하여 올바른 대상인 Google Play, Apple App Store, 타사 앱 스토어 또는 웹 페이지로 리디렉션합니다. 사용자가 앱을 실행하면 디퍼드 딥링킹을 사용하여 앱 내의 특정 활동 또는 페이지로 리디렉션할 수 있습니다.

이를 위해서는 개발자가 확장된 디퍼드 딥링킹을 구현해야 합니다.

일러두기:

• UDL은 SDK V6.1 이상을 요구합니다.
• 디퍼드 딥링킹에 이미 OneLink를 사용하고 있는 고객은 UDL 대신 레거시 방식을 사용하고 있을 수 있습니다.

딥링킹(Deep Linking)과 디퍼드 딥링킹(Deferred Deep Linking) 설정에 대한 가이드를 참조하세요.