Show Menu
TÓPICOS×

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 questões e solução de problemas relacionados a outros serviços no Adobe Experience Platform, consulte o guia de solução de problemas do Experience Platform.
O Perfil de cliente em tempo real é um repositório de entidade de pesquisa genérico que reúne dados de vários ativos de dados corporativos e, em seguida, fornece acesso a esses dados na forma de perfis individuais de clientes e eventos de séries de tempo relacionados. Esse recurso permite que os profissionais de marketing conduzam experiências coordenadas, consistentes e relevantes com suas audiências 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 dados de registro e de série ​cronológica, desde que os dados em questão contenham pelo menos um valor de identidade que associe os dados a uma pessoa individual única.
Como todos os serviços da Platform, o Perfil exige que seus dados sejam estruturados semanticamente em um schema do Modelo de Dados de Experiência (XDM). Por sua vez, esse schema deve ter uma identidade ​primária definida e estar habilitado para uso no Perfil.
Se você não estiver familiarizado com o XDM, start com a 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 schema 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 "repositório de Perfis"), separado do Data Lake que contém outros dados Platform assimilados.

Se eu já ingerir dados na Platform, posso disponibilizá-los na Perfil store?

Se os dados tiverem sido ingeridos em um conjunto de dados que não seja de Perfil, você deverá assimilá-los novamente em um conjunto de dados habilitado para Perfil para disponibilizá-los no repositório de Perfis. É possível habilitar um conjunto de dados existente para o Perfil, no entanto, quaisquer dados que foram ingeridos antes dessa configuração ainda não aparecerão no repositório de Perfis.
Se desejar adicionar dados ingeridos anteriormente ao armazenamento de Perfis, siga o 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, ingresse novamente os dados desejados nesse conjunto de dados.

Como posso visualização meus dados de Perfil ingeridos?

Existem 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 o terminal /entities (acesso ao Perfil) na API do Perfil para procurar essas entidades. Consulte a seção sobre entidades no guia do desenvolvedor para obter mais informações.
Você também pode usar a API de serviço de segmentação de Adobe Experience Platform para acessar os perfis individuais dos clientes que se qualificaram para uma associação de segmento. See the Segmentation Service overview for more information.

Uso da interface

Na interface do Experience Platform, a guia Procurar na área de trabalho de Perfis permite que você visualização a contagem total de perfis e procure perfis individuais pelo valor de identidade. Consulte o guia do usuário do Perfil para obter mais informações.
Você também pode visualização uma lista dos segmentos na guia Procurar na área de trabalho Segmentos . Depois de selecionar um segmento, uma amostra de perfis qualificados para esse segmento é exibida. Você pode selecionar qualquer um desses perfis listados para visualização de seus detalhes. See the Segmentation UI overview for more information.

Códigos de erro

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

Não foi possível pesquisar o schema do atributo calculado 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 conseguiu localizar o schema fornecido na carga da solicitação. Verifique se você forneceu a ID de locatário correta na propriedade da carga e se os valores de path schema.name é um nome de schema válido.
Se você não souber sua ID de locatário, poderá recuperá-la seguindo as etapas no guia do desenvolvedor do Registro de Schemas.

A função com o mesmo nome já existe para o schema 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 a name propriedade fornecida já está sendo usada para o schema indicado em schema.name . Substitua o valor por um nome exclusivo antes de tentar novamente.

O schema de retorno da expressão não é igual ao schema do atributo calculado no schema 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 a name propriedade fornecida já está sendo usada para o schema 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 do 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 fornecer uma ID de conjunto de dados ou lote válida sob a propriedade da carga dataSetID ou batchID , respectivamente. Consulte a seção sobre como criar uma solicitação de exclusão no guia do desenvolvedor do Perfil para obter mais informações.

Lote não encontrado para conjunto de dados de perfil

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

Este erro ocorre quando não é possível localizar um lote válido 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 Perfis antes de tentar novamente.

O destino da projeção ainda não foi criado

{
  "status":404,
  "title":"The projection destination has not yet been created.",
  "type":"http://ns.adobe.com/adobecloud/problem/missing-entity"
}

Este erro ocorre quando o destinationId fornecido em uma POST /config/projections solicitação é inválido. Verifique se você forneceu uma ID de destino válida antes de tentar novamente. Para criar um novo destino, siga as etapas descritas no guia do desenvolvedor do Perfil.

Tipo de mídia não suportado

{
  "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 terminal que está usando.
A maioria dos pontos de extremidade do Perfil aceita "application/json" para seu cabeçalho Content-Type, com as seguintes exceções:
Ponto final
Tipo de conteúdo
/config/projections
application/vnd.adobe.platform.projectionConfig+json; version=1
/config/destinations
application/vnd.adobe.platform.projectionDestination+json; version=1