Attivare i tipi di pubblico per le destinazioni di esportazione dei profili in batch

Panoramica overview

Questo articolo spiega il flusso di lavoro necessario per attivare i tipi di pubblico in Adobe Experience Platform per mettere in batch destinazioni basate su file di profilo, come l’archiviazione cloud e le destinazioni del marketing via e-mail.

Prerequisiti prerequisites

Per attivare i tipi di pubblico nelle destinazioni, devi avere connesso correttamente a una destinazione. Se non lo hai già fatto, vai al catalogo delle destinazioni, sfoglia le destinazioni supportate e configura la destinazione che desideri utilizzare.

Formati di file supportati per l’esportazione supported-file-formats-export

Durante l’esportazione dei tipi di pubblico sono supportati i seguenti formati di file:

L’esportazione di file CSV offre maggiore flessibilità in termini di struttura dei file esportati. Ulteriori informazioni sulla configurazione della formattazione dei file per i file CSV.

Selezionare il formato di file desiderato per l'esportazione durante la creazione di una connessione alla destinazione basata su file.

Seleziona la destinazione select-destination

Seleziona i tipi di pubblico select-audiences

Per selezionare i tipi di pubblico che si desidera attivare nella destinazione, utilizzare le caselle di controllo a sinistra dei nomi dei tipi di pubblico, quindi selezionare Avanti.

Puoi scegliere tra più tipi di pubblico, a seconda della loro origine:

Pianificare l’esportazione del pubblico scheduling

Adobe Experience Platform esporta i dati per le destinazioni di e-mail marketing e archiviazione cloud come tipi di file diversi. Nella pagina Pianificazione è possibile configurare la pianificazione e i nomi dei file per ogni pubblico che si sta esportando.

Experience Platform imposta automaticamente una pianificazione predefinita per ogni esportazione di file. Puoi modificare la pianificazione predefinita in base alle tue esigenze, selezionando l’icona a forma di matita accanto a ogni pianificazione e definendo una pianificazione personalizzata.

Per modificare più pianificazioni contemporaneamente, selezionare i tipi di pubblico utilizzando le caselle di controllo sul lato sinistro della schermata, quindi selezionare Modifica pianificazione. La pianificazione configurata verrà quindi applicata a tutti i file esportati per i tipi di pubblico selezionati.

Esportare file completi export-full-files

Seleziona Esporta file completi per attivare l'esportazione di un file contenente uno snapshot completo di tutte le qualifiche di profilo per il pubblico selezionato.

Esportare file incrementali

Selezionare Esporta file incrementali per attivare un'esportazione in cui il primo file è uno snapshot completo di tutte le qualifiche di profilo per il pubblico selezionato e i file successivi sono qualifiche di profilo incrementali dall'esportazione precedente.

Configurare nomi file configure-file-names

Per la maggior parte delle destinazioni, i nomi di file predefiniti sono costituiti dal nome della destinazione, dall’ID del pubblico e da un indicatore di data e ora. Ad esempio, puoi modificare i nomi dei file esportati per distinguere tra diverse campagne o per aggiungere ai file il tempo di esportazione dei dati. Tieni presente che alcuni sviluppatori di destinazione potrebbero scegliere di visualizzare diverse opzioni di aggiunta dei nomi di file predefiniti per le loro destinazioni.

Per aprire una finestra modale e modificare i nomi dei file, seleziona l’icona della matita. I nomi dei file non possono superare i 255 caratteri.

Nell’editor dei nomi di file puoi selezionare diversi componenti da aggiungere al nome del file.

Il nome di destinazione e l’ID del pubblico non possono essere rimossi dai nomi dei file. Oltre a queste opzioni, puoi aggiungere le seguenti opzioni:

Per modificare più nomi di file contemporaneamente, selezionare il pubblico utilizzando le caselle di controllo sul lato sinistro dello schermo, quindi selezionare Modifica nome file. Le opzioni di nome file configurate verranno quindi applicate a tutti i file esportati per i tipi di pubblico selezionati.

Seleziona Applica modifiche per confermare la selezione.

Dopo aver configurato tutti i tipi di pubblico, seleziona Successivo per continuare.

Mappatura mapping

In questo passaggio, devi selezionare gli attributi del profilo che desideri aggiungere ai file esportati nella destinazione di destinazione. Per selezionare gli attributi e le identità del profilo per l'esportazione:

Attributi obbligatori mandatory-attributes

Un attributo obbligatorio è una casella di controllo abilitata dall’utente che garantisce che tutti i record di profilo contengano l’attributo selezionato. Ad esempio: tutti i profili esportati contengono un indirizzo e-mail.​

È possibile contrassegnare gli attributi come obbligatori per assicurarsi che Platform esporti solo i profili che includono l'attributo specifico. Di conseguenza, può essere utilizzato come forma aggiuntiva di filtro. Contrassegnare un attributo come obbligatorio è non obbligatorio.

Se non si seleziona un attributo obbligatorio, vengono esportati tutti i profili qualificati, indipendentemente dai loro attributi.

È consigliabile che uno degli attributi sia un identificatore univoco dallo schema. Per ulteriori informazioni sugli attributi obbligatori, consulta la sezione Identità nella documentazione delle Destinazioni di e-mail marketing.

Chiavi di deduplicazione deduplication-keys

Una chiave di deduplicazione è una chiave primaria definita dall’utente che determina l’identità in base alla quale gli utenti desiderano deduplicare i propri profili​

Le chiavi di deduplicazione eliminano la possibilità di avere più record dello stesso profilo in un unico file di esportazione.

In Platform è possibile utilizzare le chiavi di deduplicazione in tre modi:

Esempio di deduplicazione deduplication-example

Questo esempio illustra il funzionamento della deduplicazione, a seconda delle chiavi di deduplicazione selezionate.

Prendiamo in considerazione i due profili seguenti.

Profilo A

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_1@example.com"
      },
      {
        "id": "doejohn_1@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-03-10 10:03:08"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "Doe",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

Profilo B

{
  "identityMap": {
    "Email": [
      {
        "id": "johndoe_2@example.com"
      },
      {
        "id": "doejohn_2@example.com"
      }
    ]
  },
  "segmentMembership": {
    "ups": {
      "fa5c4622-6847-4199-8dd4-8b7c7c7ed1d6": {
        "status": "realized",
        "lastQualificationTime": "2021-04-10 11:33:28"
      }
    }
  },
  "person": {
    "name": {
      "lastName": "D",
      "firstName": "John"
    }
  },
  "personalEmail": {
    "address": "johndoe@example.com"
  }
}

Caso di utilizzo 1: nessuna deduplicazione deduplication-use-case-1

Se non si utilizza alcuna deduplicazione, il file di esportazione conterrà le seguenti voci.

Caso di utilizzo 2: deduplicazione basata sullo spazio dei nomi delle identità deduplication-use-case-2

Se si presuppone la deduplicazione da parte dello spazio dei nomi Email, il file di esportazione conterrà le seguenti voci. Il profilo B è l’ultimo che si è qualificato per il pubblico, quindi è l’unico che viene esportato.

Caso di utilizzo 3: deduplicazione basata su un singolo attributo di profilo deduplication-use-case-3

Se si presuppone la deduplicazione tramite l'attributo personal Email, il file di esportazione conterrà la voce seguente. Il profilo B è l’ultimo che si è qualificato per il pubblico, quindi è l’unico che viene esportato.

Caso di utilizzo 4: deduplicazione basata su due attributi di profilo deduplication-use-case-4

Se si presuppone la deduplicazione per la chiave composita personalEmail + lastName, il file di esportazione conterrà le voci seguenti.

Adobe consiglia di selezionare uno spazio dei nomi di identità, ad esempio CRM ID o un indirizzo e-mail, come chiave di deduplicazione, per garantire che tutti i record di profilo siano identificati in modo univoco.

[Beta]{class="badge informative"} Esporta array tramite campi calcolati export-arrays-calculated-fields

Alcuni clienti beta possono esportare gli oggetti array da Experience Platform a destinazioni di archiviazione cloud. Ulteriori informazioni sull'esportazione di array e campi calcolati e contattare il proprio rappresentante di Adobe per accedere alla funzionalità.

Limitazioni note known-limitations

La nuova pagina Mapping presenta le seguenti limitazioni note:

Impossibile selezionare l’attributo di appartenenza del pubblico tramite il flusso di lavoro di mappatura

A causa di un limite noto, al momento non è possibile utilizzare la finestra Seleziona campo per aggiungere segmentMembership.seg_namespace.seg_id.status alle esportazioni di file. È invece necessario incollare manualmente il valore xdm: segmentMembership.seg_namespace.seg_id.status nel campo schema, come illustrato di seguito.

Le esportazioni di file variano nei modi seguenti, a seconda che sia selezionato segmentMembership.seg_namespace.seg_id.status:

Ulteriori informazioni sul comportamento di esportazione del profilo per le destinazioni basate su file.

Al momento non è possibile selezionare gli spazi dei nomi delle identità per le esportazioni

La selezione degli spazi dei nomi delle identità per l’esportazione, come illustrato nell’immagine seguente, non è attualmente supportata. Se si selezionano spazi dei nomi di identità per l'esportazione, verrà generato un errore nel passaggio Rivedi.

Come soluzione alternativa temporanea, se devi aggiungere spazi dei nomi di identità ai file esportati durante la versione beta, puoi effettuare le seguenti operazioni:

Seleziona attributi profilo select-attributes

Per le destinazioni basate su profili, devi selezionare gli attributi del profilo che desideri inviare alla destinazione target.

IMPORTANT

A causa di un limite noto, al momento non è possibile utilizzare la finestra Seleziona campo per aggiungere segmentMembership.seg_namespace.seg_id.status alle esportazioni di file. È invece necessario incollare manualmente il valore xdm: segmentMembership.seg_namespace.seg_id.status nel campo schema, come illustrato di seguito.

Le esportazioni di file variano nei modi seguenti, a seconda che sia selezionato segmentMembership.seg_namespace.seg_id.status:

Selezionare attributi di arricchimento select-enrichment-attributes

Gli attributi di arricchimento corrispondono ai tipi di pubblico caricati personalizzati acquisiti in Experience Platform come Caricamenti personalizzati. In questo passaggio puoi selezionare gli attributi da esportare nella destinazione per ogni pubblico esterno selezionato.

Per selezionare gli attributi di arricchimento per ciascun pubblico esterno, segui i passaggi seguenti:

Se desideri attivare tipi di pubblico esterni nelle destinazioni senza esportare alcun attributo, abilita l'opzione Escludi attributi di arricchimento. Questa opzione esporta i profili dai tipi di pubblico esterni, ma nessuno degli attributi corrispondenti viene inviato alla destinazione.

Seleziona Avanti per passare al passaggio Rivedi.

Controlla review

Nella pagina Rivedi puoi visualizzare un riepilogo della selezione. Seleziona Annulla per interrompere il flusso, Indietro per modificare le impostazioni oppure Fine per confermare la selezione e iniziare a inviare dati alla destinazione.

Valutazione dei criteri di consenso consent-policy-evaluation

Se l’organizzazione ha acquistato Adobe Healthcare Shield o Adobe Privacy & Security Shield, seleziona Visualizza i criteri di consenso applicabili per vedere quali criteri di consenso vengono applicati e quanti profili vengono inclusi di conseguenza nell’attivazione. Leggi informazioni sulla valutazione dei criteri di consenso per ulteriori informazioni.

Controlli dei criteri di utilizzo dei dati data-usage-policy-checks

Nel passaggio Rivedi, Experience Platform controlla anche eventuali violazioni dei criteri di utilizzo dei dati. Di seguito è riportato un esempio di violazione di una policy. Non puoi completare il flusso di lavoro di attivazione del pubblico finché non hai risolto la violazione. Per informazioni su come risolvere le violazioni dei criteri, leggere le violazioni dei criteri di utilizzo dei dati nella sezione relativa alla governance dei dati.

Filtrare i tipi di pubblico filter-audiences

Inoltre, in questo passaggio puoi utilizzare i filtri disponibili nella pagina per visualizzare solo i tipi di pubblico la cui pianificazione o mappatura è stata aggiornata come parte di questo flusso di lavoro. Puoi anche scegliere quali colonne della tabella visualizzare.

Se si è soddisfatti della selezione e non sono state rilevate violazioni dei criteri, selezionare Fine per confermare la selezione e iniziare a inviare dati alla destinazione.

Verificare l’attivazione del pubblico verify

Durante l'esportazione dei tipi di pubblico nelle destinazioni dell'archiviazione cloud, Adobe Experience Platform crea un file .csv, .json o .parquet nel percorso di archiviazione fornito. È necessario creare un nuovo file nel percorso di archiviazione in base alla pianificazione impostata nel flusso di lavoro. Di seguito è riportato il formato di file predefinito, ma è possibile modificare i componenti del nome di file:
<destinationName>_segment<segmentID>_<timestamp-yyyymmddhhmmss>.csv

Ad esempio, se hai selezionato una frequenza di esportazione giornaliera, i file che riceverai in tre giorni consecutivi potrebbero essere simili al seguente:

Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200408061804.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200409052200.csv
Salesforce_Marketing_Cloud_segment12341e18-abcd-49c2-836d-123c88e76c39_20200410061130.csv

La presenza di questi file nel percorso di archiviazione conferma la riuscita dell’attivazione. Per comprendere la struttura dei file esportati, è possibile scaricare un file .csv di esempio. Questo file di esempio include gli attributi di profilo person.firstname, person.lastname, person.gender, person.birthyear e personalEmail.address.