Real-Time Customer Profile Manual da API

O Real-Time Customer Profile permite que você veja uma visão holística de cada cliente individual dentro da Adobe Experience Platform. O Profile permite consolidar dados diferentes do cliente de vários canais, como dados online, offline, CRM e de terceiros, em uma exibição unificada, oferecendo uma conta acionável com carimbo de data e hora de cada interação com o cliente.

A API Real-Time Customer Profile inclui vários endpoints, descritos abaixo. Visite os manuais de endpoint individuais para obter detalhes e consulte o guia de introdução para obter informações importantes sobre cabeçalhos necessários, como ler chamadas de API de exemplo e muito mais.

Para exibir todos os pontos de extremidade e operações CRUD disponíveis, visite o swagger de Referência da API de perfil do cliente em tempo real.

Para obter um guia para trabalhar com dados do Real-Time Customer Profile na interface do usuário do Experience Platform, consulte o Guia do usuário do perfil.

[Beta]{class="badge informative"} atributos computados computed-attributes

Os atributos computados são funções usadas para agregar dados no nível do evento em atributos no nível do perfil. Essas funções são computadas automaticamente para que possam ser usadas na segmentação, ativação e personalização.

Cada atributo calculado contém uma expressão, ou "regra", que avalia os dados recebidos e armazena o valor resultante em um atributo de perfil. Esses cálculos ajudam a responder facilmente a perguntas relacionadas a coisas como valor de compra vitalício, tempo entre compras ou número de aberturas de aplicativo, sem exigir que você realize cálculos complexos manualmente sempre que as informações forem necessárias. Esses valores de atributos calculados podem ser exibidos em um perfil, usados para criar um público ou acessados por meio de vários padrões de acesso diferentes.

Você pode criar, exibir, editar e excluir atributos computados usando o ponto de extremidade ca/attributes/. Para saber como usar atributos computados, consulte a visão geral sobre atributos computados. Para operações de API, visite o manual de ponto de extremidade de API de atributos computados.

Entidades (acesso Profile) entities

Por meio do Adobe Experience Platform, você pode acessar dados do Real-Time Customer Profile usando APIs RESTful ou a interface do usuário. Para saber como acessar entidades, mais comumente conhecidas como "perfis", usando a API, siga as etapas descritas no manual de endpoint de entidades. Para acessar perfis usando a interface do usuário Platform, consulte o Guia do usuário do perfil.

Exportar trabalhos (Profile exportação) profile-export

Os dados do Real-Time Customer Profile podem ser exportados para um conjunto de dados para processamento adicional, como a exportação de públicos para ativação ou atributos de perfil para relatórios. Os trabalhos de exportação para públicos-alvo fazem parte da API Adobe Experience Platform Segmentation Service. Leia o manual de ponto de extremidade de trabalhos de exportação de segmentação para saber mais. Para obter instruções passo a passo sobre como criar e gerenciar trabalhos de exportação para atributos de perfil, visite o manual do ponto de extremidade de trabalhos de exportação.

Políticas de mesclagem merge-policies

Ao reunir dados de várias fontes no Experience Platform, as políticas de mesclagem são as regras que o Platform usa para determinar como os dados serão priorizados e quais dados serão combinados para criar perfis de clientes individuais. Usando a API Real-Time Customer Profile, você pode criar novas políticas de mesclagem, gerenciar políticas existentes e definir uma política de mesclagem padrão para sua organização. Para trabalhar com políticas de mesclagem usando a API, visite o manual de ponto de extremidade de políticas de mesclagem.

Para saber mais sobre as políticas de mesclagem e sua função na Platform, comece lendo a visão geral das políticas de mesclagem.

Visualizar status da amostra (Profile visualização) profile-preview

À medida que os dados são assimilados na Platform, um trabalho de amostra é executado para atualizar a contagem de perfis e outras métricas relacionadas aos dados do Perfil do cliente em tempo real. Os resultados deste trabalho de amostra podem ser exibidos usando o ponto de extremidade /previewsamplestatus, parte da API de Perfil do Cliente em Tempo Real. Esse endpoint também pode ser usado para listar distribuições de perfil por conjunto de dados e namespace de identidade, bem como para gerar vários relatórios para obter visibilidade sobre a composição do armazenamento de perfis de sua organização. Para começar a usar o ponto de extremidade /profilepreviewstatus, consulte o manual do ponto de extremidade do status da amostra de visualização.

Trabalhos do sistema de perfil profile-system-jobs

Os dados habilitados para perfil assimilados em Platform são armazenados em Data Lake e no repositório de dados Real-Time Customer Profile. Ocasionalmente, pode ser necessário excluir dados de perfil associados a um conjunto de dados do armazenamento de Perfil para remover dados que não são mais necessários ou foram adicionados por engano. Isso requer o uso da API para criar um Profile System Job, também conhecido como "delete request", que pode ser modificado, monitorado ou excluído, se necessário. Para saber como trabalhar com solicitações de exclusão usando o ponto de extremidade /system/jobs na API Real-Time Customer Profile, siga as etapas descritas no guia de ponto de extremidade de trabalhos do sistema de perfil.

Atualizar atributos de perfis update-profile

Ocasionalmente, pode ser necessário atualizar os dados no armazenamento de perfil de sua organização. Por exemplo, talvez seja necessário corrigir registros ou alterar um valor de atributo. Isso pode ser feito por meio da assimilação em lote e requer um conjunto de dados habilitado para perfil configurado com uma tag upsert. Para obter mais informações sobre como configurar um conjunto de dados para atualizações de atributo, consulte o tutorial para habilitar um conjunto de dados para Perfil e substituição.

Próximas etapas next-steps

Para começar a fazer chamadas usando a API Real-Time Customer Profile, leia o guia de introdução e selecione um dos manuais de endpoint para saber como usar endpoints específicos relacionados ao Profile. Para trabalhar com os dados do Profile usando a interface do usuário do Experience Platform, consulte o Guia do usuário do Perfil do cliente em tempo real.