Introdução ao Real-Time Customer Profile API

Usando endpoints da API de perfil do cliente em tempo real, você pode executar operações CRUD básicas 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 no trabalho com o Profile dados. Antes de começar a trabalhar com o Real-Time Customer Profile , consulte a documentação dos 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 visualização do cliente e do comportamento dele ao unir as identidades de vários dispositivos e sistemas.
Adobe Experience Platform Segmentation Service: permite criar segmentos de público-alvo a partir dos 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 O 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 com êxito para o Profile Endpoints de API.

Leitura de chamadas de API de amostra

A variável Real-Time Customer Profile A documentação da API fornece exemplos de chamadas de API para demonstrar como formatar solicitações corretamente. Isso inclui caminhos, cabeçalhos necessários e cargas de solicitação formatadas corretamente. O exemplo de JSON 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 chamadas de API de exemplo no Experience Platform guia de solução de problemas.

Cabeçalhos obrigatórios

A documentação da API também exige que você tenha concluído a tutorial de autenticação para fazer chamadas com êxito para o Platform pontos finais. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários no 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 isolados em sandboxes virtuais específicas. Solicitações para Platform As APIs exigem um cabeçalho que especifique o nome da sandbox em que a operação ocorrerá:

x-sandbox-name: {SANDBOX_NAME}

Para obter mais informações sobre sandboxes no 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 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.