[Ultimate]{class="badge positive"}

Crea una connessione sorgente Google PubSub nell'interfaccia utente

IMPORTANT
L'origine Google PubSub è disponibile nel catalogo delle origini per gli utenti che hanno acquistato Real-time Customer Data Platform Ultimate.

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.

Autenticazione basata su progetto
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.
Autenticazione basata su argomenti e sottoscrizioni
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.

TIP
Se utilizzi l’autenticazione basata sull’account del servizio, assicurati di aver concesso un accesso utente sufficiente all’account del servizio e di non inserire spazi vuoti aggiuntivi nel JSON quando copi e incolla 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.

Catalogo delle origini nellinterfaccia utente di Experience Platform.

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.

La selezione dellaccount esistente nel flusso di lavoro di origine.

Nuovo account

TIP
  • 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.

Nuova interfaccia account per lorigine Google PubSub nel flusso di lavoro delle origini

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.

Autenticazione basata su progetto

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.

Nuova interfaccia account per lorigine Google PubSub con accesso alla directory principale selezionato.

Autenticazione basata su argomenti e sottoscrizioni

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.

Nuova interfaccia account per lorigine Google PubSub con accesso con ambito selezionato.

NOTE
Le entità (ruoli) assegnate a un progetto PubSub vengono ereditate in tutti gli argomenti e le sottoscrizioni creati all'interno di un progetto PubSub. Se si desidera che un'entità principale (ruolo) abbia accesso a un argomento specifico, è necessario aggiungere anche tale entità principale (ruolo) alla sottoscrizione corrispondente dell'argomento. Per ulteriori informazioni, leggere la [PubSub documentazione sul controllo degli accessi] (https://cloud.google.com/pubsub/docs/access-control).

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.

Autenticazione basata su progetto

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.

Il passaggio di dati di selezione del flusso di lavoro origini con autenticazione basata su progetto.

Autenticazione basata su argomenti e sottoscrizioni

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.

Il passaggio di dati di selezione del flusso di lavoro origini con largomento e lautenticazione basata su sottoscrizione.

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.

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