[Ultimate]{class="badge positive"}
Crea una connessione sorgente Google PubSub nell'interfaccia utente
Questo tutorial descrive i passaggi necessari per creare Google PubSub (di seguito "PubSub") utilizzando l'interfaccia utente di Platform.
Introduzione
Questo tutorial richiede una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Origini: Experience Platform consente di acquisire dati da varie origini e allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform.
- Sandbox: Experience Platform fornisce sandbox virtuali che suddividono una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Se disponi già di una connessione PubSub valida, puoi saltare il resto del documento e passare all'esercitazione configurazione di un flusso di dati.
Raccogli le credenziali richieste
Per connettere l'account PubSub all'Experience Platform, è necessario fornire i valori per le proprietà di connessione descritte di seguito. Per ulteriori informazioni sull'autenticazione e sulla configurazione dei prerequisiti, leggere la PubSub source panoramica.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Credenziali | Descrizione |
| ID Progetto | ID progetto richiesto per autenticare PubSub. |
| Credenziali | Credenziali necessarie per autenticare PubSub. Assicurati di inserire il file JSON completo dopo aver rimosso gli spazi vuoti dalle credenziali. |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Credenziali | Descrizione |
| Credenziali | Credenziali necessarie per autenticare PubSub. Assicurati di inserire il file JSON completo dopo aver rimosso gli spazi vuoti dalle credenziali. |
| Nome argomento | Nome dell'abbonamento PubSub. In PubSub, gli abbonamenti consentono di ricevere messaggi, sottoscrivendo l'argomento in cui i messaggi sono stati pubblicati. Nota: è possibile utilizzare una singola sottoscrizione PubSub per un solo flusso di dati. Per creare più flussi di dati, devi disporre di più abbonamenti. |
| Nome abbonamento | Nome dell'abbonamento PubSub. In PubSub, gli abbonamenti consentono di ricevere messaggi, sottoscrivendo l'argomento in cui i messaggi sono stati pubblicati. |
Per ulteriori informazioni su questi valori, consulta il seguente documento di autenticazione PubSub. Se utilizzi l'autenticazione basata sull'account del servizio, consulta la Guida PubSub seguente per i passaggi su come generare le credenziali.
Dopo aver raccolto le credenziali richieste, puoi seguire i passaggi seguenti per collegare l'account PubSub a Platform.
Connetti il tuo account PubSub
Nell'interfaccia utente di Platform, seleziona Origini dal menu di navigazione a sinistra per accedere all'area di lavoro Origini. Nella schermata Catalogo sono visualizzate diverse origini con cui è possibile creare un account.
Puoi selezionare la categoria appropriata dal catalogo sul lato sinistro dello schermo. In alternativa, è possibile trovare l’origine specifica che si desidera utilizzare utilizzando l’opzione di ricerca.
Nella categoria Archiviazione cloud, seleziona Google PubSub, quindi seleziona Aggiungi dati.
Viene visualizzata la pagina Connetti a Google PubSub. In questa pagina è possibile utilizzare nuove credenziali o credenziali esistenti.
Account esistente
Per utilizzare un account esistente, seleziona l'account PubSub con cui vuoi creare un nuovo flusso di dati, quindi seleziona Successivo per continuare.
Nuovo account
- Quando crei un account con accesso limitato, devi fornire almeno uno dei tuoi nomi di argomento o di abbonamento. L’autenticazione non riuscirà se mancano entrambi i valori.
- Una volta creata, non è possibile modificare il tipo di autenticazione di una connessione di base Google PubSub. Per modificare il tipo di autenticazione, è necessario creare una nuova connessione di base.
Se stai creando un nuovo account, seleziona Nuovo account, quindi fornisci un nome e una descrizione facoltativa per il nuovo account PubSub.
L'origine PubSub consente di specificare il tipo di accesso da consentire durante l'autenticazione. Puoi impostare l’account in modo che disponga di autenticazione basata su progetto o su argomento e autenticazione basata su abbonamento. L'autenticazione basata sul progetto consente di concedere l'accesso al progetto a livello di radice nel proprio account, mentre l'autenticazione basata su argomenti e sottoscrizioni consente di limitare l'accesso a un particolare argomento e sottoscrizione PubSub.
Per creare un account con accesso alla cartella principale del progetto PubSub. Seleziona Credenziali di autenticazione Google PubSub come tipo di autenticazione e fornisci l'ID progetto e le credenziali. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Per creare un account con accesso limitato solo a un argomento e a una sottoscrizione PubSub specifici, selezionare Credenziali di autenticazione con ambito pubSub di Google, quindi specificare le credenziali, il nome dell'argomento e/o il nome della sottoscrizione. Al termine, selezionare Connetti all'origine e quindi attendere un po' di tempo per stabilire la nuova connessione.
Selezionare i dati
Se l'autenticazione ha esito positivo, viene visualizzato il passaggio Seleziona dati, in cui è possibile spostarsi nella gerarchia dei dati di PubSub e selezionare i dati da portare in Experience Platform.
Se hai eseguito l'autenticazione con l'accesso basato su progetto, nell'interfaccia Seleziona dati verranno visualizzate tutte le sottoscrizioni del progetto a cui è associato un argomento.
Se hai eseguito l'autenticazione con un argomento e un accesso basato su abbonamento, la visualizzazione dell'interfaccia Seleziona dati può variare a seconda delle informazioni fornite.
- Se si specifica solo il nome dell'argomento, nell'interfaccia verranno visualizzate tutte le coppie di argomenti-sottoscrizione corrispondenti all'argomento specificato.
- Se fornisci solo il nome dell’abbonamento, l’interfaccia visualizza tutte le coppie di argomenti-abbonamento che corrispondono al nome dell’abbonamento fornito.
- Se vengono forniti sia i nomi degli argomenti che quelli delle sottoscrizioni, l'interfaccia visualizza la coppia argomento-sottoscrizione che corrisponde a entrambi i valori specificati.
Passaggi successivi
Seguendo questa esercitazione, hai creato una connessione tra il tuo account PubSub e Platform. Ora puoi continuare con l'esercitazione successiva e configurare un flusso di dati per portare dati in streaming dall'archiviazione cloud in Platform.