Príklady dotazov OData
Poznámka
Customer Insights - Data k tabuľkám je možné pristupovať aj pomocou Dataverse API. Odporúčame vám použiť Dataverse API na dopytovanie údajov Customer Insights, pretože ponúkajú rozsiahlejšie filtrovanie, vyššiu priepustnosť a nižšiu latenciu. Ďalšie informácie nájdete v časti Dataverse API for Customer Insights.
Open Data Protocol (OData) je protokol pre prístup k údajom založený na základných protokoloch, ako je HTTP. Používa bežne akceptované metodológie ako REST pre web. Existujú rôzne druhy knižníc a nástrojov, ktoré možno použiť na používanie služieb OData.
Ak chcete pomôcť pri vytváraní vlastných implementácií na základe Dynamics 365 Customer Insights - Data rozhraní API, pozrite si niektoré často požadované vzorové dopyty.
Upravte vzorky dotazov, aby fungovali v cieľových prostrediach:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}kde {instanceId} je GUID Customer Insights - Data prostredia, na ktoré sa chcete pýtať. Operácia ListAllInstances vám umožňuje nájsť {InstanceId} ku ktorému máte prístup. - {CID}: GUID jednotného zákazníckeho záznamu. Príklad:
ce759201f786d590bf2134bff576c369. - {AlternateKey}: Identifikátor primárneho kľúča záznamu zákazníka v zdroji údajov. Príklad:
CNTID_1002 - {DSname}: Reťazec s názvom tabuľky zdroja údajov, ktorý sa prijíma do Customer Insights - Data. Príklad:
Website_contacts. - {SegmentName}: Reťazec s názvom výstupnej tabuľky segmentu v Customer Insights - Data. Príklad:
Male_under_40.
Customer
Vzorové dopyty pre tabuľku Zákazník .
| Typ dotazu | Príklad | Poznámka |
|---|---|---|
| Identifikačné číslo jedného zákazníka | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| Alternatívny kľúč | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
Alternatívne kľúče zostávajú v zjednotenej tabuľke zákazníkov |
| Vyberte | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| V | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| Alternatívny kľúč + vstup | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| Vyhľadávať | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Vráti 10 najlepších výsledkov pre hľadaný reťazec |
| Členstvo v segmente | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
Vráti prednastavený počet riadkov z tabuľky segmentácie. |
| Členstvo v segmente pre zákazníka | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Vráti profil zákazníka, ak je členom daného segmentu |
Jednotná činnosť
Vzorové dopyty pre tabuľku UnifiedActivity .
| Typ dotazu | Príklad | Poznámka |
|---|---|---|
| Činnosť CID | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Uvádza aktivity konkrétneho profilu zákazníka |
| Časový rámec činnosti | {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 |
Aktivity zákazníckeho profilu v časovom rámci |
| Typ aktivity | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| Aktivita podľa zobrazovaného mena | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| Triedenie aktivít | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Zoraďte aktivity vzostupne alebo zostupne |
| Všetky činnosti a opatrenia pre zákazníka | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
Aktivity a opatrenia sú dodatočné páry kľúč/hodnota na vrátenom zákazníckom profile |
Spravujte pracovné toky
Vzorové dopyty súvisiace s procesmi v Customer Insights - Data ako je obnovenie zdroja údajov, zjednotenie údajov alebo získanie stavu úlohy zjednotenia.
| Typ dotazu | Príklad | Poznámka |
|---|---|---|
| Získajte ID zdrojov údajov | {serviceRoot}/manage/datasources/v2 |
Vráti všetky zdroje údajov vo vašom prostredí. Z odpovede môžete skontrolovať „friendlyName“ pre konkrétny zdroj údajov a potom použiť jeho „dataSourceId“. |
| Obnovte zdroj údajov | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Na obnovenie zdroja údajov použite 'dataSourceId' z vyššie uvedenej odpovede. Toto je POST žiadosť. |
| Spustite úplné obnovenie | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Obnovuje všetky procesy vo vašom prostredí. Toto je POST žiadosť. |
| Získajte stav procesov | {serviceRoot}/manage/workflows/main/jobs |
Ďalšie príklady
Vzorové dopyty pre iné tabuľky.
| Typ dotazu | Príklad | Poznámka |
|---|---|---|
| Opatrenia CID | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| Obohatené značky CID | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| Obohatené záujmy CID | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| In-Clause + Expand | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Obmedzenia
Customer Insights API štandardne vracia maximálne 100 objektov. Pomocou štandardných techník stránkovania môžete analyzovať viac ako 100 vrátených objektov. Prípadne môžete exportovať svoje údaje.
Nasledujúce dotazy nie sú podporované:
-
$filterna prijatých zdrojových tabuľkách. Dotazy $filter môžete spúšťať iba na systémové tabuľky, ktoré Customer Insights - Data vytvoria. -
$expandz$searchdotazu. Napríklad:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey". -
$expandod$selectak je vybratá iba podmnožina atribútov. Napríklad:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'. -
$expandobohatené značky alebo záujmové afinity pre daného zákazníka. Napríklad:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'. - Dopytujte výstupné tabuľky predikčného modelu prostredníctvom alternatívneho kľúča. Napríklad:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.
-