Guide éditeur

Guide de configuration du tableau des offres

Ce guide explique comment créer un tableau des offres, y diriger les visiteurs, suivre le bon utilisateur, personnaliser le design et rémunérer les utilisateurs en toute sécurité après la validation des offres.

Ce guide est rédigé pour le créateur de tableaux des offres actuel. Les anciens tableaux des offres que vous avez déjà créés fonctionnent toujours, mais les nouvelles créations utilisent les options de configuration et d'intégration plus récemment ajoutées.

Démarrage rapide

1

Créez un nouveau tableau des offres dans Outils, puis choisissez l'un des modèles de démarrage.

2

Définissez le titre public, les instructions, le nom de la devise et les points par $1.00 de paiement.

3

Transmettez votre propre identifiant utilisateur avec ?subid=IDENTIFIANT_UTILISATEUR, ou activez l'invite de nom d'utilisateur si vous ne pouvez pas transmettre subid depuis votre site ou votre application.

4

Copiez le lien direct, le code iframe, le code de script ou le code Android depuis Obtenir le code.

5

Configurez votre renvoi éditeur avant d'envoyer de vrais utilisateurs afin que votre système puisse récompenser les offres terminées.

6

Testez le tableau des offres, vérifiez la mise en page sur ordinateur et mobile, puis consultez les statistiques et les journaux de renvoi après le démarrage du trafic.

Fonctionnement du tableau des offres

Un tableau des offres présente aux visiteurs une liste d'offres qu'ils peuvent terminer contre des points, des pièces, des gemmes, de l'argent ou un autre nom de récompense de votre choix.

CPAlead sélectionne les offres éligibles en fonction du visiteur, des règles de l'offre, de l'appareil, du pays et de la disponibilité actuelle des offres. Les utilisateurs sur ordinateur voient généralement des offres adaptées à l'ordinateur. Les utilisateurs mobiles peuvent également voir des offres d'installation d'application lorsqu'ils sont éligibles.

Lorsqu'un visiteur démarre une offre, l'offre s'ouvre avec des valeurs de suivi jointes. Si l'annonceur confirme plus tard que l'action requise a été effectuée, CPAlead enregistre la conversion et peut envoyer votre renvoi éditeur.

L'annonceur contrôle le signal final de validation. Si l'annonceur n'envoie pas de signal valide, le tableau des offres ne peut pas confirmer la récompense.

Créer et configurer le mur

Le titre interne est réservé à votre tableau de bord. Le titre public et les instructions sont affichés aux visiteurs.

Le nom de la devise est l'étiquette de récompense que les visiteurs voient, comme Points, Pièces, Gemmes, Crédits ou Robux. Le réglage des points par $1.00 de paiement détermine comment le paiement de l'offre est converti en montant de récompense affiché sur le mur.

Le logo par défaut du mur de récompenses peut être conservé ou remplacé par l'URL d'une image HTTPS sûre de votre choix. Les fichiers SVG, les URL localhost et les URL de réseaux privés sont bloqués.

Les offres de rencontres peuvent être désactivées si elles ne correspondent pas à votre public. L'éligibilité des autres offres est gérée par CPAlead selon les règles de l'offre et le contexte du visiteur.

Façons de diriger les visiteurs vers le tableau des offres

Utilisez l'option Obtenir le code sur votre page Outils une fois le mur créé. La fenêtre de code vous donne plusieurs façons sûres d'utiliser le même tableau des offres.

Un lien direct est la solution la plus simple. Un iframe garde le mur dans votre site. L'option script ouvre le mur depuis votre propre bouton. Le code Android ouvre le mur depuis un écran d'application.

Quelle que soit l'option choisie, incluez subid dès que possible afin que les récompenses et l'historique puissent être associés au bon visiteur.

Identifiants utilisateur et invite de nom d'utilisateur

La meilleure configuration consiste à ajouter votre propre identifiant utilisateur, identifiant de portefeuille ou référence de session à l'URL du tableau des offres en tant que subid. Exemple : ?subid=USER123.

La valeur subid est enregistrée avec le clic et renvoyée dans votre renvoi éditeur. C'est ainsi que votre système sait quel visiteur doit recevoir la récompense.

Si votre site web ou votre application ne peut pas ajouter subid au lien, vous pouvez activer l'option qui demande aux visiteurs un nom d'utilisateur avant d'afficher les offres. Cette valeur est utilisée comme référence du visiteur pour l'historique des récompenses et le crédit par renvoi.

L'invite de nom d'utilisateur n'est pas un système de connexion. Elle ne prouve pas la propriété du compte. Ce n'est qu'un moyen de secours pour recueillir une référence de visiteur lorsque vous ne pouvez pas transmettre subid vous-même.

Récompenser les utilisateurs avec des renvois

Le tableau des offres peut afficher les offres immédiatement, mais votre site ou votre application a toujours besoin d'un processus de récompense.

Un renvoi éditeur est la notification serveur à serveur que CPAlead envoie à votre point de terminaison après l'enregistrement d'une conversion d'offre éligible.

Votre système de récompense doit utiliser le renvoi pour retrouver le visiteur grâce au subid, enregistrer l'ID du lead afin que les notifications en double ne créditent pas deux fois l'utilisateur, puis ajouter les points ou la récompense corrects.

Ne récompensez jamais simplement parce qu'un visiteur a cliqué sur une offre ou dit l'avoir terminée. Récompensez à partir du signal de renvoi afin que votre grand livre corresponde aux conversions terminées.

Design et personnalisation

Commencez à partir d'un des modèles clairs ou sombres, puis modifiez le titre, les instructions, le logo, les points, le HTML et le CSS.

Les options avancées vous permettent de modifier séparément le HTML de la mise en page, le HTML des cartes d'offres et le CSS personnalisé. Vous pouvez copier l'invite et le code de l'IA dans votre assistant de discussion, lui demander des modifications, puis coller chaque section retournée dans le créateur.

Seuls les espaces réservés approuvés sont autorisés. Les espaces réservés obligatoires doivent rester en place afin que la liste des offres, les liens d'offres, le panneau de confidentialité, le panneau des conditions, le solde de points, l'historique, les filtres et le comportement des fenêtres modales continuent de fonctionner.

Le JavaScript, les balises de script, les attributs d'événements, les feuilles de style externes, les formulaires, les iframes, les liens non sûrs, les sources d'images non sûres et le chargement de ressources CSS sont supprimés ou bloqués pour la sécurité.

Testez avant d'envoyer du trafic

Prévisualisez les tailles ordinateur et mobile dans le créateur.

Ouvrez le lien public du mur depuis Obtenir le code et assurez-vous que le logo, les points, les catégories, la recherche, le tri, la fenêtre modale d'offre, les sections Confidentialité et Conditions sont corrects.

Testez votre point de terminaison de renvoi avant d'envoyer de vrais utilisateurs. Un tableau des offres fonctionnel sans renvoi fonctionnel peut amener des utilisateurs à terminer des offres sans recevoir de récompenses dans votre application ou votre site web.

Après le démarrage du trafic, consultez les statistiques et les journaux de renvoi pour confirmer que les clics et les conversions sont suivis comme prévu.

Exemples d'intégration

Remplacez YOUR_SLUG par le slug de votre fenêtre Obtenir le code et remplacez USER123 par votre propre identifiant de visiteur.

Lien direct

À utiliser lorsque vous voulez envoyer les visiteurs vers la page hébergée du mur de récompenses.

https://www.cpalead.com/wall/YOUR_SLUG?subid=USER123

Intégration iframe

À utiliser lorsque le mur doit apparaître dans votre propre page.

<iframe src="https://www.cpalead.com/wall/YOUR_SLUG?subid=USER123" width="100%" height="760" style="border:0;" loading="lazy"></iframe>

Script de bouton

À utiliser lorsque vous voulez que votre propre bouton ouvre le mur.

<script src="https://www.cpalead.com/offerwall-v2.js?bid=YOUR_SLUG"></script>
<button type="button" onclick="cpld_run()">Ouvrir les récompenses</button>

Application Android

Utilisez ce modèle lorsqu'une application Android ouvre le mur hébergé dans un onglet de navigation ou une vue web.

Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse("https://www.cpalead.com/wall/YOUR_SLUG?subid=USER123"));
startActivity(intent);

Espaces réservés importants

Les modèles avancés doivent conserver les espaces réservés obligatoires. Voici les plus importants que les éditeurs modifient généralement autour.

Espace réservé
Description
{{ offer_list }}
Affiche la liste complète des offres disponibles.
{{ featured_offers }}
Affiche la bande des offres en vedette.
{{ offer.link }}
Lien obligatoire de la carte d'offre. Sans lui, les visiteurs ne peuvent pas démarrer les offres.
{{ offer.image }}
Espace réservé obligatoire pour l'image de l'offre.
{{ offer.title }}
Titre de l'offre affiché aux visiteurs.
{{ offer.description }}
Brève description de l'offre affichée aux visiteurs.
{{ offer.points }}
Montant de récompense converti affiché sur la carte.
{{ offer.currency }}
Nom de votre devise de récompense, comme Points ou Gemmes.
{{ points_balance }}
Affiche la zone de solde de récompense du visiteur.
{{ history_panel }}
Affiche l'historique des récompenses du visiteur lorsqu'il est disponible.
{{ privacy_panel }}
Affiche le texte de confidentialité par défaut.
{{ terms_panel }}
Affiche les conditions par défaut de validation et de récompense.

Bonnes pratiques

  • Expliquez clairement aux visiteurs quelle récompense ils peuvent gagner et ce qu'ils doivent faire.
  • Transmettez subid depuis votre propre système d'utilisateurs connectés chaque fois que possible.
  • Gardez votre point de terminaison de renvoi rapide. Il doit répondre rapidement avec une réponse HTTP 2xx normale.
  • Stockez les identifiants de lead et ignorez les doublons afin que les tentatives de renvoi ne créditent pas deux fois les utilisateurs.
  • Ne prônez pas l'utilisation de VPN, de fausses informations, de terminaisons répétées ou de trafic trompeur.
  • Rendez la valeur de votre récompense réaliste. Des taux de conversion élevés viennent d'offres claires et de récompenses équitables, pas de la confusion des utilisateurs.
  • Examinez régulièrement les performances des offres et utilisez Gérer les offres si vous devez bloquer une offre qui ne convient pas à votre public.

Dépannage

Les visiteurs voient des offres mais ne reçoivent pas de récompenses dans mon application.

Vérifiez que votre renvoi éditeur est enregistré, accessible, renvoie HTTP 2xx et utilise subid pour identifier le bon visiteur.

Mon renvoi ne sait pas quel utilisateur créditer.

Transmettez ?subid=VOTRE_ID_UTILISATEUR dans l'URL du mur. Si vous ne pouvez pas transmettre subid, activez l'invite de nom d'utilisateur comme solution de secours.

L'iframe est trop courte ou provoque un défilement supplémentaire.

Augmentez la hauteur de l'iframe, utilisez width="100%" et testez les mises en page des pages sur ordinateur et mobile.

L'aperçu ne change pas après la modification du HTML ou du CSS.

Cliquez sur Appliquer les modifications de design pour prévisualiser après avoir modifié le code avancé. Cela permet au créateur de nettoyer le code avant de le rendre.

Un visiteur a terminé une offre mais aucune récompense n'est arrivée.

Les récompenses dépendent de l'envoi par l'annonceur d'un signal de validation valide. Vérifiez d'abord les journaux de renvoi. Si aucun signal de conversion n'est arrivé, le mur ne peut pas confirmer l'action.

Mon design personnalisé a été modifié après enregistrement.

Le nettoyeur de sécurité supprime le HTML non sûr, le JavaScript, le CSS externe, les espaces réservés non pris en charge et les sources d'image ou de lien risquées.