Configuration

Ce guide détaille les options de configuration disponibles pour personnaliser l'intégration de vos campagnes.

Gestion des domaines

Ajouter un domaine

Chaque domaine où vous souhaitez intégrer vos campagnes doit être ajouté à la whitelist.

Formats acceptés :

Formats NON acceptés :

• https://monsite.com (pas de protocole)
• monsite.com/page (pas de chemin)
• *.monsite.com (pas de wildcard)

Activer/Désactiver un domaine

Vous pouvez temporairement désactiver un domaine sans le supprimer :

1. Allez dans Paramètres > Intégration Embed
2. Dans la liste des domaines, cliquez sur le menu d'actions
3. Sélectionnez Désactiver

Un domaine désactivé ne pourra plus charger vos campagnes, mais le token restera valide.

Options de l'iframe

Attributs recommandés

<iframe
  src="URL_EMBED"
  width="100%"
  height="700"
  frameborder="0"
  allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope"
  loading="lazy"
  sandbox="allow-scripts allow-same-origin allow-forms allow-popups"
  style="border: none;">
</iframe>

Détail des attributs

Permissions (allow)

Les permissions recommandées :

• accelerometer : Détection de mouvement (mobile)
• autoplay : Lecture automatique des sons
• clipboard-write : Copie de codes promo
• encrypted-media : Média DRM (optionnel)
• gyroscope : Orientation mobile (optionnel)

Sandbox (sécurité)

Le sandbox renforce la sécurité :

sandbox="allow-scripts allow-same-origin allow-forms allow-popups"

• allow-scripts : JavaScript actif (requis)
• allow-same-origin : Cookies et storage (requis)
• allow-forms : Soumission de formulaires (requis)
• allow-popups : Ouverture de liens externes (optionnel)

Dimensions responsives

Tailles recommandées

CSS responsive

.gapila-container {
  width: 100%;
  max-width: 600px;
  margin: 0 auto;
}

.gapila-iframe {
  width: 100%;
  height: 700px;
  border: none;
}

@media (max-width: 768px) {
  .gapila-iframe {
    height: 600px;
  }
}

Paramètres d'URL

L'URL d'embed accepte des paramètres supplémentaires :

https://gapila.com/embed/wheel/GAME_ID?token=TOKEN&param=value

Paramètres disponibles

Note : D'autres paramètres seront disponibles dans les futures versions (thème, langue, etc.).

Environnements

Développement local

Pour tester en local :

1. Ajoutez localhost comme domaine autorisé
2. Générez un token pour localhost
3. Testez sur http://localhost:VOTRE_PORT

Staging/Préproduction

Ajoutez votre domaine de staging séparément :

• staging.monsite.com
• preprod.monsite.com

Production

Utilisez votre domaine de production :

• monsite.com
• www.monsite.com (si différent)

Prochaines étapes

• Événements JavaScript - Intégration avancée avec JavaScript
• Sécurité - Bonnes pratiques de sécurité