Bendrinti naudojant

„Dataverse“ API, skirtos „Customer Insights - Data“

  • Straipsnis

Jei jau naudojate Customer Insights - Data API, pvz., teikiate užklausą dėl kliento profilio arba gaunate segmentas narystes, rekomenduojame perkelti API į Dataverse API. Metaduomenų užklausų, pvz., segmentas aprašo gavimo ir darbo eigos valdymo, palaikymas netrukus Dataverse bus pasiekiamas API.

Jei pradedate teikti duomenų užklausas naudodami API, rekomenduojame naudoti Dataverse API.

Svarbu

API rekomenduojama naudoti Dataverse tik duomenims skaityti (GET), o ne duomenims rašyti (POST/PATCH/PUT), nes tai gali sukelti apdorojimo problemų Customer Insights - Data .

Dataverse API turi šiuos privalumus:

  • Išplėstinės filtravimo ir rūšiavimo galimybės

  • Patobulintas mastelis ir našumas

  • Nuoseklios API funkcijos "Dynamics 365" ir Power Platform programose

Užklausų pavyzdžiai

Norėdami pradėti naudoti Dataverse API, sukurkite programos registraciją "Azure" ir paprašykite leidimų Dataverse bei suteikite savo programos peržiūros programos teises Customer Insights - Data.

Modifikuokite užklausos pavyzdžius, kad jie veiktų paskirties aplinkose:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ kur {Organizacijos URI} yra nuomotojo, Dataverse susieto su jūsų aplinka, URI. Pavyzdžiui: https://{mydvorg}.crm.dynamics.com

  • {CID}: suvienodinto kliento įrašo GUID. Pavyzdžiui: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: kliento įrašo duomenų šaltinis pirminio rakto identifikatorius. Pavyzdžiui: CNTID_1002.

  • {DSname}: eilutė su lentelės pavadinimu duomenų šaltinis, į Customer Insights - Data kurį patenkama. Pavyzdžiui: Website_contacts.

  • {SegmentName}: eilutė su segmentas išvesties lentelės pavadinimu. Pavyzdžiui: Male_under_40.

  • {CookieId}: kiekvieno svetainės lankytojo identifikatorius. Tai automatiškai sugeneruojama naudojant žiniatinklio stebėjimo scenarijų. Pavyzdžiui: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

kliente

"CustomerProfile" lentelės ir segmentas narysčių užklausų pavyzdžiai.

Užklausos tipas Pavyzdžiui Pastaba.
Gaukite visus klientus {serviceRoot}/msdynci_customerprofiles
Gaukite klientą pagal ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Gaukite klientą pagal alternatyvusis raktas {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternatyvūs raktai išlieka vieningoje klientų lentelėje msdynci_DSname_TableName_PrimaryKeyColumnName formatu
Kliento pasirinktų atributų gavimas {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Gaukite klientų pagal ID (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Gaukite klientų naudodami alternatyviuosius raktus (į) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Klientų paieška {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Gaukite visus klientus, kurie yra segmentas nariai {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Gaukite klientą, jei jis yra segmentas narys {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Gaukite visas segmentas kliento narystes {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Žiniatinklio personalizavimas

Užklausų pavyzdžiai, skirti suasmeninti jūsų svetainę pagal CookieId. Atsakymas grąžina tiek žinomus, tiek nežinomus klientus.

Užklausos tipas Pavyzdžiui Pastaba.
Gaukite klientą naudodami CookieId {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}')
Gaukite klientą naudodami "CookieId" ir įtraukite segmentus, priemones, veiklas {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Gaukite naujausias (paskutines 10) kliento puslapių peržiūras pagal CookieId {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) Tai galima pakeisti, kad būtų pateikta iki 200 naujausių puslapių peržiūrų
Gaukite naujausius (paskutinius 10) kliento puslapio paspaudimus naudodami CookieId {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) Tai galima pakeisti, kad būtų pateikta iki 200 naujausių puslapių paspaudimų

Vieninga veikla

Lentelės UnifiedActivity užklausų pavyzdžiai.

Užklausos tipas Pavyzdžiui Pastaba.
Gaukite visą kliento veiklą {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Gaukite visą kliento veiklą per tam tikrą laikotarpį {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2017-01-01T00:00:00Z and msdynci_activitytime lt 2017-01-01T00:00:00Z
Gaukite visą veiklos veikląKliento tipas {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Gaukite visą veikląDisplayKliento vardas {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Gaukite visą kliento veiklą ir ją rūšiuokite {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Kiti pavyzdžiai

Kitų lentelių užklausų pavyzdžiai.

Užklausos tipas Pavyzdžiui Pastaba.
Gaukite visas kliento priemones {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Gaukite praturtintus kliento prekės ženklus {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Praturtinkite kliento interesus {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Gaukite kliento AI modelio rezultatus {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Paskesni veiksmai