[iOS] 3. Documentación de la API
inicializar
La función de inicialización inicializará la capa de consentimiento y verificará automáticamente si el usuario necesita un consentimiento o no. Esta función eventualmente abrirá la capa de consentimiento e interactuará con la API de transparencia de seguimiento de Apple para solicitar el consentimiento del usuario.
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
let cmpConfig : CmpConfig = CmpConfig.shared.setup(withId: config.appId, domain: config.domain, appName: config.appName, language: config.language);
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig).initialize()
conCloseListener
Agrega un oyente cercano para recibir notificaciones cuando se cierra la capa de consentimiento.
parámetros
Nombre | Tipo de Propiedad | Descripción |
cerrarOyente | función | Devolución de llamada que se llamará cuando se cierre la capa de consentimiento. |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
func onClose() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withCloseListener(onClose)
conOpenListener
Agrega un oyente abierto para recibir notificaciones cuando se abre la capa de consentimiento.
parámetros
Nombre | Tipo de Propiedad | Descripción |
Oyente abierto | función | Devolución de llamada a la que se llamará cuando se abra la capa de consentimiento |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
func onOpen() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withCloseListener(onOpen)
conErrorListener
Agrega un detector de errores para recibir notificaciones cuando ocurre un error
parámetros
Nombre | Tipo de Propiedad | Descripción |
errorListener | función | Devolución de llamada para agregar acción si se produjo un error. |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
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)
conOnCMPNotOpenedListener
Agrega una devolución de llamada de Cmp no abierto para recibir una notificación cuando la capa de consentimiento no se abre
parámetros
Nombre | Tipo de Propiedad | Descripción |
Oyente abierto | función | Devolución de llamada que se llamará cuando la capa de consentimiento `no esté abierta`. La razón más común es que el usuario ya dio su consentimiento. |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
func onCMPNotOpened() -> Void {
NSLog("APP:CLOSED");
// add custom business logic here
}
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig, viewController: self)
.withOnCMPNotOpenedListener(onCMPNotOpened)
conOnCmpButtonClickedCallback
Establece una devolución de llamada para recibir notificaciones cuando el usuario hace clic en un botón para cerrar la capa de consentimiento.
parámetros
Nombre | Tipo de Propiedad | Descripción |
Oyente abierto | función | Devolución de llamada que se invocará con ``CmpButtonEvent`` que indica qué botón se presionó |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
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)
conCmpViewControllerConfigurationBlock
Personaliza la capa de consentimiento UIViewController
parámetros
Nombre | Tipo de Propiedad | Descripción |
bloque de configuración |
Bloque de configuración CmpViewController |
Personaliza la capa de consentimiento
Controlador UIView |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig)
.withCmpViewControllerConfigurationBlock({ viewController in
viewController?.modalPresentationStyle = .formSheet
})
conCmpViewConfigurationBlock
Personaliza la UiView de la capa de consentimiento
parámetros
Nombre | Tipo de Propiedad | Descripción |
bloque de configuración |
Bloque de configuración CmpUIView |
Personaliza la capa de consentimiento
Vista de interfaz de usuario |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
let cmpLayout = CmpLayout.default()
cmpLayout?.cornerRadius = 10.0
cmpLayout?.customLayout = CGRect(x: 0, y: 0, width: 200, height: 300)
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig)
.withCmpViewConfigurationBlock({ uiView in
cmpLayout?.apply(to: uiView)
})
conActualizaciónGoogleConsentimiento
Recuperar el estado del modo de consentimiento de Google
parámetros
Nombre | Tipo de Propiedad | Descripción |
consentimientoMapa |
[Cordón: Cordón]? |
Estado de consentimiento |
Ida y vuelta
Herramienta de consentimiento CMP
Ejemplo
cmpConsentTool = CMPConsentTool(cmpConfig: cmpConfig)
.withUpdateGoogleConsent(onCmpUpdateGoogleConsent)
}
func onCmpUpdateGoogleConsent(consentMap: [String: String]?) -> Void {
guard let consentMap = consentMap else { return }
var firebaseConsentMap: [ConsentType: ConsentStatus] = [:]
consentMap.forEach { key, value in
if let consentType = convertToFirebaseConsentType(from: key),
let consentStatus = convertToFirebaseConsentStatus(from: value) {
firebaseConsentMap[consentType] = consentStatus
}
}
Analytics.setConsent(firebaseConsentMap)
}
func convertToFirebaseConsentType(from key: String) -> ConsentType? {
switch key {
case "analytics_storage":
return .analyticsStorage
case "ad_storage":
return .adStorage
case "ad_user_data":
return .adUserData
case "ad_personalization":
return .adPersonalization
default:
return nil
}
}
func convertToFirebaseConsentStatus(from value: String) -> ConsentStatus? {
switch value {
case "granted":
return .granted
case "denied":
return .denied
default:
return nil
}
}
comprobar y abrir la capa de consentimiento
Comprobar y abrir la capa de consentimiento
Ida y vuelta
Sin valor de retorno
Ejemplo
cmpConsentTool.checkAndOpenConsentLayer()
openCmpConsentToolView
Abre la vista de la capa de consentimiento de CMP
Ida y vuelta
Sin valor de retorno
Ejemplo
cmpConsentTool.openView()
comprobar
cheque
parámetros
Nombre | Tipo de Propiedad | Descripción |
enCmpLayerOpen | función | Devolución de llamada cuando la capa de consentimiento necesita estar abierta. |
está en caché | Boolean | Indicador BOOL cuando es VERDADERO, la solicitud se almacenará en caché y la respuesta se guardará |
Ida y vuelta
Sin valor de retorno
Ejemplo
cmpConsentTool?.check(
{
print("Layer wants to open")
// self.cmpConsentTool?.openView()
},
isCached: true,
onCmpLayerNotOpen: {
print("Layer does not want to open")
}
)
tiene consentimiento
Comprueba si el usuario dio su consentimiento. La capa de consentimiento puede tener la opción de simplemente cerrar la capa. En este caso el usuario no da su consentimiento.
Ida y vuelta
verdadero si el usuario dio su consentimiento.
Ejemplo
cmpConsentTool.hasConsent()
obtenertodoslospropósitos
Obtiene una cadena separada por comas de los ID de 'propósito' deshabilitados
Ida y vuelta
Cadena de todos los ID de `propósito`
Ejemplo
cmpConsentTool.getAllPurposes()
obtener lista multipropósito
Recupera una lista de todos los ID de `propósito` para el Cmp dado.
Ida y vuelta
Una `Lista` que contiene todos los ID de `propósito`.
Ejemplo
cmpConsentTool.getAllPurposeList()
getEnabledPurposes
Obtiene una cadena separada por comas de los ID de `propósito` habilitados
Ida y vuelta
`Cadena` de ID de `propósito` habilitados
Ejemplo
cmpConsentTool.getEnabledPurposes()
getEnabledPurposeList
Obtener lista de propósitos acordados
Ida y vuelta
Ejemplo
cmpConsentTool?.getEnabledPurposeList()
getDisabledPurposes
Obtener propósitos deshabilitados
Ida y vuelta
Ejemplo
cmpConsentTool?.getDisabledPurposes()
obtener todos los proveedores
Obtener todos los proveedores
Ida y vuelta
Ejemplo
cmpConsentTool?.getAllVendors()
obtener lista de todos los proveedores
Obtener la lista de todos los proveedores
Ida y vuelta
Ejemplo
cmpConsentTool?.getAllVendorsList()
getEnabledVendors
Obtener proveedores habilitados
Ida y vuelta
Ejemplo
cmpConsentTool?.getEnabledVendors()
getEnabledVendorList
Obtener lista de proveedores habilitada
Ida y vuelta
Ejemplo
cmpConsentTool?.getEnabledVendorList()
getDisabledVendors
Obtener proveedores deshabilitados
Ida y vuelta
Ejemplo
cmpConsentTool?.getDisabledVendors()
habilitarLista de proveedores
Habilita una lista de proveedores y actualiza el consentimiento dado
parámetros
Nombre | Tipo de Propiedad | Descripción |
vendedores | Formación | Lista de ID de proveedores para habilitar. |
al Finalizar | función | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.enableVendorList(vendors, onFinish: onFinish)
desactivar la lista de proveedores
Deshabilita una lista de proveedores y actualiza el consentimiento dado
parámetros
Nombre | Tipo de Propiedad | Descripción |
vendedores | Formación | Lista de identificadores de proveedores para deshabilitar. |
al Finalizar | función | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
let vendors = ["1","2"]
cmpConsentTool?.disableVendorList(vendors, onFinish: onFinish)
enablePurposeList
Habilita una lista de propósitos y actualiza el consentimiento dado
parámetros
Nombre | Tipo de Propiedad | Descripción |
fines | Formación | Lista de ID de propósito para habilitar. |
al Finalizar | función (Opcional) | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
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)
deshabilitarPurposeList
Deshabilita una lista de propósitos y actualiza el consentimiento dado
parámetros
Nombre | Tipo de Propiedad | Descripción |
fines | Formación | Lista de identificadores de propósito para deshabilitar. |
al Finalizar | función (Opcional) | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
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)
rechazar todo
Rechaza la capa de consentimiento y se comporta igual cuando el usuario `no acepta` el consentimiento
parámetros
Nombre | Tipo de Propiedad | Descripción |
al Finalizar | función | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
cmpConsentTool.rejectAll(onFinish)
aceptar todo
Acepta la capa de consentimiento y se comporta igual cuando el usuario `sí acepta` el consentimiento
parámetros
Nombre | Tipo de Propiedad | Descripción |
al Finalizar | función | Devolución de llamada para gestionar el evento de consentimiento recibido. se llamará cuando se reciba y procese el consentimiento. |
Ida y vuelta
Sin valor de retorno
Ejemplo
func onFinish() -> Void {
NSLog("Notification, that new consent is received");
}
cmpConsentTool.acceptAll(onFinish)
getUSPrivacyString
Obtener cadena de privacidad de EE. UU.
Ida y vuelta
`String` La cadena de privacidad de EE. UU., establecida por consentmanager
Ejemplo
cmpConsentTool.getUSPrivacyString()
tiene el consentimiento del proveedor
Tiene el consentimiento del proveedor
parámetros
Nombre | Tipo de Propiedad | Descripción |
proveedorId | Cordón | identificación del proveedor |
proveedorIsV1orV2 | BOOL | si la identificación del proveedor es un proveedor de IAB. (Obsoleto: la bandera ya no es necesaria) |
Ida y vuelta
VERDADERO si el usuario ha dado su consentimiento al proveedor especificado, FALSO en caso contrario.
Ejemplo
cmpConsentTool.hasVendorConsent("vendorID")
tiene PropósitoConsentimiento
Comprueba si la identificación del propósito está habilitada según el consentimiento del usuario.
parámetros
Nombre | Tipo de Propiedad | Descripción |
ID de propósito | Cordón | identificación de propósito |
proveedorIsV1orV2 | BOOL | si la identificación del proveedor es un proveedor de IAB. (Obsoleto: la bandera ya no es necesaria) |
Ida y vuelta
Ejemplo
cmpConsentTool.hasPurposeConsent("purposeID")
obtenerGoogleACString
Recupera la cadena de ID de adición de Google (`addtlConsent`) establecida por el consent manager.
Ida y vuelta
Cadena AC de Google
Ejemplo
cmpConsentTool.getGoogleACString()
obtener cadena de consentimiento
Obtener última cadena de consentimiento
Ida y vuelta
Cadena de consentimiento guardada
Ejemplo
getConsentstring()
exportarCmpString
Exporta la cadena CmpData
Ida y vuelta
La cadena CmpData codificada en base64
Ejemplo
CMPConsentTool.exportCmpString()
consentimientoSolicitadoHoy
Comprueba si la capa de consentimiento se solicitó hoy
Ida y vuelta
VERDADERO si el CMPConsent Manager El servidor fue solicitado hoy, de lo contrario FALSO
Ejemplo
cmpConsentTool.consentRequestedToday()
se requiere consentimiento
Comprueba si el usuario necesita aceptación
Ida y vuelta
TRUE si el usuario necesita dar su consentimiento.
Ejemplo
cmpConsentTool.isConsentRequired()
reajustar
Restablece todos los datos establecidos por ``CMPConsentTool``
Ida y vuelta
Sin valor de retorno
Ejemplo
CMPConsentTool.reset()