Server or PaaS/Cloud Service Quick-Start Guide
Start using Confection with a server or 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.
Inside your Confection account, click "Install Confection" > "Downloads." Then, click the "PHP" tile to save the necessary files to your desktop. Unzip them, and upload cable.php to a server or PaaS/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.
At this point you have two options. If neither applies to you, skip ahead to the "Get Your Custom Code" step.
"I'm hosting cable.php and my site on different domains. (Or I'm using cable.php on several different domains.)"
If you're hosting cable.php on the same domain as your website (eg., domain.com/cable.php and domain.com), there's no need to worry about this information. Skip ahead to the next step.
If you're hosting cable.php at a domain or sub-domain that's different from your website (eg., sub.domain.com/cable.php and anotherdomain.com), please add this code to the top of cable.php. Put it 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 sub.domain.com and you installed Confection at anotherdomain.com, you'd replace domain.com with anotherdomain.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 sub.domain.com and you installed Confection at anotherdomain.com and yetanotherdomain.com, you'd replace domain.com and xyz.net with anotherdomain.com and yetanotherdomain.com
"I want (or need) to ensure only my sites can write data to my Confection account."
For most users, Confection's standard security protocols are sufficient. However, advanced users, sites that handle sensitive information, and compliance-driven organizations may want to harden their Confection accounts against unauthorized data ingestion. If this doesn't apply to you, skip ahead to the next step.
If it does, we offer each account the option to use an API write key. This write key will ensure no domain you haven't added to your dashboard can write data to your Confection account.
To activate your write key, visit the API key section of your dashboard. Click "Generate" to generate your key, and copy it. Find $write_key = 0; in cable.php. (It's at the top.) Then, replace 0 with your actual key.
Please note, once you activate your account's write key, the current key must appear in your cable.php file. There's no going back. Going forward, Confection will not be able to add data to your account unless your current key appears in your cable.php file.
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 content 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. Copy this script, save it as a JS file (eg., confection.js), and upload it to a server you control. Then, add this above your site’s </body> tag:
<script src="https://domain.com/confection.js"></script>
Just replace https://domain.com/confection.js with the link to the file you just uploaded.
Lastly, if it doesn't already, make sure the top-level domain you're using to host your cable.php file -- the domain.com part of domain.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 Server or PaaS/Cloud Service? Leave them below.
You can also use the chat app in the lower right corner.