Exempel på OData-fråga

Kommentar

Customer Insights - Data-tabeller kan också nås med hjälp av Dataverse API:er. Vi rekommenderar att du använder Dataverse API:er för att fråga efter Customer Insights-data eftersom de erbjuder mer omfattande filtrering, större genomflöde och lägre prestanda. Mer information finns i Dataverse API:er för Customer Insights.

Open Data Protocol (OData) är ett protokoll för dataåtkomst som bygger på kärnprotokoll som HTTP. För den används vanliga metoder som REST för webben. Det finns olika typer av bibliotek och verktyg som kan användas för att använda OData-tjänster.

För att hjälpa dig att bygga dina egna implementeringar baserat på Dynamics 365 Customer Insights - Data API:er, granska några ofta efterfrågade exempel på frågor.

Ändra frågeexempel så att de fungerar i målmiljöerna:

• {serviceRoot}: https://api.ci.ai.dynamics.com/v1/instances/{instanceId} där {instanceId} är GUID för Customer Insights - Data-miljön du vill fråga. Med åtgärden ListAllInstances kan du hitta de {InstanceId} du har åtkomst till.
• {CID}: GUID för en enhetlig kundpost. Exempel: ce759201f786d590bf2134bff576c369.
• {AlternateKey}: Identifierare för den primära nyckeln för en kundpost i en datakälla. Exempel: CNTID_1002
• {DSname}: Sträng med tabellnamnet för en datakälla som förs in i Customer Insights - Data. Exempel: Website_contacts.
• {SegmentName}: Sträng med utdatatabellnamnet för ett segment i Customer Insights - Data. Exempel: Male_under_40.

Kunder

Exempelfrågor för tabellen kund.

Frågetyp	Exempel	Kommentar
Ett kund-ID	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'
Alternativ nyckel	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} eq '{AlternateKey}'	Alternativa nycklar finns kvar i en enhetlig kundtabell
Markera	{serviceRoot}/data/Customer?$select=CustomerId,FullName&$filter=customerid eq '1'
Om	{serviceRoot}/data/Customer?$filter=CustomerId in ('{CID1}',’{CID2}’)
Alternativ nyckel + In	{serviceRoot}/data/Customer?$filter={DSname_TableName_PrimaryKeyColumnName} in ('{AlternateKey}','{AlternateKey}')
Sök	{serviceRoot}/data/Customer?$top=10&$skip=0&$search="string"	Returnerar de tio översta resultaten för en söksträng
Segmentmedlemskap	{serviceRoot}/data/Customer?select=*&$filter=IsMemberOfSegment('{SegmentName}')&$top=10	Returnerar ett antal rader från segmenteringstabellen.
Segmentmedlemskap för en kund	{serviceRoot}/data/Customer?$filter=CustomerId eq '{CID}'&IsMemberOfSegment('{SegmentName}')	Returnerar kundprofilen om de är medlemmar i det angivna avsnittet

Enhetlig aktivitet

Exempelfrågor för tabellen UnifiedActivity:

Frågetyp	Exempel	Kommentar
Aktivitet för CID	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}'	Visar aktiviteter för en specifik kundprofil
Aktivitet för tidsram	{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	Aktiviteter i en kundprofil i en tidsram
Aktivitetstyp	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq '{CID}' and ActivityType eq '{ActivityName}'
Aktivitet efter visningsnamn	{serviceRoot}/data/UnifiedActivity$filter=CustomerId eq ‘{CID}’ and ActivityTypeDisplay eq ‘{ActivityDisplayName}’
Aktivitetssortering	{serviceRoot}/data/UnifiedActivity?$filter=CustomerId eq ‘{CID}’ & $orderby=ActivityTime asc	Sortera aktiviteter i stigande eller fallande
Alla aktiviteter och åtgärder för en kund	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId eq '{CID}'	Aktiviteter och mått är ytterligare nyckel-/värdepar i den returnerade kundprofilen

Hantera arbetsflöden

Exempelfrågor som är relaterade till processer i Customer Insights - Data, t.ex. att uppdatera en datakälla, sammanföra data eller få status för ett föreningsjobb.

Frågetyp	Exempel	Kommentar
Hämta ID för datakälla	{serviceRoot}/manage/datasources/v2	Returnerar alla datakällor i miljön. I svaret kan du kontrollera "friendlyName" för en specifik datakälla och sedan använda dess "dataSourceId".
Uppdatera en datakälla	{serviceRoot}/manage/workflows/main/jobs?operationType=Ingestion&identifiers='{dataSourceId}'&forceRunRequested=true	Använd dataSourceId från svaret ovan för att uppdatera en datakälla. Det här är en POST-begäran.
Kör en fullständig uppdatering	{serviceRoot}/manage/workflows/main/jobs?operationType=all&forceRunRequested=true	Uppdaterar alla processer i din miljön. Det här är en POST-begäran.
Hämta status för processer	{serviceRoot}/manage/workflows/main/jobs

Andra exempel

Exempelfrågor för andra tabeller.

Frågetyp	Exempel	Kommentar
Mått för CID	{serviceRoot}/data/Customer_Measure?$filter=CustomerId eq '{CID}'
Berikade varumärken av CID	{serviceRoot}/data/BrandShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
Berikade intressen för CID	{serviceRoot}/data/InterestShareOfVoiceFromMicrosoft?$filter=CustomerId eq '{CID}'
I sats + Expandera	{serviceRoot}/data/Customer?$expand=UnifiedActivity,Customer_Measure&$filter=CustomerId in ('{CID}', '{CID}')

Begränsningar

• API för Customer Insights returnerar maximalt 100 objekt som standard. Du kan analysera fler än de 100 returnerade objekten med hjälp av standardtekniker för sidväxling. Du kan också exportera dina data.

• Följande frågor stöds inte:

  • $filter på införlivade källtabeller. Du kan endast köra $filter-frågor på systemtabeller som Customer Insights - Data skapar.
  • $expand från en $search fråga. Exempel: Customer?$expand=UnifiedActivity$top=10&$skip=0&$search="corey".
  • $expand från $select om endast en deluppsättning attribut har markerats. Exempel: Customer?$select=CustomerId,FullName&$expand=UnifiedActivity&$filter=CustomerId eq '{CID}'.
  • $expand förädlat varumärke eller intresse för en viss kund. Exempel: Customer?$expand=BrandShareOfVoiceFromMicrosoft&$filter=CustomerId eq '518291faaa12f6d853c417835d40eb10'.
  • Ställ fråga till utdatatabeller för prediktionsmodell via alternativ nyckel. Exempel: OOBModelOutputTable?$filter=HotelCustomerID eq '{AK}'.