When building a "step-based" Cloud Connector, one very important point to keep in mind, is that the Cloud Connector framework is a "polling" system.  In order to act on members in a Program Builder step, your program must poll (or query) that step to find them first.

 

Let's look at the basic flow for a Cloud Connector step in Program Builder:

 

  1. Eloqua user sets up a Program Builder program that contains a Cloud Connector step.
  2. Eloqua user configures the step using theBuilding Cloud Connectors:  The Configuration Page that you provide for your connector.
  3. Eloqua user enables the program, and members begin to flow into the configured step (where they wait for processing).
  4. Your connector application Cloud Connector API - Counting the Members in a Program Step
  5. When members are found, your application then Cloud Connector API - Retrieving IDs of Members in Program Builder Step and changes their status to "Completed".
  6. When Program Builder executes, it looks for batches of members marked as "Completed" and moves them to the next step.

 

The frequency at which your application Cloud Connector API - Counting the Members in a Program Step is up to you, but we recommend every 5-10 minutes.