Guia de solução de problemas do Perfil do cliente em tempo real

Este documento fornece respostas a perguntas frequentes sobre o Perfil do cliente em tempo real, bem como um guia de solução de problemas para erros comuns. Para perguntas e soluções de problemas relacionados a outros serviços na Adobe Experience Platform, consulte o guia de solução de problemas do Experience Platform.

Com Real-Time Customer ProfileNo entanto, você pode ter uma visão holística de cada cliente individual ao combinar dados de vários canais, incluindo online, offline, CRM e de terceiros. Isso permite que os profissionais de marketing promovam experiências coordenadas, consistentes e relevantes para clientes em vários canais.

Perguntas frequentes

Veja a seguir uma lista de respostas para perguntas frequentes sobre o Perfil do cliente em tempo real.

Que tipos de dados são aceitos para o Perfil do cliente em tempo real?

O perfil aceita ambos gravar e série temporal dados, desde que os dados em questão contenham pelo menos um valor de identidade que associe os dados a uma única pessoa.

Como todos os serviços da plataforma, o Perfil exige que seus dados sejam semanticamente estruturados em um esquema do Experience Data Model (XDM). Por sua vez, esse esquema deve ter um identidade principal definido e ser ativado para uso no Perfil.

Se você não estiver familiarizado com o XDM, comece com o Visão geral do XDM para saber mais. Em seguida, consulte o guia do usuário XDM para obter etapas sobre como definir campos de identidade e ativar um esquema para o Perfil.

Onde os dados do perfil são armazenados?

O Perfil do cliente em tempo real mantém seu próprio armazenamento de dados (conhecido como "Armazenamento de perfis"), separado do Data Lake que contém outros dados assimilados da Platform.

Se já assimilei dados na Platform, posso disponibilizá-los na loja de perfis?

Se os dados tiverem sido assimilados em um conjunto de dados que não seja de Perfil, você deverá assimilá-los novamente em um conjunto de dados habilitado para torná-lo disponível no armazenamento de Perfil. É possível habilitar um conjunto de dados existente para o Perfil, no entanto, os dados assimilados antes dessa configuração ainda não aparecerão no armazenamento do Perfil.

Se quiser adicionar dados assimilados anteriormente ao armazenamento de Perfis, siga as tutorial de configuração do conjunto de dados para criar um novo conjunto de dados ou converter um conjunto de dados existente para ser ativado para o Perfil e, em seguida, assimilar novamente os dados desejados nesse conjunto de dados.

Como posso exibir meus dados de perfil assimilados?

Há vários métodos de exibição de Dados de perfil, dependendo se você está usando a API ou a interface do usuário.

Uso da API

Se você souber as IDs das entidades de Perfil que deseja acessar, poderá usar a variável /entities (Acesso ao perfil) na API do perfil para pesquisar essas entidades. Consulte a seção sobre entidades no guia do desenvolvedor para obter mais informações.

Você também pode usar a API do Serviço de segmentação do Adobe Experience Platform para acessar perfis individuais de clientes que se qualificaram para uma associação de público-alvo. Consulte a Visão geral do serviço de segmentação para obter mais informações.

Uso da interface

Na interface do Experience Platform, a variável Procurar na guia Perfis o workspace permite exibir a contagem total de perfis e pesquisar perfis individuais pelo valor de identidade. Consulte a Guia do usuário do perfil para obter mais informações.

Você também pode exibir uma lista de públicos-alvo na Procurar na guia Públicos-alvo espaço de trabalho. Após selecionar um público-alvo, uma amostra de perfis qualificados para esse público-alvo é exibida. Em seguida, você pode selecionar qualquer um desses perfis listados para exibir seus detalhes. Consulte a Visão geral da interface de segmentação para obter mais informações.

Códigos de erro

Veja a seguir uma lista de mensagens de erro que você pode encontrar ao trabalhar com a API de perfil do cliente em tempo real. Se o erro encontrado não estiver listado aqui, você pode encontrá-lo no modo geral Guia de solução de problemas da Platform em vez disso.

Não foi possível pesquisar o esquema do atributo computado para o caminho fornecido

{
  "code": "400",
  "message": "Could not lookup schema of the computed attribute for the provided path"
}

Ao criar um novo atributo calculado, esse erro ocorre quando o sistema não pôde encontrar o esquema fornecido na carga da solicitação. Verifique se você forneceu a ID de locatário correta na path propriedade e que os valores de schema.name é um nome de esquema válido.

Se você não souber sua ID de locatário, poderá recuperá-la seguindo as etapas da seção Guia do desenvolvedor do Registro de esquema.

Já existe uma função com o mesmo nome para o esquema especificado ou definedOn

{
  "code": "400",
  "message": "Function with the same name already exists for the specified schema or definedOn"
}

Ao criar um novo atributo calculado, esse erro ocorre quando o atributo fornecido name A propriedade já está sendo usada para o esquema indicado em schema.name. Substitua o valor por um nome exclusivo antes de tentar novamente.

O esquema de retorno da expressão não é igual ao esquema do atributo calculado no esquema XDM

{
  "code": "400",
  "message": "Return schema of the expression is not same as the schema of the computed attribute in the XDM schema"
}

Ao criar um novo atributo calculado, esse erro ocorre quando o atributo fornecido name A propriedade já está sendo usada para o esquema indicado em schema.name. Substitua o valor por um nome exclusivo antes de tentar novamente.

Solicitação de exclusão inválida (Trabalho do Sistema de Perfil)

{
  "code": "400",
  "message": "Invalid delete request (Profile System Job)"
}

Esse erro ocorre quando uma carga inválida é fornecida para um trabalho de exclusão do sistema. Certifique-se de que você esteja fornecendo um conjunto de dados ou ID de lote válido no dataSetID ou batchID propriedade, respectivamente. Consulte a seção sobre criar uma solicitação de exclusão no guia do desenvolvedor de perfis para obter mais informações.

Lote não encontrado para o conjunto de dados do perfil

{
  "requestId":"LlTmQkhgHKFGHGHnIkmUxcIL4YTFSpQw",
  "errors":{
    "400":[
      {
        "code":"400",
        "message":"Batch not found for profile dataset '5da688d2c4e60518ad25b7b1'"
      }
    ]
  }
}

Esse erro ocorre quando um lote válido não pode ser encontrado ao tentar criar uma solicitação de exclusão para dados de perfil. Verifique se você inseriu a ID correta para um conjunto de dados habilitado para perfil antes de tentar novamente.

Tipo de mídia incompatível

{
  "status": 415,
  "title": "HTTP 415 Unsupported Media Type",
  "type": "http://ns.adobe.com/adobecloud/problem/unsupported-media-type"
}

Esse erro ocorre ao enviar uma solicitação POST ou PUT com um cabeçalho Content-Type inválido. Verifique se você está fornecendo um valor Content-Type válido para o endpoint que está usando.

A maioria dos endpoints de perfil aceita "application/json" para o cabeçalho Content-Type, com as seguintes exceções:

Endpoint
Tipo de conteúdo
/config/projections
application/vnd.adobe.platform.projectionConfig+json; version=1
/config/destinations
application/vnd.adobe.platform.projectionDestination+json; version=1
recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b