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.

Origine pubblico
Supportato
Descrizione
Segmentation Service
Tipi di pubblico generati tramite il servizio di segmentazione Experience Platform.
Caricamenti personalizzati
Tipi di pubblico importati in Experience Platform da file CSV.

Tipo e frequenza di esportazione export-type-frequency

Per informazioni sul tipo e sulla frequenza di esportazione della destinazione, consulta la tabella seguente.

Elemento
Tipo
Note
Tipo di esportazione
Esportazione pubblico
Stai esportando tutti i membri di un pubblico con gli identificatori (nome, numero di telefono o altri) utilizzati nella destinazione LiveRamp - Onboarding.
Frequenza di esportazione
Batch giornaliero
Poiché i profili vengono aggiornati in Experience Platform in base alla valutazione del pubblico, i profili (identità) vengono aggiornati una volta al giorno a valle della piattaforma di destinazione. Ulteriori informazioni sulle destinazioni basate su file batch.

Connettersi alla destinazione connect

IMPORTANT
Per connettersi alla destinazione, sono necessarie le Destinazioni visualizzazione e le Autorizzazioni di gestione delle destinazioni per il controllo degli accessi. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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

Schermata di esempio che mostra come eseguire lautenticazione nella destinazione tramite 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
  • 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.
    Immagine che mostra un esempio di chiave PGP formattata correttamente nellinterfaccia utente

  • 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

Schermata di esempio che mostra come autenticare nella destinazione utilizzando la 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
  • 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.
    Immagine che mostra un esempio di chiave PGP formattata correttamente nellinterfaccia utente

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

Schermata dellinterfaccia utente di Platform che mostra come compilare i dettagli per la destinazione

  • 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 prefisso uploads 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, digitare my_export_folder nel campo Percorso cartella.
  • 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

IMPORTANT
Per attivare i dati, è necessario Visualizza destinazioni, Attiva destinazioni, Visualizza profili e Visualizza segmenti Autorizzazioni di controllo di accesso. Leggi la panoramica sul controllo degli accessi o contatta l'amministratore del prodotto per ottenere le autorizzazioni necessarie.

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.

Schermata dellinterfaccia utente di Platform che mostra il passaggio di pianificazione del pubblico.

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%

Schermata dellinterfaccia utente di Platform che mostra il modello di nome file esportato.

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.

IMPORTANT
Questa destinazione supporta l’attivazione di uno spazio dei nomi dell’identità di origine per ogni flusso di attivazione. Se devi esportare più spazi dei nomi di identità, come 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.

IMPORTANT
Per qualsiasi modifica apportata ai campi di destinazione dopo la consegna iniziale del file a LiveRamp, invia una notifica al team dell'account LiveRamp o invia un ticket al supporto LiveRamp per garantire che le modifiche vengano applicate al processo di automazione.
  1. Nel passaggio Mapping, seleziona Aggiungi nuovo mapping. Viene visualizzata una nuova riga di mappatura.

    Screeshot dellinterfaccia utente di Experience Platform che mostra la schermata Mappatura.

  2. 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.

    Screeshot dellinterfaccia utente di Experience Platform che mostra la schermata di mappatura dellorigine.

  3. 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.

    Screeshot dellinterfaccia utente di Experience Platform che mostra la schermata di mappatura di destinazione.

    È inoltre possibile immettere il nome dell'attributo digitandolo direttamente nel campo di destinazione.

    Screeshot dellinterfaccia utente di Experience Platform che mostra la schermata di mappatura 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.

Screeshot dellinterfaccia utente di Experience Platform che mostra la metrica delle identità attivate.

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.

Visualizza changelog
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
  • È stato aggiunto il supporto per le consegne in Europa e Australia LiveRamp SFTP istanze.
  • È stata aggiornata la documentazione per descrivere configurazioni specifiche per le nuove aree geografiche supportate.
  • La dimensione massima del file è stata aumentata a 10 milioni di righe (rispetto ai 5 milioni precedenti).
  • La documentazione è stata aggiornata per riflettere le maggiori dimensioni dei file.
Luglio 2023 Versione iniziale Versione di destinazione iniziale e documentazione pubblicata.
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6