Info
Contenido
Libros
CMP
API de JavaScript
API de JavaScript

API de JavaScript

El sistema consentmanager.net CMP admite varias API de JavaScript para permitir que los sitios web recuperen información de consentimiento.

Usando la API

Para todas las solicitudes a la API, utilice siempre las funciones públicas mencionadas a continuación. Por favor no ¡acceda al objeto interno window.cmpmngr directamente!

Para enviar o recibir información de / a la API, puede utilizar la función pública general __cmp(...). Esta función puede manejar la mayoría de las solicitudes genéricas. Además de esto, el CMP también ofrece funciones públicas __tcfapi(...) para el cumplimiento de IAB TCF v2 y __uspapi(...) para el cumplimiento de la privacidad de IAB US.

Ejemplo:

var x = __cmp('consentStatus');
if(x.consentExists){/* do something */}

Funciones API

Las tres funciones API utilizan diferentes parámetros debido a las diferentes especificaciones que siguen estas funciones. Las funciones de la API son:

__cmp( Command, Parameter, Callback, Async )
__tcfapi( Command, Version, Callback, Parameter )
__gpp( Command, Version, Callback, Parameter )

Remoto: Tenga en cuenta que __uspapi() ya no existe y fue reemplazado por __gpp().

Tenga en cuenta que para __cmp() todos los parámetros excepto Command son opcionales

Comandos

La API admite los siguientes comandos:

Tenga en cuenta que nuestra API puede devolver objetos a los comandos TCF v1 + v2, que son diferentes del estándar. Vea aquí para más detalles.

Comando Función Descripción
getTCData __tcfapi() Obtenga el objeto de datos de consentimiento de acuerdo con IAB TCF v2.
noncompliant_getTCData __tcfapi() Obtenga el objeto de datos de consentimiento de acuerdo con IAB TCF v2 en caso de una configuración no compatible del CMP.
getUSPData __uspapi() Obtenga la cadena de datos de consentimiento de acuerdo con las especificaciones de privacidad de IAB US.
ping

__cmp()

__tcfapi()

__gpp()

Dependiendo de la función utilizada:

__cmp('ping') devolverá falso.

__tcfapi('ping') devolverá el objeto ping IAB TCF v2.

__gpp('ping',callback) devolverá el objeto ping GPP.
addEventListener

__cmp()

__tcfapi()

Agrega un nuevo oyente de eventos. Ver detalles aquí.

Tenga en cuenta que los parámetros dependen de la función utilizada.
removeEventListener

__cmp()

__tcfapi()

 Elimina un oyente de eventos. Véase más arriba.
getCMPData __cmp()

Obtenga un objeto que contenga todos los datos de consentimiento relevantes.

{
 consentstring: "IAB TCF consent string", 
 uspstring: "IAB US Privacy String", 
 gdprApplies: true/false,
 hasGlobalScope: true/false, 
 tcfversion: 0/1/2, 
 tcfcompliant: true/false, 
 regulation: 0/1/2 (none / GDPR / CCPA), 
 purposeConsents: {},
 vendorConsents: {}, 
 purposeLI: {}, 
 vendorLI: {}
 googleVendorConsents: {}
}
   

 
consentStatus __cmp()

Obtenga la cadena de consentimiento y la información si se da la opción del usuario. El objeto de estado devuelto se verá así: {'consentExists': true/false, 'consentData': '…'}

Tenga en cuenta que esto sí no señal de consentimiento, pero solo si el usuario hizo una elección.
setConsent __cmp() Simule un clic del usuario en aceptar todo (Parámetro = 1) o rechazar todo (Parámetro = 0).
setVendorConsent __cmp()

Establece el estado de consentimiento para un determinado proveedor. El ID y el estado del proveedor deben pasarse como matriz a través del parámetro 2, por ejemplo __cmp('setVendorConsent',['s30', 1 ]) establece el consentimiento (aceptar) para el proveedor s30. Posibles valores de estado:

0 = rechazar

1 = aceptar

2 = rechazar, no contar

3 = aceptar, no contar
setPurposeConsent __cmp()

Establece el estado de consentimiento para un determinado propósito. El ID de propósito y el estado deben pasarse como una matriz a través del parámetro 2, p. Ej. __cmp('setPurposeConsent',[52, 1 ]) establece el consentimiento (aceptar) para el propósito 52.

Si desea establecer el consentimiento para un propósito y todos los proveedores que están asignados a este propósito, puede establecer el tercer campo como verdadero, por ejemplo

__cmp('setPurposeConsent',[52, 1, true ])
exportConsent __cmp() Información de consentimiento de exportaciones para intercambio de consentimiento entre dispositivos.
importConsent __cmp() Importa información de consentimiento para este visitante.
cancelwait __cmp() Evite que el CMP espere las llamadas entrantes de importación de consentimiento.
     
showScreen __cmp() Mostrar pantalla de bienvenida (dependiendo de la ubicación de los visitantes / configuración de la cuenta).
showGDPRScreen __cmp() Mostrar pantalla de bienvenida para GDPR
showCCPAScreen __cmp() Mostrar pantalla de bienvenida para CCPA
showScreenAdvanced __cmp() Mostrar administrador de preferencias (según la ubicación de los visitantes/configuración de la cuenta). Nota: Puede utilizar el segundo parámetro para indicar qué página debe abrirse (por ejemplo, utilice "c52" para abrir la página para el propósito c52).
showGDPRScreenAdvanced __cmp() Mostrar administrador de preferencias para GDPR
showGDPRScreenVendors __cmp() Mostrar administrador de preferencias para GDPR> Página Todos los proveedores
showCCPAScreenAdvanced __cmp() Mostrar administrador de preferencias para CCPA
showCookies __cmp() Mostrar mesa de galletas.
close __cmp() Cierre la capa de consentimiento.
     
setAgeCallback __cmp() Set función de devolución de llamada para verificación de edad.
setUserID __cmp()

Establecer ID de usuario externo 1.

setUserID establece la ID externa (ID 2, ID 3) para la que se conoce al usuario. getUserID y setUserID ambos devuelven un objeto de ID de usuario: {'external': ..., 'external2': ..., 'external3': ..., 'internal': ...}
Nota: La ID de usuario interna solo está disponible si está habilitada en la configuración de CMP y después de que se active el evento "configuración" (consulte Eventos CMP).
setUserID2 __cmp() Establecer ID de usuario externo 2
setUserID3 __cmp() Establecer ID de usuario externo 3
getUserID __cmp() Obtenga todas las ID de usuario
checkBlocking __cmp() Comprueba si los elementos bloqueados se pueden desbloquear y desbloquearlos.
checkShowScreen __cmp() Comprueba si mostrar la capa de consentimiento (nuevamente).
     
privacyLink __cmp() Redirige al visitante a la página de la política de privacidad.
tacLink __cmp() Redirige al visitante a la página de Términos y condiciones.
imprintLink __cmp() Redirige al visitante a la página de aviso legal / pie de imprenta.

 

Detalles
Revisión n. ° 20
Creadas Hace años 4 by Ene
Actualizado Hace 1 mes by Falko
¿No tiene una cuenta todavía?

Cumplir con el RGPD con nuestra Cookie del RGPD Consent Manager solution. ¡Pruébalo ahora gratis!

Cookie del RGPD Consent Manager
Volver