Bendrinti naudojant

Kontakto sąveikų gavimas naudojant kodą

  • Straipsnis

Pastaba.

2023 m. rugsėjo 1 d. „Dynamics 365 Marketing“ ir „Dynamics 365 Customer Insights“ bus parduodami kartu kaip vieno produkto SKU pavadinimu „Dynamics 365 Customer Insights“. Atskiros programos bus atitinkamai pervardytos į „Dynamics 365 Customer Insights – veiklos ciklai“ ir „Dynamics 365 Customer Insights – duomenys“. Išsamesnės informacijos žr. DUK apie „Dynamics 365 Customer Insights“

Be to, 2023 m. rugsėjo 1 d. nauji „Dynamics 365 Marketing“ klientai gaus tik rinkodaros realiuoju laiku funkcijas. Norėdami gauti daugiau informacijos, žr. Numatytosios rinkodaros realiuoju laiku diegimas. Daugelis instrukcijų puslapių šiuo metu nurodo į siunčiamas funkcijas, kurios gali būti neprieinamos arba veikti kitaip nei rinkodara realiuoju laiku. Instrukcijų turinys bus atnaujintas rugsėjo mėnesį, siekiant pažymėti, ar jis taikomas realiojo laiko, ar tradicinei rinkodarai.

Svarbu

Toliau pateiktas sąveikos gavimo metodas nebenaudojamas ir ateityje gali būti nepasiekiamas.

Norint gauti sąveikos duomenis, dabartinis rekomenduojamas būdas yra nustatyti "Azure" didelių dvejetainių objektų saugyklą ir prijungti ją prie Dynamics 365 Customer Insights "- Journeys" programos. Sužinokite daugiau: Pasiruoškite analitinėms ataskaitoms naudodami Power BI

Naudokite veiksmą msdyncrm_LoadInteractionsPublic , kad programiškai gautumėte kontakto sąveikas. Šis veiksmas naudingas atsakant į užklausas gauti mano duomenis , kad būtų laikomasi įvairių privatumo įstatymų ir taisyklių.

Arbatpinigiai

Šiam veiksmui taip pat galite generuoti užklausų ir atsakymų klases, ir jas įtraukti į programos kodą. Daugiau informacijos: Ankstyvųjų veiksmo susietųjų tipų generavimas

Veiksmo parametrai

Veiksmas msdyncrm_LoadInteractionsPublic tikisi šių įvesties parametrų:

Pavadinimą Tipas Aprašą
ContactId Edm.String Kontakto įrašo ID, kad būtų galima gauti sąveikas. Būtina.
DateFrom Edm.String Pradžios data MM-DD-YYYY formatu, iš kurio norite gauti sąveikas. Pasirenkama.
DateTo Edm.String Pabaigos data MM-DD-YYYY formatu, iki kurios norite gauti sąveikas. Pasirenkama.
InteractionType Edm.String Sąveikos, kurią reikia gauti, tipas. Būtina.
Galite nurodyti vieną iš šių reikšmių:
  • VeiklaKontaktasUžblokuotas
  • ActivityContactDispatched
  • ActivityContactProcessingFailed
  • CreateCrmActivityContactProcessed
  • CreateCustomChannelActivityContactProcessed
  • CustomChannelResponse
  • CustomerJourneyContactRecordUpdated
  • EmailBlockBounced
  • El. paštasužblokuotas
  • EmailClicked
  • EmailContainsBlockListedLinks
  • El. paštasPristatytas
  • EmailFeedbackLoop
  • El. paštasPersiųstas
  • EmailHardBounced
  • EmailOpened
  • EmailSendingFailed
  • El. paštasIšsiųstas
  • El. paštasSoftBounced
  • EmailSubscriptionSubmit
  • EventCheckIn
  • EventRegistration
  • FormSubmitted
  • FormVisited
  • InvalidRecipientAddress
  • InvalidSenderAddress
  • "LeadScoreBoost"
  • OutOfEmailCredits
  • PassThroughActivityContactProcessed
  • RedirectLinkClicked
  • SchedulerActivityContactProcessed
  • SegmentasRelationshipEdited
  • SegmentSubscribed
  • SegmentUnsubscribed
  • SplitterActivityContactProcessed
  • Apklausos atsakymas
  • TriggerActivityContactProcessed
  • TriggerCrmWorkflowActivityContactProcessed
  • SvetainėClicked
  • WebsiteVisited
Top Edm.Int32 Pasirenkama. Negatyvus sveikasis skaičius, ribojantis sąveikų, pateiktų kontakto įrašui, skaičių. Pasirenkama.
SkipToken Edm.String Nurodo kontakto įrašui grąžintų sąveikų rinkinio pradžios tašką. Pasirenkama.

Veimso grąžinimo tipas

Veiksmas msdyncrm_LoadInteractionsPublic pateikia šią reikšmę:

Pavadinimą Tipas Aprašą
msdyncrm_LoadInteractionsPublicResponse Komplekso tipas Pateikiamas msdyncrm_LoadInteractionsPublic veiksmo atsakas. Jame yra šios ypatybės, kuriose yra struktūriniai tipo duomenys:
Pavadinimą Tipas Aprašą
Data Edm.String Sąveikų sąrašas kaip pabėgęs JSON masyvas.
NextSkipToken Edm.String Identifikuoja kitą žymeklį arba žymelę sąveikų, grąžintų kontakto įrašui, rinkinyje.

Pavyzdžiui

Užklausa

POST [Organization URI]/api/data/v9.0/msdyncrm_LoadInteractionsPublic HTTP/1.1
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
  
{
    "InteractionType": "WebsiteClicked",
    "ContactId": "0dbe0fa3-8e18-e811-a951-000d3a37caec",
}

Response

Atsakyme yra JSON objektas su Data savybe, kurioje yra visas sąveikų sąrašas.

HTTP/1.1 200 OK  
Content-Type: application/json; odata.metadata=minimal  
OData-Version: 4.0

{
    "@odata.context":"[Organization URI]/api/data/v9.0/$metadata#Microsoft.Dynamics.CRM.msdyncrm_LoadInteractionsPublicResponse",
    "Data":"[{\"InteractionId\":\"172C1E59A3CD4D85B392316DD76651CE\",\"InteractionType\":\"EmailSent\",\"Timestamp\":\"2018-02-23T13:10:48Z\",\"OrganizationId\":\"e47e99c2-20e3-4ef3-bbd4-288258bd6bf9\",\"EmailDomain\":\"microsoft.com\",\"ActivityId\":\"b6aeb700-f1c1-4cb1-e8f8-e883eac6bfbc\",\"SendingId\":\"5a019802-f763-3b72-fc91-0a9c95b67c5f\",\"ContactId\":\"0dbe0fa3-8e18-e811-a951-000d3a37caec\",\"MessageId\":\"5a2f3e76-9518-e811-a951-000d3a38caec\",\"CustomerJourneyId\":\"4c3846a1-9618-e811-a951-000d3a37cafc\",\"CustomerJourneyIterationId\":\"538825cf-fe1c-4fee-a671-7984eabb62eb\",\"UsageType\":\"CustomerJourney\",\"EmailAddressUsed\":\"sample@adventure-works.com\"}]",
    "NextSkipToken":null
}