The client side use cases are varied and very specific to the channel and client application.  As such (as indicated by your line of questions) Pega provides an interface to activate it and not the client application implementation.  The channel client application is meant to call that interface (the Pega end-point) with enough data payload to allow the system to best service the request.  

For example, you might have a system already in place that knows that you are running low on funds (for example, a comms customer running out of data), so the system that knows this will call the event API with details that indicate this is a "RunningOutOfData" event, the customer ID and send to Pega.  The Pega system will be setup to listen to this marketable event and call NBA, which will in turn figure out what is best to do for this customer and this event context. This is an example of there being a system that has already 'detected' an event and is just passing it on to Pega as a potential marketable event to process as an NBA.  

Another example is where systems of record don't really know that an event has occurred, but have raw data that might indicate a marketable event is appropriate.  For example, a financial institution might be interested in addressing a downward trend in credit card transactions.  In this case, the financial institution would have the raw transactional data, but not a clear signal of a downward trend.  In this example, Pega offers a capability (Event Strategy Manager) to stream the raw data to Pega, group the data into an average spend over 1 month period and compare it to the spend in the prior month.  Only if the spend in this month is significantly below the last month, then forward it to the Marketing product as a Marketable event.  

In both the cases the marketable event is activated by calling the event API.  In older versions of Pega Marketing that API was implemented via the SOAP protocol.  In more recent versions (8.2+ I believe), the SOAP api has been deprecated in favor of a Kafka based API that is implemented with the REST protocol.  This was done to support much higher throughput/scale processing.  Depending on the version of the product, please ensure you use the appropriate protocol end-point.

Hope this helps and good luck.

The client side use cases are varied and very specific to the channel and client application.  As such (as indicated by your line of questions) Pega provides an interface to activate it and not the client application implementation.  The channel client application is meant to call that interface (the Pega end-point) with enough data payload to allow the system to best service the request.  

For example, you might have a system already in place that knows that you are running low on funds (for example, a comms customer running out of data), so the system that knows this will call the event API with details that indicate this is a "RunningOutOfData" event, the customer ID and send to Pega.  The Pega system will be setup to listen to this marketable event and call NBA, which will in turn figure out what is best to do for this customer and this event context. This is an example of there being a system that has already 'detected' an event and is just passing it on to Pega as a potential marketable event to process as an NBA.  

Another example is where systems of record don't really know that an event has occurred, but have raw data that might indicate a marketable event is appropriate.  For example, a financial institution might be interested in addressing a downward trend in credit card transactions.  In this case, the financial institution would have the raw transactional data, but not a clear signal of a downward trend.  In this example, Pega offers a capability (Event Strategy Manager) to stream the raw data to Pega, group the data into an average spend over 1 month period and compare it to the spend in the prior month.  Only if the spend in this month is significantly below the last month, then forward it to the Marketing product as a Marketable event.  

In both the cases the marketable event is activated by calling the event API.  In older versions of Pega Marketing that API was implemented via the SOAP protocol.  In more recent versions (8.2+ I believe), the SOAP api has been deprecated in favor of a Kafka based API that is implemented with the REST protocol.  This was done to support much higher throughput/scale processing.  Depending on the version of the product, please ensure you use the appropriate protocol end-point.

Hope this helps and good luck.