Példák OData-lekérdezésre
Feljegyzés
Customer Insights - Data A táblák API-k használatával Dataverse is elérhetők. Javasoljuk, hogy API-kat használjon Dataverse a Customer Insights-adatok lekérdezéséhez, mivel ezek kiterjedtebb szűrést, nagyobb átviteli sebességet és alacsonyabb késést kínálnak. További információ: Dataverse API-k a Customer Insightshoz.
Az Open Data Protocol (OData) egy adatelérési protokoll, amely olyan alapvető protokollokra épül, mint a HTTP. Olyan általánosan elfogadott módszereket használ, mint a REST a weben. Az OData-szolgáltatások használatához különféle könyvtárak és eszközök használhatók.
Az API-kon Dynamics 365 Customer Insights - Data alapuló saját implementációk létrehozásához tekintse át a gyakran kért példalekérdezéseket.
Módosítsa a lekérdezési mintákat, hogy működjenek a célkörnyezetekben:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}where {instanceId} a lekérdezni kívánt környezet GUID azonosítója Customer Insights - Data . A ListAllInstances művelettel megtalálhatja azt, {InstanceId} amelyhez hozzáféréssel rendelkezik. - {CID}: Egységes ügyfélrekord GUID azonosítója. Példa:
ce759201f786d590bf2134bff576c369 - {AlternateKey}: Az adatforrás ügyfélrekordja elsődleges kulcsának azonosítója. Példa:
CNTID_1002 - {DSname}: Sztring egy olyan adatforrás táblanevével, amelybe Customer Insights - Data a rendszer betölti. Példa:
Website_contacts - {SegmentName}: Karakterlánc egy szegmens Customer Insights - Data kimeneti táblájának nevével. Példa:
Male_under_40
Customer
Mintalekérdezések a Customer táblához.
| Lekérdezés típusa | Példa | Feljegyzés |
|---|---|---|
| Egyetlen ügyfél-azonosító | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| Másodlagos kulcs | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
A másodlagos kulcsok megmaradnak az egyesített vevőtáblában |
| Select | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| Ennyi idő múlva: | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| Másodlagos kulcs + bemenet | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| Keresés | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Egy keresési karakterlánc első 10 eredményét adja vissza. |
| Szegmenstagság | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
A szegmentálási táblázat előre beállított számú sorát adja eredményül. |
| Szegmenstagság egy ügyfélhez | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Visszaadja az ügyfélprofilt, ha tagja az adott szegmensnek |
Egyesített tevékenység
Mintalekérdezések a UnifiedActivity táblához.
| Lekérdezés típusa | Példa | Feljegyzés |
|---|---|---|
| A CID tevékenysége | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Felsorolja egy adott ügyfélprofil tevékenységeit |
| Tevékenység időkerete | {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 |
Ügyfélprofil tevékenységei egy időkereten belül |
| Tevékenység típusa | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| Tevékenység megjelenítendő név szerint | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| Tevékenységek rendezése | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Tevékenységek rendezése növekvő vagy csökkenő sorrendbe |
| Minden tevékenység és intézkedés az ügyfél számára | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
A tevékenységek és mértékek további kulcs/érték párok a visszaadott ügyfélprofilban |
Munkafolyamatok kezelése
Folyamatokkal Customer Insights - Data kapcsolatos mintalekérdezések, például adatforrás frissítése, adatok egyesítése vagy egyesítési feladat állapotának lekérése.
| Lekérdezés típusa | Példa | Feljegyzés |
|---|---|---|
| Adatforrás-azonosítók lekérése | {serviceRoot}/manage/datasources/v2 |
A környezet összes adatforrását visszaadja. A válaszból ellenőrizheti egy adott adatforrás "friendlyName" értékét, majd használhatja annak "dataSourceId" azonosítóját. |
| Adatforrás frissítése | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Az adatforrás frissítéséhez használja a fenti válaszban található "dataSourceId" azonosítót. Ez egy POST kérés. |
| Teljes frissítés futtatása | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Frissíti a környezet összes folyamatát. Ez egy POST kérés. |
| A folyamatok állapotának lekérése | {serviceRoot}/manage/workflows/main/jobs |
Más példák
Mintalekérdezések más táblákhoz.
| Lekérdezés típusa | Példa | Feljegyzés |
|---|---|---|
| A CID intézkedései | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| A CID dúsított márkái | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| A CID bővített érdekeltségei | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Záradékon belül + kibontás | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Korlátozások
A Customer Insights API alapértelmezés szerint legfeljebb 100 objektumot ad vissza. A szabványos tördelési technikákkal több mint 100 visszaadott objektumot elemezhet. Alternatív megoldásként exportálhatja adatait.
A következő lekérdezések nem támogatottak:
-
$filtera betöltött forrástáblákon. Csak $filter lekérdezéseket futtathat olyan rendszertáblákon, amelyek Customer Insights - Data létrehoznak. -
$expandegy$searchlekérdezésből. Például:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey" -
$expandFeladó,$selectha az attribútumoknak csak egy részhalmaza van kiválasztva. Például:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}' -
$expandbővített márka- vagy érdeklődési köri affinitások egy adott ügyfélhez. Például:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10' - Lekérdezési előrejelzési modell kimeneti táblái másodlagos kulccsal. Például:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'
-