Intégrer Cashew sur votre site

Trois lignes de code. L'encart s'affiche pendant vos temps de chargement, disparaît ensuite, et vous reverse votre part des revenus. Comptez 10 minutes, réversible à tout moment.

1 · Le principe

Étape ACollez la balise script une fois dans votre page (avant </body>) :

<script src="https://cash-ew.com/sdk/v1.js" data-site-key="pk_site_VOTRE_CLE"></script>

Étape BEncadrez votre traitement avec show() / hide() :

Cashew.show();   // le calcul commence → l'encart apparaît
Cashew.hide();   // le résultat est prêt → l'encart disparaît

C'est tout. Tant que votre site n'est pas validé par notre équipe, l'encart affiche des annonces de démonstration Cashew — vous pouvez donc intégrer et tester sans risque, rien n'est comptabilisé. Après validation, les annonces réelles prennent le relais automatiquement, sans changer une ligne.

2 · Dans votre code, concrètement

Votre traitement est une fonction async (cas le plus courant)

async function lancerEstimation() {
  Cashew.show();
  try {
    const resultat = await calculerEstimation();  // votre code existant
    afficherResultat(resultat);
  } finally {
    Cashew.hide();  // dans finally : l'encart part même en cas d'erreur
  }
}

Votre traitement est un fetch/AJAX

Cashew.show();
fetch('/api/convertir', { method: 'POST', body: data })
  .then((r) => r.json())
  .then(afficherResultat)
  .finally(() => Cashew.hide());

Vous préférez l'encart dans votre mise en page (pas en overlay)

Par défaut l'encart flotte en bas de l'écran. Pour l'afficher dans un bloc précis de votre page (par exemple à la place de votre spinner) :

Cashew.show({ container: '#zone-attente' });  // remplit votre conteneur

Le conteneur doit exister au moment de l'appel : s'il est introuvable, rien ne s'affiche (aucune erreur).

Site en plusieurs pages / SPA

La balise script se met sur chaque page où un traitement a lieu (ou dans votre layout global).
En SPA (React, Vue…), chargez le script une fois ; appelez show()/hide() où vous voulez, le SDK gère le reste.
Plusieurs traitements sur la même page ? Appelez simplement show()/hide() à chaque fois.

WordPress, Webflow, Wix…

WordPress : collez la balise via un plugin d'insertion de code (« WPCode » ou équivalent), section footer ; les appels show()/hide() vont dans le JavaScript de votre outil.
Webflow : Page settings → Custom code → Before </body>.
Wix : Paramètres → Code personnalisé → Body - fin.

3 · Vérifier que ça marche

Déclenchez votre traitement : l'encart « Sponsorisé » doit apparaître pendant l'attente puis disparaître.
Avant validation, il affiche les annonces de démonstration Cashew (fond vert) — c'est le comportement attendu.
Ensuite, cliquez « J'ai installé le code » dans votre espace éditeur : nous vérifions sur votre site, puis nous passons l'encart en réel.

4 · Questions fréquentes

Symptôme / question	Réponse
Rien ne s'affiche du tout	Vérifiez que la clé `data-site-key` est bien celle de votre espace éditeur, et que la page est servie depuis le domaine déclaré lors de votre demande (les environnements de staging ou de prévisualisation ne sont pas autorisés — `www.` et les sous-domaines de votre domaine le sont).
L'encart apparaît puis rien n'est compté	Une impression n'est comptée que si l'encart est réellement visible au moins 5 secondes, onglet au premier plan. Les attentes plus courtes affichent l'encart mais ne comptent pas — c'est notre garantie d'honnêteté envers les annonceurs, elle protège aussi la valeur de votre inventaire.
Encore des annonces de démonstration après validation	Le SDK met les annonces en cache 60 secondes : rechargez la page après une minute.
L'encart disparaît avant la fin de mon traitement	Chaque annonce reste 10 secondes et n'est jamais répétée : l'encart s'arrête quand toutes les annonces disponibles ont été montrées (10 au maximum), et dans tous les cas après 3 minutes. C'est voulu : jamais d'encart permanent. Il revient au prochain `show()`.
Et les bloqueurs de pub ?	Certains visiteurs n'auront pas d'encart, c'est normal et sans effet sur votre site (le SDK s'efface silencieusement). Vos revenus portent sur les impressions réellement affichées.
Ça ralentit mon site ?	Non : un seul fichier léger, chargé en parallèle, aucun impact tant que `show()` n'est pas appelé, et l'encart vit dans un Shadow DOM isolé — il ne touche ni votre CSS ni votre code.
Je veux arrêter	Retirez la balise script : tout s'arrête immédiatement. Aucun engagement.

5 · Ce qui est garanti

Le label « Sponsorisé » est toujours affiché — vos visiteurs ne sont jamais trompés.
Aucune lecture du contenu de vos pages, aucun suivi de vos visiteurs d'un site à l'autre : le ciblage est par catégorie de site uniquement.
Toutes les annonces sont modérées avant diffusion.
Vos revenus sont consultables en temps réel dans votre espace éditeur ; versements gérés manuellement pendant la phase pilote.

6 · Pour votre politique de confidentialité

Vous pouvez ajouter ce paragraphe tel quel à la politique de confidentialité de votre site :

Ce site affiche des encarts sponsorisés fournis par Cashew (cash-ew.com) pendant certains temps de chargement. Cashew ne vous identifie pas et ne suit pas votre navigation d'un site à l'autre. Un identifiant technique aléatoire (cashew_cid) est stocké dans le localStorage de votre navigateur, uniquement pour prévenir la fraude (plafonds d'affichage). Il n'est relié à aucun profil. Votre adresse IP n'est jamais stockée. Aucun cookie publicitaire n'est déposé. Détails : https://cash-ew.com/confidentialite

Une question, un cas particulier ? Répondez simplement au mail qui vous a transmis votre clé — réponse rapide garantie à cette étape.