Wpd Ai Event Tracking Block Request By Data

Alpha Insights Documentation

Docs Navigation

Filter: wpd_ai_event_tracking_block_request_by_data

Decide whether to block an event from being stored based on the prepared event payload.

Description

After normalizing the event data, the plugin may set $block_request = true when the request URL does not contain the site domain (e.g. to avoid storing events from other sites). This filter receives that decision and the full $data array so you can add your own rules (e.g. block by event_type, user_id, or custom fields). Return true to block the event (it will not be inserted).

Location

File: includes/classes/WPDAI_Woocommerce_Event_Tracking.php

Method: Used when validating whether to block the request based on event data (e.g. page_href not containing site domain).

Parameters

Parameter Type Description
$block_request bool Whether the request is currently marked to be blocked
$data array The prepared event payload (e.g. session_id, page_href, event_type, event_value, additional_data, etc.)

Return

Type: bool

True to block the event; false to allow it to be stored.

Example Usage

Block events with zero value

add_filter( 'wpd_ai_event_tracking_block_request_by_data', 'block_zero_value_events', 10, 2 );
function block_zero_value_events( $block_request, $data ) {
    if ( isset( $data['event_value'] ) && (float) $data['event_value'] 

Block specific event types

add_filter( 'wpd_ai_event_tracking_block_request_by_data', 'block_internal_events', 10, 2 );
function block_internal_events( $block_request, $data ) {
    $blocked_types = array( 'internal_test', 'debug_click' );
    if ( ! empty( $data['event_type'] ) && in_array( $data['event_type'], $blocked_types, true ) ) {
        return true;
    }
    return $block_request;
}

Related Filters

Got A Question?

Subscribe
Notify of
guest
0 Comments
Newest
Oldest Most Voted
Inline Feedbacks
View all comments
Alpha Insights

Alpha Insights

The World's Most Advanced WooCommerce Profit Reporting Engine

5/5 – Trustpilot

Alpha Insights