21.4 Creare e configurare una funzione Google Cloud

21.4.1 Crea la tua funzione Google Cloud

Vai a https://console.cloud.google.com/. Vai a Funzioni cloud.

GCP

Vedrete questo. Fai clic su Crea progetto.

GCP

Come Nome progetto, utilizza Lato server Launch - GCP.
Come Posizione, scegli dove memorizzare il progetto.

Fai clic su CREA.

GCP

Il progetto verrà quindi creato.

GCP

Puoi quindi creare una funzione cloud. Fai clic su CREA FUNZIONE.

GCP

Vedrete questo.

GCP

Effettua le seguenti scelte:

  • Nome funzione: ldap-launch-ssf (sostituisci ldap con il tuo ldap)
  • Regione: seleziona una regione
  • Tipo di trigger: select HTTP
  • Autenticazione: select Consenti chiamate non autenticate

Dovrebbe avere questo ora. Fai clic su SALVA.

GCP

Fai clic su SUCCESSIVO.

GCP

Vedrai questo:

GCP

Effettua le seguenti scelte:

  • Runtime: select Node.js 12
  • Punto di ingresso: enter helloAEP

GCP

Fai clic su ABILITA API per abilitare API di Cloud Build. Verrà visualizzata una nuova finestra. In quella nuova finestra, fai clic su ABILITA di nuovo.

GCP

Una volta API di Cloud Build è stato abilitato, verrà visualizzato questo.

GCP

Torna alla pagina Funzione cloud.

GCP

Nell’editor in linea della funzione cloud, assicurati di avere il seguente codice:

/**
 * 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);
};

Quindi, fai clic su DISTRIBUZIONE.

Vedrete questo. È in corso la creazione della funzione Cloud. L'operazione potrebbe richiedere un paio di minuti.

GCP

Una volta creata ed eseguita la funzione, verrà visualizzato questo. Fai clic sul nome della funzione per aprirla.

GCP

Vedrete questo. Vai a TRIGGER. Vedrai il URL trigger che è ciò che verrà utilizzato per definire l’endpoint nel lato server di Launch.

GCP

Copia l'URL del trigger, che si presenta così: https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf.

Nei passaggi successivi, configurerai Adobe Experience Platform Data Collection Server per lo streaming di informazioni specifiche su Visualizzazioni pagina alla tua funzione Google Cloud. Invece di inoltrare l'intero payload così com'è, invierai solo cose come ECID, timestamp e Nome pagina alla tua funzione Google Cloud.

Ecco un esempio di payload da analizzare per filtrare le variabili di cui sopra:

{
  "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"
		    }
		  }
		}

Questi sono i campi che contengono le informazioni da analizzare:

  • ECID: events.xdm_experienceplatform.identity.core.ecid
  • timestamp: timestamp
  • Nome pagina: events.xdm.web.webPageDetails.name

Andiamo ora su Adobe Experience Platform Data Collection Server per configurare gli elementi dati in modo che ciò sia possibile.

21.4.2 Aggiorna la proprietà Adobe Experience Platform Data Collection Server : Elementi dati

Vai a https://experience.adobe.com/#/data-collection/.

SSF raccolta dati Adobe Experience Platform

In alto a sinistra, fai clic su Lato client e nel menu a discesa fai clic su Lato server. Verrà visualizzata una panoramica di tutte le proprietà disponibili di Adobe Experience Platform Data Collection Server. Fai clic per aprire la proprietà creata in esercizio 21.1.

SSF raccolta dati Adobe Experience Platform

Nel menu a sinistra, vai a Elementi dati. Fai clic su Aggiungi elemento dati.

SSF raccolta dati Adobe Experience Platform

Verrà quindi visualizzato un nuovo elemento dati da configurare.

SSF raccolta dati Adobe Experience Platform

Effettua la selezione seguente:

  • Come Nome, inserisci customerECID.
  • Come Estensione, seleziona Core.
  • Come Tipo di elemento dati, seleziona Percorso.
  • Come Percorso, inserisci arc.event.xdm.--aepTenantId--.identification.core.ecid. Inserendo questo percorso, filtrerai il campo ecid dal payload dell’evento inviato dal sito web o dall’app mobile in Adobe Edge.
NOTA

Nei percorsi sopra e sotto viene fatto riferimento a arc. arc sta per contesto risorsa Adobe e arc sta sempre per l'oggetto disponibile più alto disponibile nel contesto lato server. Arricchimenti e trasformazioni possono essere aggiunti a quello arc mediante le funzioni di Adobe Experience Platform Data Collection Server.

Nei percorsi sopra e sotto viene fatto riferimento a event. event sta per un evento univoco e Adobe Experience Platform Data Collection Server valuterà sempre ogni singolo evento. A volte è possibile visualizzare un riferimento a events nel payload inviato dal lato client dell’SDK per web, ma in Adobe Experience Platform Data Collection Server, ogni evento viene valutato singolarmente.

Ora avrà questo. Fai clic su Salva.

SSF raccolta dati Adobe Experience Platform

Fai clic su Aggiungi elemento dati.

SSF raccolta dati Adobe Experience Platform

Verrà quindi visualizzato un nuovo elemento dati da configurare.

SSF raccolta dati Adobe Experience Platform

Effettua la selezione seguente:

  • Come Nome, inserisci eventTimestamp.
  • Come Estensione, seleziona Core.
  • Come Tipo di elemento dati, seleziona Percorso.
  • Come Percorso, inserisci arc.event.xdm.timestamp. Inserendo questo percorso, filtrerai il campo timestamp dal payload dell’evento inviato dal sito web o dall’app mobile in Adobe Edge.

Ora avrà questo. Fai clic su Salva.

SSF raccolta dati Adobe Experience Platform

Fai clic su Aggiungi elemento dati.

SSF raccolta dati Adobe Experience Platform

Verrà quindi visualizzato un nuovo elemento dati da configurare.

SSF raccolta dati Adobe Experience Platform

Effettua la selezione seguente:

  • Come Nome, inserisci pageName.
  • Come Estensione, seleziona Core.
  • Come Tipo di elemento dati, seleziona Percorso.
  • Come Percorso, inserisci arc.event.xdm.web.webPageDetails.name. Inserendo questo percorso, filtrerai il campo name dal payload dell’evento inviato dal sito web o dall’app mobile in Adobe Edge.

Ora avrà questo. Fai clic su Salva.

SSF raccolta dati Adobe Experience Platform

Ora sono stati creati i seguenti elementi dati:

SSF raccolta dati Adobe Experience Platform

21.4.3 Aggiorna la proprietà Adobe Experience Platform Data Collection Server : Aggiornare una regola

Nel menu a sinistra, vai a Regole. Nell’esercizio precedente, hai creato la regola Tutte le pagine. Fai clic su tale regola per aprirla.

SSF raccolta dati Adobe Experience Platform

Allora farai questo. Fai clic sul pulsante + icona sotto Azioni per aggiungere una nuova azione.

SSF raccolta dati Adobe Experience Platform

Vedrete questo.

SSF raccolta dati Adobe Experience Platform

Effettua la selezione seguente:

  • Seleziona la Estensione: Connettore cloud di Adobe.
  • Seleziona la Tipo di azione: Fai una chiamata di recupero.

Questo dovrebbe darvi questo Nome: Connettore cloud di Adobe - Effettua una chiamata di recupero. Ora dovresti vedere quanto segue:

SSF raccolta dati Adobe Experience Platform

Quindi, configura quanto segue:

  • Modifica il protocollo di richiesta da GET a POST
  • Inserisci l’URL della funzione cloud Google che hai creato in uno dei passaggi precedenti, simile al seguente: https://us-central1-launch-server-side-gcp.cloudfunctions.net/vangeluw-launch-ssf

Dovrebbe avere questo ora. Quindi, vai a Corpo.

SSF raccolta dati Adobe Experience Platform

Vedrete questo. Fai clic sul pulsante di scelta per JSON.

SSF raccolta dati Adobe Experience Platform

Configura le Corpo come segue:

CHIAVE VALORE
customerECID {{customerECID}}
pageName {{pageName}}
eventTimestamp {{eventTimestamp}}

Vedrete questo. Fai clic su Mantieni modifiche.

SSF raccolta dati Adobe Experience Platform

Vedrete questo. Fai clic su Salva.

SSF raccolta dati Adobe Experience Platform

È ora possibile aggiornare la regola esistente in una proprietà Adobe Experience Platform Data Collection Server. Vai a Flusso di pubblicazione per pubblicare le modifiche. Apri la libreria di sviluppo . v1 facendo clic su Modifica come indicato.

SSF raccolta dati Adobe Experience Platform

Fai clic sul pulsante Aggiungi tutte le risorse modificate , dopodiché vedrai la regola e l'elemento dati visualizzati in questa libreria. Quindi, fai clic su Salva e genera per sviluppo. Le modifiche vengono ora distribuite.

SSF raccolta dati Adobe Experience Platform

Dopo un paio di minuti, vedrai che la distribuzione è completata e pronta per essere testata.

SSF raccolta dati Adobe Experience Platform

21.3.4 Verifica la configurazione

Apri una nuova finestra del browser in incognito pulita e vai a https://public.aepdemo.net.

Vedrete questo.

Configurazione della raccolta dati di Adobe Experience Platform

Immetti l'ID di configurazione e fai clic su Carica configurazione. La configurazione viene quindi caricata.

Configurazione della raccolta dati di Adobe Experience Platform

Scorri verso il basso e fai clic su Salva configurazione.

Configurazione della raccolta dati di Adobe Experience Platform

Verrai quindi reindirizzato alla home page dell’amministratore. Vai a Seleziona LDAP. Seleziona il tuo LDAP e fai clic su Salva.

Configurazione della raccolta dati di Adobe Experience Platform

Verrai quindi reindirizzato alla home page dell’amministratore. Vai a Seleziona marchio e seleziona il marchio Luma, fai clic su Salva.

Configurazione della raccolta dati di Adobe Experience Platform

Verrai quindi reindirizzato alla home page dell’amministratore. Fai clic sul pulsante Luma logo.

Configurazione della raccolta dati di Adobe Experience Platform

Vedrete la home page di Luma.

Configurazione della raccolta dati di Adobe Experience Platform

Quando apri il browser Developer View, puoi controllare le richieste di rete come indicato di seguito. Quando utilizzi il filtro interagire, vedrai le richieste di rete inviate dal client di raccolta dati di Adobe Experience Platform ad Adobe Edge.

Configurazione della raccolta dati di Adobe Experience Platform

Passa alla funzione Google Cloud e passa a REGISTRI. Ora dovresti avere una visualizzazione simile a questa, con una serie di voci di registro visualizzate. Ogni volta che vedi Esecuzione della funzione avviata, significa che il traffico in entrata è stato ricevuto nella tua funzione Google Cloud.

Configurazione della raccolta dati di Adobe Experience Platform

Aggiorna un po' la tua funzione per lavorare con i dati in arrivo e visualizza le informazioni ricevute da Adobe Experience Platform Data Collection Server. Vai a ORIGINE e fai clic su MODIFICA.

Configurazione della raccolta dati di Adobe Experience Platform

Nella schermata successiva, fai clic su SUCCESSIVO.

Configurazione della raccolta dati di Adobe Experience Platform

Aggiorna il tuo codice in questo modo:

/**
 * 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);
};

Poi avrai questo. Fai clic su DISTRIBUZIONE.

Configurazione della raccolta dati di Adobe Experience Platform

Dopo un paio di minuti, la funzione verrà nuovamente distribuita. Fai clic sul nome della funzione per aprirla.

Configurazione della raccolta dati di Adobe Experience Platform

Nel sito web dimostrativo, accedi a un prodotto, ad esempio Nadia Elements Shell.

Configurazione della raccolta dati di Adobe Experience Platform

Passa alla funzione Google Cloud e passa a REGISTRI. Ora dovresti avere una visualizzazione simile a questa, con una serie di voci di registro visualizzate.

Per ogni visualizzazione di pagina sul sito web demo, è ora necessario visualizzare una nuova voce di registro nei registri della funzione Google Cloud, che mostra le informazioni ricevute.

Configurazione della raccolta dati di Adobe Experience Platform

I dati raccolti da Adobe Experience Platform Data Collection in tempo reale sono stati inviati correttamente a un endpoint Google Cloud Function. Da lì, tali dati possono essere utilizzati da qualsiasi applicazione Google Cloud Platform, ad esempio BigQuery per l'archiviazione e il reporting o per i casi di utilizzo di Machine Learning.

Passaggio successivo: 21.5 Creare e configurare una funzione di Microsoft Azure

Torna al modulo 21

Torna a tutti i moduli

In questa pagina