Setting Up ACME Drinks

Home > Getting Started > Setting Up ACME Drinks

Setting Up ACME Drinks

ACME Drinks is the demonstration site for Join the clicks. Your agency account has a new client called ACME Drinks configured by default.

Download the ACME Drink site.

PHP version [zip]

Developer Manual

The Developer Manual is a supplement to the ACME Drinks site.
It details how the Join the Clicks API methods have been implemented in the site.
Download the manual [PDF]

Configuring ACME Drinks.

To get ACME Drinks up and running in your environment takes a couple of minutes. The steps required are:

1. Retrieve API keys and modify email links

2. Set up a webservice user

3. Edit the ACME Drinks config files

API keys and emails

The API keys are used to authenticate your site's calls to Join the Clicks.

Login in to the Join the Clicks Web Console. The agency screen will be displayed.

1.Click on the Starter Kit Campaign. This will direct you to the campaign screen for Starter Kit

2. Download the API KEYs for this campaign. These will be inserted a bit later into ACME Drinks config file to ensure the site references your campaign.

3. Click on the Configure button for the Starter Kit Registration Activity . This will launch the Consumer Activity Wizard. You will be configuring the emails sent to consumers during the registration process.

4. Select Next for the next 5 screens until you arrive at the Activate Account email

5. Insert the URL that points to your location for acme drinks. The JTCActivationCode is used to verify consumers. The URL format is http://[your location for acme drinks]/verify.php?key=%%JTCActivationCode%%

6. Switch to HTML mode and change the Href for the verify link to http://[your location for acme drinks]/verify.php?key=%%JTCActivationCode%%. This step configures the activation email when consumers first register

7. Step through all the remaining options to complete and save the changes. This will bring you back to the Campaign screen.

Subscription IDs

The Subscription IDs are used to identify the opt-in lists used in Acme Drinks

1. Click the consumer tab

2. Click Subscriptions

The Subscription IDs are displayed in the grid.

Create a web service user

1. Click the manage account tab

2. Select Agency & Users

3. Click New Agency User

4. Create a new user of the role Webservice. Keep a note of the username and password as this will be used when making the API calls.

Edit ACME Drinks config files (PHP)

Insert the API module keys and subscriptionIDs into the config.php file to link the site to your Starter Kit campaign.

<?php
  @define(API_REGISTRATION,	     "7e11483c-b40c-452c-ad65-4f32f9cf03a6");
  @define(API_HOMEPAGE_SUBSCRIPTION, "1fc33d6d-8a19-42a6-9fc9-f1711ad2d892");
  @define(API_COMPETITION_ENTRY,     "8800db9b-9ab1-43a4-8761-9b8bfa9a086e");
  @define(API_ACME_DRINKS_FLASH_GAME,"159aca15-507c-473e-82fe-096407ebcfdb");
  @define(API_COMPETITION,           "72e85b69-54fa-4c9d-95b9-7828b064ac65");


  @define(SESSION_NAME, "Fizz");
  
  # The Username Used To Authenticate To The WebService
  @define(WEBSERVICE_API_USERNAME, "WEBSERVICE USERNAME");

  # The Password Used To Authenticate To The WebService
  @define(WEBSERVICE_API_PASSWORD, "WEBSERVICE PASSWORD");

  # Subscription IDs for lists
  @define(SUBSCRIPTION_ID_FIZZ_WEEKLY, 102);

Edit the config.xml file used by the flash game.

<?xml version="1.0" standalone="yes" ?>
<params>
<param name="HIGH_SCORE_URL" value="http://[yourURL]/scores.xml" />
<param name="SUBMIT_SCORE_URL" value="http://[yourURL]/game_03.php" />
<param name="LOGIN_URL" value="http://[yourURL]/checklogin.php" />
<param name="COOKIE_URL" value="http://[yourURL]/checklogin.php" />
<param name="REGISTER_URL" value="http://[yourURL]/register.php" />
<param name="PASSWORD_URL" value="http://[yourURL]/reset.php" />
</params>

Join the Clicks