„OData“ užklausos pavyzdžiai
Pastaba.
Customer Insights - Data lenteles taip pat galima pasiekti naudojant Dataverse API. Rekomenduojame naudoti Dataverse API užklausoms dėl "Customer Insights" duomenų, nes jie siūlo platesnį filtravimą, didesnį pralaidumą ir mažesnę delsą. Daugiau informacijos ieškokite Dataverse "Customer Insights" API.
Atvirųjų duomenų protokolas (OData) yra duomenų prieigos protokolas, sukurtas remiantis pagrindiniais protokolais, pvz., HTTP. Jis naudoja visuotinai priimtas metodikas, pvz., REST žiniatinkliui. Yra įvairių rūšių bibliotekų ir įrankių, kuriuos galima naudoti norint naudotis "OData" paslaugomis.
Kad būtų lengviau kurti savo diegimus pagal Dynamics 365 Customer Insights - Data API, peržiūrėkite keletą dažnai užduodamų užklausų pavyzdžių.
Modifikuokite užklausos pavyzdžius, kad jie veiktų paskirties aplinkose:
- {serviceRoot}:
https://api.ci.ai.dynamics.com/v1/instances/{instanceId}
kur {instanceId} yra aplinkos, Customer Insights - Data dėl kurios norite pateikti užklausą, GUID. Operacija „ListAllInstances“ leidžia rasti egzempliorių {InstanceId}, prie kurio turite prieigą. - {CID}: suvienodinto kliento įrašo GUID. Pavyzdys:
ce759201f786d590bf2134bff576c369
. - {AlternateKey}: kliento įrašo duomenų šaltinis pirminio rakto identifikatorius. Pavyzdys:
CNTID_1002
- {DSname}: eilutė su lentelės pavadinimu duomenų šaltinis, į Customer Insights - Data kurį patenkama. Pavyzdys:
Website_contacts
. - {SegmentName}: eilutė su išvesties lentelės pavadinimu, kuriame yra Customer Insights - Data segmentas. Pavyzdys:
Male_under_40
.
kliente
Lentelės Klientas užklausų pavyzdžiai.
Užklausos tipas | Pavyzdžiui | Pastaba. |
---|---|---|
Vieno kliento ID | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}' |
|
Alternatyvusis raktas | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}' |
Alternatyvieji raktai išlieka vieningoje klientų lentelėje |
Pažymėti | {serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1' |
|
Į | {serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’) |
|
Alternatyvusis raktas + į | {serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}') |
|
Paieška | {serviceRoot}/data/Customer?$top=10&$skip=0&$search="string" |
Pateikia 10 svarbiausių ieškos eilutės rezultatų |
Segmento narystė | {serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10 |
Pateikia iš anksto nustatytą segmentavimo lentelės eilučių skaičių. |
Kliento segmento narystė | {serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}') |
Grąžina kliento profilį, jei klientas yra nurodyto segmento narys |
Vieninga veikla
Lentelės UnifiedActivity užklausų pavyzdžiai.
Užklausos tipas | Pavyzdžiui | Pastaba. |
---|---|---|
CID veikla | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' |
Išvardija konkretaus kliento profilio veiklas |
Veiklos laikotarpis | {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 |
Kliento profilio veikla per tam tikrą laikotarpį |
Veiklos tipas | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}' |
|
Veikla pagal rodomą pavadinimą | {serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’ |
|
Veiklos rūšiavimas | {serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc |
Veiklos rikiavimas didėjimo arba mažėjimo tvarka |
Visa veikla ir priemonės klientui | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}' |
Veiklos ir priemonės yra papildomos raktų / reikšmių poros grąžinto kliento profilyje |
Darbo eigų valdymas
Užklausų, susijusių su procesais Customer Insights - Data , pvz., duomenų šaltinis atnaujinimu, duomenų suvienodinimu arba suvienijimo užduoties būsenos gavimu, pavyzdžiai.
Užklausos tipas | Pavyzdžiui | Pastaba. |
---|---|---|
Gaukite duomenų šaltinis ID | {serviceRoot}/manage/datasources/v2 |
Grąžina visus jūsų aplinkos duomenų šaltinius. Iš atsakymo galite patikrinti konkretaus duomenų šaltinis "friendlyName" ir naudoti jo "dataSourceId". |
Paleisti iš naujo duomenų šaltinį | {serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true |
Naudokite "dataSourceId" iš aukščiau pateikto atsakymo, kad atnaujintumėte duomenų šaltinis. Tai yra POST užklausa. |
Paleiskite visą atnaujinimą | {serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true |
Atnaujina visus jūsų aplinkos procesus. Tai yra POST užklausa. |
Gaukite procesų būseną | {serviceRoot}/manage/workflows/main/jobs |
Kiti pavyzdžiai
Kitų lentelių užklausų pavyzdžiai.
Užklausos tipas | Pavyzdžiui | Pastaba. |
---|---|---|
CID priemonės | {serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}' |
|
Praturtinti CID prekės ženklai | {serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
Praturtinti CID interesai | {serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}' |
|
Sąlyga + Išplėsti | {serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}') |
Apribojimai
Pagal numatytuosius nustatymus "Customer Insights" API pateikia daugiausia 100 objektų. Galite išanalizuoti daugiau nei 100 grąžintų objektų naudodami standartinius puslapių numeravimo metodus. Arba galite eksportuoti savo duomenis.
Nepalaikomos šios užklausos:
-
$filter
ant nurijusių šaltinių lentelių. $filter užklausas galite vykdyti tik kuriamose sistemos lentelėse Customer Insights - Data . -
$expand
iš užklausos$search
. Pavyzdžiui:Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey"
. -
$expand
iš,$select
jei pasirinktas tik atributų poaibis. Pavyzdžiui:Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'
. -
$expand
praturtintas prekės ženklo ar pomėgių panašumas konkrečiam klientui. Pavyzdžiui:Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'
. - Užklausa prognozė modelio išvesties lenteles naudojant alternatyvusis raktas. Pavyzdžiui:
OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'
.
-