Connessione LiveRamp - Onboarding liveramp-onboarding
Utilizza la connessione LiveRamp - Onboarding per integrare i tipi di pubblico da Adobe Real-time Customer Data Platform a LiveRamp Connect.
Casi d’uso use-cases
Per aiutarti a capire meglio come e quando utilizzare la destinazione LiveRamp - Onboarding, ecco un esempio di caso d'uso che i clienti Adobe Experience Platform possono risolvere utilizzando questa destinazione.
In qualità di addetto al marketing, desidero inviare tipi di pubblico da Adobe Experience Platform alle identità onboarding in LiveRamp Connect in modo da poter indirizzare gli utenti su piattaforme mobili, open web, social e CTV, utilizzando l'identificatore Ramp ID.
Prerequisiti prerequisites
La connessione LiveRamp - Onboarding esporta i file utilizzando l'archiviazione SFTP🔗 di LiveRamp.
Prima di poter inviare dati da Experience Platform a LiveRamp - Onboarding, sono necessarie le credenziali LiveRamp. Rivolgiti al tuo rappresentante LiveRamp per ottenere le tue credenziali, se non le hai già.
Identità supportate supported-identities
LiveRamp - Onboarding supporta l'attivazione di identità quali identificatori basati su PII, identificatori noti e ID personalizzati, descritti nella documentazione LiveRamp ufficiale.
Nel passaggio di mappatura del flusso di lavoro di attivazione, è necessario definire le mappature di destinazione come attributi personalizzati.
Tipi di pubblico supportati supported-audiences
Questa sezione descrive quali tipi di pubblico puoi esportare in questa destinazione.
Tipo e frequenza di esportazione export-type-frequency
Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.
Connettersi alla destinazione connect
Per connettersi a questa destinazione, seguire i passaggi descritti nell'esercitazione sulla configurazione della destinazione. Nel flusso di lavoro di configurazione della destinazione, compila i campi elencati nelle due sezioni seguenti.
Autenticarsi nella destinazione authenticate
Per eseguire l'autenticazione nella destinazione, compilare i campi obbligatori e selezionare Connetti alla destinazione.
Autenticazione SFTP con password
-
Porta: la porta utilizzata per il percorso di archiviazione LiveRamp - Onboarding. Utilizza la porta corrispondente alla tua posizione geografica, come descritto di seguito:
- NA: utilizzare la porta
22
- AU: Usa porta
2222
- NA: utilizzare la porta
-
Nome utente: il nome utente per il percorso di archiviazione LiveRamp - Onboarding.
-
Password: password per il percorso di archiviazione LiveRamp - Onboarding.
-
Chiave di crittografia PGP/GPG: è possibile allegare la chiave pubblica in formato RSA per aggiungere la crittografia ai file esportati. Visualizza un esempio di chiave di crittografia formattata correttamente nell’immagine seguente.
-
ID sottochiave:Se si fornisce una chiave di crittografia, è necessario fornire anche un ID sottochiave di crittografia. Per informazioni su come ottenere l'ID della sottochiave, consulta la LiveRamp documentazione sulla crittografia.
SFTP con autenticazione con chiave SSH
-
Porta: la porta utilizzata per il percorso di archiviazione LiveRamp - Onboarding. Utilizza la porta corrispondente alla tua posizione geografica, come descritto di seguito:
- EU: usa porta
4222
- EU: usa porta
-
Nome utente: il nome utente per il percorso di archiviazione LiveRamp - Onboarding.
-
Chiave SSH: la chiave SSH privata utilizzata per accedere al percorso di archiviazione LiveRamp - Onboarding. La chiave privata deve essere formattata come stringa con codifica Base64 e non deve essere protetta da password.
- Per connettere la chiave SSH al server LiveRamp - Onboarding, è necessario inviare un ticket tramite il portale di supporto tecnico di LiveRamp e fornire la chiave pubblica. Ulteriori informazioni sono disponibili nella documentazione di LiveRamp.
-
Chiave di crittografia PGP/GPG: è possibile allegare la chiave pubblica in formato RSA per aggiungere la crittografia ai file esportati. Visualizza un esempio di chiave di crittografia formattata correttamente nell’immagine seguente.
-
ID sottochiave:Se si fornisce una chiave di crittografia, è necessario fornire anche un ID sottochiave di crittografia. Per informazioni su come ottenere l'ID della sottochiave, consulta la LiveRamp documentazione sulla crittografia.
Inserire i dettagli della destinazione destination-details
Per configurare i dettagli per la destinazione, compila i campi obbligatori e facoltativi seguenti. Un asterisco accanto a un campo nell’interfaccia utente indica che il campo è obbligatorio.
- Nome: un nome con cui riconoscerai questa destinazione in futuro.
- Descrizione: una descrizione che ti aiuterà a identificare questa destinazione in futuro.
- Area geografica: area geografica per l'istanza dell'archiviazione SFTP LiveRamp.
- Percorso cartella: percorso della sottocartella LiveRamp
uploads
che ospiterà i file esportati. Il prefissouploads
viene aggiunto automaticamente al percorso della cartella. LiveRamp consiglia di creare una sottocartella dedicata per le consegne da Adobe Real-Time CDP per mantenere i file separati da altri feed esistenti e garantire il corretto funzionamento di tutte le attività di automazione.- Se ad esempio si desidera esportare i file in
uploads/my_export_folder
, digitaremy_export_folder
nel campo Percorso cartella.
- Se ad esempio si desidera esportare i file in
- Formato di compressione: selezionare il tipo di compressione che Experience Platform deve utilizzare per i file esportati. Le opzioni disponibili sono GZIP o None.
Abilita avvisi enable-alerts
Puoi abilitare gli avvisi per ricevere notifiche sullo stato del flusso di dati verso la tua destinazione. Seleziona un avviso dall’elenco per abbonarti e ricevere notifiche sullo stato del flusso di dati. Per ulteriori informazioni sugli avvisi, consulta la guida su abbonamento a destinazioni avvisi tramite l'interfaccia utente.
Dopo aver fornito i dettagli per la connessione di destinazione, seleziona Avanti.
Attivare tipi di pubblico in questa destinazione activate
Per istruzioni sull'attivazione dei tipi di pubblico in questa destinazione, leggi Attiva dati pubblico per esportare i profili in batch.
Pianificazione scheduling
Nel passaggio Pianificazione, crea una pianificazione di esportazione per ogni pubblico, con le impostazioni mostrate di seguito.
- Opzioni di esportazione file: Esporta file completi. Le esportazioni di file incrementali non sono attualmente supportate per la destinazione LiveRamp.
- Frequenza: Giornaliera
- Data: seleziona l'ora di inizio e di fine dell'esportazione come preferisci.
Il nome del file esportato non è attualmente configurabile dall'utente. Tutti i file esportati nella destinazione LiveRamp - Onboarding vengono denominati automaticamente in base al seguente modello:
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
Ad esempio, il nome di un file esportato per un'organizzazione denominata Luma potrebbe essere simile al seguente:
Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv
Mappare attributi e identità map
Nel passaggio Mappatura, puoi selezionare gli attributi e le identità da esportare per i profili.
Email
e Phone
, devi creare un flusso di attivazione separato per ogni identità.Nel passaggio Mappatura, la mappatura Campo di destinazione definisce il nome dell'intestazione di colonna nel file CSV esportato. È possibile modificare le intestazioni di colonna CSV nel file esportato con qualsiasi nome descrittivo desiderato, fornendo un nome personalizzato per il campo di destinazione.
-
Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.
-
Nella finestra Seleziona campo di origine, scegli la categoria Seleziona attributi e seleziona l'attributo XDM da mappare, oppure scegli la categoria Seleziona spazio dei nomi identità e seleziona un'identità da mappare alla destinazione.
-
Nella finestra Seleziona campo di destinazione, immettere il nome dell'attributo a cui si desidera mappare il campo di origine selezionato. Il nome dell’attributo qui definito si rifletterà nel file CSV esportato come intestazione di colonna.
È inoltre possibile immettere il nome dell'attributo digitandolo direttamente nel campo di destinazione.
Dopo aver aggiunto tutte le mappature desiderate, seleziona Avanti e completa il flusso di lavoro di attivazione.
Dati esportati / Convalida esportazione dati exported-data
I dati vengono esportati nel percorso di archiviazione LiveRamp - Onboarding configurato come file CSV.
I file esportati hanno una dimensione massima di 10 milioni di righe. Experience Platform genera più file per consegna se il pubblico selezionato supera i 10 milioni di righe. Se prevedi di superare il limite per i singoli file, contatta il rappresentante LiveRamp e chiedi loro di configurare l'acquisizione batch.
Durante l'esportazione dei file nella destinazione LiveRamp - Onboarding, Platform genera un file CSV per ogni ID del criterio di unione.
Ad esempio, prendiamo in considerazione i seguenti tipi di pubblico:
- Pubblico A (criterio di unione 1)
- Pubblico B (criterio di unione 2)
- Pubblico C (criterio di unione 1)
- Pubblico D (criterio di unione 1)
Platform esporterà due file CSV in LiveRamp - Onboarding:
- Un file CSV contenente i tipi di pubblico A, C e D;
- Un file CSV contenente il pubblico B.
I file CSV esportati contengono profili con gli attributi selezionati e lo stato del pubblico corrispondente, in colonne separate, con il nome dell’attributo e audience_namespace:audience_ID
coppie come intestazioni di colonna, come mostrato nell’esempio seguente:
ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X
I profili inclusi nei file esportati possono corrispondere a uno dei seguenti stati di qualificazione del pubblico:
Active
: il profilo è attualmente qualificato per il pubblico.Expired
: il profilo non è più qualificato per il pubblico, ma lo è già stato in passato.""
(stringa vuota): il profilo non è mai qualificato per il pubblico.
Ad esempio, un file CSV esportato con un attributo email
, due tipi di pubblico provenienti dall'Experience Platform Servizio di segmentazione e un pubblico esterno importato potrebbe essere simile al seguente:
email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,
Nell'esempio precedente, le sezioni ups_aa2e3d98-974b-4f8b-9507-59f65b6442df
e ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f
descrivono i tipi di pubblico provenienti dal servizio di segmentazione, mentre CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
descrive un pubblico importato in Platform come caricamento personalizzato.
Dal momento che Platform genera un file CSV per ogni ID del criterio di unione, genera anche un flusso di dati separato per ogni ID del criterio di unione.
Ciò significa che le metriche Identità attivate e Profili ricevuti nella pagina esecuzioni del flusso di dati sono aggregate per ogni gruppo di tipi di pubblico che utilizzano lo stesso criterio di unione, anziché essere visualizzate per ogni pubblico.
In seguito alla generazione del flusso di dati per un gruppo di tipi di pubblico che utilizzano lo stesso criterio di unione, i nomi dei tipi di pubblico non vengono visualizzati nel dashboard di monitoraggio.
Caricare i dati esportati su LiveRamp upload-to-liveramp
Dopo l'esportazione dei dati nell'archivio LiveRamp - Onboarding, è necessario caricare i dati nella piattaforma LiveRamp.
Per ulteriori informazioni su come caricare i file dall'archivio LiveRamp - Onboarding a un pubblico LiveRamp, consulta la seguente documentazione: Considerazioni durante il caricamento del primo file a un pubblico.
Utilizzo dei dati e governance data-usage-governance
Tutte le destinazioni Adobe Experience Platform sono conformi ai criteri di utilizzo dei dati durante la gestione dei dati. Per informazioni dettagliate su come Adobe Experience Platform applica la governance dei dati, leggere la Panoramica sulla governance dei dati.
Risorse aggiuntive additional-resources
Per ulteriori dettagli su come configurare l'archiviazione LiveRamp - Onboarding, vedere la documentazione ufficiale.
Changelog changelog
Questa sezione acquisisce le funzionalità e i significativi aggiornamenti alla documentazione apportati al connettore di destinazione.
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
Mese di rilascio | Tipo di aggiornamento | Descrizione |
Marzo 2024 | Aggiornamento della funzionalità e della documentazione |
|
Luglio 2023 | Versione iniziale | Versione di destinazione iniziale e documentazione pubblicata. |