ADV.click Lead Ingest

ADV.click Lead Ingest connects a WordPress site to an ADV.click CRM profile. Product page: adv.click/integrazioni/wordpress. After you paste the Ingest URL and secret from Impostazioni → Ingest API, the plugin:

• Sends Contact Form 7 and WPForms submissions to POST /api/v1/ingest/leads, including hidden fields
• Optional filters: blocked keywords/URLs, ads-only leads, bot/crawler exclusion, phone-click delay
• Keeps a local retry queue if the CRM is unreachable (cron every 15 minutes)
• Attributes later leads with a first-party cookie (30 days) and an IP fallback
• Optionally POSTs ads-campaign sessions only (gclid / fbclid / UTM) to POST /api/v1/ingest/visits — organic pageviews are not sent to the CRM
• Stores pages locally (table + cookie) for lead attribution even when the CRM visit POST is off
• Optional REST funnel-by-ip for chatbot/server lookups (token required)
• Shortcode [adv_click_calendario] to embed the booking calendar (iframe) on a WordPress page with slug calendario

This is a Software-as-a-Service connector. It only talks to the CRM URL you configure. You need an ADV.click profile (or an agency-managed profile) to use it. ADV.click is a product of Principi S.r.l. (https://www.principiadv.com); this is the official WordPress connector. Recommended: Contact Form 7 or WPForms. Ads-session page lists can be sent without a form plugin; organic visits are never POSTed. Privacy When the ads-session option is on and a visitor arrives from a paid campaign (gclid / fbclid / UTM), the plugin may send to your CRM: session GUID, landing/last URLs (up to 50 pages), click IDs, browser/device class, and visitor IP. Organic pageviews are not POSTed. Form leads include every submitted field (including hidden ones), plus name, email, phone, and message when present. Phone-click leads send the clicked tel: number (not the caller ID). Admin configuration of URL + secret is the consent to use the ADV.click service (WordPress.org guideline 7, SaaS exception). The /visits POST can be disabled on the settings screen; the first-party cookie can still be used only to attribute a later form or tel lead. Privacy policy: https://www.adv.click/privacy Data deletion: https://www.adv.click/cancellazione-dati Support: https://www.adv.click/

1. Install from this ZIP (Plugins → Add New → Upload) or, once listed, from the WordPress plugin directory.
2. Activate ADV.click Lead Ingest.
3. Open Settings → ADV.click Ingest.
4. Paste the Ingest leads URL and secret from your MY portal (Impostazioni → Ingest API).
5. Click Save, then Test connection (creates a disposable test lead on the CRM).

You may instead define constants in wp-config.php:

• ADV_CLICK_INGEST_URL
• ADV_CLICK_INGEST_SECRET
• ADV_CLICK_INGEST_VISITS_URL (optional)

1.8.0

• Settings screen and FAQ: removed the internal sample-profile setup notes. Connection values always come from your own CRM profile (Impostazioni → Ingest API).
• New Tools → "ADV.click lead inviati": last 200 send attempts (date, outcome, HTTP code, duplicate flag, CRM lead id + link). Email/phone masked, no message stored.
• Each form submission carries an idempotency_key, kept across queue retries, so a retry after a timeout does not create a second lead.
• Ingest guidance on the new screen: "Duplicato" means the CRM answered 200 with an existing lead (24h anti-duplicate); HTTP/network errors stay in the retry queue (cron every 15 min), with the pending count shown.
• Privacy: the log keeps only date, outcome, HTTP code, CRM lead id, form type and masked email/phone (option adv_click_ingest_sent_log, not autoloaded, removed on uninstall).

1.7.0

• Settings page: help text under each connection field pointing to the matching field in CRM Settings → Ingest API (direct link built from the saved CRM slug).

1.6.9

• Shortcode [adv_click_calendario] embeds the CRM booking calendar in an iframe (query cs / ls). Create a WordPress page with slug calendario.

1.6.8

• WordPress.org review: enqueue frontend/admin JS; REST /track requires a wp_rest nonce; Tested up to only in this readme.

1.6.7

• Form and phone-click leads send sorgente direct (or google_ads / social / ads from the session). The CRM select does not accept wordpress-cf7.

1.6.6

• Contact mapping: CF7 slugs firstname, lastname, phone, company, message, plus type-based email/phone fallback when labels are odd.

1.6.5

• Settings copy: “Visite paid” now says the CRM receives only ads-campaign sessions (gclid / fbclid / UTM), not all visits. Behavior unchanged (local cookie/table, form/tel leads, paid-only POST /visits).

1.6.4

• Settings screen: setup notes moved out of the top notice.

1.6.3

• Text domain and ZIP folder aligned to the wordpress.org slug adv-click-lead-ingest. PHP option/function prefixes unchanged.

1.6.2

• Plugin URI now points at the public product page https://www.adv.click/integrazioni/wordpress (distinct from Author URI).

1.6.1

• Plugin header: drop Plugin URI (was identical to Author URI; wordpress.org requires them to differ).

1.6.0

• All form fields (including hidden) sent to the CRM; WPForms support.
• Legacy-parity settings: blocked keywords, bot filter, ads-only, phone delay, funnel-by-ip token, visit table + repair.
• Test mode writes debug lines to PHP error_log (secrets redacted). Does not change the CRM URL.

1.5.1

• Plugin Check (PCP 2.1.0) clean: wp_rand, late escaping, wp_unslash, Tested up to 7.1.

1.5.0

• WordPress.org packaging: readme.txt, GPL headers, text domain, uninstall cleanup.
• Optional setting to disable visit POSTs while keeping lead attribution.

1.4.0

• 30-day session cookie with IP fallback; page list on the lead.

1.3.0

• Local lead queue and 15-minute retry cron.

1.2.0

• Connection test lead (wordpress-plugin-test).