APS インテグレーション(legacy)
広告スロットの設定、LevelPlayプラットフォームでのAPSの設定、APSアダプターのビルドへの追加によって、Amazonパブリッシャー サービス (APS)を統合します。
読み終わるまでの所要時間 12 分最終更新 6日前
前提条件
Amazonパブリッシャー サービス(APS)は招待制のプログラムです。APS を統合するには、LevelPlay SDK と APS SDK の両方を統合および初期化する必要があります。アプリケーションで APS 広告をディスプレイするには、以下に詳細を示す完全なインテグレーション フローを実行してください。
ステップ 1. APS アカウントの作成
- APS に連絡して、アプリケーションのアカウントを設定します。APS アカウントを作成するには、APS Web サイトに移動し、接触を選択してリクエストを開きます。
- APS リクエストが承認されると、サインアップして APS でアカウントを作成するための招待リンクが送られてきます。
- LevelPlay で APS を設定する前に、上記の手順を完了する必要があります。
ステップ 2. APS ネットワークにスロットを設定する
- Appsメニューから適切なアプリケーションを選択し、設定を選択
- Monetization サービスの設定メニューで ironsource LevelPlay を選択します。
- スロットを追加し、各スロットに定義します。 :
- 名前
- 広告サイズ
- 価格(自動/手動)
- すべてのスロットの追加を完了し、認証情報を取得します。
- App IDの取得
- 価格帯の CSV ファイルをダウンロード
ステップ 3. APS ネットワークワークのアクティベート
ironsource プラットフォーム内で、SDK Networks 設定にアクセスして、LevelPlay アカウントに APS パラメータを設定します。
- 上記の認証情報を取得したら、LevelPlay アカウントにログインし、Monetize (収益化) > 設定> SDK Networks に移動します。
- Available Networks のテーブルから APS を選択し、アクティベートを選択します。

- 広告ネットワークのリストから APS を選択し、設定 を選択します。

- APS App ID を入力し、CSV ファイルをそのままアップロードします。

ステップ 4. APS アダプタをビルドに追加する
CocoaPods
APS SDK を Cocoapods と統合するには、podfile に以下の行を入力して準備完了です。
pod 'IronSourceAPSAdapter','4.3.20.0'
ステップ 5.SKAdNetworkItemsとInfo.plistの更新
次のコードを使用して、APS SKAdNetworkItems を Info.plist に定義します。
<key>SKAdNetworkItems</key><array><dict><key>SKAdNetworkIdentifier</key><string>p78axxw29g.skadnetwork</string></dict></array>
ステップ 6.Init APS SDK
APS ネットワークワークでは、APS 広告をディスプレイするために Ironsource SDK と APS SDK の両方を初期化する必要があります。
アプリケーションを開いた後、LevelPlay SDK を初期化する前に APS SDK を初期化します。APS 設定のステップ 2 で定義した APS App ID を使用します。
#import <DTBiOSSDK/DTBiOSSDK.h>- (ブーリアン)アプリケーション:(UIApplication *)アプリケーション didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [[DTBAds sharedInstance] setAppKey: @"APS_app_id"]; return YES;}
ロードバナー/MREC 広告
-
各 Ironsource 広告単位ロード前に APS バナー広告リクエストを呼び出します(幅 320 または 728)。スロット UUID は、ロード広告リクエストの作成時に使用します。
-
APS iOS SDK 5.0.1 以降:DTBAdSize *size = [[DTBAdSize alloc] initBannerAdSizeWithWidth:320 高さ:高さ andSlotUUID:slotUID]; 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 高さ:高さ andSlotUUID:slotUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];
-
-
APS 広告が正常にロードされたら、広告データを Ironsource と共有します。これには以下のパラメータを含める必要があります。
- Bid Info (入札情報):Amazon 広告が表示されるために必要な情報
- エンコードされた価格:APS から返された落札広告価格
- UUIDスロット一意の識別子
- 幅:バナーの幅
- 高さ:バナーの高ささ
- (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, @"幅":幅, @"高さ":高さ, @"pricePointEncoded":amznPricePoint, @"mediationHints":mediationHints}; NSDictionary* apsData = @{IS_BANNER:bannerData}; [IronSource setNetworkDataWithNetworkKey:@"APS" andNetworkData:apsData];}APS がフィルを返さない場合は、LevelPlay のロードバナーメソッドを呼び出します。 -
Ironsource バナー広告をロードします。詳細については、こちらを参照してください。
インタースティシャル広告のロード
-
各 Ironsource 広告単位ロードの前に APS インタースティシャル広告リクエストを呼び出します。スロット 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];LevelPlay は、APS アダプター 4.3.3 から APS インタースティシャル動画広告をサポートします。インタースティシャルビデオをロードするには、以下のメソッドを呼び出します。アプリケーションが縦向きモードの場合:
-
APS iOS SDK 5.0.1 以降:DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 高さ:480 スロット UUID:slotUID];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 高さ:480 スロット UUID:slotUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];
アプリケーションが横向きモードの場合:-
APS iOS SDK 5.0.1 以降:DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 高さ:320 andSlotUUID: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 高さ:320 andSlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];
-
-
APS 広告が正常にロードされたら、広告データを Ironsource と共有します。これには以下のパラメータを含める必要があります。
-
Bid Info (入札情報):Amazon 広告が表示されるために必要な情報
-
エンコードされた価格:APS から返された落札広告価格
-
UUIDスロット一意の識別子- (void)onSuccess:(DTBAdResponse *)adResponse{ //svt 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 がフィルを返さない場合は、LevelPlay のロード インタースティシャルメソッドを呼び出します。
-
-
Ironsource インタースティシャル広告をロードします。詳細については、こちらを参照してください。
リワード広告
APS インテグレーションは、アプリケーションに実装するリワード広告の動作モードによって異なります。
- 手動読み込みモード:これは、APS と統合するために推奨される設定です。この場合、リワード広告がロードされるたびに APS 広告リクエストを呼び出し必要があります。
- リワード広告デフォルトモード(自動):リワード広告の表示に LevelPlay デフォルト モードを使用する場合は、LevelPlay SDK の初期化前と APS SDK の初期化後に最初の APS 広告をロードする必要があります。さらに、各ショーの前に次の APS ロードリクエストを呼び出して、次のウォーターリクエストに影響を与えることをお勧めします。
ロードリワード広告
-
各 Ironsource 広告単位ロード前(または自動モードでの表示前)に APS リワード広告リクエストを呼び出します。スロット UUID は、ロード広告リクエストの作成時に使用します。アプリケーションが縦向きモードの場合
-
APS iOS SDK 5.0.1 以降:DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:320 高さ:480 スロット UUID:slotUID];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 高さ:480 スロット UUID:slotUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];
アプリケーションが横向きモードの場合:-
APS iOS SDK 5.0.1 以降:DTBAdSize *size = [[DTBAdSize alloc] initVideoAdSizeWithPlayerWidth:480 高さ:320 andSlotUUID: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 高さ:320 andSlotUUID:slotUUID];DTBAdLoader *adLoader = [DTBAdLoader new];[adLoader setSizes:size, nil];[adLoader loadAd:self];
-
-
APS 広告が正常にロードされたら、広告データを Ironsource と共有します。これには以下のパラメータを含める必要があります。
- メディエーションのヒント:Amazon 広告が表示されるために必要な情報
- エンコードされた価格:APS から返された落札広告価格
- 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];}
APS がフィルを返さない場合は、LevelPlay の ロード rewarded メソッドを呼び出します。
これで、アプリケーション内で APS の需要を提供できるようになりました。
次のステップ
LevelPlay を通じて追加の広告ネットワークを活用するには、ネットワークアダプタを統合し、インテグレーションガイドに従ってください。