Zdieľať cez

Rozhrania API platformy Dataverse pre Customer Insights - Data

  • Článok

Ak už používate Customer Insights - Data rozhrania API, ako je napríklad dopyt na profil zákazníka alebo získanie členstiev v segmentoch, odporúčame vám namiesto toho migrovať rozhrania API na Dataverse rozhrania API. Podpora pre dopytovanie metadát, ako je napríklad získanie definície segmentu a správa pracovného toku, bude čoskoro k dispozícii v Dataverse API.

Ak začínate s dopytovaním údajov pomocou rozhraní API, odporúčame namiesto toho použiť Dataverse rozhrania API.

Dôležité

Odporúča sa používať Dataverse API iba na čítanie údajov (GET) a nie na zapisovanie údajov (POST/PATCH/PUT), pretože to môže spôsobiť problémy so spracovaním Customer Insights - Data .

Dataverse Rozhrania API majú nasledujúce výhody:

  • Rozšírené možnosti filtrovania a triedenia

  • Vylepšená mierka a výkon

  • Konzistentné rozhranie API v rámci Dynamics 365 a Power Platform aplikácií

Vzorové otázky

Ak chcete začať používať Dataverse API, vytvorte registráciu aplikácie v Azure a požiadajte o povolenia pre Dataverse a udeľte svojej aplikácii povolenia na zobrazovanie na Customer Insights - Data.

Upravte vzorky dotazov, aby fungovali v cieľových prostrediach:

  • {serviceRoot}: {Organization URI}/api/data/v9.2/ kde {URI organizácie} je URI Dataverse nájomníka spojeného s vaším prostredím. Napríklad: https://{mydvorg}.crm.dynamics.com

  • {CID}: GUID jednotného zákazníckeho záznamu. Napríklad: ce759201f786d590bf2134bff576c369.

  • {AlternateKey}: Identifikátor primárneho kľúča záznamu zákazníka v zdroji údajov. Napríklad: CNTID_1002.

  • {DSname}: Reťazec s názvom tabuľky zdroja údajov, ktorý sa prijíma do Customer Insights - Data. Napríklad: Website_contacts.

  • {SegmentName}: Reťazec s názvom výstupnej tabuľky segmentu. Napríklad: Male_under_40.

  • {CookieId}: Identifikátor pre každého návštevníka webu, ktorý sa automaticky generuje pri použití skriptu sledovania webu. Napríklad: 3f43317e-d1ef-4cd3-9917-2d3342111d1a.

Customer

Vzorové dopyty pre CustomerProfile tabuľku a členstvo v segmentoch.

Typ dotazu Príklad Poznámka
Získajte všetkých zákazníkov {serviceRoot}/msdynci_customerprofiles
Získajte zákazníka podľa ID {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID}'
Získajte zákazníka pomocou alternatívneho kľúča {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK}' Alternatívne kľúče zostávajú v zjednotenej tabuľke zákazníkov vo formáte msdynci_DSname_TableName_PrimaryKeyColumnName
Získajte vybrané atribúty pre zákazníka {serviceRoot}/msdynci_customerprofiles?$select=msdynci_fullname&$filter=msdynci_customerid eq '{CID}'
Získajte zákazníkov podľa ID (In) {serviceRoot}/msdynci_customerprofiles?$filter=msdynci_customerid eq '{CID1}' or msdynci_customerid eq '{CID2}'
Získajte zákazníkov pomocou alternatívnych kľúčov (in) {serviceRoot}/msdynci_customerprofiles?$filter={msdynci_alternate_column} eq '{AK1}' or {msdynci_alternate_column} eq '{AK2}'
Vyhľadávanie zákazníkov {serviceRoot}/msdynci_customerprofiles?$filter=contains(msdynci_lastname,'string')&$top=10
Získajte všetkých zákazníkov, ktorí sú členmi segmentu {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"')&$select=msdynci_customerid
Získajte zákazníka, ak je členom segmentu {serviceRoot}/msdynci_segmentmemberships?$filter=contains(msdynci_segments,'\"{SegmentName}\"') and msdynci_customerid eq '{CID}'&$select=msdynci_customerid
Získajte všetky segmentové členstvá zákazníka {serviceRoot}/msdynci_segmentmemberships?$filter=msdynci_customerid eq '{CID}'&$select=msdynci_segments

Prispôsobenie webu

Vzorové dopyty na prispôsobenie vášho webu na základe CookieId. Odpoveď vráti známych aj neznámych zákazníkov. Tabuľky vytvorené na sledovanie a prispôsobenie webu sú dostupné v Dataverse.

Typ dotazu Príklad Poznámka
Získajte zákazníka pomocou CookieId {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}')
Získajte zákazníka pomocou CookieId a zahrňte segmenty, opatrenia, aktivity {serviceRoot}/msdynci_p13nprofile(cookieid='{cookieId}',include=['segmentmembership','measures','unifiedactivity'])
Získajte posledné (posledných 10) zobrazení stránky zákazníka pomocou CookieId {serviceRoot}/msdynci_p13nviews(cookieid='{cookieId}',top=10) Tento dopyt je možné zmeniť tak, aby vrátil až 200 nedávnych zobrazení stránky
Získajte posledné (posledných 10) kliknutí na stránku zákazníka pomocou CookieId {serviceRoot}/msdynci_p13nactions(cookieid='{cookieId}',top=10) Tento dopyt je možné zmeniť tak, aby vrátil až 200 nedávnych kliknutí na stránku
Získajte všetky aktivity zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'
Získajte všetky aktivity zákazníka v časovom období {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
Získajte všetky aktivity typu aktivity zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Získajte všetky aktivity aktivityZobrazené meno zákazníka {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Získajte všetky aktivity zákazníka a zoraďte ich {serviceRoot}/msdynci_p13nprofile?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Jednotná činnosť

Vzorové dopyty pre tabuľku UnifiedActivity , ak sa nepoužíva prispôsobenie webu.

Typ dotazu Príklad Poznámka
Získajte všetky aktivity zákazníka {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'
Získajte všetky aktivity zákazníka v časovom období {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
Získajte všetky aktivity typu aktivity zákazníka {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytype eq '{ActivityType}'
Získajte všetky aktivity aktivityZobrazené meno zákazníka {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}' and msdynci_activitytypedisplay eq '{ActivityDisplayName}'
Získajte všetky aktivity zákazníka a zoraďte ich {serviceRoot}/msdynci_unifiedactivities?$filter=msdynci_customerid eq '{CID}'&$orderby=msdynci_activitytime asc

Ďalšie príklady

Vzorové dopyty pre iné tabuľky.

Typ dotazu Príklad Poznámka
Získajte všetky opatrenia zákazníka {serviceRoot}/msdynci_customermeasures?$filter=msdynci_customerid eq '{CID}'
Získajte obohatené značky zákazníka {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'BrandShareOfVoiceFromMicrosoft'
Získajte obohatené záujmy zákazníka {serviceRoot}/msdynci_enrichments?$filter=msdynci_customerid eq '{CID}' and msdynci_enrichmentprovider eq 'InterestShareOfVoiceFromMicrosoft'
Získajte výsledky modelu AI zákazníka {serviceRoot}/msdynci_predictions?$filter=msdynci_customerid eq '{CID}' and msdynci_modelprovider eq 'ChurnModel'

Ďalšie kroky