Skip to main content

概要

Adrop iOS SDKを使用して、さまざまな広告フォーマットをアプリに表示できます。

サポートされている広告フォーマット

要件

  • iOS 13.0以上
  • Xcode 14.1以上
  • Swift 5.0以上

事前準備

1. adrop_service.json ファイルの追加

1

ファイルのダウンロード

Adropコンソール > Admin > App から adrop_service.json ファイルをダウンロードします。
2

プロジェクトに追加

ダウンロードしたファイルをXcodeプロジェクトのルートに追加します。
3

ターゲットの確認

ファイル追加時にすべてのターゲットが選択されていることを確認します。
adrop_service.json ファイルがないと、SDKが正常に動作しません。

2. ユニットIDの確認

コンソールのAd Unitタブで広告枠に対応するユニットIDを確認します。

インストール

Swift Package Manager (推奨)

  1. Xcodeで File > Add Package Dependencies… を選択
  2. パッケージURLを入力:
  1. Add Package をクリック
バックフィル広告を使用するには、追加パッケージを登録してください:

CocoaPods

  1. Podfileがない場合は作成:
  1. Podfileに追加:
Podfile
  1. インストール:
  1. .xcworkspace ファイルでプロジェクトを開く

Info.plistの設定

バックフィル広告のためにInfo.plistに以下の設定を追加します:
  • GADApplicationIdentifier: バックフィル広告用のApp ID
  • SKAdNetworkItems: iOS 14以降で広告コンバージョントラッキングに必要
Info.plist
既存のInfo.plistに既にSKAdNetworkItemsキーがある場合は、新たに追加せず配列(<array>)の項目のみマージしてください。同じキーを2つ置くと、iOSは最初の配列のみを使用します。
SKAdNetworkItemsの全リストとApp IDの発行についてはAdropにお問い合わせください。

初期化

AppDelegateapplication(_:didFinishLaunchingWithOptions:)でSDKを初期化します。

初期化パラメータ

本番環境では必ずproduction: trueに設定してください。falseのまま配信すると広告が表示されません。

ユーザー設定

UIDの設定

ターゲティング広告のためにユーザー識別子を設定します。
ターゲティング広告が正常に動作するには、広告枠に入る前にUIDを設定してください。

テーマの設定

ダークモードをサポートする広告のためにテーマを設定します。initialize()呼び出し後に設定する必要があります。
autoモードはシステムのダークモード設定を自動的に検出します。テーマが変更されると、スプラッシュ広告のキャッシュが自動的に初期化されます。

WebViewサポート

WKWebViewを登録して、WebView内でウェブ広告を表示できます。
Adrop.sdkVersionを使用して現在のSDKバージョンを確認できます。

ディープリンクの処理

外部リンクを通じてアプリが起動された場合、ディープリンクを処理します。

テストユニットID

開発中はテストユニットIDを使用してください。本番環境への配信前に実際のユニットIDに置き換える必要があります。

バナー広告

ネイティブ広告

インタースティシャル/リワード広告

ポップアップ広告

スプラッシュ広告


エラーコード

広告読み込み失敗時に返される主なエラーコードです。 詳細なエラーコードはリファレンスを参照してください。

目次

バナー広告

バナー広告の実装

ネイティブ広告

ネイティブ広告の実装

インタースティシャル広告

インタースティシャル広告の実装

リワード広告

リワード広告の実装

ポップアップ広告

ポップアップ広告の実装

スプラッシュ広告

スプラッシュ広告の実装

WebViewガイド

WebViewでウェブ広告を表示

UMP連携

GDPR/CCPA同意管理

ターゲティング設定

ユーザー属性とコンテキストターゲティング

リファレンス

クラス、デリゲート、エラーコード

サンプル

サンプルリポジトリ