DocumentazioneJourney OptimizerGuida di Journey Optimizer

Impostare uno schema relazionale manuale manual-schema

Ultimo aggiornamento: 5 novembre 2026
  • Si applica a:
  • Campaign Orchestration

In questa pagina: scopri come creare manualmente uno schema relazionale nell’interfaccia utente, aggiungere attributi, collegare schemi, nonché creare e abilitare un set di dati per le campagne orchestrate.

style
shade-box

Gli schemi relazionali possono essere creati direttamente tramite l’interfaccia utente, consentendo la configurazione dettagliata di attributi, chiavi primarie, campi per il controllo delle versioni e relazioni.

L’esempio seguente definisce manualmente lo schema Iscrizioni fedeltà per illustrare la struttura richiesta per le campagne orchestrate.

  1. Creare manualmente uno schema relazionale tramite l’interfaccia di Adobe Experience Platform.

  2. Aggiungi attributi quali ID cliente, livello di iscrizione e campi di stato.

  3. Collega lo schema a schemi incorporati, ad esempio Destinatari per il targeting della campagna.

  4. Crea un set di dati in base allo schema e abilitalo per l’utilizzo in campagne orchestrate.

  5. Acquisisci i dati nel set di dati da origini supportate.

➡️ Ulteriori informazioni sugli schemi relazionali manuali nella documentazione di Adobe Experience Platform

Creare lo schema schema

NOTE
Il diagramma delle relazioni di visualizzazione dalla scheda Relazione è di sola lettura. Per creare o modificare una relazione, aprire lo schema dalla scheda Sfoglia.

Inizia creando manualmente un nuovo schema relazionale in Adobe Experience Platform. Questo processo ti consente di definire la struttura dello schema da zero, incluso il nome e il comportamento.

  1. Accedi a Adobe Experience Platform.

  2. Passa al menu Gestione dati > Schema.

  3. Fare clic su Crea schema.

  4. Seleziona Relazionale come tipo di schema.

    {modal="regular"}

  5. Scegli Crea manualmente per creare lo schema aggiungendo manualmente i campi.

  6. Immetti il nome visualizzato dello schema.

    {modal="regular"}

  7. Fai clic su Fine per procedere con la creazione dello schema.

Ora puoi iniziare ad aggiungere attributi allo schema per definirne la struttura.

Aggiungere attributi allo schema schema-attributes

Quindi, aggiungi gli attributi per definire la struttura dello schema. Questi campi rappresentano i punti dati chiave utilizzati nelle campagne orchestrate, ad esempio gli identificatori dei clienti, i dettagli di iscrizione e le date delle attività. Definendoli accuratamente si garantiscono personalizzazione, segmentazione e tracciamento affidabili.

Qualsiasi schema utilizzato per il targeting deve includere almeno un campo di identità di tipo String con uno spazio dei nomi di identità associato. Questo garantisce la compatibilità con le funzionalità di targeting e risoluzione delle identità di Adobe Journey Optimizer.

Le seguenti funzioni sono supportate durante la creazione di schemi relazionali in Adobe Experience Platform

  • ENUM
    I campi ENUM sono supportati sia nella creazione manuale dello schema basata su DDL, che consente di definire gli attributi con un set fisso di valori consentiti.

  • Etichetta schema per governance dei dati
    L’etichettatura è supportata a livello di campo dello schema per applicare i criteri di governance dei dati, ad esempio il controllo degli accessi e le restrizioni di utilizzo. Per ulteriori dettagli, consulta Documentazione di Adobe Experience Platform.

  • Chiave composita
    Le chiavi primarie composite che si estendono su più campi sono supportate nelle definizioni degli schemi relazionali, consentendo l’utilizzo di più campi insieme per identificare in modo univoco i record.

  1. Nell’area di lavoro, fai clic su accanto al nome schema per iniziare ad aggiungere attributi.

    {modal="regular"}

  2. Immetti l’attributo Nome campo, Nome visualizzato e Tipo.

    In questo esempio, sono stati aggiunti allo schema Appartenenze fedeltà gli attributi descritti nella tabella seguente.

    accordion
    Attributi, esempi
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3
    Nome attributo Tipo di dati Attributi aggiuntivi
    cliente STRINGA Chiave primaria
    livello_di_iscrizione STRINGA Obbligatorio
    points_balance NUMERO INTERO Obbligatorio
    enrollment_date DATA Obbligatorio
    last_status_change DATA Obbligatorio
    data_scadenza DATA -
    is_active BOOLEANO Obbligatorio
    ultima modifica DATETIME Obbligatorio

  3. Assegna i campi appropriati come Chiave primaria e Descrittore versione.

    Quando crei uno schema manuale, accertati di includere i seguenti campi essenziali:

    • Almeno una chiave primaria
    • Un identificatore di versione, ad esempio un campo lastmodified di tipo datetime o number.
    • Per l’acquisizione Change Data Capture (CDC), una colonna speciale denominata _change_request_type di tipo String che indica il tipo di modifica dei dati (ad esempio, inserimento, aggiornamento, eliminazione) e abilita l’elaborazione incrementale. _change_request_type non deve far parte dello schema della tabella, deve essere aggiunto solo al file di dati durante l’acquisizione.

    {modal="regular"}

  4. Fai clic su Salva.

Dopo aver creato e salvato gli attributi, puoi collegare lo schema con altri schemi relazionali definendo relazioni.

➡️ Ulteriori informazioni sugli schemi relazionali nella documentazione di Adobe Experience Platform

La creazione di una relazione tra due schemi consente di migliorare le campagne orchestrate con dati che vanno oltre lo schema del profilo principale.

  1. Dallo schema appena creato, seleziona l’attributo che desideri utilizzare come collegamento e fai clic su Aggiungi relazione.

    {modal="regular"}

  2. Scegli lo schema di riferimento e il campo di riferimento con cui stabilire la relazione.

    In questo esempio, l’attributo customer è collegato allo schema recipients.

    {modal="regular"}

  3. Immetti un nome di relazione dallo schema corrente e dallo schema di riferimento.

  4. Una volta configurata, fai clic su Applica.

Creare un set di dati per lo schema dataset

Dopo aver definito lo schema, ora puoi creare un set di dati basato su di esso. Il set di dati memorizza i dati acquisiti e deve essere abilitato affinché le campagne orchestrate siano accessibili.

  1. Passa al menu Gestione dati > Set di dati e fai clic su Crea set di dati.

    {modal="regular"}

  2. Seleziona Crea set di dati dallo schema.

  3. Scegli lo schema creato in precedenza, qui Appartenenze fedeltà, quindi fai clic su Successivo.

    {modal="regular"}

  4. Immetti un Nome per il Set di dati e fai clic su Fine.

Ora devi abilitare il set di dati per le campagne orchestrate.

Abilitare il set di dati per le campagne orchestrate enable

Dopo aver creato il set di dati, devi abilitarlo esplicitamente per le campagne orchestrate. Questo passaggio garantisce che il set di dati sia disponibile per l’orchestrazione e la personalizzazione in tempo reale in Adobe Journey Optimizer.

Consulta la documentazione di Adobe Developer per convalidare o abilitare l’estensione Orchestrated Campaign sul set di dati.

  1. Individua il set di dati nell’elenco Set di dati.

  2. Dalle impostazioni Set di dati, abilita l’opzione Campagne orchestrate per contrassegnare il set di dati disponibile per l’utilizzo nelle campagne orchestrate.

    {modal="regular"}

  3. Attendi alcuni minuti per il completamento del processo di abilitazione. Tieni presente che l’acquisizione dei dati e l’utilizzo della campagna saranno possibili solo dopo che questa impostazione sarà stata completamente attivata.

Ora puoi iniziare ad acquisire i dati nello schema utilizzando l’origine che preferisci.

➡️ Scopri come acquisire i dati

Se uno schema o un set di dati restituisce un codice di errore, vedere Errori relativi a schemi e set di dati.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to manually create a relational schema in Adobe Experience Platform, add attributes, link schemas, and create and enable a dataset for use in Orchestrated campaigns.

Intents:

  • Create a relational schema manually through the Adobe Experience Platform interface.
  • Add attributes to a relational schema, including primary key, version descriptor, and required fields.
  • Link a relational schema to another schema, such as Recipients, to extend Orchestrated campaigns with additional data.
  • Create a dataset from a relational schema and enable it for Orchestrated campaigns.
  • Ingest data into the enabled dataset.

Glossary:

  • Relational schema: a schema type created directly through the Adobe Experience Platform interface, enabling detailed configuration of attributes, primary keys, versioning fields, and relationships (product-specific)
  • Version Descriptor: a field, such as lastmodified of type datetime or number, used as a version identifier in a manual schema (product-specific)
  • _change_request_type: a special column of type String used for Change Data Capture (CDC) ingestion, indicating the type of data change (insert, update, delete) and enabling incremental processing (product-specific)
  • Composite Key: a primary key spanning multiple fields, supported in relational schema definitions (product-specific)
  • Schema Label: a data governance label supported at the schema field level to enforce policies such as access control and usage restrictions (product-specific)

Guardrails:

  • Any schema used for targeting must include at least one identity field of type String with an associated identity namespace, to ensure compatibility with Adobe Journey Optimizer’s targeting and identity resolution capabilities.
  • A manual schema must include at least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • For Change Data Capture (CDC) ingestion, the _change_request_type column must not be part of the table schema; it must only be added to the data file during ingestion.
  • ENUM fields are supported in both DDL-based and manual schema creation.
  • Composite primary keys spanning multiple fields are supported in relational schema definitions.
  • The View relationships diagram on the Relationship tab is read-only; to create or edit a relationship, the schema must be opened from the Browse tab instead.
  • After enabling a dataset for Orchestrated campaigns, data ingestion and campaign use are only possible once the enablement setting is fully activated.

Terminology:

  • Canonical name: Adobe Experience Platform — Acronym: AEP

FAQ:

  • Q: What fields must a manual relational schema include? — At least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • Q: What is required for a schema used for targeting? — At least one identity field of type String with an associated identity namespace.
  • Q: Where does the _change_request_type column belong? — It is used for Change Data Capture (CDC) ingestion and must only be added to the data file during ingestion, not to the table schema.
  • Q: Can I edit a relationship from the View relationships diagram? — No, that view on the Relationship tab is read-only; open the schema from the Browse tab to create or edit a relationship.
  • Q: What must be done after creating a dataset from a relational schema? — The dataset must be explicitly enabled for Orchestrated campaigns before data ingestion and campaign use are possible.

Related pages:

  • To ingest data into the created dataset: Configuration steps (orchestrated/ingest-data.md)
  • If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)

Personas:

  • developer: Can add attributes such as customer, membership_level, points_balance, enrollment_date, and lastmodified when defining a relational schema. Can use a special column named _change_request_type of type String to indicate insert, update, or delete for Change Data Capture ingestion. The page states that _change_request_type must only be added to the data file during ingestion, not to the table schema. Where: “Add attributes to your schema”.
  • admin: Can create a dataset from a relational schema and enable the Orchestrated campaigns option from the Datasets settings. Can locate the dataset in the Datasets list before enabling it. The page states that data ingestion and campaign use are only possible once this setting is fully activated. Where: “Enable dataset for orchestrated campaigns”.

Onboarding:

  • Level: Experienced
  • First minimal step: Create a relational schema manually using the Adobe Experience Platform interface.
  • Success check: You can now start ingesting data into your schema using the source of your choice.
  • Next: Ingest data into the enabled dataset: Configuration steps (orchestrated/ingest-data.md); If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)
recommendation-more-help
journey-optimizer-help