Leer en inglés

Compartir a través de


API de Dataverse para Customer Insights - Data

Si ya usa las API de Customer Insights - Data, como para consultar un perfil de cliente u obtener membresías de segmentos, le recomendamos que migre sus API a la API de Dataverse en su lugar. La compatibilidad con la consulta de metadatos, como la definición de segmentos y la gestión del flujo de trabajo, llegará pronto a las API de Dataverse.

Si está empezando a consultar datos mediante API, le recomendamos que utilice API de Dataverse en su lugar.

Importante

Se recomienda usar API de Dataverse solo para leer datos (GET) y no para escribir datos (POST/PATCH/PUT), ya que puede causar problemas con el procesamiento de Customer Insights - Data.

Las API de Dataverse tienen las siguientes ventajas:

  • Capacidades extendidas para filtrar y clasificar

  • Escala y rendimiento mejorados

  • Experiencia de API uniforme en las aplicaciones de Dynamics 365 y Power Platform

Consultas de ejemplo

Para empezar a usar las API de Dataverse, cree un registro de aplicación en Azure y solicite permisos para Dataverse y otorgue a su aplicación permisos de Visor en Customer Insights - Data.

Modifique los ejemplos de consulta para que funcionen en los entornos de destino:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ donde {URI de organización} es el URI del inquilino de Dataverse asociado a su entorno. Por ejemplo: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID de un registro de cliente unificado. Por ejemplo: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identificador de la clave primaria de un registro de cliente en un origen de datos. Por ejemplo: CNTID_1002.

  • {DSname}: Cadena con el nombre de tabla de un origen de datos que se transfiere a Customer Insights - Data. Por ejemplo: Website_contacts.

  • {SegmentName}: Cadena con el nombre de la tabla de salida de un segmento. Por ejemplo: Male_under_40.

  • {CookieId}: Identificador de cada visitante del sitio web, que se genera automáticamente al utilizar el script de seguimiento web. Por ejemplo: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Cliente

Ejemplos de consultas para la tabla CustomerProfile y membresías de segmentos.

Tipo de consulta Ejemplo Nota
Obtener todos los clientes {serviceRoot}/msdynci_customerprofiles
Obtener cliente por ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Obtener cliente por clave alternativa {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Las claves alternativas persisten en la tabla de clientes unificada con el formato msdynci_DSname_TableName_PrimaryKeyColumnName
Obtener atributos seleccionados para un cliente {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Obtener clientes por ID (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Obtener clientes por clave alternativa (In) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Buscar clientes {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Obtener todos los clientes que son miembros de un segmento {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Obtener un cliente si es miembro de un segmento {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Obtener todas las pertenencias a segmentos de un cliente {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Personalización web

Consultas de ejemplo para personalizar su sitio web según el CookieId. La respuesta devuelve tanto clientes conocidos como desconocidos. Las tablas creadas para el seguimiento y la personalización web están disponibles en Dataverse.

Tipo de consulta Ejemplo Nota
Obtener cliente por CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Obtenga un cliente por CookieId e incluya segmentos, medidas, actividades {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Obtener visitas recientes (últimas 10) a la página de un cliente mediante CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Esta consulta se puede cambiar para devolver hasta 200 vistas de página recientes
Obtener pulsaciones recientes (últimas 10) en la página de un cliente mediante CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Esta consulta se puede cambiar para devolver hasta 200 clics recientes en la página

Actividad unificada

Ejemplos de consultas para la tabla UnifiedActivity:

Tipo de consulta Ejemplo Nota
Obtener todas las actividades de un cliente {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Obtener todas las actividades de un cliente dentro de un período de tiempo {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
Obtener todas las actividades de un tipo de actividad de un cliente {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Obtener todas las actividades de activityDisplayName de un cliente {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Obtener todas las actividades un cliente y ordenarlas {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Otros ejemplos

Ejemplos de consultas para otras tablas:

Tipo de consulta Ejemplo Nota
Obtener todas las medidas de un cliente {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Obtener marcas enriquecidas de un cliente {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Obtener los intereses enriquecidos de un cliente {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Obtener los resultados de modelo de IA de un cliente {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Pasos siguientes