Ativar um conjunto de dados para Profile e Identity Service uso de APIs

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:

  1. Ativar um conjunto de dados para uso no Real-Time Customer Profile, usando uma das duas opções:
  2. Assimilar dados no conjunto de dados
  3. Confirmar assimilação de dados pelo Perfil do cliente em tempo real
  4. Confirmar assimilação de dados pelo Serviço de identidade

Introdução

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:

  • Real-Time Customer Profile: fornece um perfil de consumidor unificado em tempo real com base em dados agregados de várias fontes.
  • Identity Service: Habilita Real-Time Customer Profile unindo identidades de diferentes fontes de dados assimiladas na Platform.
  • Catalog Service: uma API RESTful que permite criar conjuntos de dados e configurá-los para Real-Time Customer Profile e Identity Service.
  • Experience Data Model (XDM): o quadro normalizado pelo qual Platform organiza os dados de experiência do cliente.

As seções a seguir fornecem as informações adicionais que você precisará saber para fazer chamadas com êxito para as APIs da plataforma.

Leitura de chamadas de API de amostra

Este tutorial fornece exemplos de chamadas de API para demonstrar como formatar suas solicitações. 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.

Coletar valores para cabeçalhos obrigatórios

Para fazer chamadas para Platform APIs, 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 todos os Experience Platform Chamadas de API, 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.

Criar um conjunto de dados habilitado para Perfil e Identidade

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.

OBSERVAÇÃO

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 '{
    "fields":[],
    "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 IMS. 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"
]

Configurar um conjunto de dados existente

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.

Verificar se o conjunto de dados está habilitado

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"
            ]
        },
        "lastBatchId": "6dcd9128a1c84e6aa5177641165e18e4",
        "lastBatchStatus": "success",
        "dule": {},
        "statsCache": {
            "startDate": null,
            "endDate": null
        },
        "namespace": "ACP",
        "state": "DRAFT",
        "version": "1.0.1",
        "created": 1536536917382,
        "updated": 1539793978215,
        "createdClient": "{CLIENT_CREATED}",
        "createdUser": "{CREATED_BY}",
        "updatedUser": "{CREATED_BY}",
        "viewId": "5b020a27e7040801dedbf46f",
        "status": "enabled",
        "transforms": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/transforms",
        "files": "@/dataSets/5b020a27e7040801dedbf46e/views/5b020a27e7040801dedbf46f/files",
        "schema": "@/xdms/context/experienceevent",
        "schemaMetadata": {
            "primaryKey": [],
            "delta": [],
            "dule": []
        },
        "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.

Ativar o conjunto de dados

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"
]

Assimilar dados no conjunto de dados

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:

  • Inclua todos os dados que deseja usar como critérios de segmentação.
  • Inclua quantos identificadores você puder verificar a partir dos dados do perfil para maximizar seu gráfico de identidade. Isso permite Identity Service para compilar identidades em conjuntos de dados com mais eficiência.

Confirmar assimilação de dados por Real-Time Customer Profile

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.

Confirmar assimilação de dados pelo Serviço de identidade

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.

Nesta página