AdMob Mediation と Vungle SDK (iOS) の統合

目次

はじめに

  • AdMob ダッシュボードには、Vungle の配置広告はまだ導入されていません。配置広告レベルのパフォーマンスを確認するには、Vungle が提供するパブリッシャー用レポート API を使用してください。

  • このチュートリアルを開始する前に、AdMob を設定する必要があります。最初に、「iOS 用 AdMob のスタート ガイド」を参照してください。

  • Vungle AdMob iOS アダプターでは、動画広告の形式として、報酬型広告とインタースティシャル広告の両方がサポートされます。

  • AdMob とアプリケーションの統合については、AdMob 統合ドキュメンテーションを参照してください。

手順 1. Vungle を広告ネットワークとしてセットアップする

  1. AdMob ダッシュボードにログインして [Monetize] タブに移動します。

  2. Vungle を広告ネットワークとして追加するアプリケーションを選択します。

  3. 広告の形式を選択し、広告ユニットをアプリケーションに追加します。

    • インタースティシャル広告形式の場合は、すべての Vungle 広告が動画広告になるため、[Video] オプションを選択します。

      image2.png

    • 報酬型動画広告形式の場合は、[Set a reward] オプションを選択し、[Reward amount] フィールドと [Reward item] フィールドに値を入力します。Vungle では、[Use third-party ad network settings] 機能はサポートされていません

      image5.png

  4. 広告ユニットを選択し、[Mediation] 列で [ad sources] をクリックします。

    image6.png

  5. [+ New Ad Network] をクリックします。

    image1.png

  6. 左側のパネルで [Vungle] を選択し、一致する広告配置 ID を Vungle ダッシュボードで選択します。

    image1.png

手順 2. Vungle アダプタと SDK を統合する

  1. Vungle AdMob アダプターVungle SDK をダウンロードして Frameworks フォルダーに保管します。これにより、ダウンロードした Vungle AdMob アダプターと Vungle SDK がプロジェクトに追加されます。

    image4.png

    VungleSDK.frameworklibVungleAdapter.a が、プロジェクトの [Build Phases] → [Link Binary With Libraries] セクションに表示されていることを確認します。

  2. Vungle スタート ガイド - iOS SDK」の「その他の必要なフレームワークを追加する」セクションに記載されている手順に従い、必要なフレームワークを追加します。

  3. Vungle のスタート ガイド - iOS SDK」の「「-ObjC」リンカー フラグを追加する」セクションに記載されている手順に従い、リンカー フラグを追加します。

  4. Vungle スタート ガイド - iOS SDK」の「iOS ステータス バーを削除する」セクションに記載されている手順に従い、ステータス バーを削除します。

手順 3. 広告配置参照 ID をアダプタに渡す

Vungle SDK vesion 5 では、VungleAdNetworkExtras.h をインポートしてVungleAdNetworkExtras オブジェクトを作成し、すべての配置参照 ID を Vungle アダプターに提供する必要があります。配置参照 ID を AdMob ダッシュボードに追加した場合、配置参照 ID をVungleAdNetworkExtras クラスに指定する必要はありません。

注意: デフォルトの広告配置はアプリケーションごとに自動的に作成されます。広告配置機能を利用するかどうかにかかわらず、広告配置の参照 ID をこの初期化手順で指定する必要があります。複数の広告配置を作成する場合は、すべての参照 ID を指定してください。

インタースティシャルの場合:

 self.interstitial = [[GADInterstitial alloc] initWithAdUnitID:@"AD_UNIT_ID"];
self.interstitial.delegate = self;
GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.allPlacements = @[@"PLACEMENT_ID_1", @"PLACEMENT_ID_2", @"PLACEMENT_ID_3"];
extras.playingPlacement = @"PLACEMENT_ID_1"; // Optional if you provide through AdMob dashboard
[request registerAdNetworkExtras:extras];
[self.interstitial loadRequest:request];

報酬型動画の場合:

 GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.allPlacements = @[@"PLACEMENT_ID_1", @"PLACEMENT_ID_2", @"PLACEMENT_ID_3"];
extras.playingPlacement = @"PLACEMENT_ID_1"; // Optional if you provide through AdMob dashboard
[request registerAdNetworkExtras:extras];
[[GADRewardBasedVideoAd sharedInstance] loadRequest:request
withAdUnitID:@"AD_UNIT_ID"];

自動キャッシュ広告に関する注意: Vungle SDK では、Vungle ダッシュボードで自動キャッシュ用として選択した配置広告が自動的にキャッシュされます。最初に表示される広告ユニットか、最も頻繁に表示される AdMob 広告ユニットを、自動キャッシュ対象の配置広告として選択することを強くお勧めします。

報酬対象の広告を複数使用できないことに関する注意: このGoogle-Mobile-Ads-SDK 7.24.0から、AdMob はあらかじめキャッシュされた報酬対象のビデオ広告配置を 1 回に 1 点だけサポートするようになりました。

追加的なパラメータを渡す (オプション)

追加的なプロパティを使用して広告をカスタマイズできます。

プロパティ

説明

userId

Vundle SDK に渡される一意のユーザー ID を設定し、報酬型広告のサーバー間コールバックで使用できるようにします。

muted

広告開始時のサウンドの状態を設定します。YES に設定されている場合、動画はミュートされた状態で始まりますが、ユーザーはサウンドの状態を変更できます。

ordinal

Vungle から序数データ レポートを受け取った場合は、このオプションを使用して媒介序数を渡します。このオプションは、ゲーム セッション内でこの広告が表示された順序を示す整数です。たとえば、現在のセッション内で 2 つの広告がすでに表示されていて、Vungle の広告が 3 番目に表示された場合は、「3」を渡します。序数データの詳細については、こちらを参照してください。

flexViewAutoDismissSeconds

指定した秒数が経過したら自動的に終了するように Flex View 広告を設定します。

GADRequest *request = [GADRequest request]; VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init]; extras.allPlacements = @[PLACEMENT_ID1, REWARDED_ID2, PLACEMENT_ID3]; extras.playingPlacement = REWARDED_ID2; extras.userId = @"vungle_test_david"; extras.ordinal = 7; extras.flexViewAutoDismissSeconds = 30; [request registerAdNetworkExtras:extras]; [[GADRewardBasedVideoAd sharedInstance] loadRequest:request withAdUnitID:REWARDED2_AD_UNIT];
他にご質問がございましたら、リクエストを送信してください

コメント