Compartir a través de

API de Dataverse para Customer Insights - Data

  • Artículo

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. Esto se genera automáticamente cuando se utiliza 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.

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) Esto se puede cambiar para devolver hasta 200 páginas vistas recientes
Obtener pulsaciones recientes (últimas 10) en la página de un cliente mediante CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Esto se puede cambiar para devolver hasta 200 pulsaciones de página recientes

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