Exemplos de consulta OData

Nota

Customer Insights - Data Tamén se pode acceder ás táboas mediante Dataverse API. Recomendamos que use Dataverse API para consultar os datos de Customer Insights xa que ofrecen filtrado máis extenso, maior rendemento e menor latencia. Para máis información, consulte Dataverse APIs para Customer Insights.

O protocolo de datos abertos (OData) é un protocolo de acceso a datos construído en protocolos básicos como HTTP. Utiliza metodoloxías comúnmente aceptadas como REST para a web. Existen varios tipos de bibliotecas e ferramentas que se poden usar para consumir servizos de OData.

Para axudarche a crear as túas propias implementacións baseadas nas Dynamics 365 Customer Insights - Data API, revisa algunhas consultas de exemplo que se solicitan con frecuencia.

Modifique as mostras de consulta para que funcionen nos ambientes de destino:

• {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId} onde {instanceId} está o GUID do Customer Insights - Data entorno que quere consultar. A operación ListAllInstances permíteche atopar o {InstanceId} ao que tes acceso.
• {CID}: GUID dun rexistro de cliente unificado. Exemplo: ce759201f786d590bf2134bff576c369.
• {AlternateKey}: identificador da clave primaria dun rexistro de cliente nun orixe de datos. Exemplo: CNTID_1002
• {DSname}: Cadea co nome da táboa dun orixe de datos que se inxire a Customer Insights - Data. Exemplo: Website_contacts.
• {SegmentName}: Cadea co nome da táboa de saída dun segmento en Customer Insights - Data. Exemplo: Male_under_40.

cliente/a

Consultas de exemplo para a táboa Cliente .

Tipo de consulta	Exemplo	Nota
ID de cliente único	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'
Clave alternativa	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}'	As claves alternativas persisten na táboa de clientes unificada
Seleccionar	{serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
Entrada	{serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
Clave alternativa + In	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
Buscar	{serviceRoot}/data/Customer?$top=10&$skip=0&$search="string"	Devolve os 10 primeiros resultados para unha cadea de busca
Segmento de pertenza	{serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10	Devolve un número predefinido de filas da táboa de segmentación.
Segmento de pertenza para un cliente	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}')	Devolve o perfil do cliente se é membro do segmento indicado

Actividade unificada

Consultas de exemplo para a táboa UnifiedActivity .

Tipo de consulta	Exemplo	Nota
Actividade do CID	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'	Lista actividades dun perfil de cliente específico
Temporalización da actividade	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityTime gt 2017-01-01T00:00:00.000Z and ActivityTime lt 2020-01-01T00:00:00.000Z	Actividades dun perfil de cliente nun marco temporal
Tipo de actividade	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
Actividade por nome de visualización	{serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
Clasificación de actividades	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc	Ordenar as actividades ascendentes ou descendentes
Todas as actividades e medidas para un cliente	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}'	As actividades e medidas son pares clave/valor adicionais no perfil do cliente devolto

Xestionar fluxos de traballo

Consultas de mostra relacionadas con procesos en Customer Insights - Data como actualizar un orixe de datos, unificar datos ou obter o estado dun traballo de unificación.

Tipo de consulta	Exemplo	Nota
Obtén ID de orixe de datos	{serviceRoot}/manage/datasources/v2	Devolve todas as fontes de datos do teu contorno. A partir da resposta, pode comprobar o 'friendlyName' para un orixe de datos específico e, a continuación, usar o seu 'dataSourceId'.
Actualizar unha orixe de datos	{serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true	Use o 'dataSourceId' da resposta anterior para actualizar un orixe de datos. Esta é unha solicitude POST.
Executa unha actualización completa	{serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true	Actualiza todos os procesos do teu entorno. Esta é unha solicitude POST.
Obter o estado dos procesos	{serviceRoot}/manage/workflows/main/jobs

Outros exemplos

Consultas de exemplo para outras táboas.

Tipo de consulta	Exemplo	Nota
Medidas de CID	{serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
Marcas enriquecidas de CID	{serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
Intereses enriquecidos do CID	{serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
In-Clause + Expandir	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

Limitacións

• A API de Customer Insights devolve un máximo de 100 obxectos por defecto. Podes analizar máis de 100 obxectos devoltos usando técnicas de paxinación estándar. Tamén podes exportar os teus datos.

• Non se admiten as seguintes consultas:

  • $filter nas táboas fonte inxeridas. Só pode executar consultas $filter nas táboas do sistema que Customer Insights - Data cree.
  • $expand dunha consulta $search . Por exemplo: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
  • $expand de $select se só se selecciona un subconxunto de atributos. Por exemplo: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
  • $expand marca enriquecida ou afinidades de interese para un determinado cliente. Por exemplo: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
  • Consulta as táboas de saída do modelo predición a través de clave alternativa. Por exemplo: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.