Este tutorial aborda o processo de habilitação de um conjunto de dados para uso no Real-Time Customer Profile e Identity Service, divididos nas seguintes etapas:
Este tutorial requer uma compreensão funcional de vários serviços da Adobe Experience Platform envolvidos no gerenciamento de conjuntos de dados habilitados para perfis. Antes de iniciar este tutorial, revise a documentação desses Platform serviços:
As seções a seguir fornecem as informações adicionais que você precisará saber para fazer chamadas com êxito para as APIs da plataforma.
Este tutorial fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. Isso inclui caminhos, cabeçalhos necessários e conteúdos de solicitação formatados corretamente. Também fornece exemplos de JSON retornado nas respostas da API. 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 manual de solução de problemas da Experience Platform.
Para fazer chamadas para APIs da Platform, primeiro conclua o tutorial de autenticação. Concluir o tutorial de autenticação fornece os valores para cada um dos cabeçalhos necessários em todas as chamadas de API da Experience Platform, conforme mostrado abaixo:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Todas as solicitações que contêm uma carga (POST, PUT, PATCH) exigem uma Content-Type
cabeçalho. O valor correto desse cabeçalho é mostrado nas solicitações de exemplo, quando necessário.
Todos os recursos em Experience Platform são isolados em sandboxes virtuais específicas. Todas as solicitações para Platform As APIs exigem uma x-sandbox-name
cabeçalho que especifica o nome da sandbox em que a operação ocorrerá. Para obter mais informações sobre sandboxes no Platform, consulte o documentação de visão geral da sandbox.
Você pode ativar um conjunto de dados para o Perfil do cliente em tempo real e o Serviço de identidade imediatamente após a criação ou em qualquer momento após a criação do conjunto de dados. Se quiser ativar um conjunto de dados que já foi criado, siga as etapas para configurar um conjunto de dados existente encontrado mais adiante neste documento.
Para criar um novo conjunto de dados habilitado para perfil, você deve saber a ID de um esquema XDM existente que está habilitado para o Perfil. Para obter informações sobre como pesquisar ou criar um esquema habilitado para perfil, consulte o tutorial em criação de um esquema usando a API do registro de esquema.
Para criar um conjunto de dados habilitado para o Perfil, você pode usar uma solicitação POST para /dataSets
terminal.
Formato da API
POST /dataSets
Solicitação
Ao incluir unifiedProfile
e unifiedIdentity
em tags
no corpo da solicitação, o conjunto de dados será ativado imediatamente para Profile e Identity Service, respectivamente. Os valores dessas tags devem ser uma matriz contendo a string "enabled:true"
.
curl -X POST \
https://platform.adobe.io/data/foundation/catalog/dataSets \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '{
"schemaRef": {
"id": "https://ns.adobe.com/{TENANT_ID}/schemas/31670881463308a46f7d2cb09762715",
"contentType": "application/vnd.adobe.xed-full-notext+json; version=1"
},
"tags": {
"unifiedProfile": ["enabled:true"],
"unifiedIdentity": ["enabled:true"]
}
}'
Propriedade | Descrição |
---|---|
schemaRef.id |
A ID do ProfileEsquema habilitado para o qual o conjunto de dados será baseado. |
{TENANT_ID} |
O namespace dentro do Schema Registry que contém recursos pertencentes à sua organização. Consulte a TENANT_ID seção do Schema Registry guia do desenvolvedor para obter mais informações. |
Resposta
Uma resposta bem-sucedida mostra uma matriz que contém a ID do conjunto de dados recém-criado na forma de "@/dataSets/{DATASET_ID}"
. Depois de criar e habilitar um conjunto de dados com sucesso, prossiga para as etapas para upload de dados.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
As etapas a seguir abordam como ativar um conjunto de dados criado anteriormente para o Real-Time Customer Profile e Identity Service. Se você já criou um conjunto de dados habilitado para o perfil, prossiga para as etapas para assimilação de dados.
Usar o Catalog , você pode inspecionar um conjunto de dados existente para determinar se ele está ativado para uso no Real-Time Customer Profile e Identity Service. A chamada a seguir recupera os detalhes de um conjunto de dados por ID.
Formato da API
GET /dataSets/{DATASET_ID}
Parâmetro | Descrição |
---|---|
{DATASET_ID} |
A ID de um conjunto de dados que você deseja inspecionar. |
Solicitação
curl -X GET \
'https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Resposta
{
"5b020a27e7040801dedbf46e": {
"name": "Commission Program Events DataSet",
"imsOrg": "{ORG_ID}",
"tags": {
"adobe/pqs/table": [
"unifiedprofileingestiontesteventsdataset"
],
"unifiedProfile": [
"enabled:true"
],
"unifiedIdentity": [
"enabled:true"
]
},
"version": "1.0.1",
"created": 1536536917382,
"updated": 1539793978215,
"createdClient": "{CLIENT_CREATED}",
"createdUser": "{CREATED_BY}",
"updatedUser": "{CREATED_BY}",
"viewId": "5b020a27e7040801dedbf46f",
"files": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/files",
"schema": "@/xdms/context/experienceevent",
"schemaRef": {
"id": "https://ns.adobe.com/xdm/context/experienceevent",
"contentType": "application/vnd.adobe.xed+json"
}
}
}
No tags
propriedade, você pode ver que unifiedProfile
e unifiedIdentity
ambos estão presentes com o valor enabled:true
. Por conseguinte, Real-Time Customer Profile e Identity Service são habilitados para este conjunto de dados, respectivamente.
Se o conjunto de dados existente não tiver sido habilitado para Profile ou Identity Service, você pode ativá-lo fazendo uma solicitação PATCH usando a ID do conjunto de dados.
Formato da API
PATCH /dataSets/{DATASET_ID}
Parâmetro | Descrição |
---|---|
{DATASET_ID} |
A ID de um conjunto de dados que você deseja atualizar. |
Solicitação
curl -X PATCH \
https://platform.adobe.io/data/foundation/catalog/dataSets/5b020a27e7040801dedbf46e \
-H 'Content-Type:application/json-patch+json' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-d '[
{ "op": "add", "path": "/tags/unifiedProfile", "value": ["enabled:true"] },
{ "op": "add", "path": "/tags/unifiedIdentity", "value": ["enabled:true"] }
]'
O corpo da solicitação inclui uma path
para dois tipos de tags, unifiedProfile
e unifiedIdentity
. A variável value
de cada são matrizes que contêm a sequência enabled:true
.
Resposta
Uma solicitação PATCH bem-sucedida retorna o Status HTTP 200 (OK) e uma matriz contendo a ID do conjunto de dados atualizado. Essa ID deve corresponder à enviada na solicitação PATCH. A variável unifiedProfile
e unifiedIdentity
As tags foram adicionadas e o conjunto de dados está habilitado para uso pelos serviços de Perfil e Identidade.
[
"@/dataSets/5b020a27e7040801dedbf46e"
]
Ambos Real-Time Customer Profile e Identity Service consumir dados XDM enquanto estão sendo assimilados em um conjunto de dados. Para obter instruções sobre como fazer upload de dados em um conjunto de dados, consulte o tutorial sobre criação de um conjunto de dados usando APIs. Ao planejar quais dados enviar para o seu Profileconjunto de dados habilitado para, considere as seguintes práticas recomendadas:
Ao fazer upload de dados para um novo conjunto de dados pela primeira vez ou como parte de um processo que envolve um novo ETL ou fonte de dados, é recomendável verificar cuidadosamente os dados para garantir que tenham sido carregados conforme esperado. Usar o Real-Time Customer Profile Acessar a API, é possível recuperar dados em lote à medida que são carregados em um conjunto de dados. Se não conseguir recuperar nenhuma das entidades esperadas, o conjunto de dados pode não estar habilitado para Real-Time Customer Profile. Depois de confirmar que o conjunto de dados foi ativado, verifique se o formato de dados de origem e os identificadores atendem às suas expectativas. Para obter instruções detalhadas sobre como usar a variável Real-Time Customer Profile API para acessar o Profile consulte os manual de endpoint de entidades, também conhecido como "Profile Access"API.
Cada fragmento de dados assimilado que contém mais de uma identidade cria um link em seu gráfico de identidade privado. Para obter mais informações sobre gráficos de identidade e acessar dados de identidade, comece lendo o Visão geral do serviço de identidade.