Comment pouvons nous vous aider ? 👋

API newsletter

1. Code à utiliser

<?php
    // ================================================================================
    // PREPARATION DES DONNEES
    // ================================================================================
    $post_data = array();
    // ---------------------------- Attributs du profil -------------------------------
    $post_data["data"]["customer_email"] = "john@doe.com";
    $post_data["data"]["external_id"] = "12345xxx6789";
    if (isset($_COOKIE['sbt'])) // Sauvegarde du cookie d'authentification du customer s'il est présent.
    {
       $post_data["data"]["customer_cookie"] = $_COOKIE['sbt'];
    }
    $post_data["data"]["customer_name"] = "Doe";
    $post_data["data"]["customer_firstname"] = "John";
    $post_data["data"]["customer_gender"] = "male"; // "male" or "female"
    $post_data["data"]["customer_address"] = "8, rue de la place";
    $post_data["data"]["customer_address_2"] = "bâtiment A";
    $post_data["data"]["customer_address_3"] = "appartement 23";
    $post_data["data"]["customer_cp"] = "76000";
    $post_data["data"]["customer_city"] = "Rouen";
    $post_data["data"]["customer_country"] = "FR";
    $post_data["data"]["customer_tel"] = "0235000000";
    $post_data["data"]["customer_mobile"] = "060606606";
    $post_data["data"]["customer_fonction"] = "developer";
    $post_data["data"]["customer_company"] = "SPREAD";
    $post_data["data"]["customer_birthday"] = "1970-12-31";
    $post_data["data"]["customer_lang"] = "fr_FR";
    $post_data["data"]["add_tag"] = array("tag1", "tag2"); // Ajout de tags client
    $post_data["data"]["del_tag"] = array("tag3", "tag4"); // Suppression de tags client
    // Champs personnalisés
    $post_data["data"]["custom_fields"][327] = "value"; // ID du custom_field à retrouver dans votre BackOffice, en bas de "Paramétrage > Tracker > Exemple de codes".
    
    // -------- REMONTER LES INSCRIPTIONS A LA NEWSLETTER  (REPORTING NEWSLETTER SUBSCRIPTION) --------
    // Doc : https://bit.ly/2VTHo5L
    $post_data["data"]["customer_email"] = "john@doe.com";
    $post_data["data"]["action"] = "newsletter";
    $post_data["data"]["consents"] = [
        // La clé est l'ID technique de votre consentement (ici dans l'exemple "TechIDConsent")
        // La valeur est le statut du consentement : "1" pour "consentement accepté", "0" pour "consentement refusé"
        // Ainsi dans cet exemple, nous passerons le consentement ayant l'ID technique "TechIDConsent" à "accepté"
        // et la base légale ayant l'ID technique "TechIDLegalBasis" à "refusé"
        "TechIDConsent" => 1, 
        "TechIDLegalBasis" => 0
        // Vous pouvez ajouter autant de consentements / bases légales que nécessaires dans ce tableau
        // Pour trouver vos ID tech, RDV dans votre back office, menu CRM > RGPD > Consentements 
        // et entrez dans votre consentement/base légale.
    ];

    // ================================================================================
    // APPEL CURL
    // ================================================================================
    $curl_post_data = http_build_query($post_data);
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, "https://social-sb.com/api/newsletter");
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
    curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
    curl_setopt($curl, CURLOPT_USERPWD, "PUBLIC_KEY:PRIVATE_KEY"); // À remplacer par vos clés d'API publique et privée dans votre back office, menu "Paramétrage > Tracker" en bas de page
    curl_setopt($curl, CURLOPT_POSTFIELDS,$curl_post_data );
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $curl_return = curl_exec($curl);
    curl_close($curl);
 ?>

2. Explications

Connecter le site avec le BackOffice SPREAD

Dans l'appel CURL en fin de code, insérez vos clés API publique et privée. Elles se trouvent dans votre BackOffice, menu Paramétrage > Intégration > Tracker

Attributs profils

Champs personnalisés

Vous pouvez ajouter davantage d'information sur les profils SPREAD, pour cela vous devez créer des champs personnalisés. Ceux-ci peuvent être renseignés de différentes façons et vous pouvez y remonter des informations en PHP. Pour cela, utilisez $post_data["data"]["custom_fields"][327] = "value";

327 est ici un identifiant de champ personnalisé, trouvez les vôtres en bas de cette page.

Inscriptions newsletters & consentements

Les consentements (notamment pour les inscriptions newsletters) nécessitent l'adresse email du profil. Dans SPREAD, vous configurez vos différents consentements. Chacun d'eux, possède un identifiant technique que vous personnalisez.

Vous pouvez mettre à jour le statut des consentements via la clé consents (voir l’exemple ci-dessus).

Cette clé attend un tableau clé/valeur où :

  • la clé est le nom technique du consentement (défini dans l’interface d’édition d’un consentement)
  • la valeur est l’état du consentement :
    • 1 ou true pour “consentement accepté”
    • 0 ou false pour “consentement refusé”
 

Vous pouvez également récupérer les consentements via d’autres méthodes :

🆘
Si vous avez d’autres questions sur ce sujet, vous pouvez contacter le support. 💬
Cela a-t-il répondu à votre question ?
😞
😐
🤩