마케터를 위한 SDK 연동 테스트

라이브 이벤트 뷰어는 인스톨 이벤트 및 기타 인앱 이벤트와 같이 SDK에서 앱스플라이어로 전송된 실시간 데이터를 보여주는 테스트 툴입니다. 각 이벤트에 대해 이벤트 로그 및 세부 정보를 볼 수 있습니다.

라이브 이벤트 뷰어에서 이벤트를 보려면:

1. 앱스플라이어의 사이드 메뉴에서 설정 > SDK 연동 테스트를 선택합니다. 

   

2. 라이브 이벤트 클릭

   

3. 앱 목록에서 테스트할 앱을 선택합니다.
4. 테스트 디바이스 목록에서, 앱 테스트에 사용할 디바이스를 선택합니다. 테스트 디바이스가 없는 경우, 테스트 디바이스 추가 링크를 클릭하여 등록할 수 있습니다.
5. 계속하기를 클릭하여 앱 이벤트 기록을 시작합니다.

6. 앱을 실행하고 상호 작용하여 세션 및 인앱 이벤트를 생성합니다.

   

7. 이벤트 항목을 클릭하면 오른쪽 패널에서 이벤트 세부 정보를 볼 수 있습니다.
8. 이벤트 기록을 중지하려면 중지를 클릭하세요. 다시 계속하려면 시작을 클릭하세요.

논오가닉 인스톨을 테스트하려면:

1. 앱스플라이어의 사이드 메뉴에서 설정 > SDK 연동 테스트를 선택합니다.  

   

2. 논오가닉 인스톨 테스트를 클릭합니다.

   

3. 앱 목록에서 테스트할 앱을 선택합니다.
4. 테스트 디바이스 목록에서, 앱 테스트에 사용할 디바이스를 선택합니다. 테스트 디바이스가 없는 경우, 테스트 디바이스 추가 링크를 클릭하여 등록할 수 있습니다.
5. 테스트된 앱이 테스트 디바이스에 설치되어 있으면 제거합니다.
6. “테스트한 디바이스에서 앱을 삭제했습니다” 선택란에 체크합니다.
7. 계속을 클릭하고 각 마법사 단계를 따릅니다.

앱이 논오가닉 인스톨을 기록하지 않는 경우, 다음과 같은 이유 때문일 수 있습니다.

• IDFA를 사용할 수 있지만 테스트 디바이스가 테스트 디바이스 페이지에서 IDFA 식별자로 등록되지 않았습니다.
• 테스트 디바이스에 테스트 앱 외에 2개 이상의 앱이 설치되어 있지만 테스트 디바이스가 테스트 디바이스 페이지의 IDFV에 등록되지 않았습니다. 
• 오가닉 인스톨이 기록되었습니다.
• SDK를 포함하지 않는 앱 버전에서 테스트가 수행되었습니다.

연동 오류가 나타나는 경우, 개발자에게 문의하십시오.

시작하기 전에:

• 테스트 앱을 3번 이상 실행합니다.
• 딥링킹(리타겟팅)을 테스트하려면 원링크가 앱에 정의되어 있어야 합니다. 자세한 정보는 원링크 설정 가이드를 참조하십시오. 
• 리타겟팅이 켜져 있는지 확인하십시오.

딥링크를 테스트하려면:

1. 앱스플라이어의 사이드 메뉴에서 설정 > SDK 연동 테스트를 선택합니다. 

   

2. 리타겟팅을 클릭합니다.

   

3. 앱 목록에서 테스트할 앱을 선택합니다.
4. 테스트 기기 목록에서, 앱 테스트에 사용할 디바이스를 선택합니다. 테스트 디바이스가 없는 경우, 테스트 디바이스 추가 링크를 클릭하여 등록할 수 있습니다.
5. 계속을 클릭하고 각 마법사 단계를 따릅니다.

인스톨 테스트를 통해 앱스플라이어 SDK가 인스톨을 다양한 미디어 소스에 올바르게 어트리뷰트하고 있는지 확인할 수 있습니다.

인스톨 어트리뷰션 테스트 방법:

1. 다음 링크(안드로이드 또는 iOS)를 복사하고 아래와 같이 수정합니다.

   1. app_id 값: 앱스플라이어에 앱 ID를 추가합니다. 
   2. pid 파라미터: 인스톨이 어트리뷰트될 미디어 소스의 이름을 지정합니다.
   3. c 파라미터: 캠페인의 이름을 지정합니다.
   4. 써드 파티 안드로이드 스토어의 앱을 테스트하는 경우, 어트리뷰션 링크에 af_r parameter를 추가합니다.  
   5. GAID, IDFA 또는 IDFV를 귀하의 디바이스 식별자로 변경합니다.
   안드로이드 iOS

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&advertising_id=<GAID>

   IDFA

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfa=<IDFA>

   IDFV

   https://app.appsflyer.com/<app_id>?pid=Test&c=Test&idfv=<IDFV>

   다음은 특정 값을 가진 어트리뷰션 링크의 예입니다.

   안드로이드 iOS

   https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*

   https://app.appsflyer.com/id123456789?pid=Test&c=Test&idfa=1A2B****-9128-4***-123*-04E***654321

    참고

   테스트 디바이스 등록을 하지 않고 iOS 앱을 테스트하는 경우, Fraud 360에 의해 테스트 클릭이 프로드로 표시될 수 있습니다.

   해당 이벤트가 프로드로 감지되는 것을 방지하려면, 링크에 다음 쿼리 파라미터를 추가하세요. pid=”ios_testing”

2. 업데이트된 링크를 복사하여 테스트 디바이스로 보낸 다음 링크를 클릭합니다.

    참고

   iOS에서는 iMessenger 또는 이메일을 사용하여 링크를 디바이스로 보냅니다. iOS Notes 앱에 링크를 붙여넣기 하지 마시고, 링크를 클릭하세요. 링크를 붙여넣기하는 경우, 링크가 끊어질 수 있습니다.

3. 다음 중 하나를 수행합니다.

   • 앱이 배포되어 있다면, 설치를 진행하십시오.
   • 앱이 아직 배포 전인 경우, 다음 메시지가 표시됩니다. "The app you are looking for is not available in the market yet."이라는 메시지가 뜬다면 정상입니다. 앱이 배포되지 않았기 때문에 어트리뷰션 링크가 앱 스토어로 연결되지 않습니다. 그러나 어트리뷰션 링크는 어트리뷰션 목적으로 여전히 유효하며 다음과 같이 앱을 설치해야 합니다.
     • 안드로이드의 경우:  APK 파일(또는 개발자용 Android Studio)로 설치
     • iOS의 경우: TestFlight(또는 개발자용 Xcode)로 설치

   테스트라고 불리는 미디어 소스 아래에 테스트 캠페인에 어트리뷰트된 인스톨이 표시됩니다. 해당 인스톨이 앱의 대시보드에 표시될 때까지 30여 분 정도 시간이 소요됩니다.

   

인앱 이벤트를 테스트하면 이벤트와 관련된 수익이 표시되며, 인앱 이벤트가 인스톨을 생성하는 미디어 소스에 어트리뷰트되는지 확인할 수 있습니다.

인앱 이벤트의 어트리뷰션 테스트 방법:

1. 앱을 실행하면 몇 가지의 인앱 이벤트가 생성됩니다.

2. 앱 대시보드를 열고 이벤트를 클릭합니다.

   이벤트, 해당 수익(수익과 연관된 이벤트인 경우) 및 연관된 미디어 소스가 표시되어야 합니다. 해당 이벤트가 대시보드에 표시될 때까지 60~70분 정도 소요됩니다.

   

팁! 이벤트가 올바르게 어트리뷰트되었는지 확인하려면 인앱 이벤트 로데이터 리포트 다운로드를 권장드립니다. 리포트를 다운로드하는 데 몇 분 정도 소요될 수 있습니다.

리포트 다운로드 방법:

1. 앱스플라이어의 사이드 메뉴에서 Report > Raw Data Export 를 선택합니다.
2. 로데이터 리포트 섹션에서 인앱 이벤트 로데이터 리포트를 다운로드합니다.

원링크를 사용하면 안드로이드와 iOS 모두에 단일 어트리뷰션 링크를 설정할 수 있습니다. 원링크는 사용자의 디바이스를 인식하여 관련 앱스토어로 리디렉션합니다.

또한 원링크를 통해 딥링킹이 가능합니다. 딥링킹을 통해, 맞춤형 콘텐츠를 제공함과 동시에 구체적인 앱 활동 내에서 앱을 오픈할 수 있습니다.

자세한 내용은 원링크 URL 테스트에 대한 가이드를 참조하십시오.

리타겟팅 어트리뷰션은 유저가 리타겟팅 어트리뷰션 링크를 클릭하여 리타겟팅 캠페인에 참여할 때 발생합니다. 이로 인해 리어트리뷰션 또는 리인게이지먼트 이벤트가 발생합니다. 자세한 정보는 리타겟팅 어트리뷰션 가이드를 참조하십시오.

리타겟팅 테스트에는 다음이 포함됩니다.

• 리어트리뷰션의 경우: 앱을 제거하고 다시 설치합니다. 그런 다음, 대시보드에서 인스톨이 기록되었는지 여부를 확인합니다.
• 리인게이지먼트의 경우: 리타겟팅 어트리뷰션 링크 또는 딥링크를 클릭했을 때, 리인게이지먼트가 올바른 미디어 소스에 어트리뷰트되는지를 확인합니다.

리타겟팅 테스트 실행 전에 다음 설정이 필요합니다.

• 테스트하려는 앱에 대해 리타겟팅이 활성화되어야 합니다.
• 앱 전용 링크를 생성하거나 원링크 커스텀 링크를 검색합니다. 해당 링크에는 리타겟팅 파라미터가 포함되어야 합니다.

리타겟팅 테스트 설정 방법:

1. 앱 설정에서 리타겟팅을 활성화합니다.

   앱 대시보드에서 앱 설정을 클릭하고 리타겟팅 어트리뷰션 활성화를 켭니다.

   

2. 다음 중 하나를 수행합니다. 
   • 앱 전용 어트리뷰션 링크를 생성합니다. 해당 링크에는 리타겟팅 파라미터와 is_retargeting=true, 광고 ID가 반드시 포함되어야 합니다. GAID, IDFA 또는 IDFV를 보려면, 테스트 디바이스 등록하기 지침을 따르세요.  
     다음은 어트리뷰션 분석 링크에 안드로이드 전용 파라미터가 디바이스 식별자(GAID)로 포함되어 있는 예입니다. IDFA 또는 IDFV와 같은 다른 디바이스 식별자 파라미터를 추가하는 방법에 대해서는 어트리뷰션 링크 구조 및 파라미터를 참조하십시오.  

     https://app.appsflyer.com/<app_id>?pid=Test&c=Test&is_retargeting=true&advertising_id=<GAID>

   • 원링크 템플릿에서 커스텀 링크의 긴URL을 가져옵니다. 리타겟팅 캠페인이 활성화되어 있는지 확인하세요. 아래 이미지를 통해 커스텀 긴 URL의 예시를 확인하세요.

이제 리어트리뷰션 및 리인게이지먼트 테스트를 진행할 수 있습니다.

시작하기 전에:

• 리타겟팅 테스트 설정에 대한 지침을 따르십시오.
• 등록되지 않은 테스트 디바이스를 사용해야 합니다.

리어트리뷰션 테스트 방법:

1. 디바이스에서 앱을 삭제합니다. 앱을 방금 설치했다면 몇 분 정도 기다려 주세요.
2. 미리 생성한 어트리뷰션 링크(원링크 템플릿을 활용한 앱 전용 어트리뷰션 링크 또는 커스텀 롱 링크)를 복사하여 테스트 디바이스로 보낸 다음 링크를 클릭합니다.

    참고

   iOS에서는 iMessenger 또는 이메일을 사용하여 링크를 디바이스로 보냅니다. iOS Notes 앱에 링크를 붙여넣기 하지 마시고, 링크를 클릭하세요. 붙여넣기 하는 경우, 링크가 끊어질 수 있습니다.

3. 다음 중 하나를 수행합니다.
   • 앱이 배포되어 있다면, 설치를 진행하십시오.
   • 앱이 아직 배포 전인 경우, 다음의 설치 방법을 따르십시오.
     • 안드로이드의 경우: Android Studio 또는 APK 파일로 설치합니다.
     • iOS의 경우: TestFlight를 통해 설치합니다.
4. 앱의 대시보드를 열고 유형 보기 박스에서 리타겟팅을 선택합니다.

5. 어트리뷰션 유형 박스에서 리어트리뷰션을 선택합니다.

   미디어소스 및 캠페인에 기여된 인스톨을 확인할 수 있습니다. 리타겟팅된 인스톨이 대시보드에 표시될 때까지 30여 분 정도 시간이 소요될 수 있습니다.

   

시작하기 전에:

• 리타겟팅 테스트 설정에 대한 지침을 따르십시오. 
• 테스트를 위해 전환 사이의 최소 시간을 없음으로 설정합니다. 이를 통해 테스트 중에 모든 리인게이지먼트 전환을 기록하고 어트리뷰트할 수 있습니다.
• 앱이 테스트 디바이스에 설치되어 있고, 몇 차례 실행된 적이 있는지 확인하십시오. 앱을 방금 설치했다면 몇 분 정도 기다려 주세요.

리인게이지먼트(direct deep linking) 테스트 방법:

앱이 딥링킹을 지원하도록 구성되었는지 확인한 후, 다음 절차를 따라 테스트하세요.

리인게이지먼트(indirect deep linking) 테스트 방법:

1. 미리 생성한 어트리뷰션 링크(원링크 템플릿을 활용한 앱 전용 어트리뷰션 링크 또는 커스텀 롱 링크)를 복사합니다.
2. 테스트 디바이스에 대한 링크를 보낸 다음 링크를 클릭합니다.

3. 앱을 열기 위해서는 다음 중 하나를 수행합니다.

   • 앱 스토어에서 열기를 클릭합니다.
   • 디바이스에서 앱을 실행합니다.

   대시보드에서 미디어소스 및 캠페인에 어트리뷰트된 리인게이지먼트가 표시됩니다. 리인게이지먼트가 나타날 때까지 최대 30분 정도 기다리십시오.

   

팁! 리인게이지먼트가 올바른 미디어 소스에 어트리뷰트되는지 확인하려면 전환 로데이터 리포트를 다운로드하는 방법도 있습니다. 리포트를 다운로드하는 데 몇 분 소요될 수 있습니다.

리포트 다운로드 방법:

1. 앱스플라이어의 사이드 메뉴에서 리포트 > 로데이터 내보내기를 선택합니다.
2. 리타겟팅 섹션에서 전환(리인게이지먼트 및 리어트리뷰션) 리포트를 다운로드합니다.