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

iOS 14.5부터는 사용자가 앱 투명성 추적(ATT) 프롬프트를 통해 동의하는 경우에만 IDFA를 사용할 수 있습니다. ATT 프롬프트가 앱에 구현된 경우 동의 사용자 또는 비동의 사용자로 테스트를 실행할 수 있습니다.  자세한 내용은 테스트 기기를 IDFA 또는 IDFV에 등록하기 위한 지침을 참조하십시오.

먼저 오가닉 인스톨 테스트부터 시작할 것을 권장합니다.

오가닉 인스톨 테스트 방법:

1. 등록된 테스트 기기에 앱을 인스톨하십시오.
2. 앱을 실행합니다.

해당 앱의 대시보드에서 신규 오가닉 인스톨이 나타납니다. 인스톨이 나타날 때까지 최대 30분 정도 기다리십시오.

SDK 연동 테스트 페이지를 사용하여 논오가닉 인스톨, 인앱이벤트 및 딥링킹(리타게팅)을 테스트하고 발생한 연동 문제를 프로젝트에 배치합니다.

iOS만 해당: SDK 연동 테스트 페이지는 ATT를 구현하는 iOS 앱에만 적용됩니다. 여기에 지정된 절차에 따라 비 ATT 앱을 테스트할 수 있습니다.

시작하기 전에:

1. 앱이 설치되지 않은 기기(안드로이드 또는 iOS)를 준비합니다. 필요한 경우 기기에서 앱 설치를 삭제합니다.
2. 기기를 테스트 기기로 등록합니다.

1단계: 논오가닉 인스톨 테스트

1. 대시보드에서 앱을 선택합니다.
2. 연동 SDK 연동 테스트로 이동합니다. 
   SDK 연동 테스트 페이지가 열립니다. 
   
3. 논오가닉 인스톨 테스트를 실행합니다.
4. 등록된 테스트 기기를 선택합니다. 
5. 설치할 앱이 있는 스토어를 선택합니다.
   • 안드로이드의 경우: 
     • 구글 플레이
     • 기타(예를 들어, 스토어 외, 안드로이드 Studio, APK 파일) 
   • iOS의 경우:
     • 앱스토어
     • 기타 (예를 들어, XCode, TestFlight)
6. 등록된 테스트 기기로 QR 코드를 스캔하고 기기에서 지시 사항을 따르십시오.

   Android 기기의 경우 이 테스트에서는 인스톨 리퍼러 메서드를 사용하므로 어트리뷰션 링크에는 GAID가 포함되지 않습니다.

7. 기타를 선택한 경우 개발 환경에서 앱을 설치합니다.
8. SDK 연동 테스트 페이지에 논오가닉 인스톨이 등록되어, 테스트 성공이 표시될 때까지 기다리십시오. 최대 2분이 소요될 수 있습니다.

   

   앱에서 논오가닉 인스톨을 기록하지 않는 경우 다음과 같은 이유 때문일 수 있습니다.
   • IDFA를 사용할 수 있지만 테스트 기기가 테스트 기기 페이지에서 이 식별자로 등록되지 않았습니다.
   • 테스트 기기에 테스트 앱 외에 2개 이상의 앱이 설치되어 있지만 테스트 기기가 테스트 기기 페이지의 IDFV에 등록되지 않았습니다. 
   • 오가닉 인스톨이 기록되었습니다.
   • 테스트가 SDK를 포함하지 않는 앱 버전에서 수행되었습니다.

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

2단계: 인앱이벤트 테스트

시작하기 전에:

• 논오가닉 인스톨을 기록하는 데 사용한 기기를 사용해야 합니다.

1. 인앱이벤트 테스트를 실행합니다.
2. 등록된 테스트 기기를 선택하고 다음을 클릭합니다. 
3. 앱을 시작하고 인앱이벤트를 발생시키길 시작하십시오.
4. 이러한 이벤트의 로그가 실시간으로 등록되며 표시됩니다.

   

3단계: 딥링크 (리타게팅) 테스트

시작하기 전에:

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

1. 딥링킹 테스트를 실행합니다.
2. 등록된 테스트 기기를 선택합니다.
3. 테스트 유형을 선택합니다.
   • 원링크: 원링크를 선택합니다. 
   • URI 스킴: URI 스킴을 입력합니다(예를 들어, greatapps://cars).
4. 다음을 클릭합니다.
5. 등록한 테스트 기기로 QR 코드를 스캔하고 기기에 대한 지시 사항을 따르십시오. 테스트가 완료되면 딥링킹 테스트가 성공으로 등록됩니다.

   

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

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

1. 다음 링크(안드로이드 또는 iOS)를 복사하고 다음과 같이 변경합니다.
   1. app_id 값: 앱스플라이어에 앱 ID를 추가합니다. 
   2. pid 파라미터: 인스톨이 어트리뷰트될 미디어 소스의 이름을 지정합니다.
   3. c 파라미터: 캠페인의 이름을 지정합니다.
   4. 타사 안드로이드 스토어의 앱을 테스트하는 경우 어트리뷰션 링크에 af_r parameter를 추가합니다. 
   5. GAID, IDFA 또는 IDFV를 해당 기기 식별자로 교체합니다.
   Android 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>

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

   Android 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

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

    참고

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

3. 다음 중 하나를 수행합니다:
   • 앱이 게재되어 있다면, 설치를 진행하십시오.
   • 앱이 보류 중인 경우 다음의 메시지가 표시됩니다. "찾고 있는 앱이 아직은 시장에 출시되지 않았습니다." 이것은 예상할 수 있는 결과입니다. 앱이 활성화되지 않았으므로, 어트리뷰션 링크가 앱 스토어로 연결되지 않습니다. 그러나 어트리뷰션 링크는 여전히 어트리뷰션 용도로 유효하며 다음과 같이 앱을 설치해야 합니다.
     • 안드로이드의 경우: APK 파일로 (또는 개발자인 경우 Android Studio)
     • iOS의 경우: TestFlight로(또는 개발자의 경우 Xcode)

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

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

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

1. 앱을 실행하고 몇 가지 인앱이벤트를 발생합니다.
2. 앱 대시보드를 열고 이벤트를 클릭합니다.

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

   

팁! 이벤트가 올바르게 어트리뷰트되었는지 확인하려면 인앱이벤트 로데이터 리포트 다운로드를 고려하십시오. 이 리포트를 다운로드하는 데 몇 분 정도 걸립니다.

리포트 다운로드 방법:

1. 대시보드에서 리포트 > 데이터 내보내기로 이동합니다.
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여 분 정도 시간을 줍니다.

   

시작하기 전에:

• 리타게팅 테스트 설정에 대한 지시 사항을 따르십시오. 
• 테스트를 위해 전환 사이의 최소 시간을 없음으로 설정합니다. 이를 통해 테스트 중에 모든 리인게이지먼트 전환을 기록하고 어트리뷰트할 수 있습니다.

  

• 앱이 테스트 기기에 설치되어 있고, 몇 번 실행된 적이 있는지 확인하십시오. 방금 앱을 설치한 경우 몇 분 동안 기다리십시오.

리인게이지먼트(직접 딥링킹) 테스트 방법:

앱이 딥링크용으로 구성되었는지 확인한 후 다음 절차에 따라 테스트를 수행합니다.

리인게이지먼트(간접 딥링킹) 테스트 방법:

1. 원링크 템플릿에서 이전에 만든 어트리뷰션 링크(앱별 어트리뷰션 링크 또는 사용자정의 롱 링크)를 복사합니다.
2. 테스트 기기에 대한 링크를 보낸 다음 링크를 클릭합니다.
3. 앱을 열기 위해서는 다음 중 어느 하나를 수행합니다.
   • 앱 스토어에서 열기를 클릭합니다.
   • 기기에서 앱을 실행합니다.

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

   

팁! 리인게이지먼트가 올바른 미디어 소스에 어트리뷰트되는지 확인하려면 전환 로데이터 리포트 다운로드를 고려하십시오. 이 리포트를 다운로드하는 데 몇 분 정도 걸립니다.

리포트 다운로드 방법:

1. 대시보드에서 리포트 > 데이터 내보내기로 이동합니다.
2. 리타게팅 섹션에서 전환(리인게이지먼트 및 리어트리뷰션) 리포트를 다운로드합니다.