Skip to main content

Playable

Playable's gamification system allows marketers to create, tailor and deploy marketing gamification campaigns / competitions to deliver results at every touch-point. Here you can learn about the Playable integration with Voyado Engage. The integration offers the following features:

  1. Sign up Playable customers to Engage

    Once you enter a competition and sign up for it for, Playable will check if the customer already exists as a contact in Engage. If not, Playable will create them there. If the customer already exists in Engage, Playable will just update the contact with data from the competition.

  2. Enrich a customer's profile from Playable

    You can ask customers for custom attributes such as interests, favorites and so on in Playable and send this data to Engage to be saved for the contact there.

  3. Custom Trigger in Engage

    You can trigger automation flows in Engage from Playable, including with personalization, once a customer has completed a campaign / competition. An Engage custom trigger will need to be created for each one (or you can even have several triggers each one). This can be done through the Configure Engage area. The trigger IDs used needs to be communicated to Playable.

Example

If the customer does not exist in Engage, they can be created using this endpoint:

POST /api/v2/contacts

Using a payload like this:

{
  "firstName": "John",
  "email": "john.doe@voyado.com",
  "mobilePhone": "4237",
  "campaignSource": "Playable",
  "country": "Danmark",
  "source": "Playable",
  "storeExternalId": "1",
  "contactType": "Member",
  "preferences": {
    "acceptsEmail": true,
    "acceptsSms": true
  }

An update to the contacts information (enrichment) can be made to Engage like this:

POST /api/v2/contacts/{contactId}

And for an update, use this kind of payload. Note the differences in how the preferences such as acceptsEmail and acceptsSms are handled here:

{
  "firstName": "John",
  "email": "john.doe@voyado.com",
  "mobilePhone": "345",
  "acceptsEmail": true,
  "acceptsSms": true,
  "campaignSource": "Playable",
  "country": "Danmark",
  "source": "Playable",
  "storeExternalId": "1"
}

The Custom trigger ("proPlayable" in this case) used when the competition is completed for a particular contact looks like this:

POST api/v2/automation/customTriggers/proPlayable/triggerByContactId/{{contactId}}

No payload body is needed in this request.