연동
이 페이지는 AppLovin MAX SDK를 다운로드, 임포트 및 설정하는 방법을 설명합니다.
최신 SDK 다운로드
CocoaPods를 통해 SDK를 디펜던시로 다운로드할 수 있습니다. 수동으로 연동하는 것을 선호하신다면 여기의 안내를 따르십시오. Swift Package Manager를 사용하여 연동하는 것을 선호하신다면 여기의 안내를 따르십시오.
SDK는 최소 iOS 배포 타겟으로 iOS 12.0 이상을 요구합니다. 또한 Xcode 버전 15 이상이 필요합니다.
릴리스 업데이트를 받으려면 AppLovin iOS MAX SDK GitHub 리포지토리를 구독하십시오.
Swift 호환성
Swift가 포함된 아티팩트와 빌드가 호환되도록 하려면 Build Settings > Always Embed Swift Standard Libraries를 YES로 설정하십시오.
Swift를 사용하고 iOS 12.2.0 이하 버전을 타겟으로 빌드하는 경우, Build Settings > Runpath Search Paths에 /usr/lib/swift를 추가하십시오.
이렇게 하면 libswiftCore.dylib 관련 문제를 방지할 수 있습니다.
CocoaPods
CocoaPods를 통해 AppLovin SDK를 연동하려면:
- Podfile에 다음 라인을 추가합니다.
pod 'AppLovinSDK' - 커맨드 라인에서 다음을 실행합니다.
pod install --repo-update
Swift Package Manager
SPM을 통해 AppLovin SDK를 연동하려면:
- Xcode에서 **File > Add Package Dependencies…**를 클릭합니다.
- 검색창에 여기에서 확인할 수 있는 AppLovin iOS MAX Swift Package GitHub 리포지토리 URL을 입력한 다음, 패키지가 나타나면 선택합니다.
- Dependency Rule을 선택하고 Add to Project를 앱 타겟으로 설정합니다.
- Add Package를 클릭하여
AppLovinSDK를 연동합니다.
Ad Review 활성화
MAX Ad Review 서비스를 활성화하려면 AppLovin 계정에 로그인해야 합니다.
그 다음 AppLovinQualityServiceSetup-ios.rb를 다운로드하여 프로젝트 폴더로 이동합니다.
터미널 창을 열고 프로젝트 폴더로 cd한 후 다음을 실행합니다.
ruby AppLovinQualityServiceSetup-ios.rb
SDK 초기화
SDK 초기화 설정 생성
SDK를 초기화하기 전에, 앱 델리게이트의 application:applicationDidFinishLaunching: 메서드에서 SDK용 초기화 설정 객체를 생성합니다.
이 설정 객체를 사용하면 SDK가 초기화될 때 사용할 속성들을 구성할 수 있습니다.
이러한 초기화 속성들은 앱의 수명 동안 변경될 수 있는 가변 속성을 포함하는 ALSdkSettings를 제외하고는 불변(immutable)입니다.
// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
// Perform any additional configuration/setting changes
}];
// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
builder.mediationProvider = ALMediationProviderMAX
// Perform any additional configuration/setting changes
}
SDK 키는 AppLovin 대시보드의 Account > General > Keys 섹션에서 확인할 수 있습니다.
SDK 초기화
초기화 설정 객체를 사용하여 AppLovin SDK를 초기화합니다. 앱 시작 시 이 작업을 수행하십시오. 이렇게 하면 SDK가 mediation 네트워크 광고를 캐싱하는 데 걸리는 시간을 극대화하여 더 나은 사용자 경험을 제공할 수 있습니다.
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
}];
// Initialize the SDK with the configuration
[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
// Start loading ads
}];
⋮
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool
{
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
builder.mediationProvider = ALMediationProviderMAX
}
// Initialize the SDK with the configuration
ALSdk.shared().initialize(with: initConfig) { sdkConfig in
// Start loading ads
}
⋮
예제
아래는 연동 예시입니다:
// Create the initialization configuration
ALSdkInitializationConfiguration *initConfig = [ALSdkInitializationConfiguration configurationWithSdkKey: @"«SDK-key»" builderBlock:^(ALSdkInitializationConfigurationBuilder *builder) {
builder.mediationProvider = ALMediationProviderMAX;
builder.segmentCollection = [MASegmentCollection segmentCollectionWithBuilderBlock:^(MASegmentCollectionBuilder *builder) {
[builder addSegment: [[MASegment alloc] initWithKey: @(849) values: @[@(1), @(3)]]];
}];
}];
// Configure the SDK settings if needed before or after SDK initialization.
ALSdkSettings *settings = [ALSdk shared].settings;
settings.userIdentifier = @"«user-ID»";
[settings setExtraParameterForKey: @"uid2_token" value: @"«token-value»"];
// Note: you may also set these values in your Info.plist
settings.termsAndPrivacyPolicyFlowSettings.enabled = YES;
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = [NSURL URLWithString: @"«https://your-company-name.com/terms-of-service»"];
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = [NSURL URLWithString: @"«https://your-company-name.com/privacy-policy»"];
// Initialize the SDK with the configuration
[[ALSdk shared] initializeWithConfiguration: initConfig completionHandler:^(ALSdkConfiguration *sdkConfig) {
// Start loading ads
}];
// Create the initialization configuration
let initConfig = ALSdkInitializationConfiguration(sdkKey: "«SDK-key»") { builder in
builder.mediationProvider = ALMediationProviderMAX
builder.segmentCollection = MASegmentCollection { segmentCollectionBuilder in
segmentCollectionBuilder.add(MASegment(key: 849, values: [1, 3]))
}
}
// Configure the SDK settings if needed before or after SDK initialization.
let settings = ALSdk.shared().settings
settings.userIdentifier = "«user-ID»"
settings.setExtraParameterForKey("uid2_token", value: "«token-value»")
// Note: you may also set these values in your Info.plist
settings.termsAndPrivacyPolicyFlowSettings.isEnabled = true
settings.termsAndPrivacyPolicyFlowSettings.termsOfServiceURL = URL(string: "«https://your-company-name.com/terms-of-service»")
settings.termsAndPrivacyPolicyFlowSettings.privacyPolicyURL = URL(string: "«https://your-company-name.com/privacy-policy»")
// Initialize the SDK with the configuration
ALSdk.shared().initialize(with: initConfig) { sdkConfig in
// Start loading ads
}
iOS 14 지원
iOS 14에서 Apple은 글로벌 개인정보 보호정책 변경 사항을 도입했습니다. Apple은 애플리케이션이 이러한 새로운 정책을 준수할 것을 요구합니다. 이를 준수하지 않을 경우 수익이 감소할 수 있습니다. 이 섹션에서는 준수 방법에 대해 설명합니다.
SKAdNetwork
네트워크별 식별자로 앱의 Info.plist를 업데이트하십시오.
자세한 안내는 SKAdNetwork 문서를 참조하십시오.
동의 및 데이터 API
특정 관할 구역의 사용자로부터 AppLovin의 수익화 파트너를 대리하여 동의를 얻어야 합니다. 또한 동의 값을 AppLovin에 전달해야 합니다. 자세한 방법은 개인정보 보호 – 동의, 연령 관련 플래그 및 데이터 API 문서를 참조하십시오.
