Baixar pontuações na IA do cliente

Este documento serve como um guia para baixar pontuações para a IA do cliente.

Introdução

A IA do cliente permite baixar pontuações no formato de arquivo Parquet. Este tutorial requer que você tenha lido e concluído a seção Baixar pontuações da IA do cliente na introdução guia.

Além disso, para acessar pontuações para a IA do cliente, é necessário ter uma instância de serviço com um status de execução bem-sucedida disponível. Para criar uma nova instância de serviço, visite Configurar uma instância da IA do cliente. Se você criou recentemente uma instância de serviço e ela ainda está sendo treinada e pontuada, aguarde 24 horas para que ela seja concluída.

Atualmente, há duas maneiras de baixar as pontuações da IA do cliente:

  1. Se você quiser baixar as pontuações em nível individual e/ou não tiver o Perfil de cliente em tempo real ativado, comece navegando até encontrar a ID do conjunto de dados.
  2. Se você tiver o Perfil ativado e quiser baixar segmentos configurados usando a IA do cliente, navegue até baixar um segmento configurado com a IA do cliente.

Encontrar a ID do conjunto de dados dataset-id

Na instância do serviço para obter insights do Customer AI, clique no link Mais ações na navegação superior direita e selecione Pontuações de acesso.

mais ações

Uma nova caixa de diálogo é exibida, contendo um link para a documentação de pontuações de download e a ID do conjunto de dados para sua instância atual. Copie a ID do conjunto de dados para a área de transferência e prossiga para a próxima etapa.

ID do conjunto de dados

Recuperar a ID do lote retrieve-your-batch-id

Usando sua ID do conjunto de dados da etapa anterior, você precisa fazer uma chamada para a API do catálogo para recuperar uma ID em lote. Parâmetros de consulta adicionais são usados para essa chamada de API para retornar o lote bem-sucedido mais recente, em vez de uma lista de lotes pertencentes à sua organização. Para retornar lotes adicionais, aumente o número do parâmetro de consulta limite para a quantia desejada a ser retornada. Para obter mais informações sobre os tipos de parâmetros de consulta disponíveis, consulte o manual no filtragem de dados do catálogo usando parâmetros de consulta.

Formato da API

GET /batches?&dataSet={DATASET_ID}&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1
Parâmetro
Descrição
{DATASET_ID}
A ID do conjunto de dados disponível na janela "Pontuações de acesso".

Solicitação

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?dataSet=5cd9146b31dae914b75f654f&createdClient=acp_foundation_push&status=success&orderBy=desc:created&limit=1' \
  -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

Uma resposta bem-sucedida retorna uma carga contendo um objeto de ID de lote. Neste exemplo, o valor principal do objeto retornado é a ID do lote 01E5QSWCAASFQ054FNBKYV6TIQ. Copie sua ID do lote para usar na próxima chamada de API.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5cd9146b31dae914b75f654f"
            }
        ],
        "id": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "externalId": "01E5QSWCAASFQ054FNBKYV6TIQ",
        "replay": {
            "predecessors": [
                "01E5N7EDQQP4JHJ93M7C3WM5SP"
            ],
            "reason": "Replacing for 2020-04-09",
            "predecessorListingType": "IMMEDIATE"
        },
        "inputFormat": {
            "format": "parquet"
        },
        "imsOrg": "412657965Y566A4A0A495D4A@AdobeOrg",
        "started": 1586715571808,
        "metrics": {
            "partitionCount": 1,
            "outputByteSize": 2380339,
            "inputFileCount": -1,
            "inputByteSize": 2381007,
            "outputRecordCount": 24340,
            "outputFileCount": 1,
            "inputRecordCount": 24340
        },
        "completed": 1586715582735,
        "created": 1586715571217,
        "createdClient": "acp_foundation_push",
        "createdUser": "sensei_exp_attributionai@AdobeID",
        "updatedUser": "acp_foundation_dataTracker@AdobeID",
        "updated": 1586715583582,
        "version": "1.0.5"
    }
}

Recupere a próxima chamada da API com sua ID de lote retrieve-the-next-api-call-with-your-batch-id

Depois de ter a ID do lote, você poderá fazer uma nova solicitação para o GET /batches. A solicitação retorna um link usado como a próxima solicitação de API.

Formato da API

GET batches/{BATCH_ID}/files
Parâmetro
Descrição
{BATCH_ID}
A ID do lote recuperada na etapa anterior recuperar a ID do lote.

Solicitação

Usando sua própria ID de lote, faça a seguinte solicitação.

curl -X GET 'https://platform.adobe.io/data/foundation/export/batches/035e2520-5e69-11ea-b624-51evfeba55d1/files' \
  -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

Uma resposta bem-sucedida retorna uma carga que contém um _links objeto. No prazo de _links o objeto é um href com uma nova chamada de API como seu valor. Copie esse valor para prosseguir para a próxima etapa.

{
    "data": [
        {
            "dataSetFileId": "035e2520-5e69-11ea-b624-51ecfeba55d0-1",
            "dataSetViewId": "5e3b2fe3fe4b9f18a8b7a3db",
            "version": "1.0.0",
            "created": "1583361894479",
            "updated": "1583361894479",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Recuperar seus arquivos retrieving-your-files

Usar o href valor que você recebeu na etapa anterior como uma chamada de API, faça uma nova solicitação do GET para recuperar o diretório do arquivo.

Formato da API

GET files/{DATASETFILE_ID}
Parâmetro
Descrição
{DATASETFILE_ID}
A ID do dataSetFile é retornada na variável href valor do etapa anterior. Também é acessível no data matriz no tipo de objeto dataSetFileId.

Solicitação

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1' \
  -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

A resposta contém uma matriz de dados que pode ter uma única entrada ou uma lista de arquivos pertencentes a esse diretório. O exemplo abaixo contém uma lista de arquivos e foi condensado para facilitar a leitura. Nesse cenário, é necessário seguir o URL de cada arquivo para acessar o arquivo.

{
    "data": [
        {
            "name": "part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet",
            "length": "16214531",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet"
                }
            }
        },
        {
            "name": "...",
            "length": "16235375",
            "_links": {
                "self": {
                    "href": "..."
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 100
    },
    "_links": {
        "next": {
            "href": "..."
        },
        "page": {
            "href": "...",
            "templated": true
        }
    }
}
Parâmetro
Descrição
_links.self.href
O URL de solicitação GET usado para baixar um arquivo no diretório.

Copie o href para qualquer objeto de arquivo na variável data e prossiga para a próxima etapa.

Baixar os dados do arquivo

Para baixar os dados do arquivo, faça uma solicitação GET ao "href" valor copiado na etapa anterior recuperação de arquivos.

NOTE
Se você estiver fazendo essa solicitação diretamente na linha de comando, talvez seja solicitado a adicionar uma saída após os cabeçalhos da solicitação. O exemplo de solicitação a seguir usa --output {FILENAME.FILETYPE}.

Formato da API

GET files/{DATASETFILE_ID}?path={FILE_NAME}
Parâmetro
Descrição
{DATASETFILE_ID}
A ID do dataSetFile é retornada na variável href valor de a etapa anterior.
{FILE_NAME}
O nome do arquivo.

Solicitação

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/035e2520-5e69-11ea-b624-51ecfeba55d0-1?path=part-00000-tid-7597930103898538622-a25f1890-efa9-40eb-a2cb-1b378e93d582-528-1-c000.snappy.parquet' \
  -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}' \
  -O 'filename.parquet'
TIP
Verifique se você está no diretório ou pasta correta na qual deseja salvar o arquivo antes de fazer a solicitação do GET.

Resposta

A resposta baixa o arquivo solicitado no seu diretório atual. Neste exemplo, o nome do arquivo é "filename.parquet".

Terminal

Baixar um segmento configurado com a IA do cliente segment

Uma maneira alternativa de baixar os dados de pontuação é exportar o público-alvo para um conjunto de dados. Depois que um trabalho de segmentação é concluído com sucesso (o valor da variável status atributo é "SUCCEEDED"), você pode exportar seu público-alvo para um conjunto de dados em que ele possa ser acessado e aplicado. Para saber mais sobre segmentação, visite o visão geral da segmentação.

IMPORTANT
Para utilizar esse método de exportação, o Perfil do cliente em tempo real precisa ser ativado para o conjunto de dados.

A variável exportar um segmento A seção no guia de avaliação de segmento aborda as etapas necessárias para exportar um conjunto de dados de público-alvo. O guia descreve e fornece exemplos do seguinte:

  • Criar um conjunto de dados de destino: Crie o conjunto de dados para conter membros do público-alvo.
  • Gerar perfis de público no conjunto de dados: Preencha o conjunto de dados com Perfis individuais XDM com base nos resultados de um trabalho de segmento.
  • Monitorar progresso da exportação: Verifique o progresso atual do processo de exportação.
  • Ler dados do público: Recupere os Perfis individuais XDM resultantes que representam os membros do público-alvo.

Próximas etapas

Este documento descreveu as etapas necessárias para baixar as pontuações da IA do cliente. Agora você pode continuar a navegar pelo outro Serviços inteligentes e guias oferecidos.

recommendation-more-help
8959a20a-a58f-4057-9f82-870706c576e9