[Ultimate]{class="badge positive"}

Google PubSub origem

IMPORTANT
A variável Google PubSub origem está disponível no catálogo de origens para usuários que compraram o Real-time Customer Data Platform Ultimate.

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 Platform 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 Google PubSub conta para Experience Platform.

Criar conta de serviço create-service-account

A 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 principais - você pode conceder acesso às contas de serviço do Google Cloud recursos. Por exemplo, você pode conceder a uma conta de serviço a função 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 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 da conta de serviço (roles/iam.serviceAccountAdmin) para permitir que o usuário conclua tarefas como exibir, editar, desativar 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é o IAM página do Google Developer Console e selecione Create Service Account.

A janela Criar conta de serviço no Console do desenvolvedor do Google

Em seguida, digite um nome para exibição e uma ID para a conta de serviço e selecione Create and Continue.

Os detalhes da conta de serviço no Console do desenvolvedor do Google

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. Nesse ponto, selecione Add key e selecione Create new key no menu suspenso. Você também pode usar esse painel para fazer upload de uma chave existente.

A janela de adição de chave no Console do desenvolvedor do Google

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 Google PubSub conta no Experience Platform.

Conceder permissões no nível de tópico e assinatura grant-permissions

Para conceder permissões no nível de tópico e de assinatura, navegue até a página do console de tópicos e selecione Show info panel. Em seguida, sob o Permissions selecione Add Principal e adicione a entidade de conta de serviço junto com as permissões.

A janela pop-up no Console do desenvolvedor do Google, onde você pode conceder permissões no nível de tópico e subscrição

Configurações ideais Google PubSub usage optimal-configurations

Esta seção descreve as configurações recomendadas para otimizar o uso do Google PubSub fonte 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 Aguardar 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.

A interface do prazo de confirmação no Google Developer Console.

Ativar 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.

A página de configuração de delivery exatamente no Console do desenvolvedor do Google.

Você pode ativar Retry after exponential backoff delay para reduzir o risco de sobrecarregar 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), fornecendo ao sistema mais tempo para recuperação antes de tentar outra conexão.

A janela Retry policy no Google Developer Console.

Você deve defina a duração de retenção da mensagem de sua assinatura para 24 horas ou mais para garantir que dados não reconhecidos não sejam perdidos durante picos de carga. Além disso, ativar um tópico de letra morta para garantir que a perda de dados não ocorra mesmo durante casos de borda raros.

IMPORTANT
Você só pode criar um fluxo de dados de origem por Google PubSub assinatura. A reutilização de uma assinatura, mesmo em sandboxes, resulta em perda de dados.

Conectar Google PubSub para Experience Platform

A documentação abaixo fornece informações sobre como se conectar Google PubSub para a Platform usando APIs ou a interface do usuário:

Uso de APIs

Uso da interface

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089