Esempi di query OData
Nota
È possibile accedere alle tabelle Customer Insights - Data anche utilizzando le API Dataverse. Ti consigliamo di utilizzare le API Dataverse per eseguire query sui dati di Customer Insights poiché offrono filtri più estesi, maggiore velocità effettiva e minore latenza. Per altre informazioni, vedi API Dataverse per Customer Insights.
OData (Open Data Protocol) è un protocollo di accesso ai dati basato su protocolli di base come HTTP. Utilizza metodologie comunemente accettate come REST per il Web. Esistono vari tipi di librerie e strumenti che consentono di utilizzare i servizi OData.
Per aiutarti a creare le implementazioni basate sulle API di Dynamics 365 Customer Insights - Data, rivedi le query di esempio richieste di frequente.
Modificare gli esempi di query perché funzionino negli ambienti di destinazione:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}dove {instanceId} è il GUID dell'ambiente Customer Insights - Data su cui eseguire le query. L'operazione ListAllInstances consente di trovare gli elementi {InstanceId} a cui hai accesso. - {CID}: GUID di un record cliente unificato. Esempio:
ce759201f786d590bf2134bff576c369. - {AlternateKey}: identificatore della chiave primaria di un record cliente in un origine dati. Esempio:
CNTID_1002 - {DSname}: stringa con il nome del tavolo di un'origine dati che viene inserito in Customer Insights - Data. Esempio:
Website_contacts. - {SegmentName}: stringa con il nome della tabella di output di un segmento in Customer Insights - Data. Esempio:
Male_under_40.
Cliente
Esempi di query per la tabella Cliente.
| Tipo di query | Esempio | Nota |
|---|---|---|
| ID cliente singolo | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| Chiave alternativa | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
Le chiavi alternative persistono nella tabella cliente unificata |
| Seleziona | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| Tra | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| Chiave alternativa + In | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| Ricerca | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Restituisce i primi 10 risultati per una stringa di ricerca |
| Appartenenza al segmento | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
Restituisce un numero predefinito di righe dalla tabella di segmentazione. |
| Membro del segmento per un cliente | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Restituisce il profilo del cliente se è un membro del segmento specificato |
Impegno unificato
Esempi di query per la tabella UnifiedActivity:
| Tipo di query | Esempio | Nota |
|---|---|---|
| Impegno di CID | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Elenca gli impegni di un profilo cliente specifico |
| Intervallo di tempo impegni | {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 |
Impegni di un profilo cliente in un intervallo di tempo |
| Tipo di impegno | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| Impegno per nome visualizzato | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| Ordinamento impegni | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Ordina gli impegni in modo crescente o decrescente |
| Tutte le attività e le misure per un cliente | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
Le attività e le misure sono coppie chiave/valore aggiuntive al profilo del cliente restituito |
Gestire flussi di lavoro
Query di esempio relative ai processi in Customer Insights - Data come aggiornare un'origine dati, unificare i dati oppure ottenere lo stato di un processo di unificazione.
| Tipo di query | Esempio | Nota |
|---|---|---|
| Otieni ID origine dati | {serviceRoot}/manage/datasources/v2 |
Restituisce tutte le origini dati nel tuo ambiente. Dalla risposta, puoi controllare "friendlyName" per un'origine dati specifica e quindi utilizzare il suo "dataSourceId". |
| Aggiornare un'origine dati | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Utilizza "dataSourceId" dalla risposta precedente per aggiornare un'origine dati. Questa è una richiesta POST. |
| Esegui un aggiornamento completo | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Aggiorna tutti i processi nell'ambiente desktop. Questa è una richiesta POST. |
| Ottiene lo stato dei processi | {serviceRoot}/manage/workflows/main/jobs |
Altri esempi
Query di esempio per altre tabelle:
| Tipo di query | Esempio | Nota |
|---|---|---|
| Misure di CID | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| Marchi arricchiti di CID | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Interessi arricchiti di CID | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Clausola In + Espandi | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Limiti
L'API Customer Insights restituisce un massimo di 100 oggetti per impostazione predefinita. È possibile analizzare più di 100 oggetti restituiti utilizzando tecniche di impaginazione standard. In alternativa, puoi esportare i tuoi dati.
Le seguenti query non sono supportate:
-
$filtersulle tabelle di origine inserite. Puoi eseguire query $filter solo sulle tabelle di sistema create da Customer Insights - Data. -
$expandda una query$search. Ad esempio:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey". -
$expandda$selectse è selezionato solo un sottoinsieme di attributi. Ad esempio:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'. -
Marchio arricchito o affinità di interesse
$expandper un determinato cliente. Ad esempio:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'. - Query sulle tabelle di output del modello di previsione tramite chiave alternativa. Ad esempio:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.
-