APS 연동 (legacy)

필수 조건

1단계. APS 계정 생성

1. 앱 계정을 설정하려면 APS에 도달률. APS 계정을 생성하려면 APS 웹사이트로 이동하여 ** 문의하기**를 선택하고 요청을 엽니다.
2. APS 요청이 승인되면 APS에 가입하고 계정을 만드는 초대 링크가 표시됩니다.
3. 레벨플레이 APS를 설정하려면 위 단계를 완료해야 합니다. 

2단계. APS 네트워크에서 슬롯 설정

1. 앱 메뉴에서 올바른 애플리케이션을 선택하고 설정을 선택합니다.
2. 수익화 서비스 설정 메뉴로 IronSource 레벨플레이를 선택합니다.
3. 각 슬롯에 슬롯을 추가하고 정의합니다.
   1. Name
   2. 광고 크기
   3. 가격 지점 (자동/매뉴얼)
4. 모든 슬롯을 추가하고 자격 증명을 수집합니다.
   1. 앱 ID 가져오기
   2. 가격대 CSV 파일 다운로드

3단계. APS 네트워크 활성화

1. 위에서 언급한 자격 증명을 보유한 후 레벨플레이 계정에 로그인하고 수익화 > 설정 > SDK 네트워크로 이동합니다.
2. 사용 가능한 네트워크 표에서 APS를 선택하고 활성화를 선택합니다.

를 선택합니다.

3. 광고 네트워크 목록에서 APS를 선택하고 설정을 선택합니다.

4. APS 앱 ID를 입력하고 CSV 파일을 그대로 업로드합니다.

4단계. 빌드 APS 어댑터 추가

CocoaPods

pod 'IronSourceAPSAdapter','4.3.20.0'

5단계 SKAdNetworkItems 및 Info.plist 업데이트

<key>SKAdNetworkItems</key><array><dict><key>SKAdNetworkIdentifier</key><string>p78axxw29g.skadnetwork</string></dict></array>

6단계. Init APS SDK

#import <DTBiOSSDK/DTBiOSSDK.h>- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {  [[DTBAds sharedInstance] setAppKey: @"APS_app_id"];  return YES;}

배너/MREC 광고 로드

1. 각 Ironsource 광고 유닛 로드 전에 APS 배너 광고 요청을 호출(너비 320 또는 728). 로드 광고 요청을 생성할 때 Slot UUID를 사용합니다.
   • APS iOS SDK 5.0.1+:

     DTBAdSize *size = [[DTBAdSize alloc] initBannerAdSizeWithWidth:320 height:height 및SlotUUID:slotUUID]; DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

   • APS iOS SDK 5.0.1 이하:

     DTBAdSize *size = [[DTBAdSize alloc] initBannerAdSizeWithWidth:320 height:height 및SlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

      
2. APS 광고가 성공적으로 로드되면 광고 데이터를 Ironsource 공유합니다. 여기에는 다음 파라미터가 포함되어야 합니다.
   1. 단가 정보: Amazon 광고 표시에 필요한 정보
   2. 가격대 인코딩: APS에서 반환된 낙찰 광고 가격
   3. UUID: 슬롯 고유 식별자
   4. 너비: 배너 너비
   5. 높이: 배너 높이

   - (void)onSuccess:(DTBAdResponse *)adResponse{       NSString* amznPricePoint = [adResponse amznSlots];    NSDictionary* mediationHints = [adResponse mediationHints];        NSNumber* width = [NSNumber numberWithInt:adSize.width];    SNumber* height = [NSNumber numberWithInt:adSize.height];            NSDictionary* bannerData = @{@"uuid":slotUUID, @"width":width, @"height":height, @"pricePointEncoded":amznPricePoint, @"mediationHints":mediationHints};    NSDictionary* apsData = @{IS_BANNER:bannerData};            [IronSource setNetworkDataWithNetworkKey:@"APS" andNetworkData:apsData];}

   APS가 보여줄 광고 없음(no fill) 반환하면 레벨플레이 load 배너 메서드를 호출.
3. Ironsource 배너 광고를 로드합니다. 자세히 알아보기 여기.

인터스티셜 광고 로드

1. 각 Ironsource 광고 유닛 로드 전에 APS 인터스티셜 광고 요청 호출 로드 광고 요청을 생성할 때 Slot UUID를 사용합니다. APS iOS SDK 5.0.1+:

   DTBAdSize *size = [[DTBAdSize alloc] initInterstitialAdSizeWithSlotUUID:slotUUID]; DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

   APS iOS SDK 5.0.1 이하:

   DTBAdSize *size = [[DTBAdSize alloc] initInterstitialAdSizeWithSlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

   레벨플레이 APS 어댑터 4.3.3부터 APS 인터스티셜 광고 비디오 광고를 지원합니다. 인터스티셜 광고 비디오를 로드하려면 다음 메서드를 호출.
   앱이 세로 모드인 경우:
   • APS iOS SDK 5.0.1+:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 height:480 및SlotUUID:slotUUID];DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

      
   • APS iOS SDK 5.0.1 이하:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 height:480 및SlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

   앱이 랜드스케이프 모드인 경우:
   • APS iOS SDK 5.0.1+:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 height:320 및SlotUUID:slotUUID];DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

      
   • APS iOS SDK 5.0.1 이하:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 height:320 및SlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

2. APS 광고가 성공적으로 로드되면 광고 데이터를 Ironsource 공유합니다. 여기에는 다음 파라미터가 포함되어야 합니다.
   1. 단가 정보: Amazon 광고 표시에 필요한 정보
   2. 가격대 인코딩: APS에서 반환된 낙찰 광고 가격
   3. UUID: 슬롯 고유 식별자

      - (void)onSuccess:(DTBAdResponse *)adResponse{ //svt on onSuccess        NSString* amznPricePoint = [adResponse amznSlots];    NSDictionary* mediationHints = [adResponse mediationHints];    NSDictionary* isData = @{@"uuid":slotUUID, @"pricePointEncoded":amznPricePoint, @"mediationHints":mediationHints};    NSDictionary* apsData = @{IS_INTERSTITIAL:isData};            [IronSource setNetworkDataWithNetworkKey:@"APS" andNetworkData:apsData];}

      APS가 보여줄 광고 없음(no fill) 반환하면 레벨플레이 load 인터스티셜 광고 메서드를 호출.
3. 로드 ironSource 인터스티셜 광고. 자세히 알아보기 여기.

보상형 광고

1. 매뉴얼 로딩 모드: APS와 연동하는 데 권장되는 설정입니다. 이렇게 하면 각 보상형 광고 광고 로드 전에 APS 광고 요청을 호출 합니다.
2. 보상형 광고 기본 모드(자동): 보상형 광고 광고를 표시하기 위해 레벨플레이 기본 모드를 사용하는 경우, 레벨플레이 SDK를 초기화하기 전에 APS SDK를 초기화한 후 첫 번째 APS 광고를 로드해야 합니다. 또한 각 쇼 전에 다음 APS 로드 요청을 호출하여 다음 워터폴 요청에 영향을 줄 것을 권장합니다.

보상형 광고 로드

1. 각 Ironsource 광고 유닛 로드 전에(또는 자동 모드에서 쇼 전에) APS 보상형 광고 광고 요청을 호출. 로드 광고 요청을 생성할 때 Slot UUID를 사용합니다. 앱이 세로 모드인 경우:
   • APS iOS SDK 5.0.1+:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 height:480 및SlotUUID:slotUUID];DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

      
   • APS iOS SDK 5.0.1 이하:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 height:480 및SlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

   앱이 랜드스케이프 모드인 경우:
   • APS iOS SDK 5.0.1+:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 height:320 및SlotUUID:slotUUID];DTBAdNetworkInfo *adNetworkInfo = [[DTBAdNetworkInfo alloc] initWithNetworkName:DTBADNETWORK_UNITY_LEVELPLAY];DTBAdLoader *loader = [[DTBAdLoader alloc]initWithAdNetworkInfo:adNetworkInfo];[adLoader setSizes:size, nil]; [adLoader loadAd:self];

      
   • APS iOS SDK 5.0.1 이하:

     DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 height:320 및SlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];

2. APS 광고가 성공적으로 로드되면 광고 데이터를 Ironsource 공유합니다. 여기에는 다음 파라미터가 포함되어야 합니다.
   1. Mediation 힌트: Amazon 광고 표시에 필요한 정보
   2. 가격대 인코딩: APS에서 반환된 낙찰 광고 가격
   3. UUID: 슬롯 고유 식별자

- (void)onSuccess:(DTBAdResponse *)adResponse{        NSString* amznPricePoint = [adResponse amznSlots];    NSDictionary* mediationHints = [adResponse mediationHints];    NSDictionary* rvData = @{@"uuid":slotUUID, @"pricePointEncoded":amznPricePoint, @"mediationHints":mediationHints};    NSDictionary* apsData = @{IS_REWARDED_VIDEO:rvData};            [IronSource setNetworkDataWithNetworkKey:@"APS" andNetworkData:apsData];}

다음 단계