WC_Tracks::record_event()public staticWC 1.0

Record an event in Tracks - this is the preferred way to record events from PHP. Note: the event request won't be made if $properties has a member called error.

Метод класса: WC_Tracks{}

Хуков нет.

Возвращает

true|false|WP_Error. True for success or WP_Error if the event pixel could not be fired.

Использование

$result = WC_Tracks::record_event( $event_name, $event_properties );
$event_name(строка) (обязательный)
The name of the event.
$event_properties(массив)
Custom properties to send with the event.
По умолчанию: array()

Код WC_Tracks::record_event() WC 8.6.1

public static function record_event( $event_name, $event_properties = array() ) {
	/**
	 * Don't track users who don't have tracking enabled.
	 */
	if ( ! WC_Site_Tracking::is_tracking_enabled() ) {
		return false;
	}

	$user = wp_get_current_user();

	// We don't want to track user events during unit tests/CI runs.
	if ( $user instanceof WP_User && 'wptests_capabilities' === $user->cap_key ) {
		return false;
	}
	$prefixed_event_name = self::PREFIX . $event_name;
	$properties          = self::get_properties( $prefixed_event_name, $event_properties );
	$event_obj           = new WC_Tracks_Event( $properties );

	if ( is_wp_error( $event_obj->error ) ) {
		return $event_obj->error;
	}

	return $event_obj->record();
}