Google Cloud Storage
O Google Cloud Storage é um armazenamento de objetos altamente escalável para dados não estruturados oferecido pelo Google como parte do conjunto de produtos de computação em nuvem.
Se você estiver trocando entre provedores de armazenamento em nuvem, entre em contato com seu gerente de sucesso do cliente da Braze para obter mais assistência na configuração e validação de sua nova integração.
A integração entre Braze e o Google Cloud Storage permite enviar dados do Currents para o Google Cloud Storage. Em seguida, é possível usar um processo ETL (Extrair, Transformar, Carregar) para transferir seus dados para outros locais, como o Google BigQuery.
Pré-requisitos
| Requisito | Descrição |
|---|---|
| Conta do Google Cloud Storage | É necessário ter uma conta do Google Cloud Storage para usar a parceria. |
| Currents | Para exportar dados de volta para o Google Cloud Storage, você precisa ter Braze Currents configurado para sua conta. Currents não é necessário se você estiver apenas configurando o arquivamento de mensagens. |
Integração
Para integrar-se ao Google Cloud Storage, é necessário configurar as credenciais apropriadas que permitem que a Braze obtenha informações sobre os buckets de armazenamento gravados (storage.buckets.get) e crie objetos dentro desse bucket (storage.objects.create).
Isso pode ser feito usando as instruções a seguir, que o orientarão na criação de uma função e de uma conta de serviço que gerará uma chave privada para ser usada em sua integração com o Currents.
Etapa 1: Criar função
Crie um novo papel em seu Console do Google Cloud Platform navegando até IAM & admin > Funções > + Criar Papel.
Dê um nome ao papel, em seguida, selecione +Adicionar Permissões e escolha o seguinte:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
A permissão storage.objects.delete é opcional. Ela permite que a Braze limpe arquivos incompletos.
Em raras circunstâncias, o Google Cloud pode encerrar as conexões antes do previsto, o que faz com que a Braze grave arquivos incompletos no Google Cloud Storage. Na maioria dos casos, a Braze tentará novamente e criará um novo arquivo com os dados corretos, deixando o arquivo antigo no Google Cloud Storage.
Quando terminar, selecione Criar.
Etapa 2: Crie uma nova conta de serviço
Etapa 2.1: Crie a conta de serviço
Crie uma nova conta de serviço em seu Console do Google Cloud Platform navegando até IAM & admin > Contas de Serviço e selecionando Criar Conta de Serviço.
Em seguida, dê um nome à conta de serviço e conceda a ela acesso à função personalizada recém-criada.
Etapa 2.2: Criar uma chave
Na parte inferior da página, use o botão Create Key (Criar chave) para criar uma chave privada JSON para usar no Braze. Depois que a chave for criada, ela será baixada na sua máquina.
Etapa 3: Configurar Currents no Braze
Na Braze, navegue até Currents > + Create Current > Google Cloud Storage Data Export (Currents > + Criar Current > Exportação de dados do Google Cloud Storage) e forneça seu nome de integração e e-mail de contato.
Em seguida, faça upload de sua chave privada JSON em GCS JSON Credentials (Credenciais JSON do GCS) e forneça o nome do bucket do CGS e o prefixo do GCS (opcional).
É importante manter seu arquivo de credenciais atualizado; se as credenciais do conector expirarem, o conector deixará de enviar eventos. Se isso persistir por mais de 5 dias, os eventos do conector serão descartados e os dados serão perdidos permanentemente.
Por fim, role até a parte inferior da página e selecione quais eventos de engajamento com mensagens ou eventos de comportamento do cliente você gostaria de exportar. Quando concluído, inicie seu Current.
Etapa 4: Configure as exportações do Google Cloud Storage
Para configurar as exportações do Google Cloud Storage (GCS), acesse Parceiros de tecnologia > Google Cloud Storage, insira suas credenciais do GCS e selecione Definir como o destino padrão de exportação de dados.
Tenha em mente que a organização e o conteúdo de quaisquer arquivos exportados serão idênticos nas integrações do AWS S3, Microsoft Azure e Google Cloud Storage.
Certifique-se de inserir o valor JSON completo que é gerado pelo Google Cloud.
Etapa 5: Teste suas credenciais da conta de serviço (opcional)
Sua conta de serviço do Google Cloud IAM deve ter as seguintes permissões:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Para verificar essas permissões no painel da Braze, vá para a página Google Cloud Storage, em seguida, selecione Testar Credenciais.
Comportamento de exportação
Os usuários que integraram uma solução de armazenamento de dados na nuvem e estão tentando exportar APIs, relatórios de dashboard ou relatórios CSV terão a seguinte experiência:
- Todas as exportações da API não retornarão um URL para baixar no corpo da resposta e devem ser recuperadas por meio do armazenamento de dados.
- Todos os relatórios do dashboard e relatórios CSV serão enviados para o e-mail do usuário para download (nenhuma permissão de armazenamento necessária) e serão salvos no Armazenamento de Dados.
Requisito de formato JSON: Para exportações JSON, o Braze usa o formato JSONL (JSON delimitado por nova linha), onde cada linha contém um objeto JSON separado. Esse formato difere do JSON padrão, que é um único array ou objeto JSON. Cada linha no arquivo exportado é um objeto JSON válido, mas o arquivo como um todo não é um único documento JSON válido. Ao processar esses arquivos, analise cada linha individualmente como um objeto JSON separado, em vez de tentar analisar o arquivo inteiro como um único documento JSON.
As exportações Currents usam o formato Apache Avro (.avro arquivos), não JSON. Esse requisito de formato JSON se aplica a exportações de dados do dashboard e exportações de API que usam o formato JSON.
Solução de problemas
As credenciais do Google Cloud Storage são inválidas
Se você receber o seguinte erro ao tentar inserir suas credenciais:
1
Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.
Certifique-se de que sua conta de serviço do Google Cloud IAM tenha as seguintes permissões:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Após a verificação, você pode testar suas credenciais no dashboard do Braze.
Editar esta página no GitHub