OData-kyselyesimerkkejä
Muistiinpano
Customer Insights - Data -taulukkoja voi käyttää myös Dataversen ohjelmointirajapintojen avulla. Suosittelemme Dataversen ohjelmointirajapintojen käyttämistä Customer Insights -tietojen kyselemiseen, koska ne tarjoavat laajempaa suodatusta, nopeampaa käsittelyä ja pienempää viivettä. Lisätietoja on kohdassa Dataversen ohjelmointirajapinnat Customer Insightsia varten
OData (Open Data Protocol) on perusprotokollien, kuten HTTP:n, tietojen käyttöprotokolla. Se käyttää verkossa yleisesti hyväksyttyjä menetelmiä, kuten REST-menetelmää. OData-palveluiden käytössä voi käyttää erilaisia kirjastoja ja työkaluja.
Omien Dynamics 365 Customer Insights - Data -ohjelmointirajapintoihin perustuvien toteutusten muodostamista auttaa tutustuminen usein pyydettyihin esimerkkikyselyihin.
Muokkaa kyselynäytteitä, jotta ne toimivat kohdeympäristöissä:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}, jossa {instanceId} on sen Customer Insights - Data -ympäristön GUID, jossa kysely halutaan tehdä. ListAllInstances-toiminnon avulla voit etsiä sen {InstanceId}-tunnuksen, johon sinulla on käyttöoikeus. - {CID}: yhtenäisen asiakastietueen GUID-tunnus. Esimerkki:
ce759201f786d590bf2134bff576c369. - {AlternateKey}: asiakastietueen perusavaimen tunnus tietolähteessä. Esimerkki:
CNTID_1002 - {DSname}: Merkkijono, jossa on sen tietolähteen taulukon nimi, joka käsitellään Customer Insights - Datassa. Esimerkki:
Website_contacts. - {SegmentName}: Merkkijono, jolla on Customer Insights - Datan segmentin tulostaulukon nimi. Esimerkki:
Male_under_40.
asiakas
Asiakas-taulukon näytekyselyt.
| Kyselyn tyyppi | Esimerkki | Huomautus |
|---|---|---|
| Yksittäisen asiakkaan tunnus | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
| Vaihtoehtoinen avain | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
Vaihtoehtoiset avaimet säilyvät yhtenäisessä asiakastaulukossa |
| Lisää pisteitä ja merkitse mitattavan tilavuuden kanta valitsemalla Lisää-painike | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
| Kohteessa | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
| Vaihtoehtoinen avain + In | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
| Haku | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Palauttaa 10 ensimmäistä tulosta hakumerkkijonolle |
| Segmentin jäsenyys | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
Palauttaa segmentointitaulukon rivien esimääritetyn määrän. |
| Asiakkaan segmentin jäsenyys | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Palauttaa asiakasprofiilin, jos hän on tietyn segmentin jäsen |
Yhdistetty aktiviteetti
UnifiedActivity-taulukon näytekyselyt:
| Kyselyn tyyppi | Esimerkki | Huomautus |
|---|---|---|
| CID:in aktiviteetti | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Luettelo tietyn asiakasprofiilin aktiviteeteista |
| Aktiviteetin aikaikkuna | {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 |
Asiakasprofiilin aktiviteetit aikavälillä |
| Aktiviteettityyppi | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
| Aktiviteetti näyttönimen mukaan | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
| Aktiviteettien lajittelu | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Aktiviteettien lajittelu nousevassa tai laskevassa järjestyksessä |
| Asiakkaan kaikki aktiviteetit ja mittarit | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
Aktiviteetit ja mittarit ovat palautetun asiakasprofiilin avain-/arvo-lisäparit |
Työnkulkujen hallinta
Esimerkkikyselyt, jotka liittyvät Customer Insights - Datan prosesseihin, kuten tietolähteen päivitykseen, tietojen yhdistämiseen ja yhdistämistyön tilan noutamiseen.
| Kyselyn tyyppi | Esimerkki | Muistiinpano |
|---|---|---|
| Tietolähteen tunnusten noutaminen | {serviceRoot}/manage/datasources/v2 |
Palauttaa ympäristön kaikki tietolähteet. Voit tarkistaa vastauksesta tietyn tietolähteen friendlyName-nimen ja käyttää sen dataSourceId-tunnusta. |
| Tietolähteen päivittäminen | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Päivitä tietolähde käyttämällä yllä olevan vastauksen dataSourceId-tunnusta. Tämä on POST-pyyntö. |
| Täyden päivityksen suorittaminen | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Päivittää ympäristön kaikki prosessit. Tämä on POST-pyyntö. |
| Prosessien tilan noutaminen | {serviceRoot}/manage/workflows/main/jobs |
Lisää esimerkkejä
Muiden taulukoiden näytekyselyt.
| Kyselyn tyyppi | Esimerkki | Huomautus |
|---|---|---|
| CID:in mittarit | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
| CID:n rikastetut tuotemerkit | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| CID:in rikastetut kiinnostuksen kohteet | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
| In-Clause + Expand | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Rajoitukset
Customer Insightsin ohjelmointirajapinta palauttaa oletusarvoisesti enintään 100 kohdetta. Voit jäsentää yli 100 palautettua kohdetta käyttämällä vakiomuotoista sivutustekniikkaa. Vaihtoehtoisesti voit viedä tiedot.
Seuraavia kyselyjä ei tueta:
$filterkäsitellyissä lähde-entiteeteissä. $filter-kyselyt voidaan suorittaa vain Customer Insights - Datan luomissa järjestelmätaulukoissa.$expand$search-kyselystä. Esimerkki:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".$expandalkaen kohteesta$select, jos vain määritteiden alijoukko on valittu. Esimerkki:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.$expandtietyn asiakkaan rikastettuja brändi- tai kiinnostuksen kohteita. Esimerkki:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.- Kysely ennustemallin tulostetaulukoista vaihtoehtoisen avaimen avulla. Esimerkki:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.