Gerar o relatório de sobreposição do conjunto de dados

O relatório de sobreposição do conjunto de dados oferece visibilidade da composição do Profile armazene expondo os conjuntos de dados que mais contribuem para seu público-alvo endereçável (perfis).

Além de fornecer insights sobre seus dados, esse relatório pode ajudá-lo a tomar medidas para otimizar o uso da sua licença, como definir um limite para a duração de determinados dados.

Este tutorial descreve as etapas necessárias para gerar o relatório de sobreposição do conjunto de dados usando o Real-Time Customer Profile e interprete os resultados para sua organização.

Introdução

Para usar as APIs do Adobe Experience Platform, primeiro complete o tutorial de autenticação para coletar os valores necessários para os cabeçalhos obrigatórios. Para saber mais sobre as APIs Experience Platform, consulte o introdução à documentação das APIs da Platform.

Os cabeçalhos necessários para todas as chamadas de API neste tutorial são:

  • Authorization: Bearer {ACCESS_TOKEN}: A variável Authorization o cabeçalho requer um token de acesso precedido pela palavra Bearer. Um novo valor de token de acesso deve ser gerado a cada 24 horas.
  • x-api-key: {API_KEY}: A variável API Key também é conhecido como Client ID e é um valor que só precisa ser gerado uma vez.
  • x-gw-ims-org-id: {ORG_ID}: a ID da organização só precisa ser gerada uma vez.

Depois de concluir o tutorial de autenticação e coletar os valores dos cabeçalhos necessários, você estará pronto para começar a fazer chamadas para a API do cliente em tempo real.

Gerar relatório de sobreposição do conjunto de dados usando a linha de comando

Se você estiver familiarizado com o uso da linha de comando, poderá usar a seguinte solicitação de cURL para gerar o relatório de sobreposição do conjunto de dados executando uma solicitação GET para /previewsamplestatus/report/dataset/overlap.

Solicitação

A solicitação a seguir usa o date para retornar o relatório mais recente para a data especificada.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
Parâmetro Descrição
date Especifique a data do relatório a ser retornado. Se vários relatórios tiverem sido executados na data, o relatório mais recente dessa data será retornado. Se não existir um relatório para a data especificada, um erro de status HTTP 404 (Não encontrado) será retornado. Se nenhuma data for especificada, o relatório mais recente será retornado. Formato: AAAA-MM-DD. Exemplo: date=2024-12-31

Resposta

Uma solicitação bem-sucedida retorna o status HTTP 200 (OK) e o relatório de sobreposição do conjunto de dados. O relatório inclui uma data objeto, contendo listas de conjuntos de dados separadas por vírgulas e sua respectiva contagem de perfis. Para obter detalhes sobre como ler o relatório, consulte a seção sobre interpretação dos dados do relatório de sobreposição do conjunto de dados mais adiante neste tutorial.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Gerar relatório de sobreposição de conjunto de dados usando o Postman

O Postman é uma plataforma colaborativa para o desenvolvimento de API e é útil para visualizar chamadas de API. Ele pode ser baixado gratuitamente no Site do Postman O e o fornecem uma interface fácil de usar para executar chamadas de API. As capturas de tela a seguir usam a interface do Postman.

Solicitação

Para solicitar o relatório de sobreposição do conjunto de dados usando o Postman, siga estas etapas:

  • Usando a lista suspensa, selecione GET como o tipo de solicitação.
  • Insira os cabeçalhos necessários na KEY coluna:
    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Insira os valores gerados durante a autenticação na VALUE , substituindo as chaves ({{ }}) e qualquer conteúdo entre chaves.
  • Insira o caminho da solicitação com ou sem o date parâmetro:
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    ou
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
Parâmetro Descrição
date Especifique a data do relatório a ser retornado. Se vários relatórios tiverem sido executados na data, o relatório mais recente dessa data será retornado. Se não existir um relatório para a data especificada, um erro de status HTTP 404 (Não encontrado) será retornado. Se nenhuma data for especificada, o relatório mais recente será retornado.
Formato: AAAA-MM-DD. Exemplo: date=2024-12-31

Após a conclusão do tipo de solicitação, cabeçalhos, valores e caminho, selecione Enviar para enviar a solicitação da API e gerar o relatório.

Resposta

Uma solicitação bem-sucedida retorna o status HTTP 200 (OK) e o relatório de sobreposição do conjunto de dados. O relatório inclui uma data objeto, contendo listas de conjuntos de dados separadas por vírgulas e sua respectiva contagem de perfis. Para obter detalhes sobre como ler o relatório, consulte a seção sobre interpretação dos dados do relatório de sobreposição do conjunto de dados.

Interpretar os dados do relatório de sobreposição do conjunto de dados

O relatório de sobreposição do conjunto de dados gerado fornece um carimbo de data e hora mostrando a data e a hora do relatório e um objeto de dados que inclui combinações exclusivas de IDs de conjunto de dados como listas separadas por vírgulas. As seções a seguir fornecem informações adicionais sobre os componentes do relatório.

Carimbo de data e hora do relatório

A variável reportTimestamp corresponde à data fornecida na solicitação da API ou, se nenhuma data foi fornecida, o carimbo de data e hora do relatório mais recente.

Lista de IDs do conjunto de dados

A variável data O objeto inclui combinações exclusivas de IDs de conjunto de dados como listas separadas por vírgulas com a respectiva contagem de perfis para essa combinação de conjuntos de dados.

OBSERVAÇÃO

A soma de todas as contagens de perfis associadas a cada linha do relatório de sobreposição do conjunto de dados deve ser igual ao número total de perfis em sua organização.

Para interpretar os resultados do relatório, considere o seguinte exemplo:

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

Esse relatório fornece as seguintes informações:

  • Há 123 perfis compostos de dados provenientes dos seguintes conjuntos de dados: 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • Há 454.412 perfis compostos de dados provenientes desses dois conjuntos de dados: 5d92921872831c163452edc8 e 5eb2cdc6fa3f9a18a7592a98.
  • Há 107 perfis compostos apenas de dados do conjunto de dados 5eeda0032af7bb19162172a7.
  • Há um total de 454.642 perfis na organização.

Próximas etapas

Após concluir este tutorial, agora é possível gerar o relatório de sobreposição de conjunto de dados usando a API de perfil do cliente em tempo real. Para saber mais sobre como trabalhar com dados de Perfil na API e na interface do usuário do Experience Platform, comece lendo o Documentação de visão geral do perfil.

Nesta página