ターゲティング設定

// ❌ 誤った使用方法（配列/ディクショナリ）
AdropMetrics.setProperty(key: "interests", value: ["tech", "gaming"])  // サポートされていません
AdropMetrics.setProperty(key: "profile", value: ["age": 25])          // サポートされていません

// ✅ 正しい使用方法
AdropMetrics.setProperty(key: "interest_tech", value: true)
AdropMetrics.setProperty(key: "interest_gaming", value: true)
AdropMetrics.setProperty(key: "age", value: 25)

// 現在の同意状態を確認
let hasConsent = AdropMetrics.userDataConsent

// 同意状態を設定
AdropMetrics.setUserDataConsent(true)

import UIKit
import AdropAds

class ArticleViewController: UIViewController {
    private var banner: AdropBanner?
    var articleCategory: String?  // 記事カテゴリ

    override func viewDidLoad() {
        super.viewDidLoad()

        // contextIdはイニシャライザで設定（読み取り専用プロパティ）
        let contextId = articleCategory ?? ""
        banner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: contextId)

        banner?.delegate = self
        view.addSubview(banner!)
        banner?.load()
    }
}

// 使用例
let sportArticle = ArticleViewController()
sportArticle.articleCategory = "sport"

let techArticle = ArticleViewController()
techArticle.articleCategory = "tech"

import SwiftUI
import AdropAds

struct ArticleView: View {
    let category: String

    var body: some View {
        VStack {
            Text("記事の内容")

            // カテゴリに応じて動的にコンテキストを設定
            AdropBannerRepresented(
                unitId: "YOUR_UNIT_ID",
                contextId: category
            )
            .frame(width: 320, height: 100)
        }
    }
}

// 使用例
struct ContentView: View {
    var body: some View {
        TabView {
            ArticleView(category: "sport")
                .tabItem { Label("スポーツ", systemImage: "sportscourt") }

            ArticleView(category: "tech")
                .tabItem { Label("テクノロジー", systemImage: "cpu") }

            ArticleView(category: "business")
                .tabItem { Label("ビジネス", systemImage: "chart.line.uptrend.xyaxis") }
        }
    }
}

import UIKit
import AdropAds

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        // SDKの初期化
        Adrop.initialize(production: false)

        // ユーザーログイン後にUIDを設定
        Adrop.setUID("user_12345")

        // 基本ユーザープロパティの設定
        AdropMetrics.setProperty(key: AdropKey.GENDER, value: AdropValue.AdropGender.MALE)
        AdropMetrics.setProperty(key: AdropKey.AGE, value: 28)
        AdropMetrics.setProperty(key: AdropKey.BIRTH, value: "19960315")

        // カスタムプロパティの設定
        AdropMetrics.setProperty(key: "membership", value: "premium")
        AdropMetrics.setProperty(key: "interest_tech", value: true)
        AdropMetrics.setProperty(key: "interest_sports", value: true)
        AdropMetrics.setProperty(key: "purchase_count", value: 15)

        // アプリ起動イベントの送信
        AdropMetrics.sendEvent(name: "app_open")

        return true
    }
}

class ProductViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()

        // 商品閲覧イベント
        AdropMetrics.sendEvent(
            name: "view_item",
            params: [
                "item_id": "PROD_123",
                "category": "electronics",
                "price": 299.99
            ]
        )
    }

    @IBAction func addToCartTapped(_ sender: UIButton) {
        // カートに追加イベント
        AdropMetrics.sendEvent(
            name: "add_to_cart",
            params: [
                "item_id": "PROD_123",
                "quantity": 1,
                "price": 299.99
            ]
        )
    }

    func completePurchase() {
        // 購入完了イベント
        AdropMetrics.sendEvent(
            name: "purchase",
            params: [
                "transaction_id": "T67890",
                "value": 299.99,
                "currency": "USD"
            ]
        )

        // 購入回数の更新
        let newPurchaseCount = 16
        AdropMetrics.setProperty(key: "purchase_count", value: newPurchaseCount)
    }
}

import UIKit
import AdropAds

// ニュースアプリの例: 記事カテゴリに応じて異なる広告を表示
class NewsArticleViewController: UIViewController {
    private var banner: AdropBanner?

    // 記事情報
    var article: Article?

    struct Article {
        let id: String
        let title: String
        let category: String  // "sport", "tech", "business", "entertainment"
    }

    override func viewDidLoad() {
        super.viewDidLoad()

        setupBanner()
        loadArticle()
    }

    private func setupBanner() {
        // contextIdは読み取り専用 — イニシャライザで設定
        let contextId = article?.category ?? ""
        banner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: contextId)

        banner?.delegate = self

        if let bannerView = banner {
            view.addSubview(bannerView)
            bannerView.translatesAutoresizingMaskIntoConstraints = false
            NSLayoutConstraint.activate([
                bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
                bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
                bannerView.widthAnchor.constraint(equalToConstant: 320),
                bannerView.heightAnchor.constraint(equalToConstant: 100)
            ])
        }

        banner?.load()
    }

    private func loadArticle() {
        // 記事閲覧イベントの送信
        if let article = article {
            AdropMetrics.sendEvent(
                name: "view_article",
                params: [
                    "article_id": article.id,
                    "category": article.category
                ]
            )
        }
    }
}

extension NewsArticleViewController: AdropBannerDelegate {
    func onAdReceived(_ banner: AdropBanner) {
        print("カテゴリ '\(article?.category ?? "")' ターゲット広告の読み込み成功")
    }

    func onAdFailedToReceive(_ banner: AdropBanner, _ errorCode: AdropErrorCode) {
        print("広告の読み込み失敗: \(errorCode)")
    }

    func onAdImpression(_ banner: AdropBanner) {
        print("広告インプレッション")
    }

    func onAdClicked(_ banner: AdropBanner) {
        print("広告クリック")
    }
}

// 使用例
let sportArticle = NewsArticleViewController()
sportArticle.article = NewsArticleViewController.Article(
    id: "A123",
    title: "プレミアリーグ試合結果",
    category: "sport"
)

let techArticle = NewsArticleViewController()
techArticle.article = NewsArticleViewController.Article(
    id: "A124",
    title: "新しいAI技術が発表",
    category: "tech"
)

// ログイン成功時
func didLoginSuccessfully(userId: String) {
    Adrop.setUID(userId)

    // ユーザープロパティも一緒に設定
    AdropMetrics.setProperty(key: "is_logged_in", value: true)
}

// ログアウト時
func didLogout() {
    Adrop.setUID("")  // UIDのリセット
    AdropMetrics.setProperty(key: "is_logged_in", value: false)
}

class UserManager {
    func updateUserProfile(profile: UserProfile) {
        // プロフィール情報更新時にプロパティを同期
        AdropMetrics.setProperty(key: AdropKey.AGE, value: profile.age)
        AdropMetrics.setProperty(key: "membership", value: profile.membershipLevel)
        AdropMetrics.setProperty(key: "interest_\(profile.mainInterest)", value: true)
    }
}

// ✅ 良い例: 意味のあるアクション
AdropMetrics.sendEvent(name: "purchase", params: ["value": 99.99])
AdropMetrics.sendEvent(name: "level_complete", params: ["level": 10])
AdropMetrics.sendEvent(name: "tutorial_complete")

// ❌ 悪い例: 過度なイベント
AdropMetrics.sendEvent(name: "button_tapped")  // 汎用的すぎる
AdropMetrics.sendEvent(name: "scroll")         // 頻度が高すぎる

// ✅ 良い例: 明確で一貫性のあるID（イニシャライザで設定）
let sportBanner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "sport")
let techBanner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "tech")
let bizBanner = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "business")

// ❌ 悪い例: 不一致または曖昧なID
let banner1 = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "Sport")  // 大文字小文字の不一致
let banner2 = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "technology")  // コンソールの値と異なる
let banner3 = AdropBanner(unitId: "YOUR_UNIT_ID", contextId: "category_1")  // 意味が不明確