16.3 Collegare GCP e BigQuery a Adobe Experience Platform

Obiettivi

  • Esplorare API e servizi in Google Cloud Platform
  • Acquisisci familiarità con OAuth Playground per testare le API di Google
  • Create your first BigQuery connection in Adobe Experience Platform

Contesto

Adobe Experience Platform fornisce un connettore all'interno di Origini questo ti aiuterà a portare i set di dati BigQuery in Adobe Experience Platform. Questo connettore dati si basa sull’API BigQuery di Google. Pertanto, è importante preparare correttamente la piattaforma Google Cloud e l’ambiente BigQuery per ricevere chiamate API da Adobe Experience Platform.

Per configurare il connettore di origine BigQuery in Adobe Experience Platform, sono necessari i seguenti 4 valori:

  • progetto
  • clientId
  • clientSecret
  • refreshToken

Finora avete solo il primo, il ID progetto. Questo ID progetto value è un ID casuale generato da Google quando hai creato il progetto BigQuery durante l’esercizio 16.1.

Copia l’ID del progetto in un file di testo separato.

Credenziali Denominazione Esempio
ID progetto random composito-task-306413

You can check your Project ID any time by clicking on your Project Name in the top menu bar:

demo

Vedrai il tuo Project ID sul lato destro:

demo

In questo esercizio imparerai come ottenere gli altri 3 campi obbligatori:

  • clientId
  • clientSecret
  • refreshToken

API e servizi di Google Cloud 16.3.1

Per iniziare, torna alla home page di Google Cloud Platform. To do this, simply click on the logo in the top left-corner of your screen.

demo

Una volta nella home page, vai al menu a sinistra e fai clic su API e servizi, quindi Fai clic su Dashboard.

demo

You'll now see the APIs & Services homepage.

demo

On this page, you're able to see the usage of your various Google API connections. In order to setup an API Connection so that Adobe Experience Platform can read from BigQuery, you need to follow these steps:

  • Innanzitutto, devi creare una schermata di consenso OAuth per abilitare le autenticazioni future. Per motivi di sicurezza Google è inoltre necessario che un utente effettui la prima autenticazione, prima che sia consentito un accesso programmatico.
  • In secondo luogo, sono necessarie le credenziali API (clientId e clientSecret) che verranno utilizzate per l’autenticazione API e l’accesso al connettore BigQuery.

Schermata di consenso OAuth 16.3.2

Cominciamo con la creazione della schermata di consenso OAuth. Nel menu a sinistra della API e servizi home page, fai clic su Schermata di consenso OAuth.

demo

Vedrai questo:

demo

Seleziona il tipo di utente: Esterno. Quindi, fai clic su CREA.

demo

Allora sarai sul Configurazione della schermata di consenso OAuth finestra.

L’unica cosa da fare è inserire il nome della schermata di consenso nel Nome applicazione e seleziona il E-mail di supporto utente. Per il nome dell'applicazione, utilizzare questa convenzione di denominazione:

Denominazione Esempio
ldap - Connettore BigQuery AEP vangeluw - Connettore Platform BigQuery

demo

Quindi, scorri verso il basso fino a visualizzare Informazioni sui contatti per gli sviluppatori e compila un indirizzo e-mail.

demo

Fai clic su SALVA E CONTINUA.

demo

Vedrete questo. Fai clic su SALVA E CONTINUA.

demo

Vedrete questo. Fai clic su SALVA E CONTINUA.

demo

You'll then see this. Fai clic su TORNA AL DASHBOARD.

demo

Vedrete questo. Fai clic su PUBBLICA APP.

demo

Fai clic su CONFERMA.

demo

Vedrete questo.

demo

Nel passaggio successivo, finirai la configurazione dell’API e otterrai le tue credenziali API.

Credenziali API Google 16.3.3: Segreto client e ID client

Nel menu a sinistra, fai clic su Credenziali. Vedrai questo:

demo

Fai clic sul pulsante + CREARE CREDENZIALI pulsante .

demo

Vedrete 3 opzioni. Fai clic sul pulsante ID client OAuth:

demo

Nella schermata successiva, seleziona Applicazione Web.

demo

Verranno visualizzati diversi nuovi campi. È ora necessario inserire il Nome dell’ID client OAuth e immetti anche il URI di reindirizzamento autorizzati.

Segui questa convenzione di denominazione:

Campo Valore Esempio
Nome ldap - Connettore BigQuery AEP vangeluw - Connettore Platform BigQuery
URI di reindirizzamento autorizzati https://developers.google.com/oauthplayground https://developers.google.com/oauthplayground

La URI di reindirizzamento autorizzati Il campo è un campo molto importante perché sarà necessario in un secondo momento per ottenere il RefreshToken necessario per completare la configurazione del connettore di origine BigQuery in Adobe Experience Platform.

demo

Prima di continuare, è necessario spingere fisicamente il Invio dopo aver inserito l’URL per memorizzare il valore nel URI di reindirizzamento autorizzati campo . Se non fai clic sul pulsante Invio In un secondo momento, ti imbatti in problemi nella Playground OAuth 2.0.

Quindi, fai clic su Crea:

demo

Ora vedrai il tuo ID client e il tuo segreto client.

demo

Copia questi due campi e incollali in un file di testo sul desktop. Puoi sempre accedere a queste credenziali in una fase successiva, ma è più semplice salvarle in un file di testo accanto al tuo ID progetto BigQuery.

Per eseguire nuovamente la configurazione del connettore di origine BigQuery in Adobe Experience Platform, ora sono già disponibili i seguenti valori:

Credenziali del connettore BigQuery Valore
ID progetto il tuo ID progetto (ad esempio: composito-task-306413)
clientid yourclientid
cilentsecret segreto client

Ti stai ancora perdendo il refreshToken. L'aggiornamentoToken è un requisito per motivi di sicurezza. In the world of APIs, tokens typically expire every 24 hours. Quindi refreshToken È necessario aggiornare il token di sicurezza ogni 24 ore, in modo che la configurazione del connettore sorgente possa continuare a connettersi a Google Cloud Platform e BigQuery.

16.3.4 API BigQuery e refreshToken

Esistono molti modi per ottenere un refreshToken per accedere alle API di Google Cloud Platform. Una di queste opzioni è l'utilizzo di Postman.
Tuttavia, Google ha creato qualcosa di più semplice da testare e riprodurre con le proprie API, uno strumento chiamato Playground OAuth 2.0.

Per accedere Playground OAuth 2.0, vai a https://developers.google.com/oauthplayground.

You'll then see the OAuth 2.0 Playground homepage.

demo

Fai clic sul pulsante ingranaggio in alto a destra sullo schermo:

demo

Assicurati che le impostazioni siano le stesse che puoi vedere nell'immagine qui sopra.

Controlla le impostazioni per essere sicuro al 100%.

Al termine, seleziona la casella di controllo di Utilizza le tue credenziali OAuth

demo

Vengono visualizzati due campi ed è disponibile il relativo valore.

demo

Compila i campi seguenti:

Impostazioni API per il parco giochi Credenziali API di Google
ID client OAuth il proprio ID client (nel file di testo sul desktop)
Segreto client OAuth Segreto client personale (nel file di testo sul desktop)

demo

Copia il ID client e Segreto client dal file di testo creato sul desktop.

demo

Dopo aver compilato le credenziali, fai clic su Chiudi

demo

Nel menu a sinistra, puoi visualizzare tutte le API Google disponibili. Cerca API BigQuery v2.

demo

Quindi, seleziona l'ambito come indicato nell'immagine seguente:

demo

Una volta selezionati, dovrebbe essere visualizzato un pulsante blu che riporta Autorizzare le API. Fai clic su di esso.

demo

Seleziona l’account Google utilizzato per configurare GCP e BigQuery.

Potrebbe comparire un grande avviso: Questa app non è verificata. Questo accade perché il tuo connettore Platform BigQuery non è ancora stato rivisto formalmente, quindi Google non sa se è un'app autentica o meno. Dovresti ignorare questa notifica.

Fai clic su Avanzate.

demo

Fai clic su Vai a ldap - Connettore BigQuery AEP (non sicuro).

demo

Verrai reindirizzato alla nostra schermata di consenso OAuth che hai creato.

demo

Se si utilizza l'autenticazione a due fattori (2FA), immettere il codice di verifica inviato.

demo

Google ora vi mostrerà otto diversi Autorizzazione prompt. Fai clic su Consenti per tutte e otto le richieste di autorizzazione. (Questa è una procedura che deve essere seguita e confermata una volta da un vero essere umano, prima che l’API consenta le richieste programmatiche)

Ancora una volta, otto finestre a comparsa diverse non verrà visualizzato, è necessario fare clic su Consenti per tutti loro.

demo

Dopo le otto richieste di autorizzazione, verrà visualizzata questa panoramica. Fai clic su Consenti per completare il processo.

demo

Dopo l'ultimo Consenti-fai clic su, verrai rimandato al parco giochi OAuth 2.0 e vedrai questo:

demo

Fai clic su Codice di autorizzazione di Exchange per token.

demo

Dopo un paio di secondi, il Passaggio 2: codice di autorizzazione per i token la visualizzazione si chiude automaticamente e vedrai Passaggio 3: configurare la richiesta all’API.

Devi tornare a Passaggio 2 Codice di autorizzazione dello scambio per i token quindi fai clic su Passaggio 2 Codice di autorizzazione dello scambio per i token per visualizzare di nuovo il Aggiorna token.

demo

Ora vedrai il Aggiorna token.

demo

Copia il Aggiorna token e incollalo nel file di testo sul desktop insieme alle altre credenziali del connettore di origine BigQuery:

Credenziali del connettore di origine BigQuery Valore
ID progetto il tuo ID progetto casuale (ad esempio: (apt-estate-273608)
clientid yourclientid
cilentsecret segreto client
token di aggiornamento token di aggiornamento

Quindi, impostiamo il connettore di origine in Adobe Experience Platform.

Esercizio 16.3.5 - Connetti Platform con la tua tabella BigQuery

Accedi a Adobe Experience Platform andando a questo URL: https://experience.adobe.com/platform.

Dopo aver effettuato l'accesso, si aprirà la homepage di Adobe Experience Platform.

Acquisizione dei dati

Prima di continuare, devi selezionare un sandbox. La sandbox da selezionare è denominata --aepSandboxId--. Per eseguire questa operazione, fai clic sul testo Produzione Prod nella linea blu sopra lo schermo.

Acquisizione dei dati

Dopo aver selezionato la sandbox appropriata, visualizzerai la modifica dello schermo e ora ti trovi nella sandbox dedicata.

Acquisizione dei dati

Nel menu a sinistra, vai a Origini.

demo

Vedrai il Origini homepage. In Origini menu, fai clic su Database.

demo

Fai clic sul pulsante BigQuery Google il Card. Fai clic su + Configura.

demo

A questo punto è necessario creare una nuova connessione.

Fai clic su Nuovo account. È ora necessario compilare tutti i campi seguenti, in base alla configurazione effettuata in GCP e BigQuery.

demo

Cominciamo denominando la connessione:

Utilizza questa convenzione di denominazione:

Credenziali del connettore BigQuery Valore Esempio
Nome account ldap - Connessione BigQuery vangeluw - Connessione BigQuery
Descrizione ldap - Connessione BigQuery vangeluw - Connessione BigQuery

Il che dovrebbe darvi qualcosa del genere:

demo

Quindi, compila l’API GCP e BigQuery . Autenticazione account-dettagli memorizzati in un file di testo sul desktop:

Credenziali del connettore BigQuery Valore
ID progetto il tuo ID progetto casuale (ad esempio: (apt-estate-273608)
clientId
cilentSecret
refreshToken

Le Autenticazione account-i dettagli dovrebbero ora essere così:

demo

Dopo aver compilato tutti questi campi, fai clic su Connetti alla sorgente.

demo

Se Autenticazione account i dettagli sono stati compilati correttamente. Ora visualizzi una conferma visiva del corretto funzionamento della connessione, visualizzando il Connesso conferma.

demo

Dopo aver creato la connessione, fai clic su Successivo:

demo

Ora vedrai il set di dati BigQuery creato durante l’esercizio 16.2.

demo

Well done! Nell’esercizio successivo, puoi caricare i dati da quella tabella e mapparli in base a uno schema e a un set di dati in Adobe Experience Platform.

Next Step: 16.4 Load data from BigQuery into Adobe Experience Platform

Go Back to Module 16

Go Back to All Modules

In questa pagina