DisplayAdCodingGuide

ディスプレイ広告 実装ガイド for Unity Plugin

1. 広告を表示するスクリプト

1.1. スクリプトの流れ

1. 管理画面から発行されるsid、広告サイズ、表示位置などを指定してRegister()メソッドでプラグインを登録します。
   AMoAdUnityPlugin.Register (sid, …​);

2. Awake()、Start()など広告の表示を開始したいタイミングで、Show()メソッドを呼び出します。
   AMoAdUnityPlugin.Show (sid);

3. 広告を消したいタイミングで、Hide()メソッドを呼び出します。
   AMoAdUnityPlugin.Hide (sid);

4. メモリ使用量が気になるときはHide()の代わりに、Dispose()メソッドを呼び出してください（Show()で再表示できます）。
   AMoAdUnityPlugin.Dispose (sid);

Tip	広告の切り替え（ローテーション）は、管理画面で指定された秒数で行なわれます。プラグインで指定することはできません。

1.2. スクリプト例

AMoAdUnityPluginSample.cs

public class AMoAdUnityPluginSample : MonoBehaviour {

  private static string SID = "管理画面から発行されるsidを設定してください";

  static AMoAdUnityPluginSample () {
    AMoAdUnityPlugin.Register (
      sid:SID,
      bannerSize:AMoAdUnityPlugin.BannerSize.B320x50,
      hAlign:AMoAdUnityPlugin.HorizontalAlign.Center,
      vAlign:AMoAdUnityPlugin.VerticalAlign.Bottom,
      adjustMode:AMoAdUnityPlugin.AdjustMode.Responsive,
      rotateTrans:AMoAdUnityPlugin.RotateTransition.FlipFromLeft,
      clickTrans:AMoAdUnityPlugin.ClickTransition.Jump,
      imageName:"b640_100.gif"
      );
  }

  void Awake () {
    AMoAdUnityPlugin.Show (SID);
  }
}

1.3. パラメタの説明

1.3.1. AMoAdUnityPlugin.Register()

管理画面から発行されるsidに紐づく広告情報を登録します。

パラメタ名	Type	Value
sid	string	管理画面から発行されるsidを設定してください
bannerSize	AMoAdUnityPlugin .BannerSize	広告サイズ
		B320x50	320×50
		B320x100	320×100
		B300x250	300×250
		B728x90	728×90 (iPad用)
hAlign	AMoAdUnityPlugin .HorizontalAlign	水平方向の表示位置
		None	なし（x座標指定）
		Left	左寄せ
		Center	中央寄せ
		Right	右寄せ
vAlign	AMoAdUnityPlugin .VerticalAlign	垂直方向の表示位置
		None	なし（y座標指定）
		Left	上寄せ
		Middle	中央寄せ
		Right	下寄せ
adjustMode	AMoAdUnityPlugin .AdjustMode	広告サイズの調整
		Fixed	固定
		Responsive	レスポンシブ（デフォルト）
rotateTrans	AMoAdUnityPlugin .RotateTransition	広告ローテーション時のトランジションを設定する（iOS用）
		None	トランジション「なし」（デフォルト）
		CurlUp	トランジション「巻き上げ」
		CurlDown	トランジション「巻き下げ」
		FlipFromLeft	トランジション「左フリップ」
		FlipFromRight	トランジション「右フリップ」
clickTrans	AMoAdUnityPlugin .ClickTransition	広告クリック時のトランジションを設定する（iOS用）
		None	トランジション「なし」（デフォルト）
		Jump	トランジション「ジャンプ」
imageName	string	初期表示画像ファイル名（Androidアプリを作成する場合は、アルファベットの小文字で始まる名前）
x	int	x座標（hAlignがNoneのときのみ有効）
y	int	y座標（vAlignがNoneのときのみ有効）
androidRotateTrans	AMoAdUnityPlugin .AndroidRotateTransition	広告ローテーション時のトランジションを設定する（Android用）
		None	トランジション「なし」（デフォルト）
		Alpha	トランジション「透過」
		Rotate	トランジション「回転」
		Scale	トランジション「拡大」
		Translate	トランジション「スライド・アップ」
androidClickTrans	AMoAdUnityPlugin .AndroidClickTransition	広告クリック時のトランジションを設定する（Android用）
		None	トランジション「なし」（デフォルト）
		Jump	トランジション「ジャンプ」

Tip	広告サイズの調整にレスポンシブを選択すると、端末のサイズに合わせて広告が拡大縮小します。

Tip	Androidアプリをビルドする場合は、対応しているアニメーションが異なりますので、androidRotateTrans、androidClickTransをご使用ください。

1.3.2. AMoAdUnityPlugin.Show()

sidを指定して広告の表示を行います。

パラメタ名	Type	Value
sid	string	管理画面から発行されるsidを設定してください

1.3.3. AMoAdUnityPlugin.Hide()

sidを指定して広告を消します。

パラメタ名	Type	Value
sid	string	管理画面から発行されるsidを設定してください

1.3.4. AMoAdUnityPlugin.Dispose()

メモリ容量が気になる場合、広告を消してViewのリソースを解放します。AMoAdUnityPlugin.Show()メソッドで再表示できます。

パラメタ名	Type	Value
sid	string	管理画面から発行されるsidを設定してください

Tip	AMoAdUnityPlugin.Show()メソッド呼び出し時、Viewがなければ作成します。同じsidの広告を同じ画面に複数、置くことはできません。

2. サンプルアプリケーションの使用方法

2.1. AMoAdUnityPluginSample

サンプルコード

AMoAdUnityPluginSample.cs

public class AMoAdUnityPluginSample : MonoBehaviour {

  private static string SID = "管理画面から発行されるsidを設定してください";

  static AMoAdUnityPluginSample () {
    AMoAdUnityPlugin.Register (
      sid:SID,
      bannerSize:AMoAdUnityPlugin.BannerSize.B320x50,
      hAlign:AMoAdUnityPlugin.HorizontalAlign.Center,
      vAlign:AMoAdUnityPlugin.VerticalAlign.Bottom,
      adjustMode:AMoAdUnityPlugin.AdjustMode.Responsive,
      rotateTrans:AMoAdUnityPlugin.RotateTransition.FlipFromLeft,
      clickTrans:AMoAdUnityPlugin.ClickTransition.Jump,
      imageName:"b640_100.gif"
      );
  }

  void Awake () {
    AMoAdUnityPlugin.Show (SID);
  }
}

1. AMoAdUnityPluginSample.csのSIDに管理画面から発行されるsidを入力してください

2. Register()のパラメタ、bannerSizeに管理画面に指定した広告サイズを記入してください

3. その他、表示設定を変えたいときはRegister()メソッドのパラメタを変更してください

4. 導入ガイドの手順に従いプラグイン、SDKの導入、ビルドを行ってください

表示設定の詳細は上記、パラメタの説明をご参照ください。