21.4 Criar e configurar uma função do Google Cloud

21.4.1 Criar a função do Google Cloud

Vá para https://console.cloud.google.com/. Vá para Funções da nuvem.

GCP

Você verá isso. Clique em Criar projeto.

GCP

Como Nome do projeto, use Lado do servidor do Launch - GCP.
Como Location, escolha onde armazenar o projeto.

Clique em CRIAR.

GCP

O projeto será criado.

GCP

Em seguida, você pode criar uma Função da nuvem. Clique em CRIAR FUNÇÃO.

GCP

Você verá isso.

GCP

Faça as seguintes opções:

  • Nome da função: ldap-launch-ssf (substitua ldap pelo seu ldap)
  • Região: selecione qualquer região
  • Tipo de acionador: selecionar HTTP
  • Autenticação: selecione Permitir invocações não autenticadas

Você deveria ter isso agora. Clique em SAVE.

GCP

Clique em NEXT.

GCP

Você verá isso:

GCP

Faça as seguintes opções:

  • Tempo de execução: selecione Node.js 12
  • Ponto de entrada: digite helloAEP

GCP

Clique em ENABLE API para habilitar Cloud Build API. Você verá uma nova janela. Nessa nova janela, clique novamente em ENABLE.

GCP

Depois que API da nuvem for ativada, você verá isso.

GCP

Volte para sua Função da nuvem.

GCP

No Editor em linha da função da nuvem, verifique se você tem o seguinte código:

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloAEP = (req, res) => {
  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Em seguida, clique em IMPLANTAR.

Você verá isso. Sua função da nuvem está sendo criada. Isso pode levar alguns minutos.

GCP

Depois que sua função for criada e executada, você verá isso. Clique no nome da sua função para abri-la.

GCP

Você verá isso. Vá para TRIGGER. Você verá o URL do Acionador que é o que você usará para definir o ponto de extremidade no Lado do Servidor do Launch.

GCP

Copie o URL do acionador, que tem a seguinte aparência: https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf.

Nas próximas etapas, você configurará o Servidor de coleta de dados da Adobe Experience Platform para transmitir informações específicas sobre Exibições de página para sua função da Nuvem do Google. Em vez de apenas encaminhar a carga útil completa como está, você só enviará itens como ECID, timestamp e Page Name para sua função do Google Cloud.

Este é um exemplo de uma carga que você precisará analisar para filtrar as variáveis mencionadas acima:

{
  "events": [
    {
      "xdm": {
		  "eventType": "web.webpagedetails.pageViews",
		  "web": {
		    "webPageDetails": {
		      "URL": "https://public.aepdemo.net/index.html",
		      "name": "Luma Home"
		    },
		    "webReferrer": {
		      "URL": "https://public.aepdemo.net/admin.html"
		    }
		  },
		  "device": {
		    "screenHeight": 1080,
		    "screenWidth": 1920,
		    "screenOrientation": "landscape"
		  },
		  "environment": {
		    "type": "browser",
		    "browserDetails": {
		      "viewportWidth": 1920,
		      "viewportHeight": 507,
		      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 11_1_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.96 Safari/537.36",
		      "acceptLanguage": "en"
		    }
		  },
		  "placeContext": {
		    "localTime": "2021-01-29T15:45:26.815+01:00",
		    "localTimezoneOffset": -60
		  },
		  "timestamp": "2021-01-29T14:45:26.815Z",
		  "implementationDetails": {
		    "name": "https://ns.adobe.com/experience/alloy/reactor",
		    "version": "2.3.0+2.2.0",
		    "environment": "browser"
		  },
		  "_experienceplatform": {
		    "identification": {
		      "core": {
		        "ecid": "83249052138816938582105724584714316131"
		      }
		    },
		    "demoEnvironment": {
		      "tms": "Launch",
		      "ldap": "vangeluw",
		      "brandLogo": "https://parsefiles.back4app.com/hgJBdVOS2eff03JCn6qXXOxT5jJFzialLAHJixD9/d632e769791f0a4dbe0b84058d282d45_logo.png",
		      "brandName": "Luma",
		      "brandIndustry": "retail"
		    }
		  }
		}

Esses são os campos que contêm as informações que precisam ser analisadas:

  • ECID: events.xdm._experienceplatform.identification.core.ecid
  • timestamp: carimbo de data/hora
  • Nome da página: events.xdm.web.webPageDetails.name

Vamos para o Adobe Experience Platform Data Collection Server agora, para configurar os elementos de dados para tornar isso possível.

21.4.2 Atualize sua propriedade do Servidor de coleta de dados da Adobe Experience Platform: Elementos de dados

Vá para https://experience.adobe.com/#/data-collection/.

Coleta de dados do Adobe Experience Platform SSF

No canto superior esquerdo, clique em Lado do cliente e, no menu suspenso, clique em Lado do servidor. Em seguida, você verá uma visão geral de todas as propriedades disponíveis do Adobe Experience Platform Data Collection Server. Clique em para abrir a propriedade criada em exercício 21.1.

Coleta de dados do Adobe Experience Platform SSF

No menu esquerdo, vá para Elementos de dados. Clique em Adicionar elemento de dados.

Coleta de dados do Adobe Experience Platform SSF

Você verá um novo elemento de dados para configurar.

Coleta de dados do Adobe Experience Platform SSF

Faça a seguinte seleção:

  • Como Nome, digite customerECID.
  • Como Extension, selecione Core.
  • Como Tipo de elemento de dados, selecione Caminho.
  • Como o Caminho, digite arc.event.xdm.--aepTenantId--.identification.core.ecid. Ao inserir esse caminho, você estará filtrando o campo ecid a partir da carga útil do evento que é enviada pelo site ou aplicativo móvel para a Adobe Edge.
OBSERVAÇÃO

Nos caminhos acima e abaixo, é feita referência a arc. ​arquipélagos para o Contexto de Recurso do Adobe e ​para os corredores representa o objeto mais alto disponível no contexto do lado do servidor. Enriquecimentos e transformações podem ser adicionados a esse objeto arc usando as funções do Servidor de coleta de dados do Adobe Experience Platform.

Nos caminhos acima e abaixo, é feita referência a event. Eventos representam um evento exclusivo e o Adobe Experience Platform Data Collection Server sempre avaliará cada evento individualmente. Às vezes, você pode ver uma referência a events no payload enviado pelo lado do cliente do SDK da Web, mas no Adobe Experience Platform Data Collection Server, cada evento é avaliado individualmente.

Agora você terá isso. Clique em Salvar.

Coleta de dados do Adobe Experience Platform SSF

Clique em Adicionar elemento de dados.

Coleta de dados do Adobe Experience Platform SSF

Você verá um novo elemento de dados para configurar.

Coleta de dados do Adobe Experience Platform SSF

Faça a seguinte seleção:

  • Como Nome, digite eventTimestamp.
  • Como Extension, selecione Core.
  • Como Tipo de elemento de dados, selecione Caminho.
  • Como o Path, digite arc.event.xdm.timestamp. Ao inserir esse caminho, você estará filtrando o campo timestamp a partir da carga útil do evento que é enviada pelo site ou aplicativo móvel para a Adobe Edge.

Agora você terá isso. Clique em Salvar.

Coleta de dados do Adobe Experience Platform SSF

Clique em Adicionar elemento de dados.

Coleta de dados do Adobe Experience Platform SSF

Você verá um novo elemento de dados para configurar.

Coleta de dados do Adobe Experience Platform SSF

Faça a seguinte seleção:

  • Como Name, digite pageName.
  • Como Extension, selecione Core.
  • Como Tipo de elemento de dados, selecione Caminho.
  • Como o Path, digite arc.event.xdm.web.webPageDetails.name. Ao inserir esse caminho, você estará filtrando o campo name a partir da carga útil do evento que é enviada pelo site ou aplicativo móvel para a Adobe Edge.

Agora você terá isso. Clique em Salvar.

Coleta de dados do Adobe Experience Platform SSF

Agora, esses elementos de dados são criados:

Coleta de dados do Adobe Experience Platform SSF

21.4.3 Atualize sua propriedade do Servidor de coleta de dados da Adobe Experience Platform: Atualizar uma regra

No menu esquerdo, vá para Rules. No exercício anterior, você criou a regra Todas as páginas. Clique nessa regra para abri-la.

Coleta de dados do Adobe Experience Platform SSF

Então você vai fazer isso. Clique no ícone + em Actions para adicionar uma nova ação.

Coleta de dados do Adobe Experience Platform SSF

Você verá isso.

Coleta de dados do Adobe Experience Platform SSF

Faça a seguinte seleção:

  • Selecione a Extensão: Conector da nuvem do Adobe.
  • Selecione o Tipo de ação: Efetuar chamada de busca.

Isso deve lhe dar este Nome: Conector do Adobe Cloud - Faça a chamada de busca. Agora você deve ver o seguinte:

Coleta de dados do Adobe Experience Platform SSF

Em seguida, configure o seguinte:

  • Altere o protocolo de solicitação de GET para POST
  • Insira o URL da função do Google Cloud que você criou em uma das etapas anteriores, com esta aparência: https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf

Você deveria ter isso agora. Em seguida, vá para Body.

Coleta de dados do Adobe Experience Platform SSF

Você verá isso. Clique no botão de opção para JSON.

Coleta de dados do Adobe Experience Platform SSF

Configure o Corpo da seguinte maneira:

CHAVE VALOR
customerECID {
pageName {{pageName}}
eventTimestamp {

Você verá isso. Clique em Manter alterações.

Coleta de dados do Adobe Experience Platform SSF

Você verá isso. Clique em Salvar.

Coleta de dados do Adobe Experience Platform SSF

Agora você atualizou sua regra existente em uma propriedade do Adobe Experience Platform Data Collection Server. Vá para Fluxo de publicação para publicar suas alterações. Abra a biblioteca de desenvolvimento v1 clicando em Editar conforme indicado.

Coleta de dados do Adobe Experience Platform SSF

Clique no botão Adicionar todos os recursos alterados , depois disso, você verá sua regra e o elemento de dados aparecerem nessa biblioteca. Em seguida, clique em Salvar e criar para desenvolvimento. Suas alterações estão sendo implantadas.

Coleta de dados do Adobe Experience Platform SSF

Após alguns minutos, você verá que a implantação foi concluída e está pronta para ser testada.

Coleta de dados do Adobe Experience Platform SSF

21.3.4 Teste sua configuração

Abra uma nova janela do navegador incognitivo e limpe e vá para https://public.aepdemo.net.

Você verá isso.

Configuração da coleta de dados do Adobe Experience Platform

Insira a ID de configuração e clique em Carregar configuração. Sua configuração é carregada.

Configuração da coleta de dados do Adobe Experience Platform

Role para baixo e clique em Salvar configuração.

Configuração da coleta de dados do Adobe Experience Platform

Em seguida, você será redirecionado para a página inicial do Administrador. Vá para Selecionar LDAP. Selecione o LDAP e clique em Save.

Configuração da coleta de dados do Adobe Experience Platform

Em seguida, você será redirecionado para a página inicial do Administrador. Vá para Selecione a Marca e selecione a marca Luma, clique em Salvar.

Configuração da coleta de dados do Adobe Experience Platform

Em seguida, você será redirecionado para a página inicial do Administrador. Clique no logotipo Luma.

Configuração da coleta de dados do Adobe Experience Platform

Você verá a página do Luma.

Configuração da coleta de dados do Adobe Experience Platform

Ao abrir a Visualização do desenvolvedor do navegador, você pode inspecionar as solicitações de rede, conforme indicado abaixo. Ao usar o filtro interagir, você verá as solicitações de rede enviadas pelo Cliente de coleta de dados da Adobe Experience Platform para a Adobe Edge.

Configuração da coleta de dados do Adobe Experience Platform

Alterne sua exibição para a Função da Nuvem do Google e vá para LOGS. Agora você deve ter uma exibição semelhante a essa, com várias entradas de log sendo mostradas. Toda vez que você vê Função de execução iniciada, isso significa que o tráfego de entrada foi recebido em sua Função do Google Cloud.

Configuração da coleta de dados do Adobe Experience Platform

Vamos atualizar sua função um pouco para funcionar com os dados recebidos e exibir as informações recebidas do Servidor de coleta de dados da Adobe Experience Platform. Vá para SOURCE e clique em EDIT.

Configuração da coleta de dados do Adobe Experience Platform

Na próxima tela, clique em NEXT.

Configuração da coleta de dados do Adobe Experience Platform

Atualize seu código desta forma:

/**
 * Responds to any HTTP request.
 *
 * @param {!express:Request} req HTTP request context.
 * @param {!express:Response} res HTTP response context.
 */
exports.helloAEP = (req, res) => {
  console.log('>>>>> Function has started. The following information was received from Launch Server Side:');
  console.log(req.body);

  let message = req.query.message || req.body.message || 'Hello World!';
  res.status(200).send(message);
};

Você terá isso. Clique em IMPLANTAR.

Configuração da coleta de dados do Adobe Experience Platform

Após alguns minutos, sua função será implantada novamente. Clique no nome da sua função para abri-la.

Configuração da coleta de dados do Adobe Experience Platform

No seu site de demonstração, navegue até um produto, como Nadia Elements Shell, por exemplo.

Configuração da coleta de dados do Adobe Experience Platform

Alterne sua exibição para a Função da Nuvem do Google e vá para LOGS. Agora você deve ter uma exibição semelhante a essa, com várias entradas de log sendo mostradas.

Para cada exibição de página no seu site de demonstração, você deve ver uma nova entrada de log pop-up nos logs da função da Google Cloud, que mostram as informações recebidas.

Configuração da coleta de dados do Adobe Experience Platform

Agora você enviou com sucesso os dados coletados pela Coleta de dados da Adobe Experience Platform, em tempo real, para um endpoint da Função da nuvem do Google. A partir daí, esses dados podem ser usados por qualquer aplicativo da Google Cloud Platform, como o BigQuery para armazenamento e relatórios ou para casos de uso do Machine Learning.

Próxima etapa: 21.5 Criar e configurar uma Função do Microsoft Azure

Voltar ao Módulo 21

Voltar para todos os módulos

Nesta página