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

요약: 안드로이드 또는 iOS 앱과 앱스플라이어 연동을 테스트합니다. 

광고 네트워크를 위한 읽을거리: 광고 네트워크 연동 테스트

개요

꼼꼼하게 연동을 테스트하여 데이터 수집이 정확하고 포괄적으로 이루어지도록 합니다. SDK 연동을 테스트하여 SDK가 앱스플라이어 서버와 성공적으로 통신하고 있는지, 그리고 인스톨, 인앱이벤트 및 리타게팅이 올바르게 기록되고 어트리뷰트되는지 확인할 수 있습니다. 

SDK 연동이 완료되면 앱스플라이어 대시보드에 액세스할 수 있는 모든 팀원이 기본 테스트를 수행할 수 있습니다. 개발사는 개발 환경에서 디버그 로그를 활용할 수 있습니다.

본 문서에서는 대시보드에서의 테스트 절차에 대해 설명하고 마케터가 개발사에 제공해야 하는 설명서의 링크를 제공합니다. 

테스트 방법

다음 절에서는 수행할 수 있는 다양한 테스트와 사용 가능한 방법에 대해 설명합니다.

대시보드에서 테스트

대시보드에서 SDK 연동을 테스트하려면 먼저 테스트 기기를 등록해야 합니다(안드로이드 또는 iOS). 이렇게 하면 동일한 기기를 반복적으로 사용할 수 있으며 인스톨이 재인스톨로 기록되지 않습니다.  

다음을 수행해야 합니다.

  • 오가닉 인스톨 테스트.
  • 기본 연동 기능(논오가닉 인스톨, 인앱이벤트 및 리타게팅) 테스트.
    사용가능한 방법은 다음과 같습니다.
    • SDK 연동 테스트 페이지: 각 테스트 실행 프로세스를 안내하는 앱스플라이어 대시보드의 마법사.
    • 어트리뷰션 링크를 사용한 테스트: 모든 비 SRN 광고 네트워크와 온드 미디어 소스는 앱스플라이어 어트리뷰션 링크를 사용합니다. 따라서 어트리뷰션 링크를 사용하여 테스트를 수행하는 것이 좋습니다. 어트리뷰션 링크를 만든 다음 테스트를 실행하여 SDK가 논오가닉 인스톨 및 인앱이벤트를 올바른 미디어 소스에 할당하고 있는지 확인합니다. 또한 테스트를 실행하여 리타게팅(리어트리뷰션 및 리인게이지먼트)이 기록되고 올바른 미디어 소스에 어트리뷰트되는지 확인해야 합니다.

iOS 14+ 테스트 고려사항

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

개발 환경에서 테스트

개발사는 다음을 수행합니다.

  • 디버그 로그 사용 및 검사 및 구매 검증, 전환 데이터 및 딥링킹 등의 시나리오 테스트.

     참고

    개발자가 로그에서 403 응답을 수신하는 경우에는 제로 패키지가 있기 때문일 수 있습니다. 이 패키지에는 어트리뷰션 데이터를 포함하지 않으며, 클릭 및 노출에 대한 데이터만 포함합니다. 패키지에 대한 자세한 정보는 hello@appsflyer.com으로 CEM 팀에 문의하거나 앱스플라이어 과금 정책 부서를 방문하십시오.

  • 디버그 앱을 생성하여 SDK 연동 테스트. 테스트를 수행할 때 데이터가 기록되고 대시보드에 표시됩니다. 데이터가 일단 기록된 후에는 삭제할 수 없습니다. 프로덕션 앱의 일부로 기록된 데이터를 테스트하지 않으려면 개발사에 디버그 앱을 사용하여 SDK 연동을 테스트하도록 요청할 수 있습니다. 디버그 앱은 다른 앱스플라이어 앱 ID와 자체 대시보드를 가지고 있으며 앱 스토어에 게시되지 않는다는 점에서 프로덕션 앱과 차이 납니다.

대시보드에 디버그 앱 추가

개발사가 디버그 앱을 만드는 경우 해당 앱을 대시보드에 추가해야 합니다. 개발사가 앱을 사용하여 테스트를 시작하면 데이터가 앱의 대시보드에 표시됩니다.

다음의 절차를 수행하여 디버그 앱을 추가합니다.

디버그 앱 추가(안드로이드) 디버그 앱 추가(iOS)

대시보드에 디버그 앱을 추가하는 방법:

  1. 개발사로부터 디버그 앱의 패키지 이름을 받아서 앱스플라이어 대시보드에 해당 앱을 추가합니다.
  2. 앱 상태를 다음 중 하나로 설정합니다.
    • 승인 대기 중
    • 미게시

특별한 테스트 사례

특별한 테스트 사례에는 다음이 포함됩니다.

  • 안드로이드 TV: SDK는 안드로이드 기반 스마트 TV와 호환됩니다. 마케터 또는 팀원은 본 문서의 절차에 따라 이러한 TV 앱을 테스트할 수 있습니다.
  • Apple TV(tvOS): SDK는 Apple TV(tvOS)와 호환됩니다. 마케터 또는 팀원은 본 문서의 절차에 따라 이러한 TV 앱을 테스트할 수 있습니다.
  • 미게시 tvOS 앱: 마케터와 개발사가 협력해야 합니다(게시 전 tvOS 연동 테스트 참조).
  • Amazon Fire TV: 마케터는 대시보드에서 테스트를 수행합니다(대체 안드로이드 스토어 테스트 참조).
  • PBA 웹 이벤트: 마케터와 개발사가 협력해야 합니다(PBA 웹 SDK 연동 테스트 참조).

기본 SDK 기능 테스트

다음 절에서는 기본 SDK 연동을 테스트하기 위해 따라야 하는 절차를 설명합니다.

오가닉 인스톨 테스트

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

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

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

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

Test_SDK_Organic_install

SDK 연동 테스트 페이지를 사용한 테스트

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

시작하기 전에:

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

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

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

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

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

    NonOrganic_install

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

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

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

시작하기 전에:

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

    Test_SDK_Integration_Inapp_events

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

시작하기 전에:

  • 논오가닉 인스톨을 기록하는 데 사용한 기기를 사용해야 합니다. 
  • 테스트 앱을 3번 이상 실행합니다.
  • 딥링킹(리타게팅)을 테스트하려면 원링크가 앱에 정의되어 있어야 합니다. 자세한 정보는 원링크 설정 가이드를 참조하십시오. 
  • 리타게팅이 켜져 있는지 확인하십시오.
  1. 딥링킹 테스트를 실행합니다.
  2. 등록된 테스트 기기를 선택합니다.
  3. 테스트 유형을 선택합니다.
    • 원링크: 원링크를 선택합니다. 
    • URI 스킴: URI 스킴을 입력합니다(예를 들어, greatapps://cars).
  4. 다음을 클릭합니다.
  5. 등록한 테스트 기기로 QR 코드를 스캔하고 기기에 대한 지시 사항을 따르십시오. 테스트가 완료되면 딥링킹 테스트가 성공으로 등록됩니다.

    TestSDK_DeepLinks_en-us.png

어트리뷰션 링크를 사용한 테스트

다음 절에서는 어트리뷰션 링크를 사용하여 인스톨을 테스트하기 위해 따라야 하는 절차에 대해 설명합니다. 앱이 아직 보류 중(즉, Google Play Store 또는 Apple 앱 스토어에 기재되지 않음)인 경우에도 이러한 테스트를 수행할 수 있습니다.

인스톨 어트리뷰션 테스트

인스톨 테스트를 통해 앱스플라이어 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>

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

    Android iOS

    https://app.appsflyer.com/com.my.app?pid=Test&c=Test&advertising_id=12345f9*-eba*-421*-876*-7654ac67876*
  2. 업데이트된 링크를 복사하여 테스트 기기로 보낸 다음 링크를 클릭합니다.

     참고

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

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

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

 

다음은 테스트 결과를 확인하는 대체 방법에 대해 설명합니다.

  • 로데이터 리포트에 액세스할 수 있다면 로데이터 인스톨 리포트를 다운로드하십시오. 이 리포트를 다운로드하는 데 몇 분 정도 걸립니다.

    리포트 다운로드 방법:

    1. 대시보드에서 리포트데이터 내보내기로 이동합니다.
    2. 사용자 인입(논오가닉) 목록에서 인스톨을 클릭한 후 리포트를 다운로드하십시오. 
  • 디버그 로그에 액세스할 수 있다면, SDK 연동 테스트 API를 사용하여 특정 인스톨에 대한 어트리뷰션 결과를 검색할 수 있습니다.

인앱이벤트 어트리뷰션 테스트

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

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

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

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

    Testing_InAppEvents_Attribution

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

리포트 다운로드 방법:

  1. 대시보드에서 리포트데이터 내보내기로 이동합니다.
  2. 로데이터 리포트 섹션에서 인앱이벤트 로데이터 리포트를 다운로드합니다.

원링크 테스트

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

또한 원링크는 딥링킹을 가능하게 합니다. 딥링킹을 통해 특정 앱 액티비티에서 앱을 열고 맞춤 콘텐츠를 제공할 수 있습니다.

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

어트리뷰션 링크를 사용한 리타게팅 테스트

다음 절에서는 리타게팅 어트리뷰션을 테스트하기 위해 따라야 하는 절차를 설명합니다.

리타케팅 테스트 정보

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

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

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

리타게팅 테스트 실행의 전제 조건

리타게팅 테스트 실행 전에 다음 설정을 해야 합니다.

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

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

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

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

    Set_Reattribution_window

  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의 예를 보여줍니다.

      Testing_LongLink_en-us.png

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

리어트리뷰션 테스트

시작하기 전에:

  • 리타게팅 테스트 설정에 대한 지시 사항을 따르십시오.
  • 테스트 기기는 등록되지 않은 것이어야 합니다.

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

  1. 기기에서 앱을 삭제합니다. 방금 앱을 설치한 경우 몇 분 동안 기다리십시오.
  2. 이전에 만든 어트리뷰션 링크(원링크 템플릿에서 앱 특정 어트리뷰션 링크 또는 사용자정의 롱 링크)를 복사하여 테스트 기기로 보낸 다음 링크를 클릭합니다.

     참고

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

  3. 다음 중 하나를 수행합니다:
    • 앱이 게재되어 있다면, 설치를 진행하십시오.
    • 앱이 보류 중인 경우 다음과 같이 설치합니다.
      • 안드로이드의 경우: Android Studio 또는 APK 파일로 설치.
      • iOS의 경우: TestFlight에서 설치.
  4. 앱의 대시보드를 열고 왼쪽 메뉴에서 리타게팅을 클릭하십시오.

    캠페인 이름 테스트 아래에서 미디어 소스 테스트에 어트리뷰트된 인스톨을 볼 수 있습니다. 리타게팅된 인스톨이 대시보드에 표시될 때까지 30여 분 정도 시간을 줍니다.

    Testing_Reattribution

 

다음은 테스트 결과를 확인하는 대체 방법에 대해 설명합니다.

  • 로데이터 리포트에 액세스할 수 있다면 로데이터 전환 리포트를 다운로드하십시오. 이 리포트를 다운로드하는 데 몇 분 정도 걸립니다.

    리포트 다운로드 방법:

    1. 대시보드에서 리포트데이터 내보내기로 이동합니다.
    2. 리타게팅 목록에서 전환(리인게이지먼트 및 리어트리뷰션)을 클릭하여 리포트를 다운로드하십시오. 
  • 디버그 로그에 액세스할 수 있다면, SDK 연동 테스트 API를 사용하여 특정 인스톨에 대한 어트리뷰션 결과를 검색할 수 있습니다.

리인게이지먼트 테스트

시작하기 전에:

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

    Testing_Reattribution_window

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

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

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

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

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

    대시보드에서 미디어 소스 테스트, 캠페인 이름 테스트 아래에 어트리뷰트된 리인게이지먼트를 볼 수 있습니다. 리인게이지먼트가 나타날 때까지 최대 30분 정도 기다리십시오.Testing_ReEngagement

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

리포트 다운로드 방법:

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