전체 구성 예제

포괄적인 SDK 구성

다음 예제에서는 여러 옵션을 사용하여 Singular SDK를 구성하는 방법을 보여줍니다. 구성은 SingularSDKObject 게임 오브젝트에서 Unity 인스펙터를 통해 수행할 수 있습니다.

SingularSDKObject 인스펙터 패널

브랜드 도메인

웹-투-앱 어트리뷰션을 위한 브랜드 도메인을 설정합니다. 이렇게 하면 Singular SDK가 커스텀 트래킹 도메인을 인식하여 앱을 열 수 있습니다.

사용 예시

yourcompany.com

go.yourcompany.com

promo.yourcompany.com

클립보드 어트리뷰션

이 확인란을 사용하면 iOS에 클립보드 어트리뷰션을 활성화할 수 있습니다. 활성화하면 SDK가 앱 실행 시 클립보드를 읽어 어트리뷰션 링크를 감지합니다. iOS에만 해당됩니다.

OAID 수집

이 확인란을 선택하면 Android 기기에서 OAID(익명 디바이스 식별자)를 수집할 수 있습니다. OAID는 구글 광고 ID를 사용할 수 없는 지역에서 대체 식별자로 사용됩니다. Android에만 해당됩니다.

Ddl 시간 초과 초

지연된 딥링크 확인을 위한 시간 제한을 초 단위로 설정합니다. 이 값은 SDK가 초기화를 계속하기 전에 디퍼드 딥링크를 기다리는 시간을 결정합니다. 기본값은 60초입니다.

로깅 활성화

SDK 로깅을 활성화하려면 이 확인란을 선택합니다. 활성화하면 SDK가 연동 및 문제 해결에 도움이 되는 디버그 정보를 출력합니다. 프로덕션 빌드에서는 비활성화해야 합니다.

시간 초과 간격으로 ODM 사용

지정된 시간 초과 간격(초)으로 ODM(온 디바이스 매칭)을 활성화합니다. ODM을 사용하면 디바이스 지문을 매칭하여 보다 정확한 어트리뷰션을 수행할 수 있습니다. 비활성화하려면 -1로 설정합니다. iOS 전용.

페이스북 앱 ID

페이스북 어트리뷰션 연동을 위한 페이스북 앱 ID를 설정합니다. 이를 통해 SDK가 페이스북 캠페인 어트리뷰션을 추적할 수 있습니다. 안드로이드 전용.

깨어 있을 때 초기화

게임 오브젝트가 깨어날 때 SDK를 자동으로 초기화할지 여부를 결정합니다. false로 설정하면 InitializeSingularSDK() 을 수동으로 호출하여 SDK를 초기화해야 합니다.

광고 식별자 제한

혼합 대상 앱에서 제한된 광고 식별자 모드를 활성화합니다. 이 옵션은 SDK가 추적을 위해 기기 식별자를 수집하고 사용하는 방식에 영향을 줍니다. 이 옵션을 활성화하면 광고 식별자가 수집되지 않습니다.

로그 수준

SDK 로깅에 대한 로그 수준을 설정합니다. 유효한 값은 다음과 같습니다: 0(없음), 1(오류), 2(중요), 3(정보/디버그), 4(상세). 값이 클수록 더 자세한 로깅 출력이 제공됩니다.

수동 SKAN 전환 관리

수동 SKAdNetwork 전환 값 관리를 활성화합니다. 활성화하면 SkanUpdateConversionValue()를 사용하여 전환 값을 수동으로 업데이트해야 합니다. iOS에만 해당됩니다.

푸시 알림 링크 경로

푸시 알림 페이로드에서 딥링크 URL을 찾을 수 있는 JSON 경로를 지정합니다. 이를 통해 SDK가 푸시 알림에서 딥링크를 추출하고 처리할 수 있습니다. iOS 전용.

notification/deep_link

data/url

custom_link

세션 시간 초과 초

세션 시간 제한을 초 단위로 설정합니다. 앱이 백그라운드로 전환된 후 사용자 세션이 지속되는 시간을 결정합니다. 기본값은 60초입니다.

쇼트링크 확인 시간 제한

짧은 링크 확인 시간 제한을 초 단위로 설정합니다. 이 값은 SDK가 짧은 링크가 확인될 때까지 기다리는 시간을 결정합니다. 기본값은 10초입니다.

Singular API 키

애플리케이션의 Singular API 키를 설정합니다. 이는 앱을 Singular 플랫폼에 식별하는 필수 구성 값입니다. API 키는 Singular 대시보드에서 찾을 수 있습니다.

Singular API 시크릿

애플리케이션의 Singular API 시크릿을 설정합니다. 이는 보안 통신을 위해 API 키와 함께 사용되는 필수 구성 값입니다. Singular 대시보드에서 API 시크릿을 찾을 수 있습니다.

SKAN 활성화

SKAdNetwork 기능을 활성화 또는 비활성화합니다. 활성화하면 SDK가 자동으로 SKAdNetwork 어트리뷰션에 등록하고 전환 값을 관리합니다. iOS에만 해당됩니다.

타임아웃 간격으로 추적 권한 부여 대기

SDK를 초기화하기 전에 ATT(앱 트래킹 투명성) 승인을 기다리는 시간 제한을 초 단위로 설정합니다. 대기하지 않으려면 0으로 설정합니다. iOS 전용.