[Ultimate]{class="badge positive"}
Google PubSub origem
O Adobe Experience Platform fornece conectividade nativa para provedores de nuvem como AWS, Google Cloud Platform e Azure, permitindo que você traga dados desses sistemas para a Plataforma para uso em serviços e destinos downstream.
As fontes de armazenamento na nuvem podem trazer seus dados para a Platform sem a necessidade de baixar, formatar ou carregar. Os dados assimilados podem ser formatados como XDM JSON, XDM Parquet ou delimitados. Cada etapa do processo é integrada ao fluxo de trabalho de origens. A Platform permite trazer dados de Google PubSub em tempo real.
Pré-requisitos prerequisites
Esta seção descreve os pré-requisitos configurados que você deve concluir antes de conectar sua conta do Google PubSub ao Experience Platform.
Criar conta de serviço create-service-account
Uma conta de serviço é um tipo de conta frequentemente usada por um aplicativo ou carga de trabalho de computação, em vez de uma pessoa. Uma conta de serviço é identificada por seu endereço de email, que é exclusivo da conta.
- Por um lado, as contas de serviço são principais - você pode conceder acesso às contas de serviço aos recursos Google Cloud. Por exemplo, você pode conceder a uma conta de serviço a função de Administrador de Computação
(roles/compute.admin)em um determinado projeto. Dessa forma, a conta de serviço poderá gerenciar os recursos do Mecanismo de computação nesse projeto específico. - Por outro lado, as contas de serviço também são recursos - você pode dar permissão a outras entidades para acessar a conta de serviço. Por exemplo, você pode conceder a um usuário a função de Usuário da Conta de Serviço
(roles/iam.serviceAccountUser)em uma conta de serviço para permitir que o usuário anexe essa conta de serviço aos recursos. Como alternativa, você pode conceder a um usuário a função de Administrador de Conta de Serviço(roles/iam.serviceAccountAdmin)para permitir que o usuário conclua tarefas como exibir, editar, desabilitar e excluir a conta de serviço.
Para obter mais informações sobre como determinar o tipo de autenticação correto para seu caso de uso, leia o Google guia sobre métodos de autenticação.
Siga as etapas descritas abaixo para criar uma conta de serviço:
Primeiro, navegue até a página IAM de Google Developer Console e selecione Create Service Account.
Em seguida, digite um nome para exibição e uma ID para a conta de serviço e selecione Create and Continue.
Gerar chaves de conta de serviço generate-service-account-keys
Para gerar chaves para sua conta de serviço, selecione o cabeçalho keys na página de contas de serviço. Ali, selecione Add key e depois selecione Create new key no menu suspenso. Você também pode usar esse painel para fazer upload de uma chave existente.
Depois de bem-sucedido, você receberá uma mensagem indicando que a chave privada foi salva no computador e que um arquivo será baixado. Em seguida, você pode usar o conteúdo desse arquivo como credenciais ao criar sua conta do Google PubSub no Experience Platform.
Conceder permissões no nível de tópico e assinatura grant-permissions
Para conceder permissões no nível de assinatura e tópico, navegue até a página do console de tópicos e selecione Show info panel. Em seguida, na guia Permissions, selecione Add Principal e adicione a entidade de conta de serviço juntamente com as permissões.
Configurações para o ideal Google PubSub usage optimal-configurations
Esta seção descreve as configurações recomendadas para otimizar o uso da fonte Google PubSub no Experience Platform.
Propriedades da assinatura subscription-properties
Use o Google Developer Console para aumentar o prazo de confirmação. Isso permite que o Google Publisher aguarde de acordo com o tempo que você configura antes de enviar a mensagem novamente. Esse atraso ajuda na redução de carga desnecessária no nível do assinante.
Habilitar exactly one delivery. Essa configuração informa o Google Publisher para garantir que as mensagens enviadas à assinatura não sejam reenviadas antes que o prazo de confirmação expire. Você pode usar essa configuração para garantir que as mensagens de confirmação não sejam reenviadas para a assinatura.
Você pode habilitar Retry after exponential backoff delay para reduzir o risco de sobrecarregar ainda mais o servidor. Você pode habilitar essa configuração no Google Developer Console para atenuar melhor as falhas transitórias (erros temporários que normalmente se resolvem), dando ao sistema mais tempo para se recuperar antes de tentar outra conexão.
Você deve definir a duração de retenção da mensagem da sua assinatura para 24 horas ou mais para garantir que dados não confirmados não sejam perdidos durante picos de carga. Além disso, habilite um tópico de letra morta para garantir que a perda de dados não ocorra mesmo durante casos de borda raros.
Conectar Google PubSub ao Experience Platform
A documentação abaixo fornece informações sobre como conectar o Google PubSub à Plataforma usando APIs ou a interface do usuário: