Exemplos de consulta OData

Nota

Customer Insights - Data Tamén se pode acceder ás táboas mediante Dataverse API. Recomendamos que utilices Dataverse APIs para consultar os datos de Customer Insights, xa que ofrecen un filtrado máis amplo, un maior rendemento e unha menor latencia. Para obter 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} é 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 principais resultados dunha 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 de 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. Como alternativa, pode exportar os seus 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}'.