Show Menu
ARGOMENTI×

Endpoint criteri di unione

Adobe Experience Platform consente di unire dati provenienti da più origini e combinarli per visualizzare una visione completa di ogni singolo cliente. Quando si uniscono questi dati, i criteri di unione sono le regole che Platform utilizzano per determinare in che modo i dati verranno classificati come priorità e quali dati verranno combinati per creare tale visualizzazione unificata. Utilizzando le API RESTful o l'interfaccia utente, puoi creare nuovi criteri di unione, gestire i criteri esistenti e impostare un criterio di unione predefinito per la tua organizzazione. Questa guida illustra i passaggi per l'utilizzo dei criteri di unione tramite l'API. Per utilizzare i criteri di unione utilizzando l'interfaccia utente, fare riferimento alla guida utente dei criteri di unione.

Componenti dei criteri di unione

I criteri di unione sono privati per l'organizzazione IMS e consentono di creare criteri diversi per unire gli schemi nel modo desiderato. Qualsiasi Profile dato di accesso API richiede un criterio di unione, anche se un valore predefinito verrà utilizzato se non viene fornito in modo esplicito. Platform fornisce un criterio di unione predefinito, oppure è possibile creare un criterio di unione per uno schema specifico e contrassegnarlo come predefinito per l'organizzazione. Ogni organizzazione può avere potenzialmente più criteri di unione per schema, tuttavia ogni schema può avere un solo criterio di unione predefinito. I criteri di unione impostati come predefiniti verranno utilizzati nei casi in cui il nome dello schema è fornito e un criterio di unione è obbligatorio ma non fornito. Quando si imposta un criterio di unione come predefinito, tutti i criteri di unione esistenti precedentemente impostati come predefiniti verranno automaticamente aggiornati in modo da non essere più utilizzati come predefiniti.

Oggetto criteri di unione completo

L'oggetto criteri di unione completo rappresenta un insieme di preferenze che controllano gli aspetti dell'unione dei frammenti di profilo.
Oggetto Criteri di unione
    {
        "id": "{MERGE_POLICY_ID}",
        "name": "{NAME}",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "{SCHEMA_NAME}"
        },
        "version": 1,
        "identityGraph": {
            "type": "{IDENTITY_GRAPH_TYPE}"
        },
        "attributeMerge": {
            "type": "{ATTRIBUTE_MERGE_TYPE}"
        },
        "default": "{BOOLEAN}",
        "updateEpoch": "{UPDATE_TIME}"
    }

Proprietà
Descrizione
id
Identificatore univoco generato dal sistema assegnato al momento della creazione
name
Nome descrittivo per l'identificazione del criterio di unione nelle viste elenco.
imsOrgId
ID organizzazione a cui appartiene il criterio di unione
identityGraph
Oggetto grafico dell'identità che indica il grafico dell'identità da cui verranno ottenute le identità correlate. I frammenti di profilo trovati per tutte le identità correlate verranno uniti.
attributeMerge
Oggetto unione attributi che indica il modo in cui il criterio di unione darà priorità agli attributi del profilo in caso di conflitti di dati.
schema
L'oggetto schema su cui è possibile utilizzare il criterio di unione.
default
Valore booleano che indica se il criterio di unione è il valore predefinito per lo schema specificato.
version
Platform versione aggiornata del criterio di unione. Questo valore di sola lettura viene incrementato ogni volta che viene aggiornato un criterio di unione.
updateEpoch
Data dell'ultimo aggiornamento del criterio di unione.
Esempio di criteri di unione
    {
        "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
        "name": "profile-default",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "timestampOrdered"
        },
        "default": true,
        "updateEpoch": 1551660639
    }

Grafico identità

Adobe Experience Platform Identity Service gestisce i grafici di identità utilizzati a livello globale e per ogni organizzazione in Experience Platform. L' identityGraph attributo del criterio di unione definisce come determinare le identità correlate per un utente.
oggetto identityGraph
    "identityGraph": {
        "type": "{IDENTITY_GRAPH_TYPE}"
    }

Se {IDENTITY_GRAPH_TYPE} è uno dei seguenti casi:
  • "none": Non eseguire alcuna cucitura di identità.
  • "pdg": Esegue l'unione delle identità in base al grafico dell'identità privata.
Esempio identityGraph
    "identityGraph": {
        "type": "pdg"
    }

Unione attributi

Un frammento di profilo è l'informazione di profilo per una sola identità inclusa nell'elenco di identità esistenti per un particolare utente. Quando il tipo di grafico dell'identità utilizzato genera più identità, è possibile che vi siano attributi di profilo in conflitto e specificare la priorità. Utilizzando attributeMerge , è possibile specificare quali attributi di profilo assegnare la priorità in caso di conflitto di unione tra i set di dati di tipo Valore chiave (dati di record).
oggetto attributeMerge
    "attributeMerge": {
        "type": "{ATTRIBUTE_MERGE_TYPE}"
    }

Se {ATTRIBUTE_MERGE_TYPE} è uno dei seguenti casi:
  • timestampOrdered : (impostazione predefinita) Assegna priorità al profilo aggiornato per ultimo. Utilizzando questo tipo di unione, l' data attributo non è obbligatorio. timestampOrdered supporta inoltre marche temporali personalizzate che avranno precedenza durante l'unione di frammenti di profilo all'interno o tra set di dati. Per ulteriori informazioni, consulta la sezione Appendice sull’ utilizzo di marche temporali personalizzate.
  • dataSetPrecedence : Attribuire priorità ai frammenti di profilo in base al set di dati da cui provengono. Questo può essere utilizzato quando le informazioni presenti in un set di dati sono preferite o attendibili rispetto ai dati contenuti in un altro set di dati. Quando si utilizza questo tipo di unione, l' order attributo è obbligatorio, in quanto elenca i set di dati in ordine di priorità.
    • order : Quando si utilizza "dataSetPrecedence", è necessario fornire un order array con un elenco di set di dati. Eventuali set di dati non inclusi nell'elenco non verranno uniti. In altre parole, i set di dati devono essere esplicitamente elencati per essere uniti in un profilo. L' order array elenca gli ID dei set di dati in ordine di priorità.
Esempio di oggetto attributeMerge con dataSetPrecedence tipo
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order" : [
            "dataSetId_2", 
            "dataSetId_3", 
            "dataSetId_1", 
            "dataSetId_4"
        ]
    }

Esempio di oggetto attributeMerge con timestampOrdered tipo
    "attributeMerge": {
        "type": "timestampOrdered"
    }

Schema

L'oggetto schema specifica lo schema Experience Data Model (XDM) per il quale viene creato il criterio di unione.
schema object
    "schema": {
        "name": "{SCHEMA_NAME}"
    }

Se il valore di name è il nome della classe XDM su cui si basa lo schema associato al criterio di unione.
Esempio schema
    "schema": {
        "name": "_xdm.context.profile"
    }

Per ulteriori informazioni su XDM e sull'utilizzo degli schemi in Experience Platform, consultare la panoramica di sistema XDM.

Accedere ai criteri di unione

Utilizzando l' Real-time Customer Profile API, l' /config/mergePolicies endpoint consente di eseguire una richiesta di ricerca per visualizzare un criterio di unione specifico in base al relativo ID, oppure di accedere a tutti i criteri di unione nell'organizzazione IMS, filtrati in base a criteri specifici. Potete inoltre utilizzare l' /config/mergePolicies/bulk-get endpoint per recuperare più criteri di unione in base ai relativi ID. I passaggi per eseguire ciascuna di queste chiamate sono descritti nelle sezioni seguenti.

Accesso a un singolo criterio di unione tramite ID

Puoi accedere a un singolo criterio di unione con il relativo ID effettuando una richiesta di GET all' /config/mergePolicies endpoint e includendo l' mergePolicyId elemento nel percorso della richiesta.
Formato API
GET /config/mergePolicies/{mergePolicyId}

Parametro
Descrizione
{mergePolicyId}
Identificatore del criterio di unione che si desidera eliminare.
Richiesta
curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/10648288-cda5-11e8-a8d5-f2801f1b9fd1' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}

Risposta
Una risposta corretta restituisce i dettagli del criterio di unione.
{
    "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
    "imsOrgId": "{IMS_ORG}",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "pdg"
    },
    "attributeMerge": {
        "type": "timestampOrdered"
    },
    "default": false,
    "updateEpoch": 1551127597
}

Per informazioni dettagliate su ciascuno dei singoli elementi che compongono un criterio di unione, vedere la sezione Componenti di criteri di unione all'inizio del documento.

Recuperare più criteri di unione in base ai relativi ID

È possibile recuperare più criteri di unione eseguendo una richiesta POST all' /config/mergePolicies/bulk-get endpoint e includendo gli ID dei criteri di unione che si desidera recuperare nel corpo della richiesta.
Formato API
POST /config/mergePolicies/bulk-get

Richiesta
Il corpo della richiesta include un array "ids" con singoli oggetti contenenti "id" per ciascun criterio di unione per il quale si desidera recuperare i dettagli.
curl -X POST \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies/bulk-get' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "ids": [
          {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b"
          },
          {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130"
          }
        ]
      }'

Risposta
Una risposta corretta restituisce lo stato HTTP 207 (Stato multiplo) e i dettagli dei criteri di unione i cui ID sono stati forniti nella richiesta di POST.
{ 
    "results": { 
        "0bf16e61-90e9-4204-b8fa-ad250360957b": {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "default": true,
            "updateEpoch": 1552086578
        },
        "42d4a596-b1c6-46c0-994e-ca5ef1f85130": {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "default": false,
            "updateEpoch": 1576099719
        }
    }
}

Per informazioni dettagliate su ciascuno dei singoli elementi che compongono un criterio di unione, vedere la sezione Componenti di criteri di unione all'inizio del documento.

Elenca più criteri di unione

È possibile elencare più criteri di unione all'interno dell'organizzazione IMS inviando una richiesta di GET all' /config/mergePolicies endpoint e utilizzando parametri di query facoltativi per filtrare, ordinare e impaginare la risposta. È possibile includere più parametri, separati da e commerciale (&). Effettuando una chiamata a questo endpoint senza parametri, tutti i criteri di unione disponibili per l'organizzazione verranno recuperati.
Formato API
GET /config/mergePolicies?{QUERY_PARAMS}

Parametro
Descrizione
default
Valore booleano che filtra i risultati in base al fatto che i criteri di unione siano o meno i valori predefiniti per una classe di schema.
limit
Specifica il limite delle dimensioni di pagina per controllare il numero di risultati inclusi in una pagina. Valore predefinito: 20
orderBy
Specifica il campo in base al quale ordinare i risultati come in orderBy=name o orderBy=+name ordinare per nome in ordine crescente o orderBy=-name , per l'ordinamento decrescente. Omettendo questo valore si ottiene l'ordinamento predefinito di name crescente.
schema.name
Nome dello schema per il quale recuperare i criteri di unione disponibili.
identityGraph.type
Filtra i risultati in base al tipo di grafico dell'identità. I valori possibili includono "none" e "pdg" (grafico privato).
attributeMerge.type
Filtra i risultati in base al tipo di unione degli attributi utilizzato. I valori possibili includono "timestampOrdered" e "dataSetPrecedence".
start
Offset pagina - specifica l'ID iniziale per i dati da recuperare. Valore predefinito: 0
version
Specificate questo valore se desiderate utilizzare una versione specifica del criterio di unione. Per impostazione predefinita, verrà utilizzata la versione più recente.
Per ulteriori informazioni sui schema.name componenti identityGraph.type e attributeMerge.type , consultare la sezione relativa ai componenti dei criteri di unione fornita in precedenza in questa guida.
Richiesta
Nella richiesta seguente sono elencati tutti i criteri di unione per uno schema specifico:
curl -X GET \
  'https://platform.adobe.io/data/core/ups/config/mergePolicies?schema.name=_xdm.context.profile' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}

Risposta
Una risposta corretta restituisce un elenco impaginato di criteri di unione che soddisfano i criteri specificati dai parametri di query inviati nella richiesta.
{
    "_page": {
        "totalCount": 2,
        "pageSize": 2
    },
    "children": [
        {
            "id": "0bf16e61-90e9-4204-b8fa-ad250360957b",
            "name": "Profile Default Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "none"
            },
            "attributeMerge": {
                "type": "timestampOrdered"
            },
            "default": true,
            "updateEpoch": 1552086578
        },
        {
            "id": "42d4a596-b1c6-46c0-994e-ca5ef1f85130",
            "name": "Dataset Precedence Merge Policy",
            "imsOrgId": "{IMS_ORG}",
            "sandbox": {
                "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
                "sandboxName": "prod",
                "type": "production",
                "default": true
            },
            "schema": {
                "name": "_xdm.context.profile"
            },
            "version": 1,
            "identityGraph": {
                "type": "pdg"
            },
            "attributeMerge": {
                "type": "dataSetPrecedence",
                "order": [
                    "5b76f86b85d0e00000be5c8b",
                    "5b76f8d787a6af01e2ceda18"
                ]
            },
            "default": false,
            "updateEpoch": 1576099719
        }
    ],
    "_links": {
        "next": {
            "href": "@/mergePolicies?start=K1JJRDpFaWc5QUpZWHY1c2JBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQldBQkVBQVBnaFFQLzM4VUIvL2tKQi8rLysvMUpBLzMrMi8wRkFmLzR4UUwvL0VrRC85em4zRTBEcmNmYi92Kzh4UUwvL05rQVgzRi8rMStqNS80WHQwN2NhUUVzQUFBUUFleGpLQ1JnVXRVcEFCQUFFQVBBRA==&orderBy=&limit=2"
        }
    }
}

Proprietà
Descrizione
_links.next.href
Indirizzo URI per la pagina successiva di risultati. Utilizzate questo URI come parametro di richiesta per un’altra chiamata API allo stesso endpoint per visualizzare la pagina. Se non esiste una pagina successiva, questo valore sarà una stringa vuota.

Creare un criterio di unione

È possibile creare un nuovo criterio di unione per la propria organizzazione effettuando una richiesta di POST all' /config/mergePolicies endpoint.
Formato API
POST /config/mergePolicies

Richiesta La richiesta seguente crea un nuovo criterio di unione, configurato dai valori attributo forniti nel payload:
curl -X POST \
  https://platform.adobe.io/data/core/ups/config/mergePolicies \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Loyalty members ordered by ID",
    "identityGraph" : {
        "type": "none"
    },
    "attributeMerge" : {
        "type":"dataSetPrecedence",
        "order" : [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "schema": {
        "name":"_xdm.context.profile"
    },
    "default": true
}'

Proprietà
Descrizione
name
Un nome descrittivo mediante il quale è possibile identificare il criterio di unione nelle viste elenco.
identityGraph.type
Il tipo di grafico dell'identità da cui ottenere le identità correlate da unire. Valori possibili: "none" o "pdg" (grafico privato).
attributeMerge
Modalità con cui assegnare la priorità ai valori degli attributi di profilo in caso di conflitti di dati.
schema
La classe dello schema XDM associata al criterio di unione.
default
Specifica se il criterio di unione è il valore predefinito per lo schema.
Per ulteriori informazioni, fare riferimento alla sezione Componenti dei criteri di unione.
Risposta
Una risposta corretta restituisce i dettagli del criterio di unione appena creato.
{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

Per informazioni dettagliate su ciascuno dei singoli elementi che compongono un criterio di unione, vedere la sezione Componenti di criteri di unione all'inizio del documento.

Aggiornare un criterio di unione

È possibile modificare un criterio di unione esistente modificando singoli attributi (PATCH) o sovrascrivendo l'intero criterio di unione con nuovi attributi (PUT). Di seguito sono riportati alcuni esempi.

Modificare singoli campi dei criteri di unione

È possibile modificare singoli campi per un criterio di unione eseguendo una richiesta PATCH all' /config/mergePolicies/{mergePolicyId} endpoint:
Formato API
PATCH /config/mergePolicies/{mergePolicyId}

Parametro
Descrizione
{mergePolicyId}
Identificatore del criterio di unione che si desidera eliminare.
Richiesta
La richiesta seguente aggiorna uno specifico criterio di unione modificando il valore della default proprietà in true :
curl -X PATCH \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
    "op": "add",
    "path": "/default",
    "value": "true"
  }'

Proprietà
Descrizione
op
Specifica l'operazione da eseguire. Esempi di altre operazioni PATCH sono disponibili nella documentazione JSON Patch
path
Percorso del campo da aggiornare. I valori accettati sono: "/name", "/identityGraph.type", "/attributeMerge.type", "/schema.name", "/version", "/default"
value
Il valore su cui impostare il campo specificato.
Per ulteriori informazioni, fare riferimento alla sezione Componenti dei criteri di unione.
Risposta
Una risposta corretta restituisce i dettagli del criterio di unione aggiornato di recente.
{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

Sovrascrivi criterio di unione

Un altro modo per modificare un criterio di unione consiste nell'utilizzare una richiesta di PUT, che sovrascrive l'intero criterio di unione.
Formato API
PUT /config/mergePolicies/{mergePolicyId}

Parametro
Descrizione
{mergePolicyId}
Identificatore del criterio di unione che si desidera sovrascrivere.
Richiesta
La richiesta seguente sovrascrive il criterio di unione specificato, sostituendo i relativi valori attributo con quelli forniti nel payload. Poiché questa richiesta sostituisce completamente un criterio di unione esistente, è necessario fornire tutti gli stessi campi che erano necessari per la definizione originale del criterio di unione. Tuttavia, questa volta vengono forniti valori aggiornati per i campi che si desidera modificare.
curl -X PUT \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "name": "Loyalty members ordered by ID",
        "imsOrgId": "{IMS_ORG}",
        "schema": {
            "name": "_xdm.context.profile"
        },
        "version": 1,
        "identityGraph": {
            "type": "none"
        },
        "attributeMerge": {
            "type": "dataSetPrecedence",
            "order": [
                "5b76f86b85d0e00000be5c8b",
                "5b76f8d787a6af01e2ceda18"
            ]
        },
        "default": true,
        "updateEpoch": 1551898378
    }'

Proprietà
Descrizione
name
Un nome descrittivo mediante il quale è possibile identificare il criterio di unione nelle viste elenco.
identityGraph
Grafico identità da cui ottenere le identità correlate da unire.
attributeMerge
Modalità con cui assegnare la priorità ai valori degli attributi di profilo in caso di conflitti di dati.
schema
La classe dello schema XDM associata al criterio di unione.
default
Specifica se il criterio di unione è il valore predefinito per lo schema.
Per ulteriori informazioni, fare riferimento alla sezione Componenti dei criteri di unione.
Risposta
Una risposta corretta restituisce i dettagli del criterio di unione aggiornato.
{
    "id": "e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2",
    "name": "Loyalty members ordered by ID",
    "imsOrgId": "{IMS_ORG}",
    "sandbox": {
        "sandboxId": "ff0f6870-c46d-11e9-8ca3-036939a64204",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "none"
    },
    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order": [
            "5b76f86b85d0e00000be5c8b",
            "5b76f8d787a6af01e2ceda18"
        ]
    },
    "default": true,
    "updateEpoch": 1551898378
}

Eliminare un criterio di unione

È possibile eliminare un criterio di unione eseguendo una richiesta di DELETE all' /config/mergePolicies endpoint e includendo l'ID del criterio di unione che si desidera eliminare nel percorso della richiesta.
Formato API
DELETE /config/mergePolicies/{mergePolicyId}

Parametro
Descrizione
{mergePolicyId}
Identificatore del criterio di unione che si desidera eliminare.
Richiesta
La richiesta seguente elimina un criterio di unione.
curl -X DELETE \
  https://platform.adobe.io/data/core/ups/config/mergePolicies/e5bc94de-cd14-4cdf-a2bc-88b6e8cbfac2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \

Risposta
Una richiesta di eliminazione riuscita restituisce lo stato HTTP 200 (OK) e un corpo di risposta vuoto. Per confermare che l'eliminazione è avvenuta correttamente, potete eseguire una richiesta di GET per visualizzare il criterio di unione con il relativo ID. Se il criterio di unione è stato eliminato, si riceverà un errore HTTP Status 404 (Non trovato).

Passaggi successivi

Ora che sai come creare e configurare criteri di unione per la tua organizzazione IMS, puoi utilizzarli per creare segmenti di pubblico dai tuoi Real-time Customer Profile dati. Per iniziare a definire e utilizzare i segmenti, consulta la documentazione di Adobe Experience Platform Segmentation Service.

Appendice

Questa sezione fornisce informazioni supplementari relative all'utilizzo dei criteri di unione.

Utilizzo di marche temporali personalizzate

Poiché i record vengono trasferiti Experience Platform, al momento dell'assimilazione viene ottenuta una marca temporale di sistema che viene aggiunta al record. Se timestampOrdered è selezionato come attributeMerge tipo per un criterio di unione, i profili vengono uniti in base alla marca temporale del sistema. In altre parole, l'unione viene eseguita in base alla marca temporale per l'inserimento del record nella piattaforma.
Talvolta possono verificarsi casi di utilizzo, ad esempio il backfill dei dati o la verifica dell'ordine corretto degli eventi se i record vengono ordinati in modo non corretto, se è necessario fornire una marca temporale personalizzata e fare in modo che il criterio di unione rispetti la marca temporale personalizzata invece che la marca temporale del sistema.
Per utilizzare una marca temporale personalizzata, è necessario aggiungere allo schema del profilo External Source Audit Details Mixin . Una volta aggiunta, la marca temporale personalizzata può essere compilata utilizzando il xdm:lastUpdatedDate campo. Quando un record viene assimilato con il xdm:lastUpdatedDate campo popolato, Experience Platform utilizzerà tale campo per unire record o frammenti di profilo all'interno e tra set di dati. Se non xdm:lastUpdatedDate è presente o non è popolato, la piattaforma continuerà a utilizzare la marca temporale del sistema.
È necessario assicurarsi che la xdm:lastUpdatedDate marca temporale sia compilata quando si invia un PATCH sullo stesso record.
Per istruzioni dettagliate sull'utilizzo degli schemi tramite l'API del Registro di sistema dello schema, inclusa l'aggiunta di mixin agli schemi, vedere l' esercitazione per la creazione di uno schema tramite l'API .
Per utilizzare le marche temporali personalizzate utilizzando l'interfaccia utente, consultare la sezione sull' uso delle marche temporali personalizzate nella guida utente dei criteri di unione.

External Source System Audit Details Mixin details

Nell'esempio seguente vengono visualizzati correttamente i campi popolati nel External Source System Audit Details Mixin. Il JSON mixin completo può essere visualizzato anche nel repo XDM ( Public Experience Data Model) su GitHub.
{
  "xdm:createdBy": "{CREATED_BY}",
  "xdm:createdDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastUpdatedBy": "{LAST_UPDATED_BY}",
  "xdm:lastUpdatedDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastActivityDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastReferencedDate": "2018-01-02T15:52:25+00:00",
  "xdm:lastViewedDate": "2018-01-02T15:52:25+00:00"
 }