SDK 導入ガイド
iOS 11.0 以降、 Xcode 14.0 以降
- CocoaPodsをお使いの場合、Podfileに以下を追加してください。
pod "AMoAd"
-
Link Binary With LibrariesにAMoAd.xcframeworkを追加してください。
※ Xcode16以上をお使いの場合、AMoAdSDK v6.2.1以上のバージョンをお使いください。
-
Link Binary With LibrariesにOMSDK_Cyberagentcojp3.xcframeworkを追加してください。 -
Frameworks, Libraries, and Embedded ContentからOMSDK_Cyberagentcojp3.xcframeworkのEmbedをEmbed ＆ Signに変更してください。
Apple公式ドキュメントを参考にIDFA取得の許諾ダイアログの文言をセットしてください。
-
Info.plistに要素（キー名:Privacy - Tracking Usage Description、タイプ:String）を追加 - Valueに任意の文字列をセットしてください
Apple公式ドキュメントを参考にAMoAdのAdNetworkIDを追加してください。
AdNetworkIDを追加しなかった場合、コンバージョン計測ができなくなりますのでご注意ください。
-
Info.plistに要素（キー名:SKAdNetworkItems、タイプ:Array）を追加 - 1の要素にAMoAdのAdNetworkID（
866k9ut3g3.skadnetwork）を追加してください
- SKAdNetwork計測を行う場合,AMoAdSDKバージョンをv6.1.12以上に設定してください。
SKAdNetworkIdentifierにAMoAdのネットワークIDである「866k9ut3g3.skadnetwork」を追加してください。
- コードで追加する場合
<key>SKAdNetworkItems</key>
<array>
<dict>
<key>SKAdNetworkIdentifier</key>
<string>866k9ut3g3.skadnetwork</string>
</dict>
</array>
- xcodeで追加する場合
- アプリ起動時または広告リクエスト前の任意のタイミングでSource App Idを設定する
- AMoAdSKAdSettingクラスのsetSourceAppIdから設定する。
※SourceAppIdを設定した場合でも、SKAdNetwork計測を行っていない枠の配信は可能です。
なのでアプリ内で一つでもSKAdNetwork計測を行う広告枠が存在する場合SourceAppIdの設定をお願いします。
import UIKit
import AMoAd
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, UISplitViewControllerDelegate {
~~~
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
AMoAdSKAdSetting.shared.setSourceAppId(sourceAppId: "Appstoreに公開されているAPP ID")
return true
}
~~~
}App Store Connect のアプリの審査時の App privacy questionへの回答する際にご参考にしてください。
- 連絡先情報
| 情報 | 定義 | 利用有無 | 使用目的 |
|---|---|---|---|
| 名前 | 姓や名など | × | |
| Eメールアドレス | ハッシュ化されたEメールアドレスを含むが、これに限定しない | × | |
| 電話番号 | ハッシュ化された電話番号を含むが、これに限定しない | × | |
| 物理的な住所 | 自宅住所、物理的な住所、郵送先住所など | × | |
| ユーザーのその他の連絡先情報 | App外でユーザーへの連絡手段として使用できるその他の情報 | × |
- ヘルスケアとフィットネス
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| ヘルスケア | ヘルスケアおよび医療関連のデータ - Clinical Health Records API、HealthKit API、MovementDisorderAPI、ヘルスケア関連の臨床調査、またはユーザーが提供したその他のヘルスケアまたは医療のデータを含むが、これらに限定しない | × | |
| フィットネス | フィットネスおよび運動データ - Motion APIおよびFitness APIを含むがこれらに限定しない | × |
- 財務情報
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 支払い情報 | 支払い方法、支払いカード番号、銀行口座番号など | × | |
| クレジット情報 | クレジットスコアなど | × | |
| その他の財務情報 | 給与、収入、資産、負債、その他の財務情報など | × |
- 位置情報
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 詳細な位置情報 | 小数点以下3桁以上の緯度経度と同等、またはそれよりも高い詳細レベルでの、ユーザーまたはデバイスの場所を示す情報 | × | |
| おおよその場所 | 小数点以下3桁以上の緯度経度よりも低い詳細レベルでのユーザーまたはデバイスの場所を示す情報（おおよその位置情報サービスなど） | ○ | サードパーティ広告 |
- 機密情報
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 機密情報 | 人種または民族情報、性的指向、妊娠または出産に関する情報、障がい、宗教または哲学的信念、労働組合への加入、政治的意見、遺伝情報、または生体情報など | × |
- 連絡先
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 連絡先 | ユーザーの電話、アドレス帳、ソーシャルグラフ内の連絡先リストなど | × |
- ユーザーコンテンツ
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| Eメールまたはテキストメッセージ | Eメールまたはメッセージの件名、送信者、受信者、および内容を含む | × | |
| 写真またはビデオ | ユーザーの写真またはビデオ | × | |
| オーディオデータ | ユーザーの声またはサウンドの録音 | × | |
| ゲームプレイコンテンツ | ゲーム内でユーザーが生成したコンテンツなど | × | |
| カスタマーサポート | カスタマーサポートの依頼中にユーザーが生成したデータ | × | |
| その他のユーザーコンテンツ | ユーザーが生成したその他のコンテンツ | × |
- 閲覧履歴
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 閲覧履歴 | ユーザーが閲覧したコンテンツに関する情報 | × |
- 検索履歴
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 検索履歴 | ユーザーが実行した検索に関する情報 | × |
- ID
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| ユーザーID | スクリーン名、ハンドル、アカウントID、割り当てられたユーザーID、顧客番号、特定のユーザーやアカウントの識別に利用できるユーザーレベルやアカウントレベルのその他のIDなど | × | |
| デバイスID | デバイスの広告ID、またはデバイスレベルのその他のIDなど | ○ | サードパーティ広告 |
- 購入
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 購入履歴 | アカウントや個人による購入、または購入傾向 | × |
- 使用状況データ
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| 製品の操作 | Appの起動、タップ、クリック、スクロール情報、音楽の視聴データ、ビデオの視聴数、ゲームやビデオや曲の保存場所、ユーザーのApp操作に関するその他の情報など | ○ | サードパーティ広告 |
| 広告データ | ユーザーが見た広告に関する情報など | ○ | サードパーティ広告 |
| その他の使用状況データ | Appのユーザーアクティビティに関するその他のデータ | × |
- 診断
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| クラッシュデータ | クラッシュログなど | × | |
| パフォーマンスデータ | 起動時間、ハング率、エネルギー使用量など | × | |
| その他の診断データ | Appに関連する技術的診断を測定する目的で収集されたその他のデータ | × |
- その他のデータ
| 情報 | 定義 | 利用有無 | 目的 |
|---|---|---|---|
| その他の種類のデータ | 言及されていないその他の種類のデータ | ○ | サードパーティ広告 |
- データの使用
| 目的 | 定義 | 利用有無 |
|---|---|---|
| サードパーティ広告 | Appにサードパーティ広告を表示したり、サードパーティ広告を表示する組織にデータを共有したりするなど | ○ |
| デベロッパの広告 | Appに自分の広告を表示したり、自分の広告を表示する組織にデータを共有したりするなど | × |
| アナリティクス | データを使用してユーザーの行動を評価すること。 | ○ |
| 製品のパーソナライズ | ユーザーに表示される内容をカスタマイズすること | ○ |
| Appの機能 | ユーザー認証、機能の有効化、不正行為の防止、セキュリティ対策の実施、サーバ稼働時間の確保、Appのクラッシュの最小化、拡張性とパフォーマンスの向上、カスタマーサポートの提供など | × |
| その他の目的 | 記載されていないその他の目的 | × |
本SDKはSwiftで作成されています。Objective-Cへのインポートに関してはサポート担当までご連絡ください。
