The ticket is not compatible with the match definition

Issue

When you create a matchmaking ticket, the creation fails. The system returns the error: "The ticket is not compatible with the match definition." This error can occur when you use a rule to match players based on a shared identifier, such as a custom room ID.

Environment

• Unity Matchmaker
• A custom matchmaking pool
• A rule that uses the Equality type to check a value in Players.CustomData

Cause

The error message indicates that a ticket cannot satisfy the rules of the match pool it enters. This issue has two primary causes:

• Incorrect Data Structure: The matchmaking ticket sends the custom data (e.g., roomId) as a top-level attribute. However, the rule's source path (Players.CustomData.roomId) expects this data to be inside a CustomData object for each player. The Matchmaker cannot find the data at the specified path and rejects the ticket.
• Incorrect Rule Scope: The rule is defined as a TeamRule. A TeamRule only enforces that all players within the same team have the same value. To ensure all players in the entire match share the same value, a MatchRule is required.

Resolution

To resolve this issue, you must align the ticket's data structure with the rule's expectation and use the correct rule scope.

1. Update the Pool Configuration
   • Open your match definition configuration.
   • Move the custom data rule from the TeamRules array to the MatchRules array. This ensures the rule applies to all players in the match.
2. Update the Ticket Data Structure
   • When you create a matchmaking ticket, ensure the custom data is passed within the customData object for each player. Do not pass it as a top-level attribute.