A Cloud Component Provider must expose a series of endpoints that the Eloqua Cloud Components framework calls out to.  One of these endpoints is called "createInstance".

 

The createInstance endpoint is what handles the creation and registration of the component in the external or "cloud" system, and links it with the Eloqua Landing Page that it resides on. 

 

Here is an example of what a createInstance endpoint in the Provider could look like:

 

https://mycompany.com/ccpservice/components/create/{Id}

 

This endpoint will be called with a POST method.

 

Now, Let's look at how this is used by the Cloud Component framework.

 

CCPframework-createInstance (1).png

 

When a marketer drags a Cloud Component onto a Landing Page through the editor in Eloqua, the createInstance endpoint is called with a POST method.  When the endpoint is called, a GUID is passed though the parameter “{Id}” along with the call.  The provider must be able to accept this parameter, and use it to register the component in their system. This GUID will then be passed when calling other Provider endpoints, as a means of identifying the component to operate on.

 

The component has been created, now we need to configure it.