Google Cloud Storage conexão
Visão geral overview
Crie uma conexão de saída ativa com o Google Cloud Storage para exportar arquivos de dados do Adobe Experience Platform periodicamente para seus próprios buckets.
Conectar-se ao armazenamento do Google Cloud Storage por meio da API ou da interface connect-api-or-ui
- Para se conectar ao local de armazenamento do Google Cloud Storage usando a interface do usuário do Experience Platform, leia as seções Conectar-se ao destino e Ativar públicos-alvo para este destino abaixo.
- Para se conectar ao local de armazenamento do Google Cloud Storage de forma programática, leia o Tutorial da API do Serviço de Fluxo para ativar públicos-alvo para destinos baseados em arquivo.
Públicos-alvo compatíveis supported-audiences
Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.
Esta categoria inclui todas as origens de público-alvo fora dos públicos-alvo gerados pelo Segmentation Service. Leia sobre as várias origens do público-alvo. Alguns exemplos incluem:
- carregar audiências personalizadas importadas para o Experience Platform de arquivos CSV,
- públicos-alvo semelhantes,
- públicos federados,
- públicos-alvo gerados em outros aplicativos da Experience Platform, como o Adobe Journey Optimizer,
- e muito mais.
Públicos-alvo compatíveis por tipo de dados de público-alvo:
Tipo e frequência de exportação export-type-frequency
Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.
Exportar conjuntos de dados export-datasets
Esse destino suporta exportações de conjunto de dados. Para obter informações completas sobre como configurar exportações de conjunto de dados, leia os tutoriais:
Formato de arquivo dos dados exportados file-format
Ao exportar dados de público-alvo, o Experience Platform cria um arquivo .csv, parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção formatos de arquivo compatíveis com a exportação no tutorial de ativação de público-alvo.
Ao exportar conjuntos de dados, o Experience Platform cria um arquivo .parquet ou .json no local de armazenamento fornecido. Para obter mais informações sobre os arquivos, consulte a seção verificar exportação bem-sucedida do conjunto de dados no tutorial exportar conjuntos de dados.
Pré-requisito de configuração para conectar sua conta do Google Cloud Storage prerequisites
Para conectar o Experience Platform ao Google Cloud Storage, primeiro você deve habilitar a interoperabilidade para sua conta Google Cloud Storage. Para acessar a configuração de interoperabilidade, abra o Google Cloud Platform e selecione Settings na opção Cloud Storage no painel de navegação.
A página Settings é exibida. Aqui, você pode ver informações sobre sua ID de projeto do Google e detalhes sobre sua conta do Google Cloud Storage. Para acessar as configurações de interoperabilidade, selecione Interoperability no cabeçalho superior.
A página Interoperability contém informações sobre autenticação, chaves de acesso e o projeto padrão associado à sua conta de serviço. Para gerar uma nova ID de chave de acesso e uma chave de acesso secreta para sua conta de serviço, selecione Create a Key for a Service Account.
Você pode usar a ID da chave de acesso recém-gerada e a chave de acesso secreta para conectar sua conta do Google Cloud Storage à Experience Platform.
Conectar ao destino connect
Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino. No workflow da configuração de destino, preencha os campos listados nas duas seções abaixo.
Autenticar para o destino authenticate
Para autenticar no destino, preencha os campos obrigatórios e selecione Connect to destination.
-
Access key ID: uma sequência de 61 caracteres alfanuméricos usada para autenticar sua conta do Google Cloud Storage no Experience Platform. Para obter informações sobre como obter este valor, leia a seção pré-requisitos acima.
-
Secret access key: uma cadeia de caracteres de 40 caracteres codificada em base64 usada para autenticar sua conta do Google Cloud Storage no Experience Platform. Para obter informações sobre como obter este valor, leia a seção pré-requisitos acima.
-
Encryption key: Opcionalmente, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos seus arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.
Para obter mais informações sobre esses valores, leia o guia de chaves HMAC do Google Cloud Storage. Para obter etapas sobre como gerar sua própria ID da chave de acesso e chave de acesso secreta, consulte a Google Cloud Storage visão geral da origem.
Preencher detalhes do destino destination-details
Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.
-
Name: Preencha o nome preferencial para este destino.
-
Description: Opcional. Por exemplo, você pode mencionar para qual campanha está usando esse destino.
-
Bucket name: insira o nome do bucket Google Cloud Storage a ser usado por este destino.
-
Folder path: Insira o caminho para a pasta de destino que hospedará os arquivos exportados.
-
File type: Selecione o formato que o Experience Platform deve usar para os arquivos exportados. Ao selecionar a opção CSV, você também pode configurar as opções de formatação de arquivo.
-
Compression format: Selecione o tipo de compactação que o Experience Platform deve usar para os arquivos exportados.
-
Include manifest file: ative esta opção se desejar que as exportações incluam um arquivo JSON de manifesto que contenha informações sobre o local de exportação, tamanho da exportação e muito mais. O manifesto é nomeado usando o formato
manifest-<<destinationId>>-<<dataflowRunId>>.json. Exibir um arquivo de manifesto de exemplo. O arquivo de manifesto inclui os seguintes campos:flowRunId: A execução do fluxo de dados que gerou o arquivo exportado.scheduledTime: A hora em UTC quando o arquivo foi exportado.exportResults.sinkPath: O caminho no local de armazenamento onde o arquivo exportado está depositado.exportResults.name: O nome do arquivo exportado.size: O tamanho do arquivo exportado, em bytes.
Ativar alertas enable-alerts
Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.
Quando terminar de fornecer detalhes da conexão de destino, selecione Next.
Google Cloud Storage permissões necessárias required-google-cloud-storage-permission
Para conectar e exportar dados com êxito para o local de armazenamento do Google Cloud Storage, você precisa das seguintes Google Cloud Storage permissões para seus buckets:
orgpolicy.policy.getresourcemanager.projects.getresourcemanager.projects.liststorage.managedFolders.createstorage.multipartUploads.abortstorage.multipartUploads.createstorage.multipartUploads.listPartsstorage.objects.createstorage.objects.list
Leia mais sobre controle de acesso e permissões em Google Cloud Storage.
Ativar públicos-alvo para esse destino activate
- Para ativar dados, você precisa das View Destinations, Activate Destinations, View Profiles e View Segments permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.
- Para exportar identidades, você precisa da View Identity Graph permissão de controle de acesso.
Consulte Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.
Agendamento
Na etapa Scheduling, você pode configurar o agendamento de exportação para o seu destino Google Cloud Storage e também configurar o nome dos seus arquivos exportados.
Mapear atributos e identidades map
Na etapa Mapping, você pode selecionar quais campos de atributo e identidade serão exportados para seus perfis. Você também pode optar por alterar os cabeçalhos no arquivo exportado para qualquer nome amigável. Para obter mais informações, exiba a etapa de mapeamento no tutorial de ativação da interface de destinos em lote.
Validar exportação de dados bem-sucedida exported-data
Para verificar se os dados foram exportados com êxito, verifique o bucket Google Cloud Storage e se os arquivos exportados contêm as populações de perfis esperadas.
INCLUO NA LISTA DE PERMISSÕES de endereços IP ip-address-allow-list
Consulte o artigo incluo na lista de permissões de endereços IP se precisar adicionar IPs do Adobe a um incluo na lista de permissões.