Documentation détaillée
Généralités
Authentification
Étapes de création d'un envoi e-mail
Étapes de création d'un envoi SMS
Nouveautés
administration du compte
contacts
abonnements
consentements
groupes d'intérêts
intérêts
champs
imports - mapping
imports de contacts
variables
ciblages
lois ciblages
critères ciblages
plannings
e-mail - adresses d'expéditeurs
e-mail - adresses de réponses
e-mail - liens de messages
e-mail - messages
e-mail - envois
e-mail - envois transactionnels
sms - expéditeurs
sms - messages
sms - envois
sms - envois transactionnels
exports - mappings
exports - colonnes
exports - filtres
exports
statistiques
hébergement
webhooks
connexions distantes
consentements - dépréciées
imports de contacts - dépréciées
Powered by Stoplight
post

/email/splittests

Crée un nouvel A/B test sur des messages e-mails.

Un A/B test permet de tester différents messages e-mails afin de mesurer lequel est le plus performant pour atteindre votre objectif : messages les plus ouverts, messages les plus cliqués ou messages ayant récoltés le moins de désabonnements.

Les changements sur les différents messages testés peuvent porter par exemple sur l’objet du message, sur l’adresse ou le nom de l’expéditeur, sur l’adresse ou le nom de réponse, ou encore sur le contenu textuel ou graphique de votre message.

Un A/B test permet de comparer jusqu’à 5 messages e-mails entre eux et se déroule en 2 phases :

  • Génération des envois tests sur un échantillon de la population globale de l’envoi
  • Génération de l’envoi final sur tous les contacts restants

2 modes d’A/B tests sont possibles :

  • A/B test manuel : le système déclenche automatiquement les envois d’échantillons tests à l’heure de votre choix et une action sera nécessaire pour déclencher l’envoi final (minimum 2 heures après les envois tests) Mode : Manual
  • A/B test automatique : le système déclenche automatiquement les envois d’échantillons tests et l’envoi final à l’heure de votre choix (minimum 1 jour après les envois tests) Mode : Auto

Pour créer un A/B test, renseigner en paramètre de la requête :

  • AccountID (*) : identifiant du compte Campaign

puis dans le corps de la requête :

  • MessageList : liste des différents messages à comparer en spécifiant pour chacun :
    • MessageID : identifiant du message e-mail
    • Name : nom que vous souhaitez donner à l’envoi échantillon test (80 caractères maximum). Veillez à nommer chaque envoi échantillon test avec un nom différent (par exemple : Version Test 1 - Nom du message puis Version Test 2 - Nom du message etc.)
  • SplitTest qui définit les propriétés de l’A/B test :
    • Name (*) : nom que vous souhaitez donner à l’A/B test (80 caractères maximum)
    • Mode (*) : Auto ou Manual
    • TargetID (*) : identifiant du ciblage correspondant au groupe de contacts sur lequel vous souhaitez réaliser votre A/B test (envois tests + envoi final)
    • PlanningTestID (*) : identifiant du planning unitaire qui définit la date et heure de la génération des envois tests
    • Ratio (*) : échantillon de test (entier de 0 à 100) qui correspond au pourcentage de contacts, issus de votre ciblage TargetID, que vous souhaitez adresser pour tester vos différentes versions de messages. Cet échantillon sera divisé à parts égales pour l’envoi de chaque version de messages tests. Assurez-vous de renseigner un pourcentage cohérent, compris idéalement entre 5 et 50%, sollicitant suffisamment de contacts. Un minimum de 100 contacts est recommandé par version de message.
    • SubscriptionID : identifiant de l’abonnement fin lié à l’envoi A/B test (si non renseigné s’applique à l’abonnement global du compte)

Pour un A/B test en mode automatique, ajoutez dans le corps de la requête, aux propriétés précédentes les éléments suivants :

  • SendingName (*) : nom que vous souhaitez donner à l’envoi final de l’A/B test, différent des noms attribués aux envois tests
  • PlanningFinalID (*) : identifiant du planning unitaire qui définit la date et heure de la génération de l’envoi final (au minimum 1 jour aprés les envois tests)
  • Trigger (*) : déclencheur de l’envoi final parmi 3 choix possibles :
    • Openings : meilleur taux d’ouvreurs (calculé en divisant le nombre d’ouvreurs distincts par le nombre d’aboutis)
    • Clicks : meilleur taux de cliqueurs (calculé en divisant le nombre de cliqueurs distincts par le nombre d’aboutis)
    • Disengagements : taux de désengagement le plus bas (calculé en divisant le nombre de désabonnés par le nombre d’envoyés)

En cas de succès, la méthode renverra l’identifiant de l’envoi A/B test créé, nécessaire à la récupération des statistiques d’un A/B test.

(*) : paramètres obligatoires

Dernière mise à jour : Juin 2021

Authorization

apiKey - X-API-Key

Request Parameters

1 Query Parameter
1 Header

Request Body

Schema
object

Message management

MessageList
array[object]

Message identifier and sending name list

SplitTest
object

SplitTest

Responses

Success

Schema
object

PostResult

ID
integer
2 validations

Send a Test Request

Send requests directly from the browser (CORS must be enabled)
$$.env
1 variable not set
X-API-Key