Endpoint Criteri di unione

Adobe Experience Platform consente di unire frammenti di dati provenienti da più sorgenti e di combinarli per ottenere una visualizzazione completa di ciascuno dei singoli clienti. Quando si riuniscono questi dati, i criteri di unione sono le regole utilizzate da Platform per determinare in che modo i dati verranno definiti come prioritari e quali dati verranno combinati per creare una visualizzazione unificata.

Ad esempio, se un cliente interagisce con il tuo marchio su più canali, la tua organizzazione avrà più frammenti di profilo relativi al singolo cliente che compaiono in più set di dati. Quando questi frammenti vengono acquisiti in Platform, vengono uniti per creare un singolo profilo per quel cliente. Quando i dati provenienti da più origini sono in conflitto (ad esempio, un frammento elenca il cliente come "singolo", mentre l’altro elenca il cliente come "sposato"), il criterio di unione determina quali informazioni includere nel profilo dell’utente.

Utilizzando le API RESTful o l'interfaccia utente, è possibile creare nuovi criteri di unione, gestire i criteri esistenti e impostare un criterio di unione predefinito per la propria organizzazione. Questa guida descrive i passaggi necessari per l’utilizzo delle API per l’unione dei criteri.

Per utilizzare i criteri di unione utilizzando l'interfaccia utente, fare riferimento alla guida all'interfaccia utente dei criteri di unione. Per ulteriori informazioni sui criteri di unione in generale e sul loro ruolo all'interno dell'Experience Platform, leggere la panoramica dei criteri di unione.

Introduzione

L'endpoint API utilizzato in questa guida fa parte del Real-time Customer Profile API. Prima di continuare, controlla la guida introduttiva per i collegamenti alla relativa documentazione, una guida per la lettura delle chiamate API di esempio in questo documento e informazioni importanti sulle intestazioni necessarie per effettuare correttamente le chiamate a qualsiasi API Experience Platform.

Componenti dei criteri di unione

I criteri di unione sono privati dell’organizzazione IMS e consentono di creare diversi criteri per unire gli schemi nei modi specifici necessari. Qualsiasi API che accede ai dati Profile richiede un criterio di unione, anche se un valore predefinito verrà utilizzato se non viene fornito esplicitamente. Platform fornisce alle organizzazioni un criterio di unione predefinito oppure è possibile creare un criterio di unione per una classe di schema XDM (Experience Data Model) specifica e contrassegnarlo come predefinito per la propria organizzazione.

Sebbene ogni organizzazione possa avere potenzialmente più criteri di unione per classe di schema, ogni classe può avere un solo criterio di unione predefinito. I criteri di unione impostati come predefiniti verranno utilizzati nei casi in cui viene fornito il nome della classe dello schema e viene richiesto un criterio di unione, ma non viene fornito.

NOTA

When you set a new merge policy as the default, any existing merge policy that was previously set as the default will automatically be updated to no longer be used as the default.

Oggetto criterio 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_CLASS_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 in base al quale i criteri di unione possono essere identificati nelle viste elenco.
imsOrgId Organization ID to which this merge policy belongs
identityGraph Identity graph object indicating the identity graph from which related identities will be obtained. I frammenti di profilo trovati per tutte le identità correlate verranno uniti.
attributeMerge Attribute merge object indicating the manner by which the merge policy will prioritize profile attributes in the case of data conflicts.
schema.name Parte dell'oggetto schema , il campo name contiene la classe dello schema XDM a cui si riferisce il criterio di unione. Per ulteriori informazioni sugli schemi e le classi, leggere la documentazione XDM.
default Valore booleano che indica se il criterio di unione è il valore predefinito per lo schema specificato.
version Platform maintained version of merge policy. Questo valore di sola lettura viene incrementato ogni volta che un criterio di unione viene aggiornato.
updateEpoch Data dell'ultimo aggiornamento del criterio di unione.

Example merge policy

    {
        "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
    }

Identity graph

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

oggetto identityGraph

    "identityGraph": {
        "type": "{IDENTITY_GRAPH_TYPE}"
    }

Where {IDENTITY_GRAPH_TYPE} is one of the following:

  • "none": non eseguire alcuna unione di identità.
  • "pdg": esegui la combinazione di identità in base al grafico di identità privata.

EsempioidentityGraph

    "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 di identità utilizzato genera più di un'identità, è possibile che vi siano attributi di profilo in conflitto e deve essere specificata la priorità. Utilizzando attributeMerge, puoi specificare quali attributi di profilo dare la priorità in caso di un conflitto di unione tra i set di dati di tipo Valore chiave (dati record).

oggetto attributeMerge

    "attributeMerge": {
        "type": "{ATTRIBUTE_MERGE_TYPE}"
    }

Where {ATTRIBUTE_MERGE_TYPE} is one of the following:

  • timestampOrdered: (Impostazione predefinita) Assegna priorità al profilo aggiornato per ultimo. Using this merge type, the data attribute is not required. timestampOrdered supporta anche le marche temporali personalizzate che avranno la precedenza quando si uniscono frammenti di profilo all’interno o tra set di dati. To learn more, see the Appendix section on using custom timestamps.
  • dataSetPrecedence : Give priority to profile fragments based on the dataset from which they came. Questo può essere utilizzato quando le informazioni presenti in un set di dati sono preferite o attendibili rispetto ai dati di un altro set di dati. Quando si utilizza questo tipo di unione, l’attributo order è 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. Any datasets not included in the list will not be merged. In other words, datasets must be explicitly listed to be merged into a profile. The order array lists the IDs of the datasets in order of priority.

Example attributeMerge object using dataSetPrecedence type

    "attributeMerge": {
        "type": "dataSetPrecedence",
        "order" : [
            "dataSetId_2", 
            "dataSetId_3", 
            "dataSetId_1", 
            "dataSetId_4"
        ]
    }

Example attributeMerge object using timestampOrdered type

    "attributeMerge": {
        "type": "timestampOrdered"
    }

Schema

L'oggetto schema specifica la classe di schema Experience Data Model (XDM) per la quale viene creato il criterio di unione.

schemaoggetto

    "schema": {
        "name": "{SCHEMA_NAME}"
    }

Dove il valore di name è il nome della classe XDM su cui si basa lo schema associato al criterio di unione.

Esempioschema

    "schema": {
        "name": "_xdm.context.profile"
    }

Per ulteriori informazioni su XDM e sull'utilizzo degli schemi in Experience Platform, inizia leggendo la Panoramica del sistema XDM.

Access merge policies

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

Accedere a un criterio di unione singolo per ID

Puoi accedere a un singolo criterio di unione dal relativo ID effettuando una richiesta di GET all’ endpoint /config/mergePolicies e includendo mergePolicyId 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 dei criteri di unione all'inizio del documento.

Recupera più criteri di unione in base ai relativi ID

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

Formato API

POST /config/mergePolicies/bulk-get

Richiesta

The request body includes an "ids" array with individual objects containing the "id" for each merge policy for which you would like to retrieve details.

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

A successful response returns HTTP Status 207 (Multi-Status) and the details of the merge policies whose IDs were provided in the POST request.

{ 
    "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 dei criteri di unione all'inizio del documento.

Elencare più criteri di unione in base ai criteri

È possibile elencare più criteri di unione all’interno dell’organizzazione IMS inviando una richiesta di GET all’endpoint /config/mergePolicies e utilizzando parametri di query facoltativi per filtrare, ordinare e impaginare la risposta. È possibile includere più parametri, separati da e commerciale (&). Effettuare una chiamata a questo endpoint senza parametri recupererà tutti i criteri di unione disponibili per la tua organizzazione.

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 di dimensioni della 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 per ordinarli in ordine crescente o orderBy=-name in ordine decrescente. Omettendo questo valore si ottiene l’ordinamento predefinito di name in ordine crescente.
schema.name Nome dello schema per il quale recuperare i criteri di unione disponibili.
identityGraph.type Filters results by the identity graph type. I valori possibili includono "none" e "pdg" (grafico privato).
attributeMerge.type Filtra i risultati in base al tipo di unione degli attributi utilizzato. Possible values include "timestampOrdered" and "dataSetPrecedence".
start Offset pagina - specifica l’ID iniziale per i dati da recuperare. Valore predefinito: 0
version Specify this if you are looking to use a specific version of the merge policy. By default, the latest version will be used.

Per ulteriori informazioni su schema.name, identityGraph.type e attributeMerge.type, consulta la sezione componenti dei criteri di unione fornita in precedenza in questa guida.

Richiesta

The following request lists all merge policies for a given schema:

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 A URI address for the next page of results. Utilizza 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

You can create a new merge policy for your organization by making a POST request to the /config/mergePolicies endpoint.

API format

POST /config/mergePolicies


RequestLa richiesta seguente crea un nuovo criterio di unione, configurato dai valori degli attributi 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 A human-friendly name by which the merge policy can be identified in list views.
identityGraph.type Il tipo di grafico delle 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 del profilo in caso di conflitti di dati.
schema 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, consulta la 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 dei 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 di ciascuno di essi.

Modifica di singoli campi dei criteri di unione

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

Formato API

PATCH /config/mergePolicies/{mergePolicyId}
Parametro Descrizione
{mergePolicyId} Identificatore del criterio di unione che si desidera eliminare.

Richiesta

La richiesta seguente aggiorna un criterio di unione specificato modificando il valore della relativa proprietà default 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 The path of the field to update. Accepted values are: "/name", "/identityGraph.type", "/attributeMerge.type", "/schema.name", "/version", "/default"
value The value to set the specified field to.

Per ulteriori informazioni, consulta la sezione componenti dei criteri di unione .

Risposta

Una risposta corretta restituisce i dettagli del criterio di unione appena 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
}

Sovrascrivi criterio di unione

Un altro modo per modificare un criterio di unione consiste nell'utilizzare una richiesta 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 richiesti durante 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 A human-friendly name by which the merge policy can be identified in list views.
identityGraph The identity graph from which to obtain related identities to merge.
attributeMerge The manner by which to prioritize profile attribute values in the case of data conflicts.
schema The XDM schema class associated with the merge policy.
default Specifica se il criterio di unione è il valore predefinito per lo schema.

Refer to the components of merge policies section for more information.

Risposta

A successful response returns the details of the updated merge policy.

{
    "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
}

Delete a merge policy

È possibile eliminare un criterio di unione effettuando una richiesta DELETE all'endpoint /config/mergePolicies 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} The identifier of the merge policy you want to delete.

Richiesta

The following request deletes a merge policy.

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 corretta restituisce lo stato HTTP 200 (OK) e un corpo di risposta vuoto. Per confermare che l'eliminazione è avvenuta correttamente, è possibile eseguire una richiesta GET per visualizzare il criterio di unione in base al relativo ID. If the merge policy was deleted, you will receive an HTTP Status 404 (Not Found) error.

Passaggi successivi

Ora che sai come creare e configurare criteri di unione per la tua organizzazione, puoi utilizzarli per regolare la visualizzazione dei profili dei clienti all’interno di Platform e per creare segmenti di pubblico dai dati Real-time Customer Profile. Per iniziare a definire e lavorare con i segmenti, consulta la documentazione del servizio di segmentazione Adobe Experience Platform .

Appendice

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

Utilizzo di marche temporali personalizzate

Man mano che i record vengono acquisiti in Experience Platform, una marca temporale di sistema viene ottenuta al momento dell’acquisizione e aggiunta al record. Quando timestampOrdered è selezionato come tipo attributeMerge 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 quando il record è stato acquisito in Platform.

Talvolta possono verificarsi casi d’uso, ad esempio il backfill dei dati o la verifica dell’ordine corretto degli eventi se i record vengono acquisiti in modo non ordinato, dove è necessario fornire una marca temporale personalizzata e far rispettare alla policy di unione la marca temporale personalizzata anziché la marca temporale di sistema.

In order to use a custom timestamp, the External Source System Audit Details schema field group must be added to your Profile schema. Once added, the custom timestamp can be populated using the xdm:lastUpdatedDate field. Quando un record viene acquisito con il campo xdm:lastUpdatedDate popolato, Experience Platform lo utilizzerà per unire record o frammenti di profilo all’interno e tra set di dati. Se xdm:lastUpdatedDate non è presente o non è popolato, Platform continuerà a utilizzare la marca temporale del sistema.

NOTA

È necessario assicurarsi che la marca temporale xdm:lastUpdatedDate 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, tra cui come aggiungere gruppi di campi agli schemi, visita l’ esercitazione per creare uno schema utilizzando l’API.

Per utilizzare le marche temporali personalizzate utilizzando l'interfaccia utente, consulta la sezione su uso delle marche temporali personalizzate nella panoramica dei criteri di unione.

External Source System Audit Details dettagli gruppo di campi

L’esempio seguente mostra i campi compilati correttamente nel gruppo di campi External Source System Audit Details . Il gruppo di campi completo JSON può essere visualizzato anche nel repository public Experience Data Model (XDM) 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"
 }

In questa pagina