Acquisire e utilizzare i tipi di pubblico di Experience Platform

Nell’interfaccia utente di Experience Platform:

1. Seleziona Cliente > Tipi di pubblico.

2. Seleziona Sfoglia e cerca i tipi di pubblico da acquisire e utilizzare in Customer Journey Analytics. Prendi nota del ID pubblico per ciascuno dei tipi di pubblico per un utilizzo successivo.

   

Richiesta

curl -X POST \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?requestDataSource=true' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -d '{
   "name": "{DATASET_NAME}",
   "schemaRef": {
      "id": "_xdm.context.profile__union",
      "contentType": "application/vnd.adobe.xed+json;version=1"
   },
   "fileDescription": {
      "persistet": true,
      "containerFormat": "parquet",
      "format": "parquet"
   }
}'

Dove:

• DATASET_NAME è il nome descrittivo del set di dati. Ad esempio: Segment Export Job Dataset for CJA.

Risposta

["@/dataSets/{DATASET_ID}"]

Dove:

• DATASET_ID è l’identificatore del set di dati creato.

curl -X POST https://platform.adobe.io/data/core/ups/export/jobs \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "fields": "{COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES}",
    "filter": {
        "segments": [
            {
                "segmentId": "{AUDIENCE_ID_1}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_2}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ],
                "segmentId": "{AUDIENCE_ID_3}",
                "segmentNs": "ups",
                "status": [
                    "realized"
                ]
             }
        ]
    },
    "destination":{
        "datasetId": "{DATASET_ID}",
        "segmentPerBatch": false
    },
    "schema":{
        "name": "_xdm.context.profile"
    }
}'

Dove

• COMMA_SEPARATED_LIST_OF_FULLY_QUALIFIED_FIELD_NAMES potrebbe essere _demoemea.identification.core.ecid, _demoemea.identification.core.email, _demoemea.identification.core.phoneNumber, person.gender, person.name.firstName, person.name.lastName. Assicurati di includere almeno i campi rilevanti (come personID (e-mail)) che desideri utilizzare nell’analisi del Percorso di clienti.
• AUDIENCE_ID_x sono gli identificatori dei tipi di pubblico che desideri esportare.
• DATASET_ID è il set di dati creato.

Risposta

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
}

Dove

• EXPORT_JOB_ID è l’identificatore del processo di esportazione.

Richiesta

curl -X GET https://platform.adobe.io/data/core/ups/export/jobs/{EXPORT_JOB_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Risposta

{
  "..."
  "id": "{EXPORT_JOB_ID}",
  "..."
  "status": "SUCCEEDED",
  "..."
}

Nell’interfaccia utente di Experience Platform:

1. Seleziona Gestione dati > Set di dati.

2. Selezionare il set di dati creato, ad esempio: Set di dati processo di esportazione segmento per CJA.

   

3. Verifica i batch acquisiti. Se il set di dati contiene batch non riusciti, utilizzare Gestione dati > Monitoraggio per verificare il motivo. Ad esempio, hai utilizzato un nome di campo che non esiste nello schema.

4. Copia il nome tabella del set di dati. Ad esempio: segment_export_job_dataset_for_cja. Usa questo nome nel passaggio successivo.

Utilizza un client PSQL che si connette a Experience Platform Query Service.

Nell’interfaccia utente di Experience Platform:

1. Seleziona Gestione dati > Query.
2. Selezionare Credenziali.

Utilizzare le credenziali per configurare il client PSQL per la connessione a Customer Journey Analytics Query Service.

Query

Esegui questa query per recuperare i dati del pubblico dal set di dati:

SELECT ROW_NUMBER() OVER (ORDER BY key)::text as _id, personID, key as audienceMembershipId
FROM (
   SELECT {IDENTITY_TO_USE_AS_PERSON_ID} AS personID, explode(segmentMembership.ups)
   FROM {DATASET_TABLE_NAME}
)
WHERE value.status = 'realized' AND (key = '{AUDIENCE_ID_1}' OR key = 'AUDIENCE_ID_2' OR key = 'AUDIENCE_ID_3')

Dove:

• IDENTITY_TO_USE_AS_PERSON_ID è uno dei campi definiti come parte del processo di esportazione. Ad esempio: _demoemea.identification.core.email.
• DATASET_TABLE_NAME è il nome della tabella del set di dati.
• AUDIENCE_ID_x sono i tipi di pubblico definiti come parte del processo di esportazione. È necessario specificare questi tipi di pubblico ancora una volta, in quanto la specifica nel processo di esportazione è un filtro a livello di riga. Tale filtro a livello di riga restituisce profili per i segmenti specificati con tutte le appartenenze al segmento per ciascuno dei profili.

Risultati

Il risultato della query, in formato JSON, dovrebbe essere simile al seguente:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   },
   {
      "_id": "2",
      "personID": "PERSON_ID_y",
      "audienceMembershipId": "{AUDIENCE_ID_x}"
   }

]

Dove:

• PERSON_ID_x sono i valori dell’identificatore da utilizzare come ID persona. Ad esempio, john.doe@gmail.com quando si utilizza la posta elettronica.
• AUDIENCE_ID_x sono gli identificatori del pubblico.

Il JSON finale sarà simile al seguente:

[
   {
      "_id": "1",
      "personID": "{PERSON_ID_x}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_x}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_x}"
      }
  },
  {
      "_id": "2",
      "personID": "{PERSON_ID_y}",
      "{TENANT_NAME}": {
         "audienceMembershipId": "{AUDIENCE_ID_y}",
         "audienceMembershipName": "{AUDIENCE_FRIENDLY_NAME_y}"
      }
    }
  }

]

Dove:

• TENANT_NAME è il nome del tenant. Ad esempio: _demoemea.
• PERSON_ID_x sono i valori dell’identificatore che si desidera utilizzare come ID persona. Ad esempio, john.doe@gmail.com quando si utilizza la posta elettronica.
• AUDIENCE_ID_x sono gli identificatori del pubblico.
• AUDIENCE_FRIENDLY_NAME_x sono nomi descrittivi di pubblico per gli ID pubblico. Ad esempio: Luma - Blue+ Members.

Utilizza lo strumento preferito per trasformare il JSON originale in questo formato.

Per creare lo schema:

Nell’interfaccia utente di Experience Platform:

1. Seleziona Gestione dati > Schemi.

2. Selezionare Crea schema. Seleziona Standard dal menu a discesa.

3. Seleziona Manuale nella finestra di dialogo Crea schema e utilizza Seleziona per continuare.

4. Nella procedura guidata Crea schema, nel passaggio Seleziona una classe:

   1. Selezionare Profilo individuale.
   2. Seleziona Avanti.

5. Nella procedura guidata Crea schema, nel passaggio Nome e revisione:

   1. Immettere un nome visualizzato per lo schema ​. Ad esempio: Audience Export for CJA Schema.
   2. (facoltativo) Immetti una Descrizione.
   3. Seleziona Fine.

6. Imposta lo schema in modo che contenga un gruppo di campi personalizzato (denominato, ad esempio, Appartenenza pubblico) contenente due campi denominati audienceMembershipId e audienceMembershipName.

7. Assicurati che il campo personID sia un Identity, Primary Identity e che contenga Email come I​dentity namespace.

   

8. Applica tutte le modifiche. Seleziona Salva per salvare lo schema.

Nell’interfaccia utente di Experience Platform:

1. Seleziona Gestione dati > Set di dati.

2. Seleziona Crea set di dati.

3. Seleziona Crea set di dati dallo schema.

4. Nella procedura guidata Crea set di dati dallo schema, nel passaggio Seleziona schema:

   1. Seleziona lo schema appena creato. Ad esempio: Esportazione pubblico per schema CJA.
   2. Seleziona Avanti.

5. Nella procedura guidata Crea set di dati dallo schema, nel passaggio Configura set di dati:

   1. Immetti un Nome per il set di dati.
   2. (facoltativo) Immetti una Descrizione per il set di dati.
   3. Seleziona Fine.

6. In Set di dati > nome del set di dati, trascina il file di dati JSON trasformato e rilascia il file in Trascina e rilascia i file. Questa azione avvia l’acquisizione dei dati JSON esportati nel set di dati.

7. Verifica i batch acquisiti. Se il set di dati contiene batch non riusciti, utilizzare Gestione dati > Monitoraggio per verificare il motivo. Ad esempio, hai definito un nome di campo nel JSON che non esiste nello schema.

Nell’interfaccia utente di Customer Journey Analytics:

1. Selezionare Gestione dati > Connessioni.

2. Crea una nuova connessione/ Definisci Impostazioni connessione e Impostazioni dati. In alternativa, selezionare una connessione esistente e utilizzare Modifica connessione per modificare la connessione.

3. Selezionare Aggiungi set di dati.

4. Seleziona il set di dati creato e in cui sono stati acquisiti i dati JSON trasformati.

5. Configura il set di dati. Ad esempio:

   

6. Salva la connessione.

1. Seleziona Gestione dati > Visualizzazioni dati.

2. Modificare una visualizzazione dati esistente o crearne una nuova.

3. Nella scheda Componenti della visualizzazione dati, verifica che ID appartenenza pubblico e Nome appartenenza pubblico siano aggiunti come componenti dimensione.

   

4. Seleziona Salva e continua per salvare la visualizzazione dati.