Consents and Preferences grupo de campos

Consents and Preferences es un grupo de campos estándar para la XDM Individual Profile clase que captura la información de preferencias y consentimiento de un cliente individual.

Estructura del grupo de campos structure

El grupo de campos Consents and Preferences proporciona un único campo de tipo de objeto, consents, para capturar información de consentimiento y preferencia. Este campo amplía el tipo de datos Consent for Privacy, Personalization and Marketing Preferences ​, eliminando el campo adID y agregando un campo de asignación idSpecific.

El siguiente JSON muestra un ejemplo del tipo de datos que el grupo de campos Consents and Preferences puede procesar. Para obtener información sobre cómo usar la mayoría de los campos proporcionados por el grupo de campos, consulte la guía del tipo de datos Consentimientos y preferencias. Las subsecciones siguientes se centran en los atributos únicos que el grupo de campos añade al tipo de datos.

{
  "consents": {
    "collect": {
      "val": "VI"
    },
    "share": {
      "val": "y"
    },
    "personalize": {
      "content": {
        "val": "y"
      }
    },
    "marketing": {
      "preferred": "email",
      "any": {
        "val": "y"
      },
      "email": {
        "val": "y"
      }
    },
    "idSpecific": {
      "ECID": {
        "37784337855396895622558625508046772577": {
          "adID": {
            "val": "n",
          },
          "share": {
            "val": "n"
          },
          "marketing": {
            "push": {
              "val": "n",
              "time": "2020-09-30T01:02:33+00:00",
              "reason": "not relevant"
            }
          }
        }
      },
      "email": {
        "john@xyz.com": {
          "marketing": {
            "email": {
              "val": "y"
            }
          }
        }
      }
    },
    "metadata": {
      "time": "2019-01-01T15:52:25+00:00"
    }
  }
}

idSpecific

idSpecific se puede usar cuando un consentimiento o preferencia en particular no se aplica universalmente a un cliente, pero está restringido a un único dispositivo o ID. Por ejemplo, un cliente puede excluirse de la recepción de correos electrónicos en una dirección y permitir potencialmente que se envíen correos electrónicos en otra.

Cada clave del objeto idSpecific representa un área de nombres de identidad específica reconocida por el servicio de identidad de Adobe Experience Platform. Aunque puede definir sus propias áreas de nombres personalizadas para categorizar distintos identificadores, se recomienda utilizar una de las áreas de nombres estándar proporcionadas por el servicio de identidad para reducir los tamaños de almacenamiento de Perfil del cliente en tiempo real. Para obtener más información sobre áreas de nombres de identidad, consulte la descripción general del área de nombres de identidad en la documentación del servicio de identidad.

Las claves de cada objeto de área de nombres representan los valores de identidad únicos para los que el cliente ha establecido preferencias. Cada valor de identidad puede contener un conjunto completo de consentimientos y preferencias, con el formato consents.

"idSpecific": {
  "email": {
    "jdoe@example.com": {
      "marketing": {
        "email": {
          "val": "n"
        }
      }
    }
  },
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Dentro de los objetos marketing proporcionados en la sección idSpecific, no se admiten los campos any y preferred. Estos campos solo se pueden configurar en el nivel de usuario. Además, las preferencias de marketing de idSpecific para email, sms y push no admiten los campos de subscriptions.

También existe un consentimiento que solo se puede proporcionar en la sección idSpecific: adID. Este campo se trata en la subsección siguiente.

adID

El consentimiento de adID representa el consentimiento del cliente para saber si se puede usar un ID de anunciante (IDFA o GAID) para vincular al cliente entre aplicaciones en este dispositivo. Este valor sólo se puede configurar en el área de nombres de identidad ECID en la sección idSpecific, y no se puede establecer para otras áreas de nombres ni en el nivel de usuario para este grupo de campos.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}

Ingesta de datos mediante el grupo de campos ingest

Para utilizar el grupo de campos Consents and Preferences para la ingesta de datos de consentimiento de los clientes, debe crear un conjunto de datos basado en un esquema que contenga ese grupo de campos.

Consulte el tutorial de creación de un esquema en la interfaz de usuario para ver los pasos sobre cómo asignar grupos de campos a los campos. Una vez que haya creado un esquema que contiene un campo con el grupo de campos Consents and Preferences, consulte la sección sobre creación de un conjunto de datos en la guía del usuario del conjunto de datos, siguiendo los pasos para crear un conjunto de datos con un esquema existente.

Gestión de cambios de consentimiento y preferencia

Cuando un cliente cambia su consentimiento o preferencias en su sitio web, estos cambios deben recopilarse y aplicarse inmediatamente estableciendo el consentimiento en la biblioteca de recopilación de datos utilizada. Si un cliente se excluye de la recopilación de datos, toda la recopilación de datos debe interrumpirse inmediatamente. Si un cliente se excluye de la personalización, no debe haber ninguna personalización presente en la siguiente página que cargue. Vea a setConsent usando la biblioteca JavaScript o la acción Set consent usando la extensión de etiquetas de Web SDK.

Próximos pasos

Este documento cubre la estructura y el uso del grupo de campos Consents and Preferences. Para obtener más información sobre los demás campos proporcionados por el grupo de campos, consulte el documento sobre el tipo de datos Consent for Privacy, Personalization and Marketing Preferences.