Configurar um destino de relatório para uma solicitação do data warehouse

Há várias opções de configuração disponíveis ao criar uma solicitação do data warehouse. As informações a seguir descrevem como configurar um destino de relatório para a solicitação.

Para obter informações sobre como começar a criar uma solicitação, bem como links para outras opções de configuração importantes, consulte Criar uma solicitação do data warehouse.

NOTE
Considere o seguinte ao configurar um destino de relatório:
  • Recomendamos o uso de uma conta na nuvem ou de um email como destino do seu relatório. Contas de FTP e SFTP herdadas estão disponíveis, mas não são recomendadas.

  • Todas as contas em nuvem configuradas anteriormente estão disponíveis para uso no data warehouse. Você pode configurar contas em nuvem de qualquer uma das seguintes maneiras:

  • As contas em nuvem estão associadas à sua conta de usuário do Adobe Analytics. Outros usuários não podem usar ou exibir contas na nuvem configuradas por você.

  • É possível editar qualquer local criado no gerenciador de locais em Componentes > Locais

Configure o destino para o qual enviar os relatórios do data warehouse.

  1. Caso ainda não o tenha feito, crie uma solicitação no Adobe Analytics selecionando Ferramentas > Data warehouse > Adicionar.

    Para obter detalhes adicionais, consulte Criar uma solicitação do data warehouse.

  2. Na página Nova solicitação do data warehouse, selecione a guia Destino do relatório.

    Guia Destino do relatório

  3. (Condicional) Caso já tenha configurado uma conta de nuvem (e um destino nessa conta) no Adobe Analytics, ela poderá ser usada como destino do relatório:

    note note
    NOTE
    As contas estão disponíveis somente se você as tiver configurado ou se tiverem sido compartilhadas com uma organização da qual você faça parte.
    A opção Mostrar todos os destinos está disponível para administradores do sistema. Habilite essa opção se desejar ter acesso a todas as contas e locais que foram criados por qualquer usuário na organização.
    1. Selecione a conta no menu suspenso Selecionar conta.

      Todas as contas em nuvem configuradas em qualquer uma das seguintes áreas do Adobe Analytics estão disponíveis para uso:

    2. Selecione o destino associado à conta no menu suspenso Selecionar destino.

  4. (Condicional) Se você não tiver acesso a uma conta na nuvem já configurada no Adobe Analytics, será possível configurá-la:

    1. Selecione Adicionar conta e especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Campo Função
      Tipo de conta

      Selecione o tipo de conta na nuvem. Recomendamos ter uma única conta de cada tipo, com os vários locais necessários contidos nessa conta.

      Depois de escolher um tipo de conta, aparecerão campos específicos para esse tipo de conta.

      Nome da conta Especifique um nome para a conta. Esse nome aparece ao criar um local.
      Descrição da conta Forneça uma breve descrição da conta para ajudar a diferenciá-la de outras contas do mesmo tipo.

      Para obter instruções de configuração, expanda a seção abaixo que corresponde ao Tipo de conta que você selecionou.

      Use qualquer um dos tipos de conta a seguir ao configurar um destino de relatório. Para obter instruções de configuração, expanda o tipo de conta. (Destinos herdados adicionais também estão disponíveis, mas não são recomendados.)

      accordion
      Amazon S3

      Para configurar uma conta do Amazon S3 Role ARN, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Campo Função
      ARN de função

      Você deve fornecer um ARN (Amazon Resource Name) de função que a Adobe possa usar para obter acesso à conta do Amazon S3. Para fazer isso, crie uma política de permissão IAM para a conta de origem, anexe a política a um usuário e crie uma função para a conta de destino. Para obter informações específicas, consulte esta documentação do AWS.

      Para obter informações sobre como configurar a permissão do bucket, consulte o artigo Como fornecer acesso entre contas a objetos que estão nos buckets do Amazon S3? no centro de conhecimento da Amazon.

      ARN de usuário O ARN (Amazon Resource Name) de usuário é fornecido pela Adobe. É preciso anexar este usuário à política que você criou.
      accordion
      Google Cloud Platform

      Para configurar uma conta da Google Cloud Platform, especifique as seguintes informações:

      table 0-row-2 1-row-2 layout-auto
      Campo Função
      ID do projeto Sua ID de projeto da Google Cloud. Consulte a documentação da Google Cloud sobre como obter uma ID de projeto.
      accordion
      Azure SAS

      Para configurar uma conta do Azure SAS, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto
      Campo Função
      ID do aplicativo Copie essa ID do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Visão geral do aplicativo. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      ID do locatário Copie essa ID do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Visão geral do aplicativo. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      URI do cofre de chaves

      O caminho para o URI do SAS no Azure Key Vault. Para configurar o Azure SAS, é necessário armazenar um URI do SAS como um segredo usando o Azure Key Vault. Para obter informações, consulte a documentação do Microsoft Azure sobre como definir e recuperar um segredo do cofre de chaves do Azure.

      Depois que o URI do cofre de chaves for criado:

      • Adicione uma política de acesso no cofre de chaves para conceder permissão ao aplicativo do Azure que você criou.

      • Verifique se a ID do aplicativo recebeu a função integrada Key Vault Certificate User para acessar o URI do cofre de chaves.

        Para obter mais informações, consulte Funções integradas do Azure.

      Para obter informações, consulte a documentação do Microsoft Azure sobre como atribuir uma política de acesso do cofre de chaves.

      Nome secreto do cofre de chaves O nome secreto que você criou ao adicionar o segredo ao cofre de chaves do Azure. No Microsoft Azure, essas informações se localizam no cofre de chaves que você criou, nas páginas de configurações do cofre de chaves. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como definir e recuperar um segredo do cofre de chaves do Azure.
      Segredo Copie o segredo do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Certificados e segredos do aplicativo. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      accordion
      Azure RBAC

      Para configurar uma conta do Azure RBAC, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
      Campo Função
      ID do aplicativo Copie essa ID do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Visão geral do aplicativo. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      ID do locatário Copie essa ID do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Visão geral do aplicativo. Para obter mais informações, consulte a documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      Segredo Copie o segredo do aplicativo do Azure que você criou. No Microsoft Azure, essas informações se localizam na guia Certificados e segredos do aplicativo. Para obter mais informações, consulte documentação do Microsoft Azure sobre como registrar um aplicativo na plataforma de identidade da Microsoft.
      accordion
      Email

      Para configurar uma conta de email, especifique as seguintes informações:

      table 0-row-2 1-row-2
      Campo Função
      Destinatários É possível enviar notificações por email a usuários específicos quando o relatório é enviado. Especifique um único endereço de email ou uma lista separada por vírgulas de endereços de email.
    2. Selecione Adicionar localização e especifique as seguintes informações:
      |Campo | Função |
      |---------|----------|
      Nome  | O nome do local.   |
      | Descrição | Forneça uma breve descrição da conta para ajudar a diferenciá-la de outras contas do mesmo tipo. |
      | Conta de localização | Selecione a conta de localização que você criou em Adicionar uma conta. |

    3. Na seção Propriedades da localização, insira as informações específicas ao tipo da sua conta de localização.

      Para obter instruções de configuração, expanda a seção abaixo que corresponde ao Tipo de conta que você selecionou anteriormente.

      accordion
      Amazon S3

      Para configurar um local do Amazon S3, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Campo Função
      Nome do bucket

      O bucket da conta do Amazon S3 para o qual você deseja enviar os dados do Adobe Analytics.

      Certifique-se de que o ARN de usuário fornecido pela Adobe contenha a permissão S3:PutObject para fazer upload de arquivos nesse bucket. Esta permissão possibilita que o ARN de usuário faça upload dos arquivos iniciais e sobrescreva arquivos em uploads subsequentes.

      Os nomes dos blocos precisam cumprir regras de nomenclatura específicas. Por exemplo, eles precisam conter entre 3 e 63 caracteres, só podem conter letras minúsculas, números, pontos (.) e hifens (-), e precisam começar e terminar com uma letra ou número. Uma lista completa de regras de nomenclatura está disponível na documentação do AWS.

      Prefixo da chave A pasta dentro do bucket onde você deseja inserir os dados. Especifique um nome de pasta e adicione uma barra invertida depois do nome para criar a pasta. Por exemplo, folder_name/
      accordion
      Google Cloud Platform

      Para configurar um local da Google Cloud Platform, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Campo Função
      Nome do bucket

      O bucket da conta da GCP para o qual você deseja enviar os dados do Adobe Analytics.

      Verifique se você concedeu uma das seguintes permissões ao principal fornecido pela Adobe: (Para mais informações sobre como conceder permissões, consulte Adicionar um principal a uma política no nível do bloco na documentação da Google Cloud.)

      • roles/storage.objectCreator: use essa permissão se desejar limitar o principal a criar arquivos somente em sua conta da GCP.
        Importante: se você usar essa permissão com relatórios agendados, deverá usar um nome de arquivo único para cada nova exportação agendada. Caso contrário, ocorrerá uma falha na geração do relatório, pois o principal não terá permissão para sobrescrever os arquivos existentes.
      • roles/storage.objectUser: use essa permissão se desejar que o principal tenha acesso para exibir, listar, atualizar e excluir arquivos na sua conta da GCP.
        Essa permissão possibilita que o principal sobrescreva arquivos existentes em uploads subsequentes, sem a necessidade de gerar automaticamente nomes de arquivo únicos para cada nova exportação agendada.

      Se a sua organização estiver usando Restrições de política da organização para permitir somente a conta da Google Cloud Platform na sua lista de permissões, você precisará da seguinte ID de organização da Google Cloud Platform pertencente à Adobe:

      • DISPLAY_NAME: adobe.com
      • ID: 178012854243
      • DIRECTORY_CUSTOMER_ID: C02jo8puj
      Prefixo da chave A pasta dentro do bucket onde você deseja inserir os dados. Especifique um nome de pasta e adicione uma barra invertida depois do nome para criar a pasta. Por exemplo, folder_name/
      accordion
      Azure SAS

      Para configurar um local do Azure SAS, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 layout-auto
      Campo Função
      Nome do container O container na conta especificada para onde você deseja enviar os dados do Adobe Analytics.
      Prefixo da chave

      A pasta no container onde você deseja inserir os dados. Especifique um nome de pasta e adicione uma barra invertida depois do nome para criar a pasta. Por exemplo, folder_name/

      Verifique se o armazenamento de URIs do SAS que você especificou no campo do nome secreto no Key Vault ao configurar a conta do Azure SAS possui a permissão Write. Isso permite que o URI do SAS crie arquivos no container do Azure.

      Se desejar que o URI do SAS também substitua arquivos, verifique se o armazenamento de URIs do SAS possui a permissão Delete.

      Para obter mais informações, consulte Recursos de armazenamento de blobs na documentação do Armazenamento Azure Blob.

      accordion
      Azure RBAC

      Para configurar um local do Azure RBAC, especifique as seguintes informações:

      table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
      Campo Função
      Nome do container O container na conta especificada para onde você deseja enviar os dados do Adobe Analytics. Conceda permissões para fazer upload de arquivos para o aplicativo do Azure que você criou anteriormente.
      Prefixo de chave

      A pasta no container onde você deseja inserir os dados. Especifique um nome de pasta e adicione uma barra invertida depois do nome para criar a pasta. Por exemplo, folder_name/

      Verifique se a ID do aplicativo que você especificou ao configurar a conta do Azure RBAC recebeu a função Storage Blob Data Contributor para acessar o container (pasta).

      Para obter mais informações, consulte Funções integradas do Azure.

      Nome da conta A conta de armazenamento do Azure.
  5. Continue configurando sua solicitação do data warehouse na guia Opções de relatório. Para obter mais informações, consulte Configurar opções de relatório para uma solicitação do data warehouse.

Destinos herdados

IMPORTANT
Os destinos descritos nesta seção são herdados e não são recomendados. Em vez disso, use um dos seguintes destinos ao criar um destino do data warehouse: Amazon S3, Google Cloud Platform, Azure RBAC, Azure SAS ou Email. Consulte as informações acima para obter detalhes sobre cada um desses destinos recomendados.

As informações a seguir fornecem informações de configuração para cada um dos destinos herdados:

FTP

Os dados do data warehouse podem ser entregues em um local FTP da Adobe ou hospedado pelo cliente. Requer um host FTP, nome de usuário e senha. Use o campo de caminho para colocar arquivos de feed em uma pasta. As pastas já devem existir; os feeds exibem um erro se o caminho especificado não existir.

Use as seguintes informações ao preencher os campos disponíveis:

Campos da conta

  • Nome da conta: o nome da conta FTP.

  • Descrição da conta: uma descrição da conta FTP.

  • Nome do host: insira o URL de destino do FTP desejado. Por exemplo, ftp.company.com.

    note note
    NOTE
    Não inclua ftp:// no início do URL.
  • Nome de usuário: digite o nome de usuário para fazer logon no site FTP.

  • Senha e confirmação de senha: digite a senha para fazer logon no site FTP.

Campos de local

  • Nome do local: o nome do local na conta FTP para o qual você deseja enviar os arquivos.

  • Descrição do local: uma descrição do local na conta FTP.

  • Caminho do diretório: o caminho para o local na conta FTP.

SFTP

O SFTP é compatível com o data warehouse. Isso exige que um host SFTP, nome de usuário e site de destino contenham uma chave pública RSA ou DSA válida. Você pode baixar a chave pública apropriada ao criar o destino do data warehouse.

Use as seguintes informações ao preencher os campos disponíveis:

Campos da conta

  • Nome da conta: o nome da conta FTP.

  • Descrição da conta: uma descrição da conta FTP.

  • Nome do host: insira o URL de destino do SFTP desejado. Por exemplo, sftp.company.com.

    note note
    NOTE
    Não inclua sftp:// no início do URL.
  • Nome de usuário: digite o nome de usuário para fazer logon no site SFTP.

  • Usar extensões de arquivo temporárias durante o upload: quando habilitada, a extensão de arquivo .part é usada durante o processo de upload. Mantenha essa opção habilitada, a menos que o servidor SFTP proíba a alteração de nomes dos arquivos após a conclusão do upload.

  • Chaves públicas: baixe a chave pública apropriada ao criar o destino do data warehouse.

Campos de local

  • Nome do local: o nome do local na conta SFTP para o qual você deseja enviar os arquivos.

  • Descrição do local: uma descrição do local na conta SFTP.

  • Caminho do diretório: o caminho para o local na conta SFTP.

Para obter informações adicionais sobre a configuração de SFTP, consulte Enviar solicitações do data warehouse para servidores SFTP.

S3

Você pode enviar dados do warehouse diretamente para buckets do Amazon S3. Este tipo de destino requer um nome de bucket, uma ID de chave de acesso e uma chave secreta. Consulte Requisitos de nomenclatura de bucket do Amazon S3 nos documentos do Amazon S3 para obter mais informações.

O usuário fornecido para fazer upload dos dados do data warehouse precisa ter as seguintes permissões:

  • s3:GetObject
  • s3:PutObject
  • s3:PutObjectAcl

As 16 regiões AWS padrão a seguir são compatíveis (usando o algoritmo de assinatura apropriado, quando necessário):

  • us-east-2
  • us-east-1
  • us-west-1
  • us-west-2
  • ap-south-1
  • ap-northeast-2
  • ap-southeast-1
  • ap-southeast-2
  • ap-northeast-1
  • ca-central-1
  • eu-central-1
  • eu-west-1
  • eu-west-2
  • eu-west-3
  • eu-north-1
  • sa-east-1
NOTE
A região cn-north-1 não é compatível.

Azure Blob

O data warehouse é compatível com destinos do Azure Blob. Requer um contêiner, uma conta e uma chave. A Amazon criptografa automaticamente os dados em repouso. Os dados são descriptografados automaticamente ao baixá-los. Consulte Criar uma conta de armazenamento nos documentos do Microsoft Azure para obter mais informações.

NOTE
Você deve implementar seu próprio processo para gerenciar o espaço em disco no destino do data warehouse. A Adobe não exclui dados do servidor.
recommendation-more-help
6b7d49d5-f5fe-4b7f-91ae-5b0745755ed2