PaaS/Cloud Service Quick-Start Guide
Start using Confection with a PaaS/cloud service in a few simple steps.
Issues? Questions? Feedback? Leave a comment. Already have a Confection account? Skip to step three. New to Confection? Learn more here.
If you haven’t already, create a Confection account. If you already have a Confection account, log in.
Click “My Account” (or “Set Up My Account” if you’re accessing your account for the first time). Enter your contact information, the domain(s) on which you want to use Confection, and select one of our two data storage options. Then, click “Save Changes.”
Click "Install Confection" (If you're accessing your account for the first time, this will be the default screen.) Next, select "PHP" to download the relevant scripts.
Click "Downloads" > "PHP" to save the necessary PHP files to your desktop. Unzip them, and upload cable.php to a PaaS or cloud service that can execute scripts (Elastic Beanstalk, Digital Ocean, Heroku, &c). (Simply uploading cable.php to a CDN that hosts static files won't work.) You'll need the link to this script later in this process.
If you're hosting cable.php at a domain or sub-domain (eg., sub.domain.com) that's different from the site on which you've installed Confection (eg., domain.com), please add this code to the top of cable.php (below <?php and above $write_key = 0;).
Use the second line to whitelist your primary domain (the domain on which you installed Confection). Just replace domain.com with your site's domain. For example, if you're hosting cable.php at subdomain.abc.com and you installed Confection at abc.com, you'd replace domain.com with abc.com
If you're installing Confection on multiple domains, comment out the second line, uncomment the fourth, and enter a comma-separated list of domains. For example, if you're hosting cable.php at subdomain.abc.com and you installed Confection at abc.com and def.com, you'd replace domain.com and xyz.net with abc.com and def.com
Next, use our code-builder tool to set your privacy options, choose your banner position, and even upload your own logo. Click the button below to get started.
Get Your Custom CodeMake sure you add your complete, secure (ie., https:// included) URL you created earlier in this step (eg., https://link.to.script.com/cable.php) to the "Cable URL" field. To avoid mixed contenet errors, make sure you load cable.php over https:// vs. http://
Once that's done, paste the code above your site's </head> tag.
Next, paste the following code anywhere between your site's <body> </body> tags.
If character or line limits prevent this, host the script yourself or add this single line instead:
<script src="https://cdn.jsdelivr.net/gh/studiohyperset/[email protected]/body.js"></script>
Lastly, if it doesn’t already, make sure the top-level domain you created earlier in this step (eg., the link.to.script.com portion of https://link.to.script.com/cable.php) appears in your account's list of authorized domains. To find this list, click "My Account" inside your Confection account.
That's it. You're done.
After installing Confection, start sending data to any number of different endpoints.
Questions or comments about using Confection with PaaS/Cloud Service? Leave them below.
You can also use the chat app in the lower right corner.