Jaa

OData-kyselyesimerkkejä

  • Artikkeli

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:

    • $filter kä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".
    • $expand alkaen kohteesta $select, jos vain määritteiden alijoukko on valittu. Esimerkki: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
    • $expand tietyn 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}'.