Qualify

Opportunity Qualification

Opportunity Registry partners can use the /qualify endpoint to check if opportunities are a match for respondents. The /qualify will return relevant information for each opportunity.

Match

Opportunities that are a match will return qualified: true, and exact_match: true if it’s a 100% match. If the opportunity returns qualified: true and exact_match: false additional pre-screening will be required.

High Priority Opportunities

Dynata strongly recommends prioritizing opportunities groups with priority: true. These opportunities have a higher conversion and may target individual respondents.

Inbound

The start_url provided in the qualify response contains an extended context (ctx) with information related to the pre-qualification. It’s respondent specific, and time sensitive. Partners should use this start_url as the basis for building the inbound (entry URL), instead of the link.live URL provided in the opportunity nofication.

Please Note

• Partners do not need to append the respondent ID or any attribute information to start_url.
• Partners should still append any custom tracking parameters and the entry URL must be signed using the Dynata signing algorithm

Mismatch

If an opportunity is a mismatch for a respondent, it will return qualfied: false. Each unqualified opportunity will include a dispositions array containing one or more disposition and status objects that describe why the opportunity group was not a match.

Fingerprinting Data

To mitigate duplicates, partners are strongly encouraged to pass respondent fingerprinting_data with each qualify request. Including ip_address, device_type, height (device height in pixels), width (device width in pixels), and http_headers in the request will help verify quota_group_ids that will result in duplicate dispositions. At a minimum, partners should send the ip_address and device_type.