Instalarea plugin-ului NewsMAN în WordPress

Pluginul NewsMAN pentru WordPress îți permite să îți conectezi rapid site-ul la contul tău NewsMAN și să colectezi abonați direct din formularele existente. Pe lângă formularele native WordPress, pluginul oferă integrare cu unele dintre cele mai utilizate soluții de formulare, precum Contact Form 7, Elementor Forms, WPForms și Gravity Forms.

Prin intermediul acestor integrări poți trimite automat abonații către listele și segmentele NewsMAN, poți salva informațiile completate în formular ca proprietăți ale abonatului și poți utiliza formularele existente pentru construirea bazei de date de email marketing.

Instalarea pluginului

1. Autentifică-te în panoul de administrare WordPress.
2. Accesează Plugins → Add New.
3. Caută pluginul NewsMAN.
4. Apasă Install Now, apoi Activate.
5. După activare, accesează secțiunea NewsMAN > Settings din meniul WordPress.
6. Introdu datele de conectare: cheia API, user ID și Remarketing ID din contul tău NewsMAN.

După conectare, pluginul va sincroniza listele și segmentele disponibile în cont.

Configurarea formularelor WordPress

După instalarea pluginului, poți conecta diferite tipuri de formulare la listele și segmentele din NewsMAN.

Contact Form 7

Integrarea cu Contact Form 7 adaugă un tab dedicat NewsMAN în editorul fiecărui formular.

Din această secțiune poți:

• activa integrarea NewsMAN pentru formular;
• marca orice formular ca formular de newsletter;
• configura opțiunea de opt-in simplu sau dublu;
• selecta lista și segmentul în care vor fi adăugați abonații;
• mapa câmpul de email;
• trimite subiectul și mesajul formularului ca proprietăți ale abonatului.

Această integrare este utilă atunci când dorești să transformi formularele de contact în surse de colectare a abonaților. Dacă folosești pluginul Contact Form 7, citește pașii detaliați de aici.

Elementor Forms

Pluginul oferă integrare atât pentru Elementor Pro Legacy Form, cât și pentru Elementor Atomic Forms.

La nivelul formularului poți configura:

• lista NewsMAN;
• segmentul;
• câmpul care conține adresa de email;
• câmpuri ale căror valori vor fi salvate în profilul abonatului ca proprietăți.

Toate datele completate de utilizator pot fi transferate automat către NewsMAN și utilizate ulterior pentru segmentare și personalizare.

Află toate detaliile pentru formulare Elementor sau Atomic Forms.

WPForms

Pentru formularele create cu WPForms, pluginul adaugă un tab NewsMAN în secțiunea Settings a formularului.

De aici poți configura:

• activarea integrării;
• lista și segmentul de destinație;
• câmpul de email;
• câmpurile care vor fi salvate ca proprietăți ale abonatului.

Astfel, informațiile colectate prin formular pot fi utilizate ulterior în campanii segmentate și automatizări.

Citește pe larg cum să configurezi setările pentru WPForms.

Gravity Forms

În Gravity Forms este disponibilă o subpagină dedicată NewsMAN în secțiunea Form Settings.

Configurarea permite:

• selectarea listei și segmentului;
• alegerea modului de opt-in;
• maparea câmpurilor de email, prenume, nume și telefon;
• transmiterea câmpurilor selectate ca proprietăți ale abonatului în NewsMAN.

Această integrare oferă control complet asupra datelor transferate către platformă.

Dacă site-ul tău folosește Gravity Forms urmează etapele de configurare de aici.

Funcționalități noi ale pluginului

Actualizare automată a segmentelor

Atunci când modifici lista selectată într-un formular, segmentele disponibile se actualizează automat fără a fi necesară reîncărcarea paginii.

Acest lucru simplifică procesul de configurare și reduce riscul selectării unor segmente invalide.

Newsletter Form

În toate integrările de formulare este disponibilă opțiunea Newsletter Form. Aceasta permite identificarea formularelor utilizate pentru colectarea abonaților și diferențierea lor de formularele obișnuite de contact.

Exportul abonaților din trimiterile formularelor

Pluginul poate utiliza datele provenite din formulare drept sursă pentru exportul abonaților. Sunt suportate trimiterile provenite din:

• Elementor Forms
• Contact Form 7
• WPForms
• Gravity Forms
• WooCommerce
• formularele native WordPress

Această funcționalitate facilitează centralizarea și administrarea datelor colectate prin intermediul site-ului.

Plugin Newsman pentru WordPress permite integrarea rapidă a formularelor cu platforma de email marketing și simplifică procesul de colectare și segmentare a abonaților. Indiferent dacă utilizezi Contact Form 7, Elementor, WPForms sau Gravity Forms, poți sincroniza automat datele cu NewsMAN și construi o bază de date campaniile tale de email marketing.

Citiți toate detalii despre plugin-ul NewsMAN în WordPress.

Autentificare OAuth 2.0

Pentru a accesa API-ul newsman folosind autentificare OAuth 2, trebuie sa parcurgeti etapele:

Inregistrarea aplicatiei care va folosi API-ul cu autentificare OAuth2

Folositi formularul de contact si trimiteti-ne urmatoarele date:
– Numele aplicatiei
– redirect_uri: Callback URL unde Newsman va trimite un callback (ex: https://situlmeu.ro/callback)

Noi va punem la dispozitie doi parametri pe care ii veti folosi la autentificare:
– client_id (ex: app_client_example)
– client_secret (ex: 123123123123 )

Autentificarea

API-ul Newsman foloseste pentru autentificare protocolul OAuth 2.0
Toate request-urile catre API trebuie facute folosind SSL (https:// nu http://)

Pentru autentificare aveti nevoie de:
– client_id (vi-l trimitem dupa inregistrarea aplicatiei)
– client_secret (vi-l trimitem dupa inregistrarea aplicatiei)
– Authorization endpoint: https://ssl.newsman.ro/admin/oauth/authorize
– Token endpoint: https://ssl.newsman.ro/admin/oauth/token

Pas 1: Directionati utilizatorul la url-ul de autorizare
https://ssl.newsman.ro/admin/oauth/authorize?scope=api&redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback&response_type=code&client_id=app_client_example

Daca utilizatorul nu este autentificat in Newsman, va fi redirectionat la formularul de login. Utilizatorul va fi intrebat daca permite aplicatiei accesul la contul lui Newsman.

Pas 2: Redirectare din Newsman catre callback URL
https://situlmeu.ro/callback?code=jksasda4sda5ssd1a1122sdassdas123

Daca utilizatorul nu a permis accesul la contul Newsman, va fi redirectionat la url-ul
https://situlmeu.ro/callback?error=access_denied&error_description=end-user+denied+authorization

Pas 3: Obtineti access_token
In pasul anterior ati obtinut “code”-ul care trebuie schimbat pe un “access_token” (API key).
Pentru a-l schimba, faceti un request POST la access_token endpoint https://ssl.newsman.ro/admin/oauth/token folosind parametrii:

• code=d869078edb8658f7ccaae5545d506662
• redirect_uri=https%3A%2F%2Fsitulmeu.ro%2Fcallback
• client_id=app_client_example
• client_secret=123123123123
• grant_type=authorization_code

Daca nu sunt erori, veti primi un raspuns JSON de forma:

{
    "user_id": 2312121,
    "access_token": "6c595cd6db27b05dya3be2f65e28291f",
    "expires_in": 1709550943,
    "lists": [1, 2],
    "token_type": "bearer",
    "scope": "api"
}

access_token obtinut (denumit API key) il veti folosi de fiecare data cand apelati API-ul impreuna cu user_id.

Webhook import.csv (notificare import abonati)

Daca aveti o aplicatie care foloseste API-ul Newsman si incarcati / actualizati abonatii in baza de date, va putem notifica in momentul in care import-ul s-a terminat. Pentru a activa acest lucru, trebuie sa aveti definita in setarile listei Webhook URL. La adresa specificata in Setari (webhook url) veti primi un request POST ce contine unul sau mai multe Newsman Events.

Un event este compus din:

• type – tipul event-ului (in cazul de fata: import)
• timestamp – (data la care s-a petrecut event-ul)
• data – array cu date custom ale fiecarui event in parte

Pentru event-ul de import, se trimit urmatoarele date:

• import_id – ID-ul importului
• status – text (finished / error)

Apelul facut de catre noi este POST si contine un singur parametru, newsman_events care contine un STRING encodat JSON. String-ul encodat JSON este un array de evenimente (unul sau mai multe evenimente Newsman).

Exemplu de cod PHP pentru a face DEBUG la evenimente:

<?php
print_r($_POST);
/*
Array
(
    [newsman_events] => [{"type":"import","timestamp":1372428476,"data":{"import_id":"51cd98951fbbbf972d000001","status":"finished"}}]
)
*/
 
$newsman_events = json_decode($_POST["newsman_events"]);
print_r($newsman_events[0]);
/* 
Array
(
    [type] => import
    [timestamp] => 1372428476
    [data] => Array
        (
            [import_id] => 51cd98951fbbbf972d000001
            [status] => finished
        )
 
)
*/
)
?>

Folosind valoare din import_id se pot face verificari via API despre statusul import-ului folosind metoda import.status.

Cum generez un API Key NewsMan ?

Pentru a crea un API key, vă rugăm urmați pașii de mai jos:

• Din meniul din stânga, intrați în Integrări > API

• Faceți click pe Adaugă API key

• Alegeți lista (-ele) dorită (-e), selectați tipul de acces, completați IP-urile pentru acces (opțional) sau lăsați gol pentru orice IP și salvați:

API key-ul dumneavoastră tocmai a fost creat:

Mai multe detalii despre: documentație și metode API NewsMan.