Prvi koraci - iOS i tvOS

OptSens SDK je Swift paket. Dodajte ga, pozovite OptSens.configure sa svojim SDK ID-jem i prikažite baner. Isti paket radi na iPhone-u, iPad-u i Apple TV-u.

Zahtevi

SDK je dostupan na Pro, Business i Custom planovima.
iOS 16 ili noviji, tvOS 17 ili noviji.
Swift Package Manager. SDK nikada ne prikazuje App Tracking Transparency upit; taj upit pravi vaša aplikacija, ako joj je potreban.

Preuzmite svoj SDK ID

U svojoj OptSens kontrolnoj tabli kliknite na Dodaj domen u gornjoj navigaciji i dodajte svoju aplikaciju. Pogledajte Dodajte svoju aplikaciju za ceo tok (izbor platforme, unos identifikatora aplikacije, izbor plana).
Prođite kroz vođeno podešavanje. U koraku Integracija kopirajte svoj SDK ID. Dostupan je i na stranici Integracija u kontrolnoj tabli u svakom trenutku.

Dodajte SDK

U Xcode-u izaberite File > Add Package Dependencies, unesite URL repozitorijuma i dodajte proizvod OptSensUI u svoj app target. On za vas povlači i mehanizam za saglasnost. Ili ga dodajte u Package.swift:

dependencies: [
    .package(url: "https://github.com/Optsens/optsens-sdk-ios.git", from: "1.0.0")
]

Inicijalizujte OptSens i prikažite baner

Pozovite OptSens.configure jednom pri pokretanju, sa svojim SDK ID-jem. Kada je saglasnost potrebna, prikažite OptSensBanner prikaz preko svog interfejsa, kao sheet ili preko celog ekrana:

import OptSensCore
import OptSensUI

OptSens.configure(apiKey: "YOUR_SDK_ID") { result in
    if case .success(let status) = result, status.shouldCollectConsent,
       let config = OptSens.config() {
        OptSensBanner(
            config: config,
            language: OptSens.bannerLanguage(),
            iabActive: OptSens.isIabActive(),
            onAccept: { OptSens.acceptAll() },
            onReject: { OptSens.rejectAll() },
            onSave: { decision, acIds, categories in
                OptSens.saveDecision(decision, acConsentedIds: acIds, meta: DecisionMeta(categories: categories))
            }
        )
    }
}

configure preuzima konfiguraciju banera, utvrđuje region i jezik uređaja i upisuje ključeve saglasnosti na uređaj. Za posetioca pod američkim pravilima o privatnosti, umesto toga prikažite panel "Your Privacy Choices" pomoću OptSens.applyUsPrivacy.

Da bi posetioci kasnije mogli ponovo da otvore svoj izbor, dodajte plutajuće dugme kao overlay u svom glavnom prikazu. Za razliku od veba, gde se dugme dodaje samo, u aplikaciji ga postavljate sami, jednom. Pogledajte Plutajuće dugme.

Apple TV

Isti paket radi na Apple TV-u (tvOS 17). Baner sam prelazi na raspored za velike ekrane sa fokusom preko daljinskog. Ponovno otvaranje saglasnosti na TV-u koristi prikaz koji postavljate u svoj meni. Pogledajte Televizori.

Nakon integracije

Pokrenite aplikaciju. Baner se prikazuje pri prvom pokretanju kada je saglasnost potrebna.
Potvrdite integraciju iz koraka Provera aplikacije u kontrolnoj tabli.
Kontrolišite sopstveni analitički i oglasni kod pomoću OptSens.hasConsent i podesite prosleđivanje saglasnosti za Google i svoje partnere za atribuciju.

Dalje: Prikazivanje banera.

Zahtevi​

Preuzmite svoj SDK ID​

Dodajte SDK​

Inicijalizujte OptSens i prikažite baner​

Apple TV​

Nakon integracije​