Groupes de codes
Un groupe de codes est un lot : un ensemble de conteneurs créés à l’avance, avant que l’on sache qui utilisera chacun d’eux. C’est le mécanisme sur lequel reposent les parcours construits autour d’un support physique pré-imprimé — une carte ou une boîte imprimée avant même qu’un seul destinataire soit connu.
Ce qu’est un groupe de codes
Un groupe de codes ne décrit pas un parcours à lui seul — c’est une étiquette qui relie un ensemble de conteneurs, pour qu’un lot créé aujourd’hui puisse demain être interrogé, filtré et analysé comme un tout, quel que soit le moment où chaque conteneur sera utilisé.
Définir un groupe de codes à la création
codeGroup est un champ facultatif du corps de création d’un conteneur. Renseignez-le lorsque le conteneur est créé dans le cadre d’un lot plutôt qu’à la demande, pour un destinataire unique et déjà connu.
{
"crid": "…",
"codeGroup": "…"
}Lister les groupes de codes
GET /code-groups liste les groupes de codes connus de votre compte. Il requiert le scope code_groups:read.
curl https://client-api.v5.livstick.com/api/v3/code-groups \
-H "Authorization: Bearer {ACCESS_TOKEN}"Filtrer les messages par groupe de codes
GET /messages peut être filtré par groupe de codes comme par crid : vous récupérez ainsi tous les messages d’un lot sans devoir d’abord lister ses conteneurs un par un.
Ce que cette page ne couvre pas
Cette page décrit le mécanisme des groupes de codes lui-même, pas un parcours produit particulier qui s’appuie dessus. Le détail des parcours Activate sur support pré-imprimé n’est pas encore arrêté : il est volontairement laissé de côté plutôt que deviné.