{"id":363985,"date":"2026-09-11T12:24:48","date_gmt":"2026-09-11T12:24:48","guid":{"rendered":"https:\/\/it.wordpress.org\/plugins\/adv-click-lead-ingest\/"},"modified":"2026-09-11T12:24:18","modified_gmt":"2026-09-11T12:24:18","slug":"adv-click-lead-ingest","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/adv-click-lead-ingest\/","author":23560523,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.6.9","stable_tag":"1.6.9","tested":"7.1","requires":"6.0","requires_php":"8.1","requires_plugins":null,"header_name":"ADV.click Lead Ingest","header_author":"ADV.click","header_description":"Invia lead (Contact Form 7 \/ WPForms, campi nascosti inclusi) e, se attivo, solo le sessioni da campagna ads al CRM ADV.click (Ingest API).","assets_banners_color":"ffffff","last_updated":"2026-09-11 12:24:18","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.adv.click\/integrazioni\/wordpress","header_author_uri":"https:\/\/www.adv.click","rating":0,"author_block_rating":0,"active_installs":0,"downloads":43,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.6.9":{"tag":"1.6.9","author":"principiadv","date":"2026-09-11 12:24:18","revision":3691366}},"upgrade_notice":{"1.6.8":"<p>Phone-click tracking now sends a WordPress REST nonce. Behavior for forms and visits is unchanged.<\/p>","1.6.7":"<p>Form leads use CRM sorgente <code>direct<\/code> unless the session already has ads attribution.<\/p>","1.6.6":"<p>Maps common Contact Form 7 field names (firstname, lastname, phone, company) to CRM contact fields.<\/p>","1.6.5":"<p>Settings wording only: the plugin does not send organic visits to the CRM. Paid-session POST \/visits is unchanged.<\/p>","1.6.4":"<p>Demo tester instructions on Settings are collapsed by default so client sites are not shown the howto.<\/p>","1.6.3":"<p>Text domain matches the wordpress.org plugin slug. Existing settings (options) are unchanged.<\/p>","1.6.2":"<p>Plugin URI restored: public product page on adv.click, different from Author URI.<\/p>","1.6.1":"<p>Header fix for wordpress.org: Plugin URI removed (it matched Author URI).<\/p>","1.6.0":"<p>Sends all form fields (including hidden), adds WPForms and filters from the previous ADV CRM plugin. Creates a local visits table on upgrade.<\/p>","1.5.1":"<p>WordPress.org Plugin Check compliance (escaping, sanitization, Tested up to 7.1).<\/p>","1.5.0":"<p>Adds a visit-tracking toggle and WordPress.org metadata. Existing sites keep visit tracking on unless you disable it.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3691466,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3691466,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3691363,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3691363,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.6.9"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[1152,1150,335,456,130711],"plugin_category":[42,55,58],"plugin_contributors":[280234],"plugin_business_model":[],"class_list":["post-363985","plugin","type-plugin","status-publish","hentry","plugin_tags-contact-form-7","plugin_tags-crm","plugin_tags-leads","plugin_tags-marketing","plugin_tags-wpforms","plugin_category-contact-forms","plugin_category-seo-and-marketing","plugin_category-user-management","plugin_contributors-principiadv","plugin_committers-principiadv"],"banners":{"banner":"https:\/\/ps.w.org\/adv-click-lead-ingest\/assets\/banner-772x250.png?rev=3691363","banner_2x":"https:\/\/ps.w.org\/adv-click-lead-ingest\/assets\/banner-1544x500.png?rev=3691363","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/adv-click-lead-ingest\/assets\/icon-128x128.png?rev=3691466","icon_2x":"https:\/\/ps.w.org\/adv-click-lead-ingest\/assets\/icon-256x256.png?rev=3691466","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>ADV.click Lead Ingest connects a WordPress site to an ADV.click CRM profile. Product page: <a href=\"https:\/\/www.adv.click\/integrazioni\/wordpress\">adv.click\/integrazioni\/wordpress<\/a>. After you paste the Ingest URL and secret from <strong>Impostazioni \u2192 Ingest API<\/strong>, the plugin:<\/p>\n\n<ul>\n<li>Sends Contact Form 7 and WPForms submissions to <code>POST \/api\/v1\/ingest\/leads<\/code>, including hidden fields<\/li>\n<li>Optional filters: blocked keywords\/URLs, ads-only leads, bot\/crawler exclusion, phone-click delay<\/li>\n<li>Keeps a local retry queue if the CRM is unreachable (cron every 15 minutes)<\/li>\n<li>Attributes later leads with a first-party cookie (30 days) and an IP fallback<\/li>\n<li>Optionally POSTs <strong>ads-campaign sessions only<\/strong> (gclid \/ fbclid \/ UTM) to <code>POST \/api\/v1\/ingest\/visits<\/code> \u2014 organic pageviews are not sent to the CRM<\/li>\n<li>Stores pages locally (table + cookie) for lead attribution even when the CRM visit POST is off<\/li>\n<li>Optional REST <code>funnel-by-ip<\/code> for chatbot\/server lookups (token required)<\/li>\n<li>Shortcode <code>[adv_click_calendario]<\/code> to embed the booking calendar (iframe) on a WordPress page with slug <code>calendario<\/code><\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p><strong>Recommended:<\/strong> <a href=\"https:\/\/wordpress.org\/plugins\/contact-form-7\/\">Contact Form 7<\/a> or <a href=\"https:\/\/wordpress.org\/plugins\/wpforms-lite\/\">WPForms<\/a>. Ads-session page lists can be sent without a form plugin; organic visits are never POSTed.<\/p>\n\n<h4>Privacy<\/h4>\n\n<p>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 <code>tel:<\/code> number (not the caller ID).<\/p>\n\n<p>Admin configuration of URL + secret is the consent to use the ADV.click service (WordPress.org guideline 7, SaaS exception). The <code>\/visits<\/code> 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.<\/p>\n\n<p>Privacy policy: https:\/\/www.adv.click\/privacy\nData deletion: https:\/\/www.adv.click\/cancellazione-dati\nSupport: https:\/\/www.adv.click\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install from this ZIP (Plugins \u2192 Add New \u2192 Upload) or, once listed, from the WordPress plugin directory.<\/li>\n<li>Activate <strong>ADV.click Lead Ingest<\/strong>.<\/li>\n<li>Open Settings \u2192 ADV.click Ingest.<\/li>\n<li>Paste the Ingest leads URL and secret from your MY portal (Impostazioni \u2192 Ingest API).<\/li>\n<li>Click <strong>Save<\/strong>, then <strong>Test connection<\/strong> (creates a disposable test lead on the CRM).<\/li>\n<\/ol>\n\n<p>You may instead define constants in <code>wp-config.php<\/code>:<\/p>\n\n<ul>\n<li><code>ADV_CLICK_INGEST_URL<\/code><\/li>\n<li><code>ADV_CLICK_INGEST_SECRET<\/code><\/li>\n<li><code>ADV_CLICK_INGEST_VISITS_URL<\/code> (optional)<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20the%20plugin%20work%20without%20adv.click%3F\"><h3>Does the plugin work without ADV.click?<\/h3><\/dt>\n<dd><p>No. It is a connector. Without a valid CRM URL and secret, leads stay in the local queue.<\/p><\/dd>\n<dt id=\"does%20it%20send%20all%20historical%20contact%20form%207%20entries%3F\"><h3>Does it send all historical Contact Form 7 entries?<\/h3><\/dt>\n<dd><p>No. The queue only stores failures that happen after the plugin is installed or upgraded. There is no backfill.<\/p><\/dd>\n<dt id=\"does%20it%20send%20all%20visits%20to%20the%20crm%3F\"><h3>Does it send all visits to the CRM?<\/h3><\/dt>\n<dd><p>No. Only ads-campaign sessions (gclid \/ fbclid \/ UTM) can be POSTed to <code>\/visits<\/code>, and only if <strong>Invia al CRM solo le sessioni da campagna ads<\/strong> is on. Organic pageviews stay on the site. Form and tel leads still go to the CRM. If you turn the option off, leads stay attributed via the first-party cookie; the <code>\/visits<\/code> POST does not run.<\/p><\/dd>\n<dt id=\"how%20do%20i%20connect%20the%20demo%20%2F%20tester%20profile%3F\"><h3>How do I connect the demo \/ tester profile?<\/h3><\/dt>\n<dd><ol>\n<li>Open https:\/\/tester.my.adv.click\/<\/li>\n<li>Sign in with company identifier <code>tester<\/code> and email <code>tester@de2.it<\/code> (password is the demo profile password, not shipped in this plugin).<\/li>\n<li>Go to <strong>Impostazioni \u2192 Ingest API<\/strong>.<\/li>\n<li>Paste into this plugin:<\/li>\n<\/ol>\n\n<ul>\n<li>Ingest leads URL: <code>https:\/\/tester.my.adv.click\/api\/v1\/ingest\/leads<\/code><\/li>\n<li>Ingest visits URL: <code>https:\/\/tester.my.adv.click\/api\/v1\/ingest\/visits<\/code><\/li>\n<li>Secret: copy from that MY screen<\/li>\n<li>Slug CRM: <code>tester<\/code><\/li>\n<\/ul>\n\n<ol>\n<li>Save, then <strong>Test connection<\/strong>. A disposable lead (sorgente <code>direct<\/code>) appears under Leads on the tester profile.<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.6.9<\/h4>\n\n<ul>\n<li>Shortcode <code>[adv_click_calendario]<\/code> embeds the CRM booking calendar in an iframe (query <code>cs<\/code> \/ <code>ls<\/code>). Create a WordPress page with slug <code>calendario<\/code>.<\/li>\n<\/ul>\n\n<h4>1.6.8<\/h4>\n\n<ul>\n<li>WordPress.org review: enqueue frontend\/admin JS; REST <code>\/track<\/code> requires a <code>wp_rest<\/code> nonce; <code>Tested up to<\/code> only in this readme.<\/li>\n<\/ul>\n\n<h4>1.6.7<\/h4>\n\n<ul>\n<li>Form and phone-click leads send sorgente <code>direct<\/code> (or <code>google_ads<\/code> \/ <code>social<\/code> \/ <code>ads<\/code> from the session). The CRM select does not accept <code>wordpress-cf7<\/code>.<\/li>\n<\/ul>\n\n<h4>1.6.6<\/h4>\n\n<ul>\n<li>Contact mapping: CF7 slugs <code>firstname<\/code>, <code>lastname<\/code>, <code>phone<\/code>, <code>company<\/code>, <code>message<\/code>, plus type-based email\/phone fallback when labels are odd.<\/li>\n<\/ul>\n\n<h4>1.6.5<\/h4>\n\n<ul>\n<li>Settings copy: \u201cVisite paid\u201d 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).<\/li>\n<\/ul>\n\n<h4>1.6.4<\/h4>\n\n<ul>\n<li>Settings screen: tester\/demo howto is no longer a top notice. Same steps sit in a closed \u201cProfilo demo (tester)\u201d accordion at the bottom (also in this FAQ).<\/li>\n<\/ul>\n\n<h4>1.6.3<\/h4>\n\n<ul>\n<li>Text domain and ZIP folder aligned to the wordpress.org slug <code>adv-click-lead-ingest<\/code>. PHP option\/function prefixes unchanged.<\/li>\n<\/ul>\n\n<h4>1.6.2<\/h4>\n\n<ul>\n<li>Plugin URI now points at the public product page https:\/\/www.adv.click\/integrazioni\/wordpress (distinct from Author URI).<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>Plugin header: drop Plugin URI (was identical to Author URI; wordpress.org requires them to differ).<\/li>\n<\/ul>\n\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>All form fields (including hidden) sent to the CRM; WPForms support.<\/li>\n<li>Legacy-parity settings: blocked keywords, bot filter, ads-only, phone delay, funnel-by-ip token, visit table + repair.<\/li>\n<li>Test mode writes debug lines to PHP error_log (secrets redacted). Does not change the CRM URL.<\/li>\n<\/ul>\n\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>Plugin Check (PCP 2.1.0) clean: wp_rand, late escaping, wp_unslash, Tested up to 7.1.<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>WordPress.org packaging: readme.txt, GPL headers, text domain, uninstall cleanup.<\/li>\n<li>Optional setting to disable visit POSTs while keeping lead attribution.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>30-day session cookie with IP fallback; page list on the lead.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Local lead queue and 15-minute retry cron.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Connection test lead (<code>wordpress-plugin-test<\/code>).<\/li>\n<\/ul>","raw_excerpt":"Send Contact Form 7 \/ WPForms leads (including hidden fields) to ADV.click CRM. Optional: send ads-campaign sessions only (not organic visits).","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/363985","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=363985"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/principiadv"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=363985"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=363985"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=363985"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=363985"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=363985"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=363985"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}