[iOS] 3. Dokumentacja API
API
zainicjować
Funkcja inicjalizacji zainicjuje warstwę zgody i automatycznie sprawdzi, czy użytkownik potrzebuje zgody, czy nie. Ta funkcja ostatecznie otworzy warstwę zgody i wejdzie w interakcję z interfejsem Apple Tracking Transparency API, aby poprosić użytkownika o zgodę
Powrót
Narzędzie CMPConsent
Przykład
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.initialize()
z CloseListener
Dodaje bliskiego słuchacza, który będzie otrzymywać powiadomienia, gdy warstwa zgody zostanie zamknięta.
parametry
Nazwa | Typ | Opis |
zamknij Słuchacz | funkcjonować | Wywołanie zwrotne, które zostanie wywołane po zamknięciu warstwy zgody. |
Powrót
Narzędzie CMPConsent
Przykład
func onClose() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withCloseListener(onClose)
z OpenListenerem
Dodaje otwartego odbiornika, który będzie otrzymywać powiadomienia o otwarciu warstwy zgody.
parametry
Nazwa | Typ | Opis |
Otwórz słuchacza | funkcjonować | Wywołanie zwrotne, które zostanie wywołane po otwarciu warstwy zgody |
Powrót
Narzędzie CMPConsent
Przykład
func onOpen() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withCloseListener(onOpen)
za pomocąErrorListener
Dodaje odbiornik błędów, aby otrzymywać powiadomienia o wystąpieniu błędu
parametry
Nazwa | Typ | Opis |
słuchacz błędów | funkcjonować | Wywołanie zwrotne w celu dodania akcji w przypadku wystąpienia błędu. |
Powrót
Narzędzie CMPConsent
Przykład
func onCMPError(type: CmpErrorType, message: String?) -> Void {
switch type {
case .networkError:
print(message)
print("error network")
break
case .timeoutError:
print(message)
print("error timeout")
break
case .consentDataReadWriteError:
print(message)
print("error consent read/write")
break
case .unknownError:
print(message)
print("error unknown")
break
@unknown default:
print(message)
print("error network")
break
}
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withErrorListener(onCMPError)
z OnCMMPNotOpenedListener
Dodaje wywołanie zwrotne Cmp, które nie zostało otwarte, aby otrzymywać powiadomienia, gdy warstwa zgody się nie otwiera
parametry
Nazwa | Typ | Opis |
Otwórz słuchacza | funkcjonować | Wywołanie zwrotne, które zostanie wywołane, gdy warstwa zgody nie zostanie otwarta. Najczęstszym powodem jest to, że użytkownik wyraził już zgodę |
Powrót
Narzędzie CMPConsent
Przykład
func onCMPNotOpened() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withOnCMPNotOpenedListener(onCMPNotOpened)
z OnCmpButtonClickedCallback
Ustawia wywołanie zwrotne w celu otrzymywania powiadomień, gdy użytkownik kliknie przycisk w celu zamknięcia warstwy zgody.
parametry
Nazwa | Typ | Opis |
Otwórz słuchacza | funkcjonować | Wywołanie zwrotne, które zostanie wywołane z ``CmpButtonEvent`` wskazującym, który przycisk został naciśnięty |
Powrót
Narzędzie CMPConsent
Przykład
func onButtonClickedEvent(event: CmpButtonEvent) -> Void {
switch event {
case .acceptAll:
print("user accepted all")
break
case .rejectAll:
print("user accepted all")
break
case .save:
print("user saved custom settings")
break
case .close:
print("user closed consent layer without giving consent")
break
@unknown default:
print("unknown button event")
}
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withOnCmpButtonClickedCallback(onButtonClickedEvent)
checkAndOpenConsentLayer
Sprawdź i otwórz warstwę zgody
Powrót
Brak wartości zwracanej
Przykład
cmpConsentTool.checkAndOpenConsentLayer()
openCmpConsentToolView
Otwiera widok warstwy zgody CMP
Powrót
Brak wartości zwracanej
Przykład
cmpConsentTool.openView()
ZOBACZ
Kontrola
parametry
Nazwa | Typ | Opis |
naCmpLayerOpen | funkcjonować | Oddzwanianie, gdy warstwa zgody musi być otwarta. |
jest w pamięci podręcznej | Boolean | BOOL, gdy PRAWDA, żądanie zostanie zapisane w pamięci podręcznej, a odpowiedź zostanie zapisana |
Powrót
Brak wartości zwracanej
Przykład
cmpConsentTool?.check({() -> Void in
print("Notification, that consent layer needs to be open")
}, isCached: false)
otwórz warstwę niestandardową
otwiera dostosowaną warstwę zgody
parametry
Nazwa | Typ | Opis |
kontekst | Kontekst | Kontekst aplikacji |
interfejs aplikacji | Interfejs CmpLayerAppEventListener |
Powrót
Brak wartości zwracanej
Przykład
openCustomLayer(context = ...,appInterface = ...)
otwórz warstwę zgody
otwiera warstwę zgody
Powrót
Brak wartości zwracanej
Przykład
openConsentLayer()
utwórzCustomLayerFragment
Utwórz niestandardowy fragment warstwy
Powrót
Fragment warstwy Cmp
Przykład
createCustomLayerFragment()
ma zgodę
Sprawdza, czy użytkownik wyraził zgodę. Warstwa zgody może mieć opcję zamknięcia warstwy przez. W takim przypadku użytkownik nie wyraził zgody.
Powrót
true, jeśli użytkownik wyraził zgodę.
Przykład
cmpConsentTool.hasConsent()
pobierzWszystkie cele
Pobiera oddzielony przecinkami łańcuch znaków wyłączonych identyfikatorów „przeznaczenia”.
Powrót
Ciąg wszystkich identyfikatorów „przeznaczenia”.
Przykład
cmpConsentTool.getAllPurposes()
pobierz listę wszystkich celów
Pobiera listę wszystkich identyfikatorów „celu” dla danego Cmp.
Powrót
„Lista” zawierająca wszystkie identyfikatory „przeznaczenia”.
Przykład
cmpConsentTool.getAllPurposeList()
getEnabledCele
Pobiera oddzielony przecinkami ciąg znaków włączonych identyfikatorów „przeznaczenia”.
Powrót
`Ciąg` włączonych identyfikatorów `celu`
Przykład
getEnabledPurposes()
getEnabledPurposeList
Uzyskaj uzgodnioną listę celów
Powrót
Przykład
getEnabledPurposeList()
getDisabledCele
Zdobądź cele dla osób niepełnosprawnych
Powrót
Przykład
getDisabledPurposes()
getAllVendors
Zdobądź wszystkich dostawców
Powrót
Przykład
getAllVendors()
pobierz listę wszystkich dostawców
Pobierz listę wszystkich dostawców
Powrót
Przykład
getAllVendorsList()
getEnabledVendors
Uzyskaj uzgodnionych dostawców
Powrót
Przykład
getEnabledVendors()
getEnabledVendorList
Uzyskaj uzgodnioną listę dostawców
Powrót
Przykład
getEnabledVendorList()
getDisabledVendors
Zdobądź wyłączonych dostawców
Powrót
Przykład
getDisabledVendors()
włącz listę dostawców
Włącza listę dostawców i aktualizuje udzieloną zgodę
parametry
Nazwa | Typ | Opis |
sprzedawców | Szyk | Lista identyfikatorów dostawców do włączenia. |
naZakończ | funkcjonować | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.enableVendorList(vendors, onFinish: onFinish)
wyłącz listę dostawców
Wyłącza listę dostawców i aktualizuje udzieloną zgodę
parametry
Nazwa | Typ | Opis |
sprzedawców | Szyk | Lista identyfikatorów dostawców do wyłączenia. |
naZakończ | funkcjonować | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.disableVendorList(vendors, onFinish: onFinish)
włącz listę celów
Włącza listę celów i aktualizuje udzieloną zgodę
parametry
Nazwa | Typ | Opis |
cele | Szyk | Lista identyfikatorów celów do włączenia. |
naZakończ | funkcja (opcjonalnie) | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.enablePurposeList(vendors, onFinish: onFinish)
// or without callback
cmpConsentTool?.enablePurposeList(vendors)
wyłącz listę celów
Wyłącza listę celów i aktualizuje udzieloną zgodę
parametry
Nazwa | Typ | Opis |
cele | Szyk | Lista identyfikatorów celów do wyłączenia. |
naZakończ | funkcja (opcjonalnie) | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.disablePurposeList(vendors, onFinish: onFinish)
// or without callback
cmpConsentTool?.disablePurposeList(vendors)
odrzuć wszystko
Odrzuca warstwę zgody i zachowuje się tak samo, gdy użytkownik „nie zaakceptował” zgody
parametry
Nazwa | Typ | Opis |
naZakończ | funkcjonować | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
cmpConsentTool.rejectAll(onFinish)
Akceptuj wszystkie
Akceptuje warstwę zgody i zachowuje się tak samo, gdy użytkownik „zaakceptuje” zgodę
parametry
Nazwa | Typ | Opis |
naZakończ | funkcjonować | Oddzwanianie do obsługi zdarzenia otrzymania zgody. zostanie wywołana po otrzymaniu i przetworzeniu zgody. |
Powrót
Brak wartości zwracanej
Przykład
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
cmpConsentTool.acceptAll(onFinish)
pobierz USPrivacyString
Uzyskaj amerykański ciąg znaków prywatności
Powrót
`String` Ciąg znaków prywatności USA, który został ustawiony przez consentmanager
Przykład
cmpConsentTool.getUSPrivacyString()
mazgodędostawcy
Posiada zgodę sprzedawcy
parametry
Nazwa | Typ | Opis |
identyfikator sprzedawcy | sznur | identyfikator sprzedawcy |
dostawcaJestV1lubV2 | BOOL | jeśli identyfikator dostawcy to dostawca IAB. (przestarzałe: flaga nie jest już potrzebna) |
Powrót
PRAWDA, jeśli użytkownik udzielił zgody określonemu dostawcy, w przeciwnym razie FAŁSZ.
Przykład
cmpConsentTool.hasVendorConsent("vendorID", FALSE)
maCelowązgodę
Sprawdza, czy identyfikator celu jest włączony na podstawie zgody użytkownika.
parametry
Nazwa | Typ | Opis |
identyfikator celu | sznur | identyfikator celu |
dostawcaJestV1lubV2 | BOOL | jeśli identyfikator dostawcy to dostawca IAB. (przestarzałe: flaga nie jest już potrzebna) |
Powrót
Przykład
cmpConsentTool.hasPurposeConsent("purposeID", FALSE)
pobierz GoogleACString
Pobiera ciąg identyfikatora dodania Google (`addtlConsent`), który został ustawiony przez consent manager.
Powrót
Ciąg Google AC
Przykład
cmpConsentTool.getGoogleACString()
pobierz ciąg zgody
Pobierz ostatni ciąg zgody
Powrót
zapisany ciąg zgody
Przykład
getConsentstring()
eksportCmpString
Eksportuje ciąg CmpData
Powrót
Ciąg znaków CmpData zakodowany w formacie base64
Przykład
CMPConsentTool.exportCmpString()
o nazwie ThisDay
Sprawdza, czy warstwa zgody została wywołana dzisiaj
Powrót
PRAWDA, jeśli plik CMPConsent Manager Żądanie serwera zostało wysłane dzisiaj, w przeciwnym razie FAŁSZ
Przykład
cmpConsentTool.calledThisDay()
potrzebuje Akceptacji
Sprawdza, czy użytkownik potrzebuje akceptacji
Powrót
PRAWDA, jeśli użytkownik musi wyrazić zgodę.
Przykład
cmpConsentTool.needsAcceptance()
nastawić
Resetuje wszystkie dane ustawione przez ``CMPConsentTool``
Powrót
Brak wartości zwracanej
Przykład
CMPConsentTool.reset()