Recuperar las interacciones de marketing saliente para un contacto mediante código

  • Artículo

Nota

Dynamics 365 Marketing y Dynamics 365 Customer Insights son ahora Customer Insights - Journeys y Customer Insights - Data. Para obtener más información, consulte Preguntas frecuentes de Dynamics 365 Customer Insights

Los nuevos clientes de Customer Insights - Journeys solo reciben características de recorridos en tiempo real. Para obtener más información, consulte Instalación de recorridos en tiempo real predeterminada.

Importante

Este artículo solo se aplica a marketing saliente.

Importante

El siguiente método para recuperar interacciones ha quedado en desuso y es posible que no esté disponible en el futuro.

Para recuperar datos de interacción, el método recomendado actual es configurar Azure Blob Storage y conectarlo a la aplicación Dynamics 365 Customer Insights - Journeys. Más información: Prepararse para los informes analíticos con Power BI

Utilice la acción msdyncrm_LoadInteractionsPublic para recuperar mediante programación las interacciones de un contacto. Esta acción es útil para responder a solicitudes para obtener mis datos para cumplir con varias leyes y regulaciones de privacidad.

Propina

También generar clases de solicitud y respuesta para esta acción para incluirlas en el código de aplicación. Más información: Generar tipos de enlace en tiempo de compilación para una acción.

Parámetros de la acción

La acción msdyncrm_LoadInteractionsPublic espera los siguientes parámetros de entrada:

Nombre Tipo Descripción
ContactId Edm.String Id. del registro de contacto del que se van a recuperar las interacciones. Obligatorio.
DateFrom Edm.String Fecha de inicio con formato MM-DD-AAAA a partir de la cual desea recuperar las interacciones. Opcional.
DateTo Edm.String Fecha de finalización con formato MM-DD-AAAA hasta la cual desea recuperar las interacciones. Opcional.
InteractionType Edm.String Tipo de interacción que se va a recuperar. Obligatorio.
Puede especificar uno de los siguientes valores:
  • ActivityContactBlocked
  • ActivityContactDispatched
  • ActivityContactProcessingFailed
  • CreateCrmActivityContactProcessed
  • CreateCustomChannelActivityContactProcessed
  • CustomChannelResponse
  • CustomerJourneyContactRecordUpdated
  • EmailBlockBounced
  • EmailBlocked
  • EmailClicked
  • EmailContainsBlockListedLinks
  • EmailDelivered
  • EmailFeedbackLoop
  • EmailForwarded
  • EmailHardBounced
  • EmailOpened
  • EmailSendingFailed
  • EmailSent
  • EmailSoftBounced
  • EmailSubscriptionSubmit
  • EventCheckIn
  • EventRegistration
  • FormSubmitted
  • FormVisited
  • InvalidRecipientAddress
  • InvalidSenderAddress
  • LeadScoreBoost
  • OutOfEmailCredits
  • PassThroughActivityContactProcessed
  • RedirectLinkClicked
  • SchedulerActivityContactProcessed
  • SegmentRelationshipEdited
  • SegmentSubscribed
  • SegmentUnsubscribed
  • SplitterActivityContactProcessed
  • SurveyResponse
  • TriggerActivityContactProcessed
  • TriggerCrmWorkflowActivityContactProcessed
  • WebsiteClicked
  • WebsiteVisited
Top Edm.Int32 Opcional. Entero no negativo que limita el número de interacciones devueltas para un registro de contacto. Opcional.
SkipToken Edm.String Identifica un punto de partida en la colección de interacciones devueltas para un registro de contacto. Opcional.

Tipo devuelto por la acción

La acción msdyncrm_LoadInteractionsPublic devuelve el siguiente valor:

Nombre Tipo Descripción
msdyncrm_LoadInteractionsPublicResponse ComplexType Contiene la respuesta de la acción msdyncrm_LoadInteractionsPublic. Contiene las siguientes propiedades que contienen los datos estructurados del tipo:
Nombre Tipo Descripción
Data Edm.String Lista de interacciones como una matriz JSON con secuencias de escape.
NextSkipToken Edm.String Identifica el siguiente cursor o marcador en la colección de interacciones devueltas para un registro de contacto.

Ejemplo

Solicitud

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",
}

Respuesta

La respuesta contiene un objeto JSON con una propiedad Data que contiene la lista de interacciones completa.

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
}