# Guide d'intégration

Ce guide détaillé a pour but de faciliter l'intégration des kist e-mailing au sein de notre solution.

En suivant scrupuleusement les directives ci-dessous, vous vous assurez que votre contenu sera correctement affiché et fonctionnel pour vos destinataires.

# Consignes de format et de structure

# Format de l'archive

Votre kit e-mailing être fourni sous la forme d'une archive compressée utilisant le format .zip.

# Contraintes de poids

Poids de l'archive : Le fichier .zip ne doit pas excéder 2.5 Mo.
Poids après décompression : Une fois décompressée, la taille totale des fichiers ne doit pas dépasser 5 Mo.

# Contenu de l'Archive

L'archive doit contenir à sa racine un fichier index.html contenant le code HTML de l'e-mailing.

# Gestion des images

Il est crucial que les images soient correctement organisées au sein de l'archive pour assurer leur intégration :

Toutes les images doivent être regroupées dans un dossier unique appelé /img/, qui doit se trouver directement à la racine de l'archive. Aucun sous-dossier supplémentaire dans /img/ ne doit être utilisé.

Les images situées dans un emplacement différent de ce dossier spécifié ne seront pas prises en compte lors de l'importation.

# Types de fichiers supportés

Nous acceptons uniquement certaines extensions de fichiers pour les images. Voici un tableau récapitulatif :

Extension	Description
`.html`	Uniquement pour le fichier index.html situé à la racine de l'archive
`.jpg`	Fichier JPEG
`.png`	Fichier PNG
`.gif`	Fichier GIF

Tout autre format de fichier ne sera pas pris en compte lors de l'importation.

# Lien de désinscription

Pour être en conformité avec le Règlement Général sur la Protection des Données (RGPD), il est obligatoire que votre fichier index.html inclue un lien permettant aux destinataires de se désinscrire facilement.

Utilisez le shortcode [[UNSUBSCRIBE_URL]] pour intégrer automatiquement un lien de désinscription dans vos e-mails.

Exemple

<a href="[[UNSUBSCRIBE_URL]]">Cliquer ici pour vous désinscrire</a>

# Exemple d'arborescence

Voici comment votre archive ZIP devrait être structurée :

mon-kit-emailing.zip
├── index.html
└── img
    ├── image1.jpg
    ├── image2.png
    └── image3.gif

Cette structure assure que le fichier HTML principal et toutes les images associées sont organisés de manière optimale pour l'intégration.

# Shortcodes Supportés

Votre contenu peut être personnalisé grâce à l'utilisation de shortcodes spécifiques. Voici une liste des shortcodes que nous supportons :

Shortcode	Description	Obligatoire
`[[UNSUBSCRIBE_URL]]`	URL de désinscription	Oui
`[[VIEW_IN_BROWSER_URL]]`	URL de la version en ligne de l'e-mailing	Non

# Archive Modèle

Pour vous aider dans le processus de création de votre kit, une archive modèle est disponible. Cette dernière illustre parfaitement l'organisation des fichiers et le respect des spécifications techniques requises pour une intégration sans faille.

Vous pouvez retrouver cette archive à cette adresse.