Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Funciones relacionadas con la privacidad
AWS Clean Rooms proporciona funciones que le ayudan a cumplir con las normas relacionadas con la privacidad en relación con las siguientes especificaciones.
+ **Plataforma de privacidad global (GPP)**: especificación de la Oficina de Publicidad Interactiva (IAB) que establece un marco global y estandarizado para la privacidad en línea y el uso de los datos. Para obtener más información sobre las especificaciones técnicas de la GPP, consulte la documentación de la [Plataforma de privacidad global](https://github.com/InteractiveAdvertisingBureau/Global-Privacy-Platform) en. GitHub
+ **Marco de transparencia y consentimiento (TCF)**: un componente clave de la GPP, lanzada en 2020, que proporciona un marco técnico estandarizado para ayudar a las empresas a cumplir con las normas de privacidad, como el Reglamento General de Protección de Datos (GDPR) de la UE. El TCF permite a los clientes conceder o denegar su consentimiento a la recopilación y el procesamiento de datos. Para obtener más información sobre las especificaciones técnicas del TCF, consulte la documentación del [TCF](https://github.com/InteractiveAdvertisingBureau/GDPR-Transparency-and-Consent-Framework/tree/master/TCFv2) en. GitHub
**Topics**
+ [función consent\$1gpp\$1v1\$1decode](consent_gpp_v1_decode.md)
+ [función consent\$1tcf\$1v2\$1decode](consent_tcf_v2_decode.md)
# función consent\$1gpp\$1v1\$1decode
La `consent_gpp_v1_decode` función se utiliza para decodificar los datos de consentimiento de la versión 1 de la Global Privacy Platform (GPP). Toma la cadena de consentimiento codificada como entrada y devuelve los datos de consentimiento decodificados, que incluyen información sobre las preferencias de privacidad y las opciones de consentimiento del usuario. Esta función resulta útil cuando se trabaja con datos que incluyen información de consentimiento de la GPP v1, ya que permite acceder a los datos de consentimiento y analizarlos en un formato estructurado.
## Sintaxis
```
consent_gpp_v1_decode(gpp_string)
```
## Argumentos
*gpp\$1string*
La cadena de consentimiento codificada del GPP v1.
## Devuelve
El diccionario devuelto incluye los siguientes pares clave-valor:
+ `version`: La versión de la especificación GPP utilizada (actualmente 1).
+ `cmpId`: el ID de la plataforma de gestión del consentimiento (CMP) que codificó la cadena de consentimiento.
+ `cmpVersion`: la versión de la CMP que codificó la cadena de consentimiento.
+ `consentScreen`: el ID de la pantalla de la interfaz de usuario de la CMP en la que el usuario dio su consentimiento.
+ `consentLanguage`: El código de idioma de la información de consentimiento.
+ `vendorListVersion`: La versión de la lista de proveedores utilizada.
+ `publisherCountryCode`: El código de país del editor.
+ `purposeConsent`: una lista de números enteros que representan los fines para los que el usuario ha dado su consentimiento.
+ `purposeLegitimateInterest`: Una lista de propósitos IDs para los que se ha comunicado de forma transparente el interés legítimo del usuario.
+ `specialFeatureOptIns`: una lista de números enteros que representan las funciones especiales que el usuario ha elegido.
+ `vendorConsent`: una lista de proveedores a los IDs que el usuario ha dado su consentimiento.
+ `vendorLegitimateInterest`: una lista de proveedores IDs para los que se ha comunicado de forma transparente el interés legítimo del usuario.
## Ejemplo
El siguiente ejemplo utiliza un único argumento, que es la cadena de consentimiento codificada. Devuelve un diccionario que contiene los datos de consentimiento decodificados, incluida información sobre las preferencias de privacidad del usuario, las opciones de consentimiento y otros metadatos.
```
SELECT * FROM consent_gpp_v1_decode('ABCDEFGHIJK');
```
La estructura básica de los datos de consentimiento devueltos incluye información sobre la versión de la cadena de consentimiento, los detalles de la CMP (plataforma de gestión del consentimiento), las opciones de consentimiento e interés legítimo del usuario para los distintos fines y proveedores, y otros metadatos.
```
{
"version": 1,
"cmpId": 12,
"cmpVersion": 34,
"consentScreen": 5,
"consentLanguage": "en",
"vendorListVersion": 89,
"publisherCountryCode": "US",
"purposeConsent": [1],
"purposeLegitimateInterests": [1],
"specialFeatureOptins": [1],
"vendorConsent": [1],
"vendorLegitimateInterests": [1]}
}
```
# función consent\$1tcf\$1v2\$1decode
La `consent_tcf_v2_decode` función se utiliza para decodificar los datos de consentimiento del Marco de Transparencia y Consentimiento (TCF) v2. Toma la cadena de consentimiento codificada como entrada y devuelve los datos de consentimiento decodificados, que incluyen información sobre las preferencias de privacidad y las opciones de consentimiento del usuario. Esta función resulta útil cuando se trabaja con datos que incluyen información de consentimiento según el TCF v2, ya que permite acceder a los datos de consentimiento y analizarlos en un formato estructurado.
## Sintaxis
```
consent_tcf_v2_decode(tcf_string)
```
## Argumentos
*tcf\$1string*
La cadena de consentimiento codificada del TCF v2.
## Devuelve
La `consent_tcf_v2_decode` función devuelve un diccionario que contiene los datos de consentimiento decodificados de una cadena de consentimiento del Marco de Transparencia y Consentimiento (TCF) v2.
El diccionario devuelto incluye los siguientes pares clave-valor:
**Segmento principal**
+ `version`: La versión de la especificación TCF utilizada (actualmente 2).
+ `created`: La fecha y la hora en que se creó la cadena de consentimiento.
+ `lastUpdated`: la fecha y la hora en que se actualizó por última vez la cadena de consentimiento.
+ `cmpId`: el ID de la plataforma de gestión del consentimiento (CMP) que codificó la cadena de consentimiento.
+ `cmpVersion`: la versión de la CMP que codificó la cadena de consentimiento.
+ `consentScreen`: el ID de la pantalla de la interfaz de usuario de la CMP en la que el usuario dio su consentimiento.
+ `consentLanguage`: El código de idioma de la información de consentimiento.
+ `vendorListVersion`: La versión de la lista de proveedores utilizada.
+ `tcfPolicyVersion`: La versión de la política del TCF en la que se basa la cadena de consentimiento.
+ `isServiceSpecific`: un valor booleano que indica si el consentimiento es específico de un servicio en particular o se aplica a todos los servicios.
+ `useNonStandardStacks`: un valor booleano que indica si se utilizan pilas no estándar.
+ `specialFeatureOptIns`: una lista de números enteros que representan las funciones especiales que el usuario ha elegido.
+ `purposeConsent`: una lista de números enteros que representan los fines para los que el usuario ha dado su consentimiento.
+ `purposesLITransparency`: una lista de números enteros que representan los fines para los que el usuario ha dado transparencia a sus intereses legítimos.
+ `purposeOneTreatment`: Un valor booleano que indica si el usuario ha solicitado el «tratamiento con un único propósito» (es decir, todos los fines se tratan por igual).
+ `publisherCountryCode`: el código de país del editor.
+ `vendorConsent`: una lista de proveedores a los IDs que el usuario ha dado su consentimiento.
+ `vendorLegitimateInterest`: una lista de proveedores IDs para los que se ha comunicado de forma transparente el interés legítimo del usuario.
+ `pubRestrictionEntry`: una lista de restricciones para editores. Este campo contiene el identificador de propósito, el tipo de restricción y la lista de proveedores IDs sujetos a esa restricción de propósito.
**Segmento de proveedores divulgado**
+ `disclosedVendors`: una lista de números enteros que representan los proveedores y que se ha revelado al usuario.
**Segmento de fines editoriales**
+ `pubPurposesConsent`: una lista de números enteros que representan los fines específicos del editor para los que el usuario ha dado su consentimiento.
+ `pubPurposesLITransparency`: una lista de números enteros que representan los fines específicos del editor para los que el usuario ha expresado su interés legítimo en la transparencia.
+ `customPurposesConsent`: una lista de números enteros que representan los fines personalizados para los que el usuario ha dado su consentimiento.
+ `customPurposesLITransparency`: una lista de números enteros que representan los fines personalizados para los que el usuario ha dado transparencia a sus intereses legítimos.
Estos datos detallados de consentimiento se pueden utilizar para comprender y respetar las preferencias de privacidad del usuario cuando trabaja con datos personales.
## Ejemplo
El siguiente ejemplo utiliza un único argumento, que es la cadena de consentimiento codificada. Devuelve un diccionario que contiene los datos de consentimiento decodificados, incluida información sobre las preferencias de privacidad del usuario, las opciones de consentimiento y otros metadatos.
```
from aws_clean_rooms.functions import consent_tcf_v2_decode
consent_string = "CO1234567890abcdef"
consent_data = consent_tcf_v2_decode(consent_string)
print(consent_data)
```
La estructura básica de los datos de consentimiento devueltos incluye información sobre la versión de la cadena de consentimiento, los detalles de la CMP (plataforma de gestión del consentimiento), las opciones de consentimiento e interés legítimo del usuario para los distintos fines y proveedores, y otros metadatos.
```
/** core segment **/
version: 2,
created: "2023-10-01T12:00:00Z",
lastUpdated: "2023-10-01T12:00:00Z",
cmpId: 1234,
cmpVersion: 5,
consentScreen: 1,
consentLanguage: "en",
vendorListVersion: 2,
tcfPolicyVersion: 2,
isServiceSpecific: false,
useNonStandardStacks: false,
specialFeatureOptIns: [1, 2, 3],
purposeConsent: [1, 2, 3],
purposesLITransparency: [1, 2, 3],
purposeOneTreatment: true,
publisherCountryCode: "US",
vendorConsent: [1, 2, 3],
vendorLegitimateInterest: [1, 2, 3],
pubRestrictionEntry: [
{ purpose: 1, restrictionType: 2, restrictionDescription: "Example restriction" },
],
/** disclosed vendor segment **/
disclosedVendors: [1, 2, 3],
/** publisher purposes segment **/
pubPurposesConsent: [1, 2, 3],
pubPurposesLITransparency: [1, 2, 3],
customPurposesConsent: [1, 2, 3],
customPurposesLITransparency: [1, 2, 3],
};
```