Comprendre la création de campagne via API – Diva Digital

Introduction

La création d'une campagne peut être effectuée guidé depuis la plateforme et de manière programmatique via API.

Le détail de chaque paramètre nécessaire à la création d'une campagne est accessible dans la documentation :

La création d'une campagne permet de créer les campagnes :

Pour tous les types de campagnes (tactiques, applicative et trigger api), définis grâce au type de campagne et au type de schedule
Pour tous les canaux : email, SMS et push notification
Dans le statut brouillon, éditable depuis la plateforme, ou publié, prête à partir selon le type de campagne.

Des identifiants nécessaires à la création d'une campagne font référence à des informations auxquelles le compte a accès grâce à d'autres endpoints :

Group_id : liste des groupes depuis l'endpoint /settings/groups
Content Id : liste des contenus créés accessible depuis l'endpoint /content
Tags : liste des tags pour les différentes familles accessible depuis l'endpoint /settings/tag-families

Il est nécessaire de renseigner au moins une valeur pour chaque famille obligatoire.
Sender : liste des expéditeurs accessible pour chaque groupe depuis l'endpoint /settings/groups/{id}/sender
Un expediteur est nécessaire pour chaque population active sur le client.
optin_id : liste des consentements accessible pour chaque groupe depuis l'endpoint /groups/{id}/optins
procedure_id et parameters : Listes des procédures de ciblages accessible pour chaque groupe depuis l'endpoint /groups/{id}/targeting-procedures,
Chaque procédure de ciblage est accompagnée de ses paramètres et des valeurs associées.

Une fois la campagne créée, il est possible d'interagir avec grâce aux endpoints suivants :

De retrouver l'ensemble des informations qui la définissent sur l'endpoint /campaigns/{id}
De changer son statut brouillon ou publié grâce à l'endpoint /campaigns/{id}
De déclencher son envoi pour une campagne de type trigger api, ou on demand depuis l'api, grâce à l'endpoint /campaigns/{id}/sends
De retrouver des informations liées au statut et à l'avancé d'un envoi sur l'endpoint /campaigns/{id}/sends/{send_id}
De retrouver les informations sur l'envoi d'un messages pour cette campagne grâce à l'enpoint /messages
De retrouver le contenu du message envoyé grâce à l'endpoint /messages/{id}/content
De déclencher l'envoi de message pour une campagne applicative grâce à l'enpoint /messages
De retrouver les messages répondus à cette campagne grâce à l'enpoint /inbounds

Une fois la campagne créée et programmée, vous pouvez la retrouver dans Sendingly et analyser ses performances dans Dashboardly