Grupo de campos Consentimentos e Preferências

Consentimentos e Preferências é um grupo de campos padrão para a XDM Individual Profile classe que captura informações de consentimento e preferência de um cliente individual.

NOTE
Como este grupo de campos é compatível somente com XDM Individual Profile, ele não pode ser usado para esquemas XDM ExperienceEvent. Se quiser incluir dados de consentimento e preferência no esquema do Evento de experiência, adicione o Tipo de dados de Consentimento para privacidade, Personalization e Preferências de marketing ao esquema usando um grupo de campos personalizado.

Estrutura do grupo de campos structure

O grupo de campos Consentimentos e Preferências fornece um único campo de tipo de objeto, consents, para capturar informações de consentimento e preferência. Este campo estende o tipo de dados 🔗 Consentimento para Privacidade, Personalization e Preferências de Marketing, removendo o campo adID e adicionando um campo de mapa idSpecific.

TIP
Consulte o guia em explorando recursos XDM para obter etapas sobre como pesquisar qualquer recurso XDM e inspecionar sua estrutura na interface do usuário da plataforma.

O JSON a seguir mostra um exemplo do tipo de dados que o grupo de campos Consentimentos e Preferências pode processar. Para obter informações sobre como usar a maioria dos campos fornecidos pelo grupo de campos, consulte o manual no tipo de dados Consentimentos e Preferências. As subseções abaixo se concentram nos atributos exclusivos que o grupo de campos adiciona ao tipo de dados.

{
  "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"
    }
  }
}
TIP
Você pode gerar dados JSON de amostra para qualquer esquema XDM definido no Experience Platform para ajudar a visualizar como os dados de consentimento e preferência do cliente devem ser mapeados. Consulte a documentação a seguir para obter mais informações:

idSpecific

idSpecific pode ser usado quando um determinado consentimento ou preferência não se aplica universalmente a um cliente, mas está restrito a um único dispositivo ou ID. Por exemplo, um cliente pode recusar o recebimento de emails para um endereço, enquanto possivelmente permite emails em outro.

IMPORTANT
Os consentimentos e preferências no nível do canal (ou seja, aqueles fornecidos em consents fora de idSpecific) se aplicam a todas as IDs nesse canal. Portanto, todos os consentimentos e preferências no nível do canal têm efeito direto se as configurações equivalentes específicas de ID ou dispositivo são respeitadas:
  • Se o cliente optou por não participar no nível do canal, quaisquer consentimentos ou preferências equivalentes em idSpecific serão ignorados.
  • Se o consentimento ou a preferência no nível do canal não estiver definido, ou se o cliente tiver optado, os consentimentos ou as preferências equivalentes em idSpecific serão honrados.

Cada chave no objeto idSpecific representa um namespace de identidade específico reconhecido pelo Adobe Experience Platform Identity Service. Embora você possa definir seus próprios namespaces personalizados para categorizar identificadores diferentes, é recomendável usar um dos namespaces padrão fornecidos pelo Serviço de identidade para reduzir os tamanhos de armazenamento do Perfil do cliente em tempo real. Para obter mais informações sobre namespaces de identidade, consulte a visão geral sobre namespaces de identidade na documentação do Serviço de Identidade.

As chaves para cada objeto de namespace representam os valores de identidade exclusivos para os quais o cliente definiu preferências. Cada valor de identidade pode conter um conjunto completo de consentimentos e preferências, formatados da mesma forma que consents.

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

Dentro de marketing objetos fornecidos na seção idSpecific, os campos any e preferred não têm suporte. Esses campos só podem ser configurados no nível do usuário. Além disso, as preferências de marketing do idSpecific para email, sms e push não oferecem suporte para campos subscriptions.

Também há um consentimento que só pode ser fornecido na seção idSpecific: adID. Esse campo é abordado na subseção abaixo.

adID

O consentimento de adID representa o consentimento do cliente para que uma ID de anunciante (IDFA ou GAID) possa ser usada para vincular o cliente em aplicativos neste dispositivo. Este valor só pode ser configurado no namespace de identidade ECID na seção idSpecific e não pode ser definido para outros namespaces ou no nível de usuário para este grupo de campos.

"idSpecific": {
  "ECID": {
    "37784337855396895622558625508046772577": {
      "collect": {
        "val": "y"
      },
      "adID": {
        "val": "n"
      },
      "marketing": {
        "push": {
          "val": "n"
        }
      }
    }
  }
}
NOTE
Não é esperado que você defina esse valor diretamente, já que o SDK do Adobe Experience Platform Mobile o define automaticamente quando apropriado.

Assimilar dados usando o grupo de campos ingest

Para usar o grupo de campos Consentimentos e Preferências para assimilar dados de consentimento de seus clientes, você deve criar um conjunto de dados com base em um esquema que contenha esse grupo de campos.

Consulte o tutorial sobre criação de um esquema na interface para ver etapas sobre como atribuir grupos de campos a campos. Depois de criar um esquema contendo um campo com o grupo de campos Consentimentos e Preferências, consulte a seção sobre criação de um conjunto de dados no guia do usuário do conjunto de dados, seguindo as etapas para criar um conjunto de dados com um esquema existente.

IMPORTANT
Para enviar dados de consentimento para Real-Time Customer Profile, é necessário criar um esquema habilitado para Profile com base na classe XDM Individual Profile que contenha o grupo de campos Consentimentos e Preferências. O conjunto de dados criado com base nesse esquema também deve ser habilitado para Profile. Consulte os tutoriais vinculados acima para obter etapas específicas relacionadas aos requisitos de Real-Time Customer Profile para esquemas e conjuntos de dados.
Além disso, você também deve garantir que suas políticas de mesclagem sejam configuradas para priorizar os conjuntos de dados que contêm os dados de consentimento e preferência mais recentes, para que os perfis do cliente sejam atualizados corretamente. Consulte a visão geral em políticas de mesclagem para obter mais informações.

Lidar com alterações de consentimento e preferência

Quando um cliente altera seus consentimentos ou preferências no site, essas alterações devem ser coletadas e imediatamente aplicadas usando o Adobe Experience Platform Web SDK. Se um cliente recusar a coleta de dados, toda a coleta de dados deverá ser interrompida imediatamente. Se um cliente optar por não ser personalizado, não deverá haver personalização na próxima página que visitar.

Próximas etapas

Este documento abordou a estrutura e o uso do grupo de campos Consentimentos e Preferências. Para obter mais informações sobre os outros campos fornecidos pelo grupo de campos, consulte o documento sobre o Tipo de dados Consentimento para Privacidade, Personalization e Preferências de Marketing.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07