client_config() ); wp_register_script( 'bw-lead-ai-admin-test', BW_LEAD_AI_URL . 'assets/js/admin-test.js', array( 'bw-lead-ai-capture' ), BW_LEAD_AI_VERSION, true ); wp_register_script( 'bw-lead-ai-utm-builder', BW_LEAD_AI_URL . 'assets/js/utm-builder.js', array(), BW_LEAD_AI_VERSION, true ); } public function render_page() { if ( ! current_user_can( 'manage_options' ) ) { return; } $tab = isset( $_GET['tab'] ) ? sanitize_key( wp_unslash( $_GET['tab'] ) ) : 'settings'; // phpcs:ignore WordPress.Security.NonceVerification.Recommended $tabs = array( 'settings' => __( 'Settings', 'bw-lead-ai' ), 'events' => __( 'Interactions', 'bw-lead-ai' ), 'handoff' => __( 'Handoff', 'bw-lead-ai' ), 'targets' => __( 'Form Fields', 'bw-lead-ai' ), 'utm' => __( 'UTM Builder', 'bw-lead-ai' ), 'test' => __( 'Test', 'bw-lead-ai' ), 'help' => __( 'Help', 'bw-lead-ai' ), ); if ( ! isset( $tabs[ $tab ] ) ) { $tab = 'settings'; } echo '
'; echo '

' . esc_html__( 'BW Lead Attribution Intelligence', 'bw-lead-ai' ) . '

'; echo '

'; foreach ( $tabs as $key => $label ) { $class = ( $tab === $key ) ? ' nav-tab-active' : ''; $url = add_query_arg( array( 'page' => self::PAGE_SLUG, 'tab' => $key, ), admin_url( 'options-general.php' ) ); echo '' . esc_html( $label ) . ''; } echo '

'; switch ( $tab ) { case 'events': $this->render_events_tab(); break; case 'handoff': $this->render_handoff_tab(); break; case 'targets': $this->render_targets_tab(); break; case 'utm': $this->render_utm_tab(); break; case 'test': $this->render_test_tab(); break; case 'help': $this->render_help_tab(); break; case 'settings': default: $this->render_settings_tab(); break; } echo '
'; } /** * Emit hidden inputs carrying every setting this tab does not itself render. * * All tabs post to the same option, and BW_Lead_AI_Settings::sanitize() falls * back to the DEFAULT for any key missing from the POST. Without this, saving * one tab silently resets everything the other tabs own. * * @param array $settings Current settings. * @param array $skip Keys this tab renders real inputs for. */ private function render_passthrough( $settings, $skip = array() ) { $opt = esc_attr( BW_LEAD_AI_OPTION ); foreach ( array_keys( BW_Lead_AI_Settings::defaults() ) as $key ) { if ( in_array( $key, $skip, true ) ) { continue; } $val = isset( $settings[ $key ] ) ? $settings[ $key ] : ''; // field_targets is the one nested setting — carry each leaf through. if ( 'field_targets' === $key && is_array( $val ) ) { foreach ( $val as $target_key => $row ) { printf( '', $opt, esc_attr( $target_key ), esc_attr( isset( $row['attr'] ) ? $row['attr'] : '' ) ); printf( '', $opt, esc_attr( $target_key ), esc_attr( isset( $row['val'] ) ? $row['val'] : '' ) ); } continue; } if ( is_array( $val ) ) { continue; } printf( '', $opt, esc_attr( $key ), esc_attr( $val ) ); } } private function render_settings_tab() { $settings = BW_Lead_AI_Settings::get(); $opt = esc_attr( BW_LEAD_AI_OPTION ); $standard_list = '' . implode( ', ', BW_Lead_AI_Settings::STANDARD_ALIAS_KEYS ) . ''; ?>
render_passthrough( $settings, array( 'parameter_aliases', 'referrer_classification', 'click_ids', 'channels', 'source_medium_separator', 'debug', 'capture_ga_client_id' ) ); ?>

label : value1, value2, .... One rule per line. Rules are walked in order — earlier rules win over later ones when both could match.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

$cust_vals ) { $other_lines[] = $cust_key . ' : ' . implode( ', ', $cust_vals ); } $other_text = implode( "\n", $other_lines ); ?>

Source and Medium are required — without them nothing else can be attributed, so they live in their own inputs and cannot be deleted. Enter URL parameter names comma-separated; earlier aliases win. Order matters: put utm_source first to prefer UTMs over custom conventions.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

Other dimensions & custom parameters. One per line, format label : param1, param2. The remaining built-ins are campaign, term, content, adgroup. Any other label becomes a custom dimension exposed as a merge tag {bw:your_label}.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array(), 'em' => array() ) ); ?>

match_type : mt, match, utm_match_type to track match type from any of those URL parameters, then use {bw:match_type} in a hidden form field.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

fallback only — explicit UTMs (utm_medium=cpc) and click-IDs always override these rules. Hostname matches are suffix-aware, so google matches www.google.co.uk.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

ai : openai.com, gemini.google.com, claude.ai, perplexity.ai to classify AI-referrer traffic under the ai medium.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

source/medium on the left. Format per line: source/medium : param1, param2.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

source / medium combinations to friendly channel labels (e.g. "Google Ads"). Rules are checked top-to-bottom; the first match wins. Unmatched visits fall back to the raw source / medium string.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

* to match any source or medium. In the label, {bw:source} and {bw:medium} are substituted with the actual visit values (useful for generic rules like {bw:source} : */referral). Exposed as merge tags {bw:channel} and {bw:first_channel}.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

client ID — the anonymous per-browser identifier Google Analytics stores in the _ga cookie — and expose it as {bw:ga_client_id}. Sending it with a lead lets that lead be joined back to its GA4 session in reporting or BigQuery.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

array() ) ); ?>
__( 'Plays and progress milestones for HTML5 <video>, YouTube and Vimeo embeds.', 'bw-lead-ai' ), 'download' => __( 'Clicks on links to files with one of the extensions below — on your site or off it.', 'bw-lead-ai' ), 'phone' => __( 'Clicks on tel: links.', 'bw-lead-ai' ), 'email' => __( 'Clicks on mailto: links.', 'bw-lead-ai' ), 'social' => __( 'Clicks on links to the social hostnames listed below.', 'bw-lead-ai' ), 'outbound' => __( 'Clicks on links to any other external site (anything not social and not a download).', 'bw-lead-ai' ), 'custom' => __( 'Clicks on elements you name yourself by CSS selector, below.', 'bw-lead-ai' ), 'scroll' => __( 'How far down the page the visitor read. Fires once per milestone per page.', 'bw-lead-ai' ), 'form_start' => __( 'The first time a visitor interacts with any form field — useful for spotting abandoned forms.', 'bw-lead-ai' ), ); ?>
render_passthrough( $settings, array( 'event_types', 'event_downloads', 'event_social_hosts', 'event_video_milestones', 'event_scroll_thresholds', 'event_custom_selectors' ) ); ?>

Everything here is off by default. With nothing ticked, no extra JavaScript is loaded and nothing changes anywhere — so leaving this tab alone costs a site nothing. Enabled interactions appear in {bw:summary}, and as the merge tags {bw:events}, {bw:events_list} and {bw:event.<type>}.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

Custom actions. One per line, format Label : selector1, selector2. Any click on a matching element (or inside one) is recorded under your label.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

Pricing CTA : .pricing-cta, #get-quote. Note that a custom match wins: if the element is also an outbound link or a download, only the custom action is recorded, so totals are not double-counted.', 'bw-lead-ai' ), array( 'code' => array(), 'em' => array() ) ); ?>

' . sprintf( /* translators: %d is a number of deleted records. */ esc_html__( 'Deleted %d handoff record(s).', 'bw-lead-ai' ), $purged ) . '

'; } ?>
render_passthrough( $settings, array( 'handoff_enabled', 'handoff_mode_data', 'handoff_mode_link', 'handoff_ack', 'handoff_domains', 'handoff_origins', 'handoff_param', 'handoff_ttl', 'handoff_retention', 'handoff_datapoints', ) ); ?>

The journey itself is never in the URL. What the destination can do with that token is decided by the two modes below.', 'bw-lead-ai' ), array( 'strong' => array() ) ); ?>

example.com covers portal.example.com.', 'bw-lead-ai' ), array( 'code' => array() ) ); ?>

Allowed origins — which sites may read the token. Leave empty to allow https:// plus each destination above, which is usually right. Set explicitly if the destination runs on a different scheme or port.', 'bw-lead-ai' ), array( 'code' => array(), 'strong' => array() ) ); ?>

__( 'Full summary', 'bw-lead-ai' ), 'source' => __( 'Source (last)', 'bw-lead-ai' ), 'medium' => __( 'Medium (last)', 'bw-lead-ai' ), 'sources' => __( 'Sources (all, comma-joined)', 'bw-lead-ai' ), 'terms' => __( 'Terms (all, comma-joined)', 'bw-lead-ai' ), 'first_page' => __( 'First landing page', 'bw-lead-ai' ), ); ?>

$label ) : ?> '', 'val' => '' ); ?>
home_url(), 'rest' => rest_url( BW_Lead_AI_REST::NAMESPACE_V1 . '/links' ), 'nonce' => wp_create_nonce( 'wp_rest' ), ) ); $options = get_option( BW_LEAD_AI_UTM_OPTION, array() ); if ( ! is_array( $options ) ) { $options = array(); } ?>

$item ) : $item = wp_parse_args( is_array( $item ) ? $item : array(), array( 'link_to_uri' => home_url(), 'utm_source' => '', 'utm_medium' => '', 'utm_campaign' => '', 'utm_term' => '', 'utm_content' => '', 'note' => '', ) ); ?>
__( 'Linked-to URL', 'bw-lead-ai' ), 'utm_source' => __( 'UTM Source', 'bw-lead-ai' ), 'utm_medium' => __( 'UTM Medium', 'bw-lead-ai' ), 'utm_campaign' => __( 'UTM Campaign', 'bw-lead-ai' ), 'utm_term' => __( 'UTM Term', 'bw-lead-ai' ), 'utm_content' => __( 'UTM Content', 'bw-lead-ai' ), ); foreach ( $fields as $fk => $fl ) : ?>

$group_full, 'label' => __( 'Google Ads — full UTM tagging', 'bw-lead-ai' ), 'note' => __( 'A properly tagged paid click with every dimension present.', 'bw-lead-ai' ), 'params' => array( 'utm_source' => 'google', 'utm_medium' => 'cpc', 'utm_campaign' => 'spring-sale', 'utm_term' => 'blue widgets', 'utm_content' => 'ad-variant-a', 'utm_adgroup' => 'widgets-exact', ), ); $out[] = array( 'group' => $group_full, 'label' => __( 'Facebook Ads — full UTM tagging', 'bw-lead-ai' ), 'note' => __( 'Paid social tagged explicitly rather than relying on fbclid.', 'bw-lead-ai' ), 'params' => array( 'utm_source' => 'facebook', 'utm_medium' => 'cpc', 'utm_campaign' => 'retargeting-q3', 'utm_content' => 'carousel-b', ), ); $out[] = array( 'group' => $group_full, 'label' => __( 'Email newsletter', 'bw-lead-ai' ), 'note' => __( 'Should land in the Email channel, not Direct.', 'bw-lead-ai' ), 'params' => array( 'utm_source' => 'newsletter', 'utm_medium' => 'email', 'utm_campaign' => 'july-roundup', ), ); // --- one row per configured click-ID source/medium pair ----------- $seen_pairs = array(); foreach ( BW_Lead_AI_Settings::parse_click_ids( $settings['click_ids'] ) as $row ) { $pair = $row['source'] . '/' . $row['medium']; if ( isset( $seen_pairs[ $pair ] ) ) { continue; } $seen_pairs[ $pair ] = true; $out[] = array( 'group' => $group_click, 'label' => sprintf( /* translators: 1: click-ID parameter name, 2: source/medium pair. */ __( '%1$s only → %2$s', 'bw-lead-ai' ), $row['param'], $pair ), 'note' => __( 'No UTMs at all — the source has to be inferred from the click ID.', 'bw-lead-ai' ), 'params' => array( $row['param'] => 'bwtest-' . $row['param'] ), ); } // --- minimal ------------------------------------------------------ $out[] = array( 'group' => $group_minimal, 'label' => __( 'Source only — utm_source=google', 'bw-lead-ai' ), 'note' => __( 'Source with no medium. Exercises step 2 of the cascade.', 'bw-lead-ai' ), 'params' => array( 'utm_source' => 'google' ), ); $out[] = array( 'group' => $group_minimal, 'label' => __( 'Completely untagged URL', 'bw-lead-ai' ), 'note' => __( 'Only what the browser reveals. Opened from here it is a Direct visit, because your own admin is a same-site referrer.', 'bw-lead-ai' ), 'params' => array(), ); // --- referrer-driven (preview only) ------------------------------- $referrers = array( array( 'https://www.google.com/search?q=blue+widgets', __( 'Google organic search', 'bw-lead-ai' ) ), array( 'https://www.bing.com/search?q=blue+widgets', __( 'Bing organic search', 'bw-lead-ai' ) ), array( 'https://www.facebook.com/', __( 'Facebook — organic, unpaid', 'bw-lead-ai' ) ), array( 'https://www.linkedin.com/feed/', __( 'LinkedIn — organic', 'bw-lead-ai' ) ), array( 'https://blog.example.net/post/', __( 'Unknown site — plain referral', 'bw-lead-ai' ) ), ); foreach ( $referrers as $ref ) { $out[] = array( 'group' => $group_referrer, 'label' => $ref[1], 'note' => sprintf( /* translators: %s is a referring URL. */ __( 'Untagged visit whose referrer is %s.', 'bw-lead-ai' ), $ref[0] ), 'params' => array(), 'referrer' => $ref[0], 'preview_only' => true, ); } // --- edge cases --------------------------------------------------- $out[] = array( 'group' => $group_edge, 'label' => __( 'UTM and gclid together', 'bw-lead-ai' ), 'note' => __( 'Both present at once — the UTM values must win over click-ID inference.', 'bw-lead-ai' ), 'params' => array( 'utm_source' => 'facebook', 'utm_medium' => 'social', 'gclid' => 'bwtest-conflict', ), ); // A non-UTM alias pair, if this site has any configured. $alt_source = ''; $alt_medium = ''; foreach ( $aliases['standard']['source'] as $alias ) { if ( 0 !== strpos( $alias, 'utm_' ) ) { $alt_source = $alias; break; } } foreach ( $aliases['standard']['medium'] as $alias ) { if ( 0 !== strpos( $alias, 'utm_' ) ) { $alt_medium = $alias; break; } } if ( '' !== $alt_source && '' !== $alt_medium ) { $out[] = array( 'group' => $group_edge, 'label' => sprintf( /* translators: 1: source alias, 2: medium alias. */ __( 'This site\'s own aliases — %1$s / %2$s', 'bw-lead-ai' ), $alt_source, $alt_medium ), 'note' => __( 'Uses your non-UTM parameter aliases instead of utm_source / utm_medium.', 'bw-lead-ai' ), 'params' => array( $alt_source => 'partner-site', $alt_medium => 'referral' ), ); } // One row covering every configured custom dimension at once. if ( ! empty( $aliases['custom'] ) ) { $custom_params = array(); $custom_keys = array(); foreach ( $aliases['custom'] as $key => $param_list ) { if ( empty( $param_list ) ) { continue; } $custom_params[ $param_list[0] ] = 'test-' . $key; $custom_keys[] = $key; } if ( ! empty( $custom_params ) ) { $custom_params['utm_source'] = 'google'; $custom_params['utm_medium'] = 'cpc'; $out[] = array( 'group' => $group_edge, 'label' => sprintf( /* translators: %s is a comma-separated list of custom dimension keys. */ __( 'Custom dimensions — %s', 'bw-lead-ai' ), implode( ', ', $custom_keys ) ), 'note' => __( 'A tagged visit that also carries every custom dimension you have defined.', 'bw-lead-ai' ), 'params' => $custom_params, ); } } // Normalise the optional keys so the JS never has to guess. foreach ( $out as $index => $scenario ) { $out[ $index ]['referrer'] = isset( $scenario['referrer'] ) ? $scenario['referrer'] : ''; $out[ $index ]['preview_only'] = ! empty( $scenario['preview_only'] ); } return $out; } private function render_test_tab() { wp_enqueue_script( 'bw-lead-ai-capture' ); wp_enqueue_script( 'bw-lead-ai-admin-test' ); wp_localize_script( 'bw-lead-ai-admin-test', 'bwLeadAITest', array( 'origin' => untrailingslashit( home_url() ), 'scenarios' => $this->test_scenarios(), ) ); ?>

resolves to column is computed live against this site\'s settings — your click-ID table, parameter aliases and channel mappings — so it doubles as a check that your configuration does what you expect. These are throwaway test links; they are not saved to the UTM Builder.', 'bw-lead-ai' ), array( 'strong' => array(), 'em' => array() ) ); ?>


(loading)

(loading)
(loading)
(loading)
{bw:source_medium}
{bw:campaign}
{bw:term}
{bw:first_page}
{bw:submit_page}
{bw:first_source} + {bw:source}
{bw:summary}

$cvals ) { printf( '', esc_html( $ckey ), esc_html__( 'Custom dimension, populated from URL parameters:', 'bw-lead-ai' ), esc_html( implode( ', ', $cvals ) ) ); } } ?>
{bw:source}
{bw:medium}
{bw:source_medium}
{bw:channel}
{bw:campaign}
{bw:term}
{bw:content}
{bw:adgroup}
{bw:first_page}
{bw:last_page}
{bw:submit_page}
{bw:first_source}
{bw:first_medium}
{bw:first_channel}
{bw:visits}
{bw:pages}
{bw:tagged_visits}
{bw:summary}
{bw:summary_detailed}
{bw:%1$s}%2$s %3$s