가이드

연동 테스트

수정 제안하기

Recommended 👍

Easily test with our SDK wizard

참고

If you prefer not to use our recommended wizard you can find detailed instructions here

iOS SDK 연동 문제 해결

앱 설치 및 이벤트가 기록되지 않습니다

앱 설치 및 이벤트가 기록되지 않는 몇 가지 이유가 있을 수 있습니다.

  • 잘못된 앱 ID 형식: 잘못된 형식으로 앱 ID를 지정하면 앱 설치 및 이벤트가 기록되지 않습니다. Delegate 파일에서 앱 ID를 설정할 때, 앱 ID가 숫자로만 구성되어 있는지 확인하십시오. 앱 ID 형식이 잘못된 경우 로그에 다음 오류가 표시됩니다:

    \[ERROR\] AppsFlyer: -\[AppsFlyerTracker validateAppID\] 
    AppsFlyer Error: appleAppID should be a number!

  • 잘못된 앱 ID: 계정에 존재하지 않는 앱 ID를 지정하면, 앱 인스톨 및 이벤트가 기록되지 않습니다. 로그에는 다음 오류가 표시됩니다:

    AppsFlyer: -[AppsFlyerHTTPClient sendRequestEventToServer:isRequestFromCache:appID:isDebug:
        completionHandler:]_block_invoke sent information to server, status = 404

The 404 오류는 SDK가 계정에서 앱을 찾을 수 없음을 나타냅니다.

  • 잘못된 Dev Key: 잘못된 dev key ID를 지정하면 앱 인스톨 및 이벤트가 기록되지 않습니다. 로그에는 다음 오류가 표시됩니다:

    AppsFlyer: -[AppsFlyerHTTPClient 
sendRequestEventToServer:isRequestFromCache:appID:isDebug:completionHandler:]
        _block_invoke sent information to server, status = 400

    400 오류는 SDK가 앱 설치 및 이벤트 기록 요청을 인증할 수 없음을 나타냅니다. Dev key가 올바른지 확인하십시오. 또한, dev key에 영숫자만 포함되어 있는지 확인하십시오.

    올바른 예:

    [AppsFlyerLib shared].appleAppID = @"340954503";

    잘못된 예:

    [AppsFlyerLib shared].appleAppID = @"id340954503";

    잘못된 예:

    [AppsFlyerLib shared].appleAppID = @"com.appslyer.sampleapp";

앱 ID와 dev key가 정확하지만 앱 설치가 기록되지 않습니다

시나리오
앱에 올바른 앱 ID와 dev key가 포함되어 있지만 앱 설치가 기록되지 않습니다.

가능한 이유
SDK가 제대로 시작되지 않았습니다. 다음 메서드 start 를 다음에서 호출하십시오: applicationDidBecomeActive: 

    - (void)applicationDidBecomeActive:(UIApplication *)application { 
        [[AppsFlyerLib shared] start]; 
        }

    func applicationDidBecomeActive(application: UIApplication) { 
        AppsFlyerLib.shared().start() 
    }

"AppsFlyer dev key missing or empty. aborting" 라고 로그에 표시됩니다

시나리오
로그에서 인스톨과 인앱 이벤트를 확인해보려고 합니다. "AppsFlyer dev key missing or empty. Aborting" 이라고 로그에 표시됩니다

가능한 이유

dev key가 설정되지 않았습니다. 다음 didFinishLaunchingWithOptions 메서드에서 appDelegate에서 설정해야 합니다:

[AppsFlyerLib shared].appsFlyerDevKey = @"<YOUR_DEV_KEY>";

AppsFlyerLib.shared().appsFlyerDevKey = "<YOUR_DEV_KEY>"

항상 오가닉으로 어트리뷰트 되는 인스톨

시나리오
어트리뷰션 링크를 사용하여 어트리뷰션을 테스트하려고 합니다. SDK conversion listerner를 구현했지만 로그에서는 항상 설치가 오가닉으로 표시됩니다. 게다가, 논오가닉 인스톨은 대시보드에 전혀 기록되지 않았습니다.

가능한 이유

  1. 사용하는 어트리뷰션 링크가 잘못되었습니다. 어트리뷰션 링크에 대한 가이드를 참조하십시오.
  2. 테스트 중인 기기가 등록되어 있는지 확인하십시오.

수익이 제대로 기록되지 않았습니다

시나리오
수익 데이터가 포함된 인앱 이벤트를 테스트하려고 합니다. 이벤트는 대시보드에 표시되지만 수익은 기록되지 않습니다

가능한 이유
수익 파라미터가 올바른 형식이 아닙니다. 수익 값은 어떤 표시 형식도 지정되지 않아야 합니다. 쉼표 구분 기호, 환율 기호, 또는 문자가 포함되면 안됩니다. 예를 들어, 수익 값은 1234.56과 같은 형태가 되어야 합니다.

앱 설치 또는 이벤트 기록시 404 응답이 표시됩니다

시나리오
인스톨과 인앱 이벤트가 정확한 미디어소스에 어트리뷰트되는지 확인하기 위해 테스트하려고 합니다. 그러나 앱 설치와 인앱 이벤트의 경우 모두 404 응답이 표시됩니다. 앱 설치 또는 인앱 이벤트 아무것도 대시보드에 표시되지 않습니다.

가능한 이유
404 응답은 앱 ID가 잘못되었음을 나타냅니다. 인스톨 및 이벤트가 기록되지 않음 항목을 참조하십시오.

앱 설치 또는 이벤트 기록시 400 응답이 표시됩니다

시나리오
로그에서 인앱 이벤트를 테스트해보려고 합니다. 이벤트를 트리거하면 로그에 400 응답이 표시됩니다.

가능한 이유
이것은 dev key에 문제가 있음을 나타낼 수 있습니다. Dev key가 올바른지 확인하십시오. 또한, dev key에 영숫자만 포함되어 있는지 확인하십시오. 인스톨 및 이벤트가 기록되지 않음 항목을 참조하십시오.

앱 설치 또는 이벤트 기록시 response 403이 표시됩니다.

시나리오
로그에서 인스톨과 기타 전환 이벤트를 확인하고자 합니다. 이러한 이벤트를 트리거하는 경우 로그에 response 403 (forbidden)이 표시됩니다.

가능한 이유
This might be because you have the Zero package, which does not include attribution data; only data on clicks and impressions. To start receiving attribution data, learn more about the different AppsFlyer packages, and update as needed. You can also contact our customer engagement team at [email protected] if you have questions about our packages.

My SDK connection to AppsFlyer is secured by TLS 1.0 or 1.1

To ensure that the connection to AppsFlyer is secured by TLS 1.2 or 1.3 and not by lower TLS versions use the appsflyersdk.com endpoint without a prefix. Specifically call the setHost function in the following way: setHost("","[appsflyersdk.com](http://appsflyersdk.com/)")

iOS 디버그 앱 만들기

선택 가능
Xcode의 컴파일 설정 기능을 활용하여 사용하기 쉬운 디버그 앱 을 설정할 수 있습니다. Xcode의 활성 컴파일 조건을 활용하여 디버그 앱과 프로덕션 앱 간에 전환할 수 있습니다.

📘

참고

프로덕션 데이터와 테스트 트래픽을 혼합해도 상관 없다면 연동 테스트로 건너뛸 수 있습니다. 모든 테스트는 프로덕션 및 디버그 앱 모두에 대해 수행할 수 있습니다.

이는 프로젝트의 빌드 설정에서 사용자 정의 설정을 구성하고 info.plist 속성을 통해 표시함으로써 달성됩니다.

1단계: 앱스플라이어에 디버그 앱 추가
Add a new pending iOS app to AppsFlyer or ask a team member with dashboard access to add it. Choose any available app ID–You will need it in step 3. Make sure the ID is 9 digits and starts with four 1s, for example, 111167538.

2단계: 사용자 정의 설정 추가

  1. Xcode의 파일 탐색기 보기에서 프로젝트 루트를 선택하고 빌드 설정(Build Settings)으로 이동합니다.
  2. 도구 모음에서 +를 클릭하고 사용자 정의 설정 추가를 선택합니다. 이 경우에는 다음 이름을 붙입니다: AF_APP_ID.
  3. 새로 생성된 사용자 정의 설정을 확장합니다:
    • 디버그 조건부 설정을 테스트 앱의 앱 ID로 설정(1단계에서 언급)
    • 출시 조건부 설정을 프로덕션 앱의 앱 ID로 설정합니다.
987

3단계: info.plist를 통해 앱 ID 노출
프로젝트의 info.plist 으로 이동하여 새 속성을 추가합니다(이 경우 AFAppID 라고 부름). 값을 $(AF_APP_ID) 으로 설정합니다(2단계의 사용자 정의 설정 이름을 기반으로 함).

971

4단계: 앱 ID 검색 및 설정
SDK 초기화 중 앱 ID에 액세스하고 사용하려면 다음에 다음 코드를 추가합니다: didFinishLaunchingWithOptions 푸시 알림 AppDelegate:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // ...
    guard let appID : String = Bundle.main.object(forInfoDictionaryKey: "AFAppID") as? String else {
        fatalError("Cannot find app ID")
    }
    AppsFlyerLib.shared().appleAppID = appID
    // ...
    return true
}

5단계: 디버그 빌드 설정을 사용하여 앱 실행
활성 빌드 설정을 변경하려면:

  1. 제품 > 스키마 > 스키마 편집...으로 이동합니다.
  2. 실행을 선택하고 필요에 따라 빌드 설정을 디버그 또는 출시로 변경합니다.
945

이제 디버그 설정을 사용하여 앱을 빌드할 때 Xcode는 2단계에서 설정한 디버그 앱 ID를 사용합니다.

최신 데이터 약 2개월 전