Megosztás a következőn keresztül:

Dataverse API-k a Customer Insights - Data lehetőséghez

  • Cikk

Ha már használ Customer Insights - Data API-kat, például lekérdez egy ügyfélprofilt vagy szegmenstagsá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 szegmensdefiní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}: Az adatforrás ügyfélrekordja elsődleges kulcsának azonosítója. Például: CNTID_1002

  • {DSname}: Sztring egy olyan adatforrás táblanevével, amelybe Customer Insights - Data a rendszer betölti. Például: Website_contacts

  • {SegmentName}: Karakterlánc egy szegmens kimeneti táblájának nevével. Például: Male_under_40

  • {CookieId}: Az egyes webhelylátogatók azonosítója, amely automatikusan létrejön a webes nyomkövető szkript használatakor. Például: 3f43317e-d1ef-4cd3-9917-2d3342111d1a

Customer

Mintalekérdezések a CustomerProfile tábla- és szegmenstagsá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}'
Ügyfél lekérése másodlagos kulccsal {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
A szegmens összes tagjának lekérése {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Szerezzen ügyfelet, ha tagja egy szegmensnek {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Egy ügyfél összes szegmenstagsá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. A webes nyomon követéshez és személyre szabáshoz létrehozott táblázatok a következő nyelveken Dataverse érhetők el:

Lekérdezés típusa Példa Feljegyzés
Ügyfél szerzése CookieId alapján {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Szerezzen ügyfelet a CookieId segítségével, és foglalja bele a szegmenseket, mértékeket és tevékenységeket {serviceRoot}/msdynci_p13nprofile(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_p13nviews(cookieid='{cookieId}',top=10) Ez a lekérdezés módosítható úgy, hogy legfeljebb 200 legutóbbi oldalmegtekintést adjon vissza
Egy ügyfél legutóbbi (legutóbbi 10) oldalkattintásainak lekérése CookieId alapján {serviceRoot}/msdynci_p13nactions(cookieid='{cookieId}',top=10) Ez a lekérdezés módosítható úgy, hogy legfeljebb 200 legutóbbi oldalkattintást adjon vissza
Az ügyfél összes tevékenységének lekérése {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Az ügyfél összes tevékenységének lekérése egy adott időszakon belül {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytime gt 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-01T00:00:00Z
Egy tevékenység összes tevékenységének lekéréseÜgyfél típusa {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Az activityDisplayName összes tevékenységének lekérése {serviceRoot}/msdynci_p13nprofile?$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_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Egyesített tevékenység

Mintalekérdezések a UnifiedActivity táblához, ha a webes személyre szabás nincs használatban.

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 2024-01-01T00:00:00Z and msdynci_activitytime lt 2024-06-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