Dynamic Links Other Functions
| Topic / function | Dynamic Links |
|---|---|
| Audience | Project Owner / Admin / CRM Manager / Marketing Manager / Implementation Manager / Developer |
| Goal | Extend standard Dynamic Links with technical configuration, survey pre-filling, deep-link behavior, QR-code reuse, and ongoing link management. |
Other functions covered
- ACTION_CONFIG: Pass predefined technical values when a Dynamic Link is executed.
- Pre-filled Survey Context: Use one survey with separate venue-specific links.
- Deep Links: Open supported app content directly, with Client Zone web fallback.
- Reusable QR Codes: Change the destination without replacing the distributed URL.
- Link Management: Edit, duplicate, unpublish, or delete existing links.
ACTION_CONFIG
ACTION_CONFIG is an optional JSON object used to pass additional configuration when a Dynamic Link is executed.
A common use case is pre-filling one or more answers in a survey.
Survey pre-fill structure
{
"SURVEY_UUID": {
"QUESTION_UUID": "PRE_FILLED_VALUE"
}
}To pre-fill several answers:
{
"SURVEY_UUID": {
"QUESTION_UUID_1": "PRE_FILLED_VALUE_1",
"QUESTION_UUID_2": "PRE_FILLED_VALUE_2",
"QUESTION_UUID_3": "PRE_FILLED_VALUE_3"
}
}How to read the configuration
| Part | Meaning |
|---|---|
| SURVEY_UUID | ID of the survey opened by the Dynamic Link. |
| QUESTION_UUID | ID of the survey question or survey node that should receive a predefined answer. |
| PRE_FILLED_VALUE | Value stored as the answer when the Dynamic Link opens the survey. |
ACTION_CONFIGmust contain valid JSON. Incorrect IDs, invalid JSON syntax, or a value incompatible with the question can prevent the pre-fill from working.
The Survey UUID is normally visible in the survey URL. Question or node UUIDs may require technical inspection or assistance from the implementation or development team.
Use case: one survey with a pre-filled venue
This setup is useful when the same survey is used at several venues but the venue should be identified automatically.
Principle
- Create one common survey.
- Add a question that stores the venue ID or venue name.
- Create one Dynamic Link for each venue.
- Point every Dynamic Link to the same survey.
- Use a different
ACTION_CONFIGvalue in each link. - Encode each Dynamic Link into the QR code used at the corresponding venue.
When a member scans the QR code, the correct venue answer is pre-filled in the background. The member does not need to select the venue and the pre-filled question is not displayed during the survey.
Example
Survey ID:
e26e1cf9-a2ee-4d98-9704-70d57a1707a2Venue question ID:
019db586-d0cb-76ab-aee9-24663dedf691Dynamic Link for Venue A:
{
"e26e1cf9-a2ee-4d98-9704-70d57a1707a2": {
"019db586-d0cb-76ab-aee9-24663dedf691": "venue-a"
}
}Dynamic Link for Venue B:
{
"e26e1cf9-a2ee-4d98-9704-70d57a1707a2": {
"019db586-d0cb-76ab-aee9-24663dedf691": "venue-b"
}
}Setup steps
- Create the survey and the question that will store the venue.
- Obtain the Survey UUID and the UUID of the venue question.
- Open Engagement → Dynamic Links.
- Create a separate Dynamic Link for each venue.
- Set the destination to the common survey.
- Add the venue-specific JSON to
ACTION_CONFIG. - Save and copy the generated
/link/{code}path. - Add the Client Zone domain.
- Generate one QR code for each complete URL.
- Test that each QR code stores the correct venue answer.
This approach can also be used for other predefined context, such as campaign source, event location, store code, printed-material variant, or another value that should not be selected manually by the member.
Deep Links
Deep Links open a specific supported destination directly instead of sending the member to the Client Zone homepage.
When the TRIFFT Mobile App is installed, the supported link opens the relevant screen in the app. When the app is not installed, the same link opens the Client Zone in the device's web browser.
Coupon detail example
https://yourclientzone.trifftloyalty.com/coupon/1a4e8721-888f-4bff-b0b6-9d306f728973This URL opens the detail of the coupon with ID:
1a4e8721-888f-4bff-b0b6-9d306f728973Recommended usage
- QR codes placed next to a specific promotion.
- Email or SMS links to a specific coupon.
- Printed materials that should open an app section directly.
- Campaign destinations that need an app-first experience with web fallback.
Testing
Test every Deep Link:
- On a device with the Mobile App installed.
- On a device without the Mobile App.
- As a logged-in member.
- As a logged-out visitor.
- With a member who is eligible for the linked content.
- With a member who is not eligible, when eligibility restrictions apply.
The linked content must exist and be available to the member. A correct URL cannot override coupon visibility, segment eligibility, consent requirements, validity, or other content rules.
Reuse a printed QR code
A major benefit of a Dynamic Link is that the generated public path can remain stable while its destination is changed.
Example:
https://yourclientzone.trifftloyalty.com/link/6PA0PVAfter this URL is printed as a QR code, you can edit the existing Dynamic Link and change its destination. The QR code still points to the same generated path, but TRIFFT resolves the updated configuration.
Use this when:
- Seasonal content changes regularly.
- A printed campaign should later open a new survey or coupon.
- A location uses permanent signage.
- A campaign destination needs to be corrected after distribution.
Edit the existing Dynamic Link. Creating a new Dynamic Link generates a different path and requires a new QR code.
Manage an existing Dynamic Link
Open the Dynamic Link detail to access the available actions.
Edit
Change the title, description, validity, destination, or ACTION_CONFIG.
Duplicate
Create a new Dynamic Link using an existing configuration as the starting point. The duplicate receives its own generated public path.
This is useful for venue-specific links that share the same destination but use different ACTION_CONFIG values.
Unpublish
Temporarily disable the link without deleting its configuration.
Use this when:
- A campaign is paused.
- A destination is temporarily unavailable.
- The link must be disabled while an issue is investigated.
Delete
Permanently remove the Dynamic Link.
Before deletion, confirm that its URL or QR code is no longer distributed or displayed.
Ongoing management checklist
Technical Configuration
ACTION_CONFIGis valid JSON.- Survey and question UUIDs are correct.
- Every venue-specific link stores the intended value.
- Deep Links use the correct Client Zone domain and content ID.
Operations
- Distributed QR codes are mapped to their Dynamic Link names.
- Published links have valid destinations and validity periods.
- Links are tested after every edit.
- Old links are unpublished before they are deleted.
- Duplicated links have unique names and the correct configuration.
Updated 2 days ago
