Dataverse API-k a Customer Insights - Data lehetőséghez
Ha már használ Customer Insights - Data API-kat, például lekérdez egy ügyfélprofilt, vagy szegmens tagságot szerez be, javasoljuk, hogy inkább migrálja az API-kat API-kba Dataverse . A metaadatok lekérdezésének támogatása, például a szegmens definíció lekérése és a munkafolyamat-kezelés hamarosan elérhető lesz az API-kban Dataverse .
Ha most kezdi meg az adatok API-k használatával történő lekérdezését, javasoljuk, hogy inkább API-kat használjon Dataverse .
Fontos
Javasoljuk, hogy az API-kat csak az adatok olvasására (GET) használja Dataverse , és ne írjon adatokat (POST/PATCH/PUT), mivel ez problémákat okozhat a feldolgozás során Customer Insights - Data .
Dataverse Az API-k a következő előnyökkel rendelkeznek:
Bővített szűrési és rendezési lehetőségek
Továbbfejlesztett méretezés és teljesítmény
Konzisztens API-élmény a Dynamics 365-ben és Power Platform az alkalmazásokban
Minta lekérdezések
Az API-k használatának Dataverse megkezdéséhez hozzon létre egy alkalmazásregisztrációt az Azure-ban, és kérjen engedélyeket az alkalmazásmegjelenítőhöz Dataverse , és adjon engedélyeket hozzá Customer Insights - Data.
Módosítsa a lekérdezési mintákat, hogy működjenek a célkörnyezetekben:
{serviceRoot}:
{Organization URI}/api/data/v9.2/
ahol {a szervezeti URI} a környezethez társított bérlő URI-ja Dataverse . Például:https://{mydvorg}.crm.dynamics.com
{CID}: Egységes ügyfélrekord GUID azonosítója. Például:
ce759201f786d590bf2134bff576c369
{AlternateKey}: Egy ügyfélrekord elsődleges kulcsának azonosítója egy adatforrás. Például:
CNTID_1002
{DSname}: Sztring egy adatforrás táblanevével, amelybe Customer Insights - Data a rendszer betölti. Például:
Website_contacts
{SegmentName}: Sztring egy szegmens kimeneti táblájának nevével. Például:
Male_under_40
{CookieId}: Az egyes webhelylátogatók azonosítója. Ez automatikusan létrejön a webes nyomkövető szkript használatakor. Például:
3f43317e-d1ef-4cd3-9917-2d3342111d1a
Ügyfelünk
Mintalekérdezések a CustomerProfile táblához és szegmens tagságokhoz.
Lekérdezés típusa | Példa | Feljegyzés |
---|---|---|
Szerezzen minden ügyfelet | {serviceRoot}/msdynci_customerprofiles |
|
Ügyfél lekérése azonosító alapján | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}' |
|
Szerezzen ügyfelet másodlagos kulcs | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' |
A másodlagos kulcsok megmaradnak az egyesített vevőtáblában a következő formátumban msdynci_DSname_TableName_PrimaryKeyColumnName |
Kiválasztott attribútumok lekérése egy ügyfélhez | {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}' |
|
Ügyfelek lekérése azonosítók alapján (In) | {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}' |
|
Ügyfelek szerzése másodlagos kulcsokkal (be) | {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}' |
|
Ügyfelek keresése | {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10 |
|
Az szegmens tagjai közé tartozó összes ügyfél lekérése | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid |
|
Szerezzen ügyfelet, ha tagja egy szegmens | {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid |
|
Egy ügyfél összes szegmens tagságának lekérése | {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments |
Webes személyre szabás
Mintalekérdezések a webhely személyre szabásához a CookieId alapján. A válasz ismert és ismeretlen ügyfeleket isvisszaad.
Lekérdezés típusa | Példa | Feljegyzés |
---|---|---|
Ügyfél szerzése CookieId alapján | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}') |
|
Szerezzen ügyfelet a CookieId segítségével, és foglalja bele a szegmenseket, mértékeket és tevékenységeket | {serviceRoot}/msdynci_personalizationprofiles(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity']) |
|
Egy ügyfél legutóbbi (legutóbbi 10) oldalmegtekintéseinek lekérése a CookieId alapján | {serviceRoot}/msdynci_pageviews(cookieid='{cookieId}',top=10) |
Ez módosítható, hogy akár 200 legutóbbi oldalmegtekintést is visszaadjon |
Egy ügyfél legutóbbi (legutóbbi 10) oldalkattintásainak lekérése CookieId alapján | {serviceRoot}/msdynci_pageclicks(cookieid='{cookieId}',top=10) |
Ez módosítható úgy, hogy legfeljebb 200 legutóbbi oldalkattintást adjon vissza |
Egyesített tevékenység
Mintalekérdezések a UnifiedActivity táblához.
Lekérdezés típusa | Példa | Feljegyzés |
---|---|---|
Az ügyfél összes tevékenységének lekérése | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' |
|
Az ügyfél összes tevékenységének lekérése egy adott időszakon belül | {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 |
|
Egy tevékenység összes tevékenységének lekéréseÜgyfél típusa | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}' |
|
Az activityDisplayName összes tevékenységének lekérése | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}' |
|
Az ügyfél összes tevékenységének beolvasása és rendezése | {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc |
Más példák
Mintalekérdezések más táblákhoz.
Lekérdezés típusa | Példa | Feljegyzés |
---|---|---|
Az ügyfél összes mérésének lekérése | {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}' |
|
Szerezzen gazdagabb márkákat egy ügyféltől | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft' |
|
Az ügyfél érdeklődési körének bővítése | {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft' |
|
Egy ügyfél AI-modelleredményeinek lekérése | {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel' |
További lépések
A legtöbb Customer Insights - Data táblázat elérhető Dataverse. További információért tekintse meg a Táblázatok részt Dataverse.
Dataverse széleskörű támogatást kínál API-ik teszteléséhez, például a Postmanon keresztül. További információkért lásd: Postman-környezet beállítása.
Az Dataverse API-szolgáltatási korlátokról további információért tekintse meg az Microsoft Dataverse API-korlátok áttekintését.
Az Dataverse API-k használatával kapcsolatos további információkért lásd: Adatok lekérdezése a webes API-val.