Show Menu
TÓPICOS×

Download de pontuações no AI de atribuição

Este documento serve como guia para baixar pontuações para a Atribuição AI.

Introdução

O AI de atribuição permite baixar pontuações no formato de arquivo de parâmetro. Este tutorial requer que você tenha lido e concluído o download da seção de Pontuações AI de atribuição no guia de introdução .
Além disso, para acessar as pontuações da Atribuição 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 o guia do usuário da Atribuição AI. Se você criou recentemente uma instância de serviço e ela ainda está treinando e marcando, aguarde 24 horas para terminar a execução.

Find your dataset ID

Em sua instância de serviço para insights de AI de atribuição, clique na lista suspensa Mais ações na navegação superior direita e selecione Pontuações de acesso.
Uma nova caixa de diálogo é exibida, contendo um link para a documentação das pontuações de download e a ID do conjunto de dados da sua instância atual. Copie a ID do conjunto de dados para a área de transferência e prossiga para a próxima etapa.

Recuperar a ID do lote

Usando a ID do conjunto de dados da etapa anterior, é necessário fazer uma chamada para a API de catálogo para recuperar uma ID de lote. Parâmetros de query adicionais são usados para esta chamada de API a fim de 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 do limit query para a quantia desejada que você deseja que seja retornada. Para obter mais informações sobre os tipos de parâmetros de query disponíveis, visite o guia sobre como filtrar dados do catálogo usando parâmetros de query.
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: {IMS_ORG}' \
  -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 Chave para o objeto retornado é a ID do lote 01E5QSWCAASFQ054FNBKYV6TIQ . Copie a ID do lote para usar na próxima chamada da API.
A resposta a seguir fez com que o tags objeto fosse reformado para 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"
    }
}

Recuperar a próxima chamada de API com sua ID de lote

Depois de ter a ID do lote, você poderá fazer uma nova solicitação GET para /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 de lote recuperada na etapa anterior recupera a ID de 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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Resposta
Uma resposta bem-sucedida retorna uma carga que contém um _links objeto. Dentro do _links objeto há uma nova chamada de API href com 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 seus arquivos

Usando o href valor obtido na etapa anterior como uma chamada de API, faça uma nova solicitação GET para recuperar seu diretório de arquivos.
Formato da API
GET files/{DATASETFILE_ID}

Parâmetro
Descrição
{DATASETFILE_ID}
A ID dataSetFile é retornada no href valor da etapa Recuperar a próxima chamada de API com sua ID de lote anterior. Ele também pode ser acessado na 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: {IMS_ORG}' \
  -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 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 GET usado para baixar um arquivo em seu diretório.
Copie o href valor para qualquer objeto de arquivo na data matriz e prossiga para a próxima etapa.

Baixar seus dados de arquivo

Para baixar os dados do arquivo, faça uma solicitação GET para o "href" valor copiado na etapa anterior para recuperar os arquivos .
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 dataSetFile é retornada no href valor de uma etapa Recuperar a próxima chamada de API com sua ID de lote 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: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -O 'file.parquet'

Verifique se você está no diretório ou pasta corretos na qual deseja salvar o arquivo antes de fazer a solicitação GET.
Resposta
A resposta baixa o arquivo solicitado no diretório atual. Neste exemplo, o nome do arquivo é "file.parquet".

Próximas etapas

Este documento descreveu as etapas necessárias para baixar as pontuações da Atribuição AI. Agora você pode continuar navegando pelos outros serviços e guias inteligentes oferecidos.

Acessar pontuações usando Floco de Neve

Entre em contato com attributionai-support@adobe.com para obter mais detalhes sobre como acessar as pontuações usando o SnowFlake.
Você pode acessar as pontuações agregadas da Atribuição AI por meio do Floco de neve. Atualmente, você precisa enviar um email para o suporte da Adobe em attributionai-support@adobe.com para configurar e receber as credenciais da sua conta de leitor para o Floco de neve.
Depois que o suporte da Adobe tiver processado sua solicitação, você receberá um URL para a conta do leitor para Snowflake e as credenciais correspondentes abaixo:
  • URL do floco de neve
  • Nome do usuário
  • Password
A conta do leitor é para consultar os dados usando clientes sql, planilhas e soluções BI que suportam o conector JDBC.
Depois de ter suas credenciais e URL, você pode query as tabelas de modelo, agregadas por data do ponto de contato ou data de conversão.

Encontrar seu schema em Floco de Neve

Usando as credenciais fornecidas, faça logon no Floco de neve. Clique na guia Planilhas na navegação principal superior esquerda e navegue até o diretório do banco de dados no painel esquerdo.
Em seguida, clique em Selecionar Schema no canto superior direito da tela. Na janela que aparece, confirme se você tem o banco de dados certo selecionado. Em seguida, clique na lista suspensa Schema e selecione um dos schemas listados. Você pode query diretamente das tabelas de pontuação listadas abaixo do schema selecionado.

Conectando o Power BI ao Floco de neve (opcional)

Suas credenciais do Snowflake podem ser usadas para configurar uma conexão entre os bancos de dados Power BI Desktop e Snowflake.
Primeiro, na caixa Servidor , digite o URL do floco de neve. Em seguida, em Warehouse , digite "XSMALL". Em seguida, digite seu nome de usuário e senha.
Depois que a conexão for estabelecida, selecione seu banco de dados Snowflake e selecione o schema apropriado. Agora você pode carregar todas as tabelas.