Skip to content

FacebookAudienceNetwork_Banner_Interstitial_Ad_iOS

AdGeneration edited this page Jan 24, 2017 · 25 revisions

Facebook Audience Network バナー広告/インタースティシャル広告 SDK連携 iOS

はじめに

Facebook Audience NetworkのSDKと連携し、Facebook Audience Networkで配信されている広告を表示することができます。 開発環境にXcodeを使用することを前提とします。

対応バージョン

iOS 7.0以降

導入の流れ

  1. SDKをダウンロードします
  2. プロジェクトにSDKを追加します
  3. Ad Generation SDK及びFacebook Audience Network SDKが参照しているframeworkを追加します
  4. SDK連携時の共通作業を行います
  5. Ad Generationのバナー広告/インタースティシャル広告の実装を行います

1. SDKをダウンロードする

こちらからダウンロードしてください。
Ad Generation SDK ダウンロード
Facebook Audience Network SDK ダウンロード

2. プロジェクトにSDKを追加する

ADG.framework 及び、 FBAudienceNetwork.framework をプロジェクトに追加してください。
追加方法は、Getting Started / バナー広告 をご参照ください。

※ 対象外バージョンで動作するアプリの場合は、Optionalの指定してください。

3. Ad Generation SDK及びFacebook Audience Network SDKが参照しているframeworkを追加する

Ad Generation

Getting Started / バナー広告 をご参照ください。

Facebook Audience Network

以下のframeworkをプロジェクトに追加してください。

  • AdSupport.framework( * )
  • StoreKit.framework
  • CoreMotion.framework
  • CoreMedia.framework
  • AVFoundation.framework
  • AudioToolbox.framework
  • libxml2.tbd
  • libc++.tbd

( * ) Ad Generationでも参照しています。AdSupportはOptionalで指定してください。

4. SDK連携時の共通作業を行う

こちらをご参照ください。
アドネットワークのSDKと連携する際の注意事項及び共通手順

5. Ad Generationのバナー広告/インタースティシャル広告の実装を行う

Getting Started / バナー広告
インタースティシャル広告
をご参照ください。

制限事項

以下のプロパティ及びメソッドは利用できません。

ADGManagerViewController
  • adScale
  • preventAccidentClick
ADGManagerViewControllerDelegate
  • ADGManagerViewControllerOpenUrl:
  • ADGManagerViewControllerReceiveFiller:

広告サイズについて

バナー

縦は50ptか90ptを指定してください。
横は自由です(320以外を指定した場合はFacebook Audience Network側で自動調整が行われます)。

※ フリーサイズ指定方法

NSDictionary *adgparam = @{
  @"locationid" : @"xxxxx",
  @"adtype" : @(kADG_AdType_Free),
  @"w" : @(320),
  @"h" :@(50)
};

レクタングルサイズ(300×250)はネイティブ広告で実装してください。
Facebook Audience Network ネイティブ広告 SDK連携

配信条件について

Facebook Audience Networkの広告が配信されるためには以下の様な条件が揃っている必要があります。

  1. Facebookアプリが端末にインストールしてあり、ログインしている
  2. 端末で広告ターゲティングがオプトアウトされていない

オプトアウト設定
「設定」>「プライバシー」>「広告」で「追跡型広告を制限」をオフ

テストについて

テスト用ID

テスト広告の表示に使用するAd Generationの広告枠IDです。
このIDをセットしたままアプリをリリースしないようご注意ください。

ID 説明 配信広告
32781 横320 x 縦50 または 横320 x 縦90 Facebook Audience Network
26809 横320 x 縦50 Facebook Audience Network / Zucks
26159 インタースティシャル Facebook Audience Network
26813 インタースティシャル Facebook Audience Network / Zucks

テスト広告の表示

下記の手順により実機でテスト広告を表示することが可能です。

  1. 以下のコードを追加する。
[FBAdSettings setLogLevel:FBAdLogLevelNotification];
  1. Facebook Audience Networkが配信設定された枠IDをセットして広告のリクエストを行う。
  2. ログにテスト広告表示のための指示が出力される。(XXXXXXXXXXXXXXXXXXXに入る文字列は環境によってユニークです)
2015-11-30 00:00:00.000 SampleApp[99999:9999999]
 [FBAudienceNetworkLog/FBAdSettings:95]
 When testing your app with Facebook's ad units
 you must specify the device hashed ID to ensure the delivery of test ads,
 add the following code before loading an ad:
 [FBAdSettings addTestDevice:@"XXXXXXXXXXXXXXXXXXX"]
  1. 指示の[FBAdSettings addTestDevice:@"XXXXXXXXXXXXXXXXXXX"]の箇所をコード上にペーストする。(アプリのリリース時はペーストしたコードを削除してください)

シミュレータの場合は必ずテスト広告が表示されます。

注意事項

表示速度について

広告クリエイティブによっては読み込みまで時間がかかるケースもございます。
その回避の為、ロードタイミングをできるだけ早めることを推奨いたします。

タップ後の挙動について

Facebook Audience Networkの広告タップ時の動作をカスタマイズすることはできません。以下のいずれの場合もFacebook Audience Networkの仕様に従います。

  • アプリ内ブラウザでのWebページ表示
  • モーダルでのストア表示
  • プレイヤーでの動画再生

動作確認について

以下のような点を踏まえて動作確認を行ってください

  • Facebookアプリにログインした端末でFacebook Audience Networkの広告が表示されること
  • Facebookアプリにログインしていない端末でFacebook Audience Network以外の広告がスムーズに表示されること
  • 広告のタップによる遷移が正常に行われること

Home

導入マニュアルのドキュメントはコチラに移行しました。

お手数ですがリンクから遷移してください。 https://docs.sdk.ad-generation.jp/

Clone this wiki locally