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, è necessario aver completato connesso a una destinazione. Se non lo hai già fatto, accedi 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 su configurazione della formattazione dei file per i file CSV.

Seleziona il formato file desiderato per l’esportazione quando 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 da attivare nella destinazione, utilizza le caselle di controllo a sinistra dei nomi dei tipi di pubblico, quindi seleziona Successivo.

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. In Pianificazione , puoi configurare la pianificazione e i nomi dei file per ogni pubblico da esportare.

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.

Esportare file completi export-full-files

Seleziona Esporta file completi per attivare l’esportazione di un file contenente un’istantanea completa di tutti i requisiti del profilo per il pubblico selezionato.

Esportare file incrementali

Seleziona Esporta file incrementali per attivare un’esportazione in cui il primo file è un’istantanea completa di tutte le qualifiche di profilo per il pubblico selezionato e i file successivi sono qualifiche di profilo incrementali rispetto all’esportazione precedente.

Configurare nomi file

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:

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

Puoi contrassegnare gli attributi come obbligatori per garantire che Platform esporta solo i profili che includono l’attributo specifico. Di conseguenza, può essere utilizzato come forma aggiuntiva di filtro. Contrassegno di 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 Identity nel Destinazioni di e-mail marketing documentazione.

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.

È possibile utilizzare le chiavi di deduplicazione in tre modi Platform:

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": "johndoe_2@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_1@example.com"
      },
      {
        "id": "johndoe_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

Presupponendo la deduplicazione da parte di Email namespace, il file di esportazione conterrebbe 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

Presupponendo la deduplicazione da parte di personal Email , il file di esportazione conterrà la seguente voce. 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

Presupponendo la deduplicazione tramite la chiave composita personalEmail + lastName, il file di esportazione conterrà le seguenti voci.

L’Adobe consiglia di selezionare uno spazio dei nomi dell’identità come CRM ID o 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 su esportazione di array e campi calcolati e contatta il rappresentante del tuo Adobe per accedere alla funzionalità.

Limitazioni note known-limitations

Il nuovo Mappatura La pagina presenta le seguenti limitazioni note:

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

A causa di una limitazione nota, al momento non è possibile utilizzare Seleziona campo finestra da 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 seguenti modi, a seconda che segmentMembership.seg_namespace.seg_id.status è selezionato:

Ulteriori informazioni su comportamento di esportazione del profilo per 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. La selezione di qualsiasi spazio dei nomi di identità per l’esportazione genererà un errore in Revisione passaggio.

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 una limitazione nota, al momento non è possibile utilizzare Seleziona campo finestra da aggiungere segmentMembership.seg_namespace.seg_id.status alle esportazioni di file. È necessario invece incollare manualmente il valore xdm: segmentMembership.seg_namespace.seg_id.status nel campo schema, come illustrato di seguito.

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

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 pubblici esterni nelle destinazioni senza esportare alcun attributo, abilita Escludi attributi di arricchimento attivare/disattivare. Questa opzione esporta i profili dai tipi di pubblico esterni, ma nessuno degli attributi corrispondenti viene inviato alla destinazione.

Seleziona Successivo per passare al Revisione passaggio.

Controlla review

Il giorno Revisione pagina, è possibile 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. Ulteriori informazioni valutazione dei criteri di consenso per ulteriori informazioni.

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

In Revisione step, 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, vedere violazioni dei criteri di utilizzo dei dati nella sezione documentazione sulla 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

Quando si esportano tipi di pubblico in destinazioni di archiviazione cloud, Adobe Experience Platform crea un .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 modifica i componenti del nome 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: scarica un esempio di file .csv. Questo file di esempio include gli attributi del profilo person.firstname, person.lastname, person.gender, person.birthyear, e personalEmail.address.