HyprMX インテグレーション
アカウントを作成し、プレースメントを設定し、HyprMX アダプタをビルドに追加して、Unity LevelPlay に HyprMX を広告ネットワークとして追加します。
読み終わるまでの所要時間 9 分最終更新 7日前
このガイドでは、Unity LevelPlay Mediation で HyprMX を広告ネットワークとして稼働させる方法についてステップごとに説明します。
前提条件
-
リワード広告、インタースティシャル広告、またはバナー広告をアプリケーションに正しく統合していることを確認します。インテグレーション手順については、以下のプラットフォーム固有のガイドを参照してください。
-
アダプタのバージョンが低いものから 4.1.2 以降にアップグレードする場合は、プラットフォーム内でそれらの HyprMX パラメータを新しいものに再設定してください。 HyprMX の新しいパラメータを取得するには、インテグレーション@hyprmx.com に連絡する必要があります。
-
HyprMX SDK iOS 12.0 以上でコンパイルし、iOS 15.0 以上で広告を表示する
ステップ 1. HyprMX アカウントの作成
HyprMX はマネージサービスを提供します。アカウントを作成するには、インテグレーション@hyprmx.com に直接接触してください。アカウントの作成後、アプリケーションの設定や LevelPlay アカウントで HyprMx をアクティベートするために必要なパラメータの取得のヘルプが表示されます。
ステップ 2. LevelPlay ネットワークワーク設定モジュールで HyprMX をアクティベートする
HyprMX アカウントから 3 つのデータを LevelPlay ネットワーク設定モジュールに挿入して、HyprMX を Ironsource と正しく接続する必要があります。
APIキー | これは、HyprMX システムでのアカウントの一意の識別子です。 |
|---|---|
| ディストリビューター****ID | これは、HyprMX が広告を配信する一意のアプリケーション識別子です。 |
| 配置****名 | これは、HyprMX を使用した配置の一意の識別子です。 |
この情報を取得したら、LevelPlay アカウントで HyprMX のパラメータ上記の情報を正しく追加することで、HyprMX の広告インベントリと Unity LevelPlay Mediation のレポートデータを最大限に活用できるようになります。
LevelPlay アカウントへの HyprMX のパラメータの設定
- 上記のパラメータを取得したら、Ironsource アカウントにログインし、「Monetize」> 「SDK Networks」に移動します。

- 使用可能な広告ネットワークのリストから HyprMX を選択し、HyprMX API キーを入力します。


- 次に、HyprMX で Unity LevelPlay Mediation を実行するアプリケーションを選択し、設定を選択します。次に、関連するフィールドにディストリビューター ID と配置名を入力します。


- 設定ダッシュボードで HyprMX がメディエーションに対してアクティブと表示されます。

ステップ 3. HyprMX Adapter をビルドに追加する
LevelPlay SDK は**、Cocoapod** と手動ダウンロードの両方のメカニズムをサポートします。
HyprMX アダプターと Cocoapods の統合
HyprMX SDK を Cocoapods と統合するには、podfile に以下の行を入力します。
pod 'IronSourceHyprMXAdapter','5.2.0'
HyprMX Adapter の手動ダウンロード
- **HyprMX Adapter & SDKのダウンロード:**HyprMX Adapter および HyprMX SDK (XCFrameworks) ファイルをビルドに追加します。iOS のメディエーションネットワーク を参照してください。
- プロジェクトに HyprMX フレームワークを追加します。 - ISHyprMXAdapter.framework (SDK の zip で使用可能) を Xcode プロジェクトにドラッグアンドドロップし、ファイルがコピーされていることを確認し、ターゲットメンバーシップを確認します。 - プロジェクトファイルとターゲットを選択します。General タブで、HyprMX.XCFrameworks をファイルエクスプローラーから "Frameworks, Libraries, and 埋め込まれた コンテンツ" セクションにドラッグします。 - Embed 設定を "Embed & Sign" に設定します。
XCode プロジェクト設定
-
Configure Application Transport Security (ATS) Settings HyprMX では、ATS 設定をオフにすることをお勧めします。これを行うには、以下のように アプリケーション Transport Security キーplist に加えます。<key>NSAppTransportSecurity</key><dict> <key>NSAllowsArbitraryLoads</key> <true/></dict>ATS を有効にする場合は、以下のキーを plists に追加します。<dict> <key>NSAllowsArbitraryLoads</key> <true/> <key>NSAllowsArbitraryLoadsForMedia</key> <true/> <key>NSAllowsArbitraryLoadsInWebContent</key> <true/></dict>アプリケーションを送信するときは、これらの ATS 設定の理由を指定する必要があります。HyprMX では、広告パートナーが、HTTPS をまだサポートしていないソースなど、さまざまなソースからウェブコンテンツをロードする必要があることに注意してください。Apple のドキュメントでは、これが許容できる理由であることをすでに認めています。
-
plist declaration iOS では、ユーザーのカメラ、カレンダー、写真ライブラリなど、特定の機能の使用が広告主によって plist で宣言されている必要があります。以下のすべてのエントリーをアプリケーションの plist に追加します。<key>NSCameraUsageDescription</key> <string>${PRODUCT_NAME} はカメラへの書き込みアクセスをリクエストします</string><key>NSPhotoLibraryAddUsageDescription</key> <string>${PRODUCT_NAME}はフォトライブラリへの書き込みアクセスをリクエストします</string> <key>NSUserTrackingUsageDescription</key> <string>${PRODUCT_NAME}はパーソナライズされた広告を表示しています</string>
ステップ 4. HyprMX の追加設定
年齢制限ユーザー
Unity LevelPlay メディエーションを使用すると、パブリッシャーは HyprMX ageRestrictedUser 設定を HyprMX ネットワークに直接通知できます。この特徴は、LevelPlay SDK 7.3.1 以降、HyprMX iOS Adapter 4.3.3 以降を使用して有効化されます。フラグの設定は、LevelPlay SDK を初期化する前に行う必要があります。
以下の構文を使用して、HyprMX フラグに ageRestrictedUser パラメーター true を設定します。
[LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"YES"];
以下の構文を使用して、HyprMX フラグに ageRestrictedUser パラメーター false を設定します。
[LevelPlay setMetaDataWithKey:@"HyprMX_ageRestricted" value:@"NO"];
広告ネットワーク インテグレーションの評価
-
インテグレーションヘルパーを使用して広告ネットワークのインテグレーションを確認します。LevelPlay SDK は、SDK と追加のネットワークアダプタを正常に統合するためのツールを提供します。
-
このブーリアンを使用して統合メディエーション広告ネットワークのデバッグを管理する[LevelPlay setAdaptersDebug:YES];YES に設定すると、このコード行でデバッグが有効になり、すべてのメディエーション広告ネットワークに関する問題のトラブルシューティングにヘルプます。アプリケーションを広告ユニットで稼働させる前に、このコードを削除してください。SDK バージョン 6.5.2 以降でサポートされます。
これで、アプリケーション内で HyprMX を提供できるようになりました。
次のステップ
Unity LevelPlay Mediation を通じて追加の広告ネットワークを活用するには、アダプタを統合し、インテグレーションガイドに従ってください。