Automattic\WooCommerce\Admin\Features\Fulfillments

FulfillmentsTracker::track_fulfillment_tracking_lookup_attempt │ public static │ WC 10.7.0

Track when a tracking number auto-lookup is attempted.

Tracked from: FulfillmentsManager::try_parse_tracking_number(). Measures: Effectiveness of auto-detection. A high failure rate indicates the need to improve carrier detection logic. The url_generated flag checks if a functional tracking URL was constructed (a success requires both provider identification AND URL generation).

Method of the class: FulfillmentsTracker{}

No Hooks.

Returns

null. Nothing (null).

Usage

$result = FulfillmentsTracker::track_fulfillment_tracking_lookup_attempt( $lookup_status, $provider_identified, $url_generated ): void;

$lookup_status(string) (required)

The lookup result ("success" or "not_found").

$provider_identified(string) (required)

The standardized carrier name identified (e.g., "usps"). Empty if not found.

$url_generated(true|false)

Whether the system successfully constructed a tracking URL.
Default: false

Changelog

FulfillmentsTracker::track_fulfillment_tracking_lookup_attempt() FulfillmentsTracker::track fulfillment tracking lookup attempt code ^{WC 10.7.0}

public static function track_fulfillment_tracking_lookup_attempt( string $lookup_status, string $provider_identified, bool $url_generated = false ): void {
	WC_Tracks::record_event(
		'fulfillment_tracking_lookup_attempted',
		array(
			'lookup_status'       => $lookup_status,
			'provider_identified' => $provider_identified,
			'url_generated'       => $url_generated,
		)
	);
}