Android & AndroidTV: Métodos

Métodos UI del CMP

Mostrar la interfaz de consentimiento desde nuestra app en otra sección (forzado):

CMP.tryShowConsentTool(true);

Se podrán utilizar los listener para comprobar si se ha abierto o no el CMP, también para ejecutar código después de que el CMP se haya cerrado. De la siguiente manera:

Ejemplo en Kotlin

Crea la variable CMP:

lateinit var CMP: ConsentHelper

Inizializa CMP con tu contexto:

CMP = ConsentHelper(YourContext)

Utiliza setOnTryOpenListener para ejecutar código antes de que aparezca el CMP. Dentro de success, boolean indicará si el CMP aparecerá o no:

CMP.setOnTryOpenListener { success ->
//Your code
}

Utiliza setOnTryOpenListener para ejecutar código después de que el CMP ha sido cerrado:

CMP.setOnTryOpenListener ( success -> {
//Your code
});

Ejemplo en Java

Crea la variable CMP:

private ConsentHelper CMP

Inizializa CMP con tu contexto:

CMP = new ConsentHelper(YourContext)

Utiliza setOnTryOpenListener para ejecutar código antes de que aparezca el CMP. Dentro de success, boolean indicará si el CMP aparecerá o no:

CMP.setOnTryOpenListener ( success -> {
//Your code
});

Utiliza setOnTryOpenListener para ejecutar código después de que el CMP ha sido cerrado:

CMP.setOnTryOpenListener ( () -> {
//Your code
});

Métodos para obtener consentimientos

Obtener la cadena de consentimiento:

String consentString = CMP.getConsentString();

Si consentString == null, no hay consentimiento almacenado aún.

Obtener el estado del consentimiento de algún vendor de la IAB:

Ejemplo con proveedor “Amobee, Inc.” que es el id 23:

Boolean status = CMP.isConsentVendorStatus(23);

Devuelve true si se tiene el consentimiento, false si no se tiene y null si el id es menor a 0

Obtener el estado del consentimiento de algún vendor de terceras partes:

Ejemplo con proveedor “googleConsent”:

Boolean status = CMP.isThirdDataConsentVendorStatus("googleConsent");

Devuelve true si se tiene el consentimiento, false si no se tiene y null si el id es menor a 0

Estado de un proveedor

Descripción: decodifica el consentimiento de un proveedor de TCF dado

isConsentVendorStatus([vendor_number])

Resultado esperado: true si el proveedor ha sido aceptado / false si el proveedor ha sido rechazado

Estado de un proveedor personalizado que no es de TCF

Descripción: decodifica el consentimiento de un proveedor no TCF dado

isThirdDataConsentVendorStatus([vendor_name])

Resultado esperado: true si el proveedor ha sido aceptado / false si el proveedor ha sido rechazado

Nombres de proveedores disponibles (verifique si el proveedor está configurado primero):

[vendor_name]=google

[vendor_name]=charbeat

[vendor_name]=facebook

Estado de un proveedor legítimo de interés de TCF

Descripción: decodifica el consentimiento dado a un proveedor de TCF según el interés legítimo

isVendorLegitimateInterestStatus([vendor_number])

Resultado esperado: true si el proveedor ha sido aceptado / false si el proveedor ha sido rechazado

Estado de un propósito de consentimiento (para proveedores de TCF)

Descripción: decodifica el consentimiento del propósito de consentimiento (para proveedores de TCF)

isConsentPurposeVendorStatus([purpose_number])

Resultado esperado: true si el propósito de consentimiento dado para los proveedores de TCF ha sido aceptado / false si ha sido rechazado

Estado del propósito de interés legítimo (para proveedores de TCF)

Descripción: decodifica el consentimiento de un propósito según el interés legítimo (para proveedores de TCF)

isVendorPurposeLegitimateInterestStatus ([purpose_number])

Resultado esperado: true si el propósito de interés legítimo dado para los proveedores de TCF ha sido aceptado / false si ha sido rechazado

Estado de un propósito de consentimiento (para editores)

Descripción: decodifica el consentimiento del propósito de consentimiento (para editores)

isPublisherConsentStatus([purpose_number])

Resultado esperado: true si el propósito de consentimiento dado para el editor ha sido aceptado / false si ha sido rechazado

Estado del propósito de interés legítimo (para editores)

Descripción: decodifica el consentimiento de un propósito según el interés legítimo (para editores)

1. isPublisherLegitimateInterestStatus([purpose_number])

Resultado esperado: true si el propósito de interés legítimo dado para el editor ha sido aceptado / false si ha sido rechazado

Estado de características especiales

Descripción: decodifica el consentimiento de características especiales

isSpecialFeatureStatus([special_feature_number])

Resultado esperado: true si la característica especial dada ha sido aceptada / false si ha sido rechazada

Estado combinado

Descripción: decodifica el consentimiento de diferentes elementos

isAllAcceptedCustom()

Puede contener 8 listas diferentes (puede funcionar con menos de 8 listas)

El orden de la lista y los parámetros es el siguiente:

1. vendors: List<Int> = listOf(), // lista de proveedores de consentimiento TCF

2. vendorsLegitimateInterest: List<Int> = listOf(), // lista de proveedores de LI TCF

3. thirdDataConsentVendors: List<String> = listOf(), // lista de proveedores personalizados

4. vendorsPurpose: List<Int> = listOf(), // lista de consentimientos a propósitos TCF

5. vendorsPurposeLegitimateInterest: List<Int> = listOf(), // lista de propósitos de interés legítimo TCF

6. List<Int> = listOf(), // lista de consentimientos a propósitos de editores

7. publishersLegitimateInterest: List<Int> = listOf(), // lista de propósitos de interés legítimo de editores

8. specialFeatures: List<Int> = listOf() // lista de características especiales

Ejemplos en Kotlin:

Consentimientos de proveedores solamente

List=1;

isAllAcceptedCustom(listOf(1,2))

Consentimientos de proveedores + custom vendor = Google

List=1; List=3;

isAllAcceptedCustom(listOf(1,2), listOf(),listOf("googleConsent", "vendor1"))

La Lista 2 debe incluirse pero debería estar vacía.