Integrating PuzzleMe
Overview
Objectives
- Understand the various options available for integrating PuzzleMe™ puzzles into your websites and apps
Methods of embedding
Puzzles can be embedded on your website using these methods:
- iframes
- JavaScript (JS) Code
The following articles cover related points essential to the embedding process:
- Custom parameters - This article explores URL parameters you can use to easily customize your implementation.
- iFrame size - This article covers best practices for sizing the puzzle iframe.
Choosing your implementation
If you are using iframe embed, several important features of PuzzleMe would require custom implementation done by your engineering team. The JS embed implements most of these features out of the box, reducing engineering effort at your end and helping you launch faster.
| Feature | iframe embed | JS embed | Work required for custom integration |
|---|---|---|---|
| Share direct links to puzzles and puzzle scores | ✗ | ✓ | Check full URL of puzzle page on each load, identify id/ set parameters and pass them to puzzle iframe |
| One click, link based social play | ✗ | ✓ | Check full URL of puzzle page on each load, identify id, set and playId parameters and pass them to puzzle iframe |
| Save puzzle progress robustly | ✗ | ✓ | Place a first party cookie on user's browser, anonymize it and pass it to the puzzle iframe |
For most use cases, we could recommend using a JS embed code based implementation.