当社の広告配信サーバーからバナー広告を取得・表示し、インプレッション / クリックを自動計測する iOS SDK です。Swift Package Manager でバイナリ(XCFramework)として配布されます。ソースコードは含まれません。
Xcode で File > Add Package Dependencies... を開き、次の URL を入力します。
https://github.com/AGIFT-co/adserver-iOS-SDK-dist.git
⚠️ Dependency Rule は必ず「Exact Version」を選び、当社が案内するバージョン(本リリースは1.0.0)を指定してください。 当社は版ごとに動作確認したバージョンを案内するため、意図しない版への自動更新を避けます。特にプレリリース版(-rc.N)は semver 仕様により、既定の「Up to Next Major Version」では解決されず「該当バージョンなし」になります。
Package.swift で追加する場合:
dependencies: [
.package(url: "https://github.com/AGIFT-co/adserver-iOS-SDK-dist.git", exact: "1.0.0")
]import AdServerSDK
AdServer.configure()import AdServerSDK
let banner = AdServerBannerView(adUnitId: "<当社から共有する AdUnit の UUID>", size: .banner)
banner.delegate = self // 任意(取得成功 / 失敗・VIEW / CLICK の通知)
banner.fallbackView = myView // 任意(no-fill 時に枠内へ表示)
view.addSubview(banner) // この時点でサイズ分の枠を確保(レイアウトのガタつき防止)
banner.load()対応サイズ: .banner(320×50) / .largeBanner(320×100) / .mediumRectangle(300×250)
ℹ️ no-fill・エラー時は枠を畳みません。なお、障害・ポリシー対応のため当社サーバーからの指示で配信を一時停止することがあり、hard モードの停止時に限り枠が畳まれます(詳細は docs/vendor-guide.md §5「サーバー側の配信停止制御(遠隔制御)」を参照)。
adUnitId(AdUnit の UUID): 当社から個別に共有します。- 配信サーバー側にクリエイティブ(広告)が登録されていること: 対象 AdUnit に広告が無い場合、SDK は no-fill として扱い、枠は空のまま(または
fallbackView)になります。「真っ白で何も出ない」場合はまずこれを確認してください(導入ミスではなく在庫なしのことが多いです)。
| 項目 | バージョン |
|---|---|
| iOS | 16.0 以上 |
| Xcode | 動作確認済み: Xcode 16.4(配布バイナリの生成コンパイラ。15.x は生成コンパイラより古いため動作未確認です。15.x での利用をご希望の場合は当社までご相談ください) |
導入の詳細(PPID / 同意、AdMob メディエーション経路、App Privacy 申告など)は同梱ドキュメントを参照してください。
- docs/vendor-guide.md — 導入ガイド(必読)
- docs/privacy-disclosure.md — App Privacy(栄養ラベル)記入指針
Copyright © 2026 株式会社AGIFT. All rights reserved. 詳細は LICENSE を参照してください。