Combinar extremo de directivas

Adobe Experience Platform le permite unir fragmentos de datos de varias fuentes y combinarlos para ver una vista completa de cada uno de sus clientes. Al unir estos datos, las políticas de combinación son las reglas que Platform utiliza para determinar cómo se priorizarán los datos y qué datos se combinarán para crear una vista unificada.

Por ejemplo, si un cliente interactúa con la marca a través de varios canales, su organización tendrá varios fragmentos de perfil relacionados con ese único cliente que aparecerán en varios conjuntos de datos. Cuando estos fragmentos se incorporan a Platform, se combinan para crear un perfil único para ese cliente. Cuando los datos de múltiples fuentes entran en conflicto (por ejemplo, un fragmento enumera al cliente como "soltero" mientras que el otro indica que el cliente está "casado"), la política de combinación determina qué información incluir en el perfil del individuo.

Con las API de RESTful o la interfaz de usuario, puede crear nuevas políticas de combinación, administrar las políticas existentes y establecer una directiva de combinación predeterminada para su organización. Esta guía proporciona los pasos para trabajar con políticas de combinación mediante la API.

Para trabajar con políticas de combinación mediante la interfaz de usuario, consulte la guía de interfaz de usuario de políticas de combinación. Para obtener más información sobre las políticas de combinación en general, y su función dentro del Experience Platform, comience leyendo el información general sobre políticas de combinación.

Primeros pasos

El extremo de API utilizado en esta guía forma parte de la variable Real-time Customer Profile API. Antes de continuar, revise la guía de introducción para ver vínculos a documentación relacionada, una guía para leer las llamadas de API de ejemplo en este documento e información importante sobre los encabezados necesarios para realizar llamadas correctamente a cualquier Experience Platform API.

Componentes de políticas de combinación

Las políticas de combinación son privadas para su organización de IMS, lo que le permite crear distintas políticas para combinar esquemas de las formas específicas que necesite. Cualquier API que acceda a Profile Los datos de requieren una directiva de combinación, aunque se utilizará un valor predeterminado si no se proporciona uno explícitamente. Platform proporciona a las organizaciones una directiva de combinación predeterminada, o bien puede crear una directiva de combinación para una clase de esquema de Experience Data Model (XDM) específica y marcarla como predeterminada para su organización.

Aunque cada organización puede tener varias directivas de combinación por clase de esquema, cada clase solo puede tener una directiva de combinación predeterminada. Cualquier directiva de combinación establecida como predeterminada se utilizará en los casos en que se proporcione el nombre de la clase de esquema y se requiera una directiva de combinación, pero no se proporcione.

NOTA

Cuando se establece una nueva directiva de combinación como predeterminada, cualquier directiva de combinación existente previamente establecida como predeterminada se actualizará automáticamente para que ya no se use como predeterminada.

Para garantizar que todos los consumidores de perfil trabajen con la misma vista en los bordes, las políticas de combinación se pueden marcar como activas en el borde. Para que un segmento se active en el perímetro (marcado como segmento perimetral), debe estar vinculado a una política de fusión que esté marcada como activo en el borde. Si un segmento es not vinculado a una política de combinación marcada como activa en Edge, el segmento no se marcará como activo en Edge y se marcará como segmento de flujo continuo.

Además, cada organización de IMS solo puede tener one directiva de combinación activa en edge. Si una directiva de combinación está activa en Edge, puede utilizarse para otros sistemas Edge, como Perfil de Edge, Segmentación de Edge y Destinations on Edge.

Completar objeto de directiva de combinación

El objeto de directiva de combinación completa representa un conjunto de preferencias que controlan los aspectos de la combinación de fragmentos de perfil.

Combinar objeto de directiva

    {
        "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}"
        },
        "isActiveOnEdge": "{BOOLEAN}",
        "default": "{BOOLEAN}",
        "updateEpoch": "{UPDATE_TIME}"
    }
Propiedad Descripción
id El sistema generó un identificador único asignado en el momento de la creación
name Nombre descriptivo mediante el cual se puede identificar la política de combinación en las vistas de lista.
imsOrgId ID de organización al que pertenece esta directiva de combinación
schema.name Parte del schema el objeto name contiene la clase de esquema XDM con la que se relaciona la política de combinación. Para obtener más información sobre esquemas y clases, lea la Documentación XDM.
version Platform versión mantenida de la directiva de combinación. Este valor de solo lectura se incrementa cada vez que se actualiza una directiva de combinación.
identityGraph Gráfico de identidad objeto que indica el gráfico de identidad del que se obtendrán las identidades relacionadas. Se combinarán los fragmentos de perfil encontrados para todas las identidades relacionadas.
attributeMerge Combinación de atributos que indica la forma en que la directiva de combinación priorizará los atributos de perfil en caso de conflictos de datos.
isActiveOnEdge Valor booleano que indica si esta política de combinación se puede usar en edge. De forma predeterminada, este valor es false.
default Valor booleano que indica si esta política de combinación es la predeterminada para el esquema especificado.
updateEpoch Fecha de la última actualización de la directiva de combinación.

Ejemplo de política de combinación

    {
        "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"
        },
        "isActiveOnEdge": false,
        "default": true,
        "updateEpoch": 1551660639
    }

Gráfico de identidad

Servicio de identidad de Adobe Experience Platform administra los gráficos de identidad utilizados globalmente y para cada organización en Experience Platform. La variable identityGraph de la política de combinación define cómo determinar las identidades relacionadas de un usuario.

objeto identityGraph

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

Donde {IDENTITY_GRAPH_TYPE} es una de las siguientes:

  • "ninguno": No realice ninguna vinculación de identidad.
  • "pdg": Realice la vinculación de identidad en función del gráfico de identidad privada.

EjemploidentityGraph

    "identityGraph": {
        "type": "pdg"
    }

Combinación de atributos

Un fragmento de perfil es la información de perfil de una sola identidad de la lista de identidades que existe para un usuario en particular. Cuando el tipo de gráfico de identidad utilizado da como resultado más de una identidad, existe la posibilidad de que haya atributos de perfil en conflicto y se debe especificar la prioridad. Uso attributeMerge, puede especificar qué atributos de perfil priorizar en caso de conflicto de combinación entre conjuntos de datos de tipo Valor clave (datos de registro).

attributeMerge, objeto

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

Donde {ATTRIBUTE_MERGE_TYPE} es una de las siguientes:

  • timestampOrdered: (predeterminado) Asigne prioridad al perfil que se actualizó por última vez. Con este tipo de combinación, la variable data no es obligatorio.
  • dataSetPrecedence : Asigne prioridad a los fragmentos de perfil en función del conjunto de datos del que proceden. Esto se puede usar cuando se prefiere o confía en la información presente en un conjunto de datos sobre los datos de otro conjunto de datos. Al utilizar este tipo de combinación, la variable order es obligatorio, ya que enumera los conjuntos de datos en orden de prioridad.
    • order: Cuando se usa "dataSetPrecedence", se usa una variable order la matriz debe proporcionarse con una lista de conjuntos de datos. Los conjuntos de datos que no estén incluidos en la lista no se combinarán. En otras palabras, los conjuntos de datos deben enumerarse explícitamente para combinarse en un perfil. La variable order matriz enumera los ID de los conjuntos de datos en orden de prioridad.

Ejemplo attributeMerge objeto que utiliza dataSetPrecedence type

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

Ejemplo attributeMerge objeto que utiliza timestampOrdered type

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

Esquema

El objeto schema especifica la clase de esquema Experience Data Model (XDM) para la que se crea esta política de combinación.

schemaobject

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

Donde el valor de name es el nombre de la clase XDM en la que se basa el esquema asociado a la política de combinación.

Ejemploschema

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

Para obtener más información sobre XDM y trabajar con esquemas en Experience Platform, comience leyendo el Información general del sistema XDM.

Acceso a las directivas de combinación

Al usar la variable Real-time Customer Profile API, la variable /config/mergePolicies permite realizar una solicitud de búsqueda para ver una directiva de combinación específica por su ID o acceder a todas las directivas de combinación de su organización de IMS, filtradas según criterios específicos. También puede usar la variable /config/mergePolicies/bulk-get para recuperar varias directivas de combinación por sus ID. Los pasos para realizar cada una de estas llamadas se describen en las siguientes secciones.

Acceder a una directiva de combinación única por ID

Puede acceder a una política de combinación única por su ID realizando una solicitud de GET al /config/mergePolicies y incluyendo mergePolicyId en la ruta de solicitud.

Formato de API

GET /config/mergePolicies/{mergePolicyId}
Parámetro Descripción
{mergePolicyId} Identificador de la directiva de combinación que desea eliminar.

Solicitud

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}

Respuesta

Una respuesta correcta devuelve los detalles de la directiva de combinación.

{
    "id": "10648288-cda5-11e8-a8d5-f2801f1b9fd1",
    "imsOrgId": "{IMS_ORG}",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "version": 1,
    "identityGraph": {
        "type": "pdg"
    },
    "attributeMerge": {
        "type": "timestampOrdered"
    },
    "isActiveOnEdge": "false",
    "default": false,
    "updateEpoch": 1551127597
}

Consulte la componentes de políticas de combinación al principio de este documento para obtener detalles sobre cada uno de los elementos individuales que componen una política de combinación.

Recuperar varias directivas de combinación por sus ID

Puede recuperar varias directivas de combinación realizando una solicitud de POST al /config/mergePolicies/bulk-get e incluye los ID de las directivas de combinación que desea recuperar en el cuerpo de la solicitud.

Formato de API

POST /config/mergePolicies/bulk-get

Solicitud

El cuerpo de la solicitud incluye una matriz de "id" con objetos individuales que contienen el "id" para cada política de combinación para la que desea recuperar detalles.

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"
          }
        ]
      }'

Respuesta

Una respuesta correcta devuelve el Estado HTTP 207 (Multi-Status) y los detalles de las políticas de combinación cuyos ID se proporcionaron en la solicitud del 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"
            },
            "isActiveOnEdge": true,
            "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"
                ]
            },
            "isActiveOnEdge": false,
            "default": false,
            "updateEpoch": 1576099719
        }
    }
}

Consulte la componentes de políticas de combinación al principio de este documento para obtener detalles sobre cada uno de los elementos individuales que componen una política de combinación.

Enumerar varias directivas de combinación por criterios

Puede enumerar varias directivas de combinación dentro de su organización de IMS enviando una solicitud de GET al /config/mergePolicies y usar parámetros de consulta opcionales para filtrar, ordenar y paginar la respuesta. Se pueden incluir varios parámetros, separados por el símbolo &. Al realizar una llamada a este extremo sin parámetros, se recuperarán todas las directivas de combinación disponibles para su organización.

Formato de API

GET /config/mergePolicies?{QUERY_PARAMS}
Parámetro Descripción
default Valor booleano que filtra los resultados según si las políticas de combinación son o no las predeterminadas para una clase de esquema.
limit Especifica el límite de tamaño de página para controlar el número de resultados que se incluyen en una página. Valor predeterminado: 20
orderBy Especifica el campo en el que se van a ordenar los resultados como orderBy=name o orderBy=+name para ordenar por nombre en orden ascendente, o orderBy=-name, para ordenarlas en orden descendente. Si se omite este valor, la clasificación predeterminada de name en orden ascendente.
isActiveOnEdge Valores booleanos que filtran los resultados por si las políticas de combinación están activas o no en Edge.
schema.name Nombre del esquema para el que se recuperan las directivas de combinación disponibles.
identityGraph.type Filtra los resultados por tipo de gráfico de identidad. Los valores posibles incluyen "ninguno" y "pdg" (gráfico privado).
attributeMerge.type Filtra los resultados por el tipo de combinación de atributos utilizado. Los valores posibles incluyen "timestampOrdered" y "dataSetPrecedence".
start Desplazamiento de página : especifique el ID de inicio de los datos que se van a recuperar. Valor predeterminado: 0
version Especifique esto si desea utilizar una versión específica de la directiva de combinación. De forma predeterminada, se utilizará la versión más reciente.

Para obtener más información sobre schema.name, identityGraph.typey attributeMerge.type, consulte componentes de políticas de combinación sección proporcionada anteriormente en esta guía.

Solicitud

La siguiente solicitud enumera todas las directivas de combinación para un esquema determinado:

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}

Respuesta

Una respuesta correcta devuelve una lista paginada de directivas de combinación que cumplen los criterios especificados por los parámetros de consulta enviados en la solicitud.

{
    "_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"
            },
            "isActiveOnEdge": true,
            "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"
                ]
            },
            "isActiveOnEdge": false,
            "default": false,
            "updateEpoch": 1576099719
        }
    ],
    "_links": {
        "next": {
            "href": "@/mergePolicies?start=K1JJRDpFaWc5QUpZWHY1c2JBQUFBQUFBQUFBPT0jUlQ6MSNUUkM6MiNGUEM6QWdFQUFBQldBQkVBQVBnaFFQLzM4VUIvL2tKQi8rLysvMUpBLzMrMi8wRkFmLzR4UUwvL0VrRC85em4zRTBEcmNmYi92Kzh4UUwvL05rQVgzRi8rMStqNS80WHQwN2NhUUVzQUFBUUFleGpLQ1JnVXRVcEFCQUFFQVBBRA==&orderBy=&limit=2"
        }
    }
}
Propiedad Descripción
_links.next.href Una dirección URI para la siguiente página de resultados. Utilice este URI como parámetro de solicitud para otra llamada de API al mismo extremo para ver la página. Si no existe ninguna página siguiente, este valor será una cadena vacía.

Crear una directiva de combinación

Puede crear una nueva directiva de combinación para su organización realizando una solicitud de POST al /config/mergePolicies punto final.

Formato de API

POST /config/mergePolicies

Solicitud
La siguiente solicitud crea una nueva directiva de combinación, que está configurada por los valores de atributo proporcionados en la carga útil:

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"
    },
    "isActiveOnEdge": true,
    "default": true
}'
Propiedad Descripción
name Nombre reconocible mediante el cual se puede identificar la política de combinación en las vistas de lista.
identityGraph.type Tipo de gráfico de identidad desde el cual obtener identidades relacionadas para combinar. Valores posibles: "none" o "pdg" (gráfico privado).
attributeMerge Modo en el que se priorizan los valores de atributos de perfil en caso de conflictos de datos.
schema La clase de esquema XDM asociada a la directiva de combinación.
isActiveOnEdge Especifica si esta directiva de combinación está activa en Edge.
default Especifica si esta directiva de combinación es la predeterminada para el esquema.

Consulte la componentes de políticas de combinación para obtener más información.

Respuesta

Una respuesta correcta devuelve los detalles de la política de combinación recién creada.

{
    "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"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Consulte la componentes de políticas de combinación al principio de este documento para obtener detalles sobre cada uno de los elementos individuales que componen una política de combinación.

Actualizar una directiva de combinación

Puede modificar una política de combinación existente editando atributos individuales (PATCH) o sobrescribiendo toda la política de combinación con atributos nuevos (PUT). A continuación se muestran ejemplos de cada uno.

Editar campos de política de combinación individuales

Puede editar campos individuales para una política de combinación realizando una solicitud de PATCH al /config/mergePolicies/{mergePolicyId} punto final:

Formato de API

PATCH /config/mergePolicies/{mergePolicyId}
Parámetro Descripción
{mergePolicyId} Identificador de la directiva de combinación que desea eliminar.

Solicitud

La siguiente solicitud actualiza una directiva de combinación especificada cambiando el valor de su default propiedad a 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"
  }'
Propiedad Descripción
op Especifica la operación que se va a realizar. Se pueden encontrar ejemplos de otras operaciones de PATCH en la Documentación de parches JSON
path Ruta del campo que se va a actualizar. Los valores aceptados son: "/name", "/identityGraph.type", "/attributeMerge.type", "/schema.name", "/version", "/default", "/isActiveOnEdge"
value El valor en el que se va a establecer el campo especificado.

Consulte la componentes de políticas de combinación para obtener más información.

Respuesta

Una respuesta correcta devuelve los detalles de la directiva de combinación recién actualizada.

{
    "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"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Sobrescribir una directiva de combinación

Otra forma de modificar una política de combinación es utilizar una solicitud de PUT, que sobrescribe toda la política de combinación.

Formato de API

PUT /config/mergePolicies/{mergePolicyId}
Parámetro Descripción
{mergePolicyId} Identificador de la política de combinación que desea sobrescribir.

Solicitud

La siguiente solicitud sobrescribe la directiva de combinación especificada, reemplazando sus valores de atributo por los suministrados en la carga útil. Dado que esta solicitud sustituye completamente una política de combinación existente, es necesario proporcionar todos los campos necesarios al definir originalmente la política de combinación. Sin embargo, esta vez se proporcionan valores actualizados para los campos que se desea cambiar.

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"
            ]
        },
        "isActiveOnEdge": true,
        "default": true,
        "updateEpoch": 1551898378
    }'
Propiedad Descripción
name Nombre reconocible mediante el cual se puede identificar la política de combinación en las vistas de lista.
identityGraph Gráfico de identidad desde el cual obtener identidades relacionadas para fusionar.
attributeMerge Modo en el que se priorizan los valores de atributos de perfil en caso de conflictos de datos.
schema La clase de esquema XDM asociada a la directiva de combinación.
isActiveOnEdge Especifica si esta directiva de combinación está activa en Edge.
default Especifica si esta directiva de combinación es la predeterminada para el esquema.

Consulte la componentes de políticas de combinación para obtener más información.

Respuesta

Una respuesta correcta devuelve los detalles de la directiva de combinación actualizada.

{
    "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"
        ]
    },
    "isActiveOnEdge": true,
    "default": true,
    "updateEpoch": 1551898378
}

Eliminar una directiva de combinación

Una directiva de combinación se puede eliminar realizando una solicitud de DELETE al /config/mergePolicies e incluye el ID de la directiva de combinación que desea eliminar en la ruta de solicitud.

NOTA

Si la directiva de combinación tiene isActiveOnEdge establezca en true, la directiva de combinación cannot se eliminará. Utilice cualquiera de las opciones PATCH o PUT extremos para actualizar la directiva de combinación antes de eliminarla.

Formato de API

DELETE /config/mergePolicies/{mergePolicyId}
Parámetro Descripción
{mergePolicyId} Identificador de la directiva de combinación que desea eliminar.

Solicitud

La siguiente solicitud elimina una directiva de combinación.

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}' \

Respuesta

Una solicitud de eliminación correcta devuelve el estado HTTP 200 (OK) y un cuerpo de respuesta vacío. Para confirmar que la eliminación se ha realizado correctamente, puede realizar una solicitud de GET para ver la directiva de combinación por su ID. Si se eliminó la directiva de combinación, recibirá un error de estado HTTP 404 (no encontrado).

Pasos siguientes

Ahora que sabe cómo crear y configurar políticas de combinación para su organización, puede utilizarlas para ajustar la vista de los perfiles de cliente dentro de Platform y para crear segmentos de audiencia a partir de su Real-time Customer Profile datos.

Consulte la Documentación del servicio de segmentación de Adobe Experience Platform para empezar a definir y trabajar con segmentos.

En esta página