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 CSM da Braze para obter mais assistência na configuração e validação da sua nova integração.
A integração entre a 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 aproveitar essa parceria. |
| Currents | Para exportar dados de volta para o Google Cloud Storage, você precisa ter o Braze Currents configurado para a sua conta. O Currents não é necessário se você estiver configurando apenas o arquivamento de mensagens. |
Integração
Para integrar com o Google Cloud Storage, você deve configurar as credenciais apropriadas que permitam à Braze obter informações sobre os buckets de armazenamento que estão sendo gravados (storage.buckets.get) e criar objetos dentro desse bucket (storage.objects.create).
O Workload Identity Federation (WIF) não é compatível como método de autenticação para o Currents. Você deve usar uma conta de serviço com uma chave privada JSON.
Isso pode ser feito usando as instruções a seguir, que orientam você na criação de uma função e conta de serviço que gerará uma chave privada para uso na sua integração com o Currents.
Etapa 1: Criar função
Crie uma nova função no console do Google Cloud Platform navegando até IAM & admin > Roles > + Create Role.
Dê um nome à função, selecione +Add Permissions e escolha as seguintes:
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 circunstâncias raras, o Google Cloud pode encerrar conexões antecipadamente, resultando na gravação de arquivos incompletos pela Braze 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.
Se o seu bucket usa namespace hierárquico, você também deve adicionar a permissão storage.folders.create. Nesses buckets, as pastas são recursos gerenciados, então a Braze precisa dessa permissão para criar a estrutura de pastas dos seus arquivos exportados. Sem ela, a Braze não consegue gravar no bucket e a integração falha ao exportar dados.
Quando terminar, selecione Create.
Etapa 2: Criar uma nova conta de serviço
Etapa 2.1: Criar a conta de serviço
Crie uma nova conta de serviço no console do Google Cloud Platform navegando até IAM & admin > Service Accounts e selecionando Create Service Account.
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 para criar uma chave privada JSON para uso na Braze. Após a criação da chave, ela será baixada na sua máquina.
Etapa 3: Configurar o Currents na Braze
Na Braze, navegue até Currents > + Create Current > Google Cloud Storage Data Export e forneça o nome da integração e o e-mail de contato.
Forneça um e-mail de contato para notificações de erros de integração. A Braze envia notificações para esse endereço se a integração encontrar erros, como problemas de credencial ou de conectividade. Para garantir que as pessoas certas recebam os alertas, use uma lista de distribuição ou um endereço de e-mail de grupo.
Em seguida, faça o upload da sua chave privada JSON em GCS JSON Credentials e forneça o nome do bucket GCS e o prefixo GCS (opcional). Observe que você deve gerar essas credenciais pelo Google Cloud Platform, conforme descrito nas etapas anteriores.
É importante manter seu arquivo de credenciais atualizado. Se as credenciais do seu 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 permanentemente perdidos.
Por fim, role até a parte inferior da página e selecione quais eventos de engajamento com mensagem ou eventos de comportamento do cliente você deseja exportar. Quando concluído, inicie seu Current.
Etapa 4: Configurar exportações do Google Cloud Storage
Para configurar exportações do Google Cloud Storage (GCS), acesse Technology Partners > Google Cloud Storage, insira suas credenciais do GCS e selecione Make this the default data export destination.
Tenha em mente que a organização e o conteúdo de quaisquer arquivos exportados serão idênticos nas integrações com AWS S3, Microsoft Azure e Google Cloud Storage.
Etapa 5: Testar as credenciais da sua conta de serviço (opcional)
Sua conta de serviço IAM do Google Cloud deve ter as seguintes permissões:
storage.objects.createstorage.objects.deletestorage.objects.liststorage.objects.getstorage.buckets.get
Para verificar essas permissões no dashboard da Braze, acesse a página Google Cloud Storage e selecione Test Credentials.
Comportamento de exportação
Os usuários que integraram uma solução de armazenamento de dados em nuvem e estão tentando exportar APIs, relatórios do dashboard ou relatórios CSV terão a seguinte experiência:
- Todas as exportações de API não retornarão uma URL de download 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 (sem necessidade de permissões de armazenamento) e terão backup no armazenamento de dados.
Requisito de formato JSON: Para exportações JSON, a Braze usa o formato JSONL (JSON delimitado por nova linha), em que 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 do Currents usam o formato Apache Avro (arquivos .avro), não JSON. Esse requisito de formato JSON se aplica a exportações de dados do dashboard e exportações de API que usam 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:
Google Cloud Storage Credentials are invalid. Please ensure that your credentials string, bucket name, and prefix are valid. You do not have read permission.
Verifique se a conta de serviço IAM do Google Cloud tem 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 da Braze.