Fazer download de pontuações no Attribution AI

Este documento serve como um guia para baixar pontuações para o Attribution AI.

Introdução

O Attribution AI permite baixar pontuações no formato de arquivo Parquet. Este tutorial requer que você tenha lido e concluído a seção de download de pontuações do Attribution AI no introdução guia.

Além disso, para acessar pontuações para o Attribution AI, é 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 a Guia do usuário do Attribution AI. Se você criou recentemente uma instância de serviço e ela ainda está treinando e pontuando, aguarde 24 horas para que ela termine de ser executada.

Encontrar a ID do conjunto de dados

Na instância de serviço do Attribution AI insights, clique no botão Mais ações lista suspensa 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 download de pontuações 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

Usando sua ID de conjunto de dados da etapa anterior, é necessário fazer uma chamada para a API de catálogo a fim de recuperar uma ID de 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 para a variável limit parâmetro de consulta para a quantidade desejada que você deseja retornar. Para obter mais informações sobre os tipos de parâmetros de consulta disponíveis, visite o guia em filtrar 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 caixa de diálogo "Pontuações de acesso".

Solicitação

curl -X GET 'https://platform.adobe.io/data/foundation/catalog/batches?&dataSet=5e8f81ce7a4ecb18a8d25b22&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 em lote. Neste exemplo, o valor Chave para o objeto retornado é a ID do lote 01E5QSWCAASFQ054FNBKYV6TIQ. Copie a ID do lote para usar na próxima chamada de API.

OBSERVAÇÃO

A resposta seguinte foi tags objeto reformado para facilitar a leitura.

{
    "01E5QSWCAASFQ054FNBKYV6TIQ": {
        "status": "success",
        "tags": {
            "Tags": [ ... ],
        },
        "relatedObjects": [
            {
                "type": "dataSet",
                "id": "5e8f81cf7a4ecb28a8d85b22"
            }
        ],
        "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 a ID do lote

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

Formato da API

GET batches/{BATCH_ID}/files
Parâmetro Descrição
{BATCH_ID} A ID de 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/01E5QSWCAASFQ054FNBKYV6TIQ/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 contendo um _links objeto. No _links objeto é um href com uma nova chamada de API como seu valor. Copie esse valor para prosseguir para a próxima etapa.

{
    "data": [
        {
            "dataSetFileId": "01E5QSWCAASFQ054FNBKYV6TIQ-1",
            "dataSetViewId": "5e8f81cf7a4ecb28a8d85b22",
            "version": "1.0.0",
            "created": "1586715582571",
            "updated": "1586715582571",
            "isValid": false,
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}

Recuperar arquivos

Usar o href na etapa anterior como uma chamada de API, faça uma nova solicitação do GET para recuperar o diretório de arquivos.

Formato da API

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

Solicitação

curl -X GET 'https://platform.adobe.io/data/foundation/export/files/01E5QSWCAASFQ054FNBKYV6TIQ-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-5614147572541837832-908bd66a-d856-47fe-b7da-c8e7d22a4097-1370467-1.c000.snappy.parquet",
            "length": "2380211",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-1.c000.snappy.parquet"
                }
            }
        }
    ],
    "_page": {
        "limit": 100,
        "count": 1
    }
}
Parâmetro Descrição
_links.self.href O URL de solicitação do GET usado para baixar um arquivo em seu diretório.

Copie o href para qualquer objeto de arquivo na data , em seguida, prossiga para a próxima etapa.

Baixar os dados do arquivo

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

OBSERVAÇÃO

Se você estiver fazendo essa solicitação diretamente na linha de comando, talvez seja solicitado que você adicione 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 de dataSetFile é retornada na variável href valor de um etapa anterior.
{FILE_NAME} O nome do arquivo.

Solicitação

curl -X GET 'https://platform.adobe.io:443/data/foundation/export/files/01E5QSWCXXYFQ054FNBKYV2BAQ-1?path=part-00000-trd-5714147572541837832-938bd66a-d556-41fe-b7da-c8e7d22a4097-1320467-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 'file.parquet'
DICA

Certifique-se de estar no diretório ou pasta corretos para a qual deseja salvar o arquivo antes de fazer a solicitação do GET.

Resposta

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

Terminal

As pontuações baixadas estarão no formato Parquet e precisarão de um Spark-shell ou leitor de Parquet para visualizar as pontuações. Para exibição de pontuação bruta, você pode usar Ferramentas do Apache Parquet. As ferramentas do Parquet podem analisar os dados com Spark.

Próximas etapas

Este documento descreve as etapas necessárias para o download das pontuações do Attribution AI. Para obter mais informações sobre os resultados da pontuação, visite o Entrada e saída do Attribution AI documentação.

Acessar pontuações usando o Snowflake

IMPORTANTE

Entre em contato com attributionai-support@adobe.com para obter mais detalhes sobre como acessar pontuações usando o Snowflake.

Você pode acessar pontuações de Attribution AI agregadas por meio do Snowflake. Atualmente, você precisa enviar o suporte ao Adobe por email para attributionai-support@adobe.com para configurar e receber as credenciais da conta de leitor para o Snowflake.

Depois que o suporte ao Adobe processar sua solicitação, você receberá um URL para a conta do leitor no Snowflake e as credenciais correspondentes abaixo:

  • Snowflake URL
  • Nome do usuário
  • Senha
OBSERVAÇÃO

A conta do leitor é para consultar os dados usando clientes sql, planilha e soluções BI que oferecem suporte ao conector JDBC.

Depois de ter suas credenciais e URL, você pode consultar as tabelas do modelo, agregadas por data do ponto de contato ou data de conversão.

Encontrar o esquema no Snowflake

Usando as credenciais fornecidas, faça logon no Snowflake. Clique no botão Planilhas na navegação principal do canto superior esquerdo, em seguida, navegue até o diretório do banco de dados no painel esquerdo.

Planilhas e navegação

Em seguida, clique em Selecionar esquema no canto superior direito da tela. Na janela exibida, confirme se o banco de dados correto está selecionado. Em seguida, clique no botão Esquema selecione um dos seus esquemas listados. Você pode consultar diretamente das tabelas de pontuação listadas no schema selecionado.

localizar um esquema

Conexão do Power BI ao Snowflake (opcional)

Suas credenciais do Snowflake podem ser usadas para configurar uma conexão entre os bancos de dados do Power BI Desktop e do Snowflake.

Primeiro, em Servidor digite o Snowflake URL. Em seguida, em Depósito, digite "XSMALL". Em seguida, digite seu nome de usuário e senha.

exemplo do POWERBI

Depois que a conexão for estabelecida, selecione o banco de dados do Snowflake e selecione o schema apropriado. Agora você pode carregar todas as tabelas.

Nesta página