Skip to content
This repository has been archived by the owner on Apr 5, 2024. It is now read-only.

フルボード広告

fan-c-yu edited this page Mar 5, 2021 · 5 revisions

事前準備

まだ広告枠作成、SDKダウンロードを行っていない場合、下記リンク先を参照してください。

フルボード広告枠作成手順

nend管理画面「新規広告枠の作成」から下記項目を選択し、広告枠を作成します。

  • 広告枠のタイプ:「ネイティブアド」
  • 広告枠名:任意
  • 実装タイプ:「SDK」
  • 広告画像選択:「横長(5:3)の大きい広告画像」
  • 広告表示数:「1ヶ所のみ」

SDKの組み込み

プロジェクトにUnityパッケージをインポートしていない場合は、下記手順でインポートを行ってください。


実装手順

  1. NendAdFullBoardNewFullBoardAdメソッドでNendAdFullBoard のインスタンスを取得します。
  2. ハンドリングしたいイベントのコールバックを任意で登録します。
    イベントは以下の通りです。
    public event NendAdFullBoardLoaded AdLoaded;
    public event NendAdFullBoardFailedToLoad AdFailedToLoad;
    public event NendAdFullBoardShown AdShown;
    public event NendAdFullBoardClick AdClicked;
    public event NendAdFullBoardDismiss AdDismissed;
  3. NendAdFullBoard Loadメソッドで広告のロードを行います。
    ロード失敗時のエラーコードは以下の通りです。
    public enum FullBoardAdErrorType : int {
        FailedAdRequest, // 広告リクエストに失敗しました
        InvalidAdSpaces, // フルボード広告で利用できない広告枠が指定されました
        FailedDownloadImage // 広告画像のダウンロードに失敗しました
    }
  4. NendAdFullBoard Showメソッドで広告の表示を行います。
    注意: フルボード広告を閉じた際、自動で広告のリロードは行われません。広告内容を更新する場合は再度ロード処理を実行する必要があります。

実装サンプル

using UnityEngine;
using NendUnityPlugin.AD.FullBoard;

public class FullBoardObject : MonoBehaviour
{
	private NendAdFullBoard m_fullBoardAd;

	// Use this for initialization
	void Start ()
	{
		m_fullBoardAd = NendAdFullBoard.NewFullBoardAd (spotId, "apiKey");

		m_fullBoardAd.AdLoaded += (NendAdFullBoard instance) => {
			// 広告ロード成功のコールバック
		};
		m_fullBoardAd.AdFailedToLoad += (NendAdFullBoard instance, NendAdFullBoard.FullBoardAdErrorType type) => {
			// 広告ロード失敗のコールバック
		};
		m_fullBoardAd.AdShown += (NendAdFullBoard instance) => {
			// 広告表示のコールバック
		};
		m_fullBoardAd.AdClicked += (NendAdFullBoard instance) => {
			// 広告クリックのコールバック
		};
		m_fullBoardAd.AdDismissed += (NendAdFullBoard instance) => {
			// 広告クローズのコールバック
		};
	}

	public void Load ()
	{
		m_fullBoardAd.Load ();
	}

	public void Show ()
	{
		m_fullBoardAd.Show ();
	}
}

Safe Area の外側の背景色について

iPhoneXのSafe Area外の背景色を、アプリのデザインに合わせ変更することが可能です。

m_fullBoardAd.AdLoaded += (NendAdFullBoard instance) => {
    // 広告ロード成功のコールバック
    instance.IOSBackgroundColor = Color.white;
};

詳細についてはiOS向けのWiki「Safe Area の外側の背景色について」をご参照ください。

Clone this wiki locally