Introdução ao Real-time Customer Profile API

Usando os pontos de extremidade da API de perfil do cliente em tempo real, é possível executar operações básicas de CRUD em relação aos dados do perfil, como configurar atributos calculados, acessar entidades, exportar dados do perfil e excluir conjuntos de dados ou lotes desnecessários.

O uso do guia do desenvolvedor requer uma compreensão funcional dos vários serviços da Adobe Experience Platform envolvidos em trabalhar com a Profile dados. Antes de começar a trabalhar com a variável Real-time Customer Profile Consulte a documentação para obter os seguintes serviços:

Real-time Customer Profile: Fornece um perfil de cliente unificado em tempo real com base em dados agregados de várias fontes.
Adobe Experience Platform Identity Service: Obtenha uma melhor visão de seu cliente e de seu comportamento ao unir identidades em dispositivos e sistemas.
Adobe Experience Platform Segmentation Service: Permite criar segmentos de público-alvo a partir de dados do Perfil do cliente em tempo real.
Experience Data Model (XDM): A estrutura padronizada pela qual a Platform organiza os dados de experiência do cliente.
Sandboxes: Experience Platform fornece sandboxes virtuais que particionam uma única Platform em ambientes virtuais separados para ajudar a desenvolver aplicativos de experiência digital.

As seções a seguir fornecem informações adicionais que você precisará saber para fazer chamadas para o Profile Pontos de extremidade da API.

Lendo exemplos de chamadas de API

O Real-time Customer Profile A documentação da API fornece exemplos de chamadas de API para demonstrar como formatar corretamente as solicitações. Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O JSON de exemplo retornado nas respostas da API também é fornecido. Para obter informações sobre as convenções usadas na documentação para chamadas de API de exemplo, consulte a seção sobre como ler exemplos de chamadas de API no Experience Platform guia de solução de problemas.

Cabeçalhos obrigatórios

A documentação da API também requer que você tenha completado o tutorial de autenticação para fazer chamadas para Platform endpoints. A conclusão do tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em Experience Platform Chamadas de API, conforme mostrado abaixo:

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

Todos os recursos em Experience Platform são isoladas em sandboxes virtuais específicas. Solicitações para Platform As APIs exigem um cabeçalho que especifica o nome da sandbox em que a operação ocorrerá:

x-sandbox-name: {SANDBOX_NAME}

Para obter mais informações sobre sandboxes em Platform, consulte o documentação de visão geral da sandbox.

Todas as solicitações com uma carga no corpo da solicitação (como chamadas de POST, PUT e PATCH) devem incluir uma Content-Type cabeçalho. Os valores aceitos específicos para cada chamada são fornecidos nos parâmetros de chamada .