Jagamisviis:

OData päringute näited

  • Artikkel

Märkus.

Customer Insights - Data tabelitele pääseb juurde ka API-de abil Dataverse . Soovitame Dataverse kasutada rakendusliideseid Customer Insightsi andmete kohta päringute tegemiseks, kuna need pakuvad ulatuslikumat filtreerimist, suuremat läbilaskevõimet ja väiksemat latentsusaega. Lisateavet vaadake jaotisest Dataverse Customer Insightsi API-d.

Avaandmete protokoll (OData) on andmetele juurdepääsu protokoll, mis põhineb põhiprotokollidel nagu HTTP. See kasutab üldtunnustatud metoodikaid, nagu REST veebi jaoks. OData teenuste tarbimiseks saab kasutada mitmesuguseid teeke ja tööriistu.

Selleks et aidata teil API-de Dynamics 365 Customer Insights - Data põhjaloma juurutusi luua, vaadake üle mõned korduma kippuvad näidispäringud.

Muutke päringunäidiseid, et need töötaksid sihtkeskkondades.

  • {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId} kus {instanceId} on selle keskkonna GUID, mille Customer Insights - Data kohta soovite päringu esitada. Toiming ListAllInstances võimaldab teil leida selle {InstanceId}, millele teil on juurdepääs.
  • {CID}: ühtse kliendikirje GUID. Näide: ce759201f786d590bf2134bff576c369.
  • {AlternateKey}: andmeallikas kliendikirje primaarvõtme identifikaator. Näide: CNTID_1002
  • {DSname}: String allaneelatava Customer Insights - Data andmeallikas tabelinimega. Näide: Website_contacts
  • {SegmentName}: String, millel on segmendi Customer Insights - Data väljundtabeli nimi. Näide: Male_under_40

klient

Näidispäringud tabeli Klient jaoks .

Päringu tüüp Näide Märkus.
Ühe kliendi ID {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' 
alternatiivvõti {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' Alternatiivvõtmed jäävad ühtses klienditabelis alles
Valige {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
Sisse {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
Alternatiivvõti + Sisse {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
Otsige {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" Annab vastuseks otsingustringi 10 parimat tulemust.
Segmendi liikmelisus {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 Tagastab valmismääratud arvu ridu segmentimistabelist.
Segmendi liikmelisus kliendi jaoks {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') Tagastab kliendiprofiili, kui ta on antud segmendi liige.

Ühtne tegevus

Tabeli UnifiedActivity näidispäringud .

Päringu tüüp Näide Märkus.
CID aktiivsus {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'  Loetleb konkreetse kliendiprofiili tegevused
Tegevuse ajakava {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 Kliendiprofiili tegevused ajaraamis
Tegevuse tüüp {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
Tegevus kuvatava nime järgi {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
Tegevuste sorteerimine {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc Tõusvate või laskuvate tegevuste sortimine
Kõik tegevused ja meetmed kliendi jaoks {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' Tegevused ja mõõdud on täiendavad võtme/väärtuse paarid tagastatud kliendiprofiilil

Töövoogude haldamine

Protsessidega Customer Insights - Data seotud näidispäringud, nagu andmeallikas värskendamine, andmete ühendamine või ühendamistöö oleku saamine.

Päringu tüüp Näide Märkus.
Hankige andmeallikas ID-d {serviceRoot}/manage/datasources/v2 Tagastab kõik teie keskkonnas olevad andmeallikad. Vastuse põhjal saate kontrollida konkreetse andmeallikas "friendlyName" ja seejärel kasutada selle ’dataSourceId’.
Andmeallika värskendamine {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true Kasutage andmeallikas värskendamiseks ülaltoodud vastuses olevat "dataSourceId". See on POST-taotlus.
Täieliku värskenduse käivitamine {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true Värskendab kõiki teie keskkonnas toimuvaid protsesse. See on POST-taotlus.
Protsesside oleku saamine {serviceRoot}/manage/workflows/main/jobs

Muud näited

Näidispäringud muude tabelite kohta.

Päringu tüüp Näide Märkus.
CID meetmed {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
Rikastatud CID kaubamärgid {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
CID rikastatud huvid {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
Klauslisisene + laiendamine {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

Piirangud

  • Customer Insightsi API tagastab vaikimisi maksimaalselt 100 objekti. Saate sõeluda läbi rohkem kui 100 tagastatud objekti, kasutades standardseid lehitsemistehnikaid. Teise võimalusena saate oma andmed eksportida.

  • Järgmisi päringuid ei toetata.

    • $filter allaneelatud lähtetabelitel. $filter päringuid saate käivitada ainult loodud süsteemitabelites Customer Insights - Data .
    • $expand $search päringust. Näiteks: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
    • $expand alates $select , kui valitud on ainult atribuutide alamhulk. Näiteks: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
    • $expand rikastatud kaubamärk või huvid antud kliendi jaoks. Näiteks: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
    • Päring prognoos mudeli väljundtabeleid alternatiivvõti kaudu. Näiteks: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.