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

O relatório de sobreposição de conjunto de dados oferece visibilidade da composição do armazenamento Profile de sua organização, 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 a API Real-Time Customer Profile e interpretar 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 necessários. Para saber mais sobre as APIs Experience Platform, consulte a documentação de introdução às APIs da plataforma.

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

  • Authorization: Bearer {ACCESS_TOKEN}: O cabeçalho Authorization 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}: 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 parâmetro 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 um objeto data, 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 e fornece uma interface de usuário 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 coluna KEY:

    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Insira os valores gerados durante a autenticação na coluna VALUE, substituindo as chaves ({{ }}) e qualquer conteúdo dentro das chaves.

  • Insira o caminho da solicitação com ou sem o parâmetro date opcional:
    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, dos cabeçalhos, valores e do caminho, selecione Enviar para enviar a solicitação de 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 um objeto data, 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 interpret-the-report

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

O reportTimestamp corresponde à data fornecida na solicitação de API ou, se nenhuma data foi fornecida, ao carimbo de data e hora do relatório mais recente.

Lista de IDs do conjunto de dados

O objeto data 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.

NOTE
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 destes 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 a documentação de visão geral do perfil.

recommendation-more-help
54550d5b-f1a1-4065-a394-eb0f23a2c38b