Core concepts

Four ideas explain how the Frak SDK turns your app into a rewarded referral program: configuration, interactions, backend-driven config, and placements. This section introduces each one before the integration guides put them to use.

Key concepts

1. Configuration Set up and customize the SDK for your application.

2. Interactions Record user actions such as arrivals, shares, and custom events, the basis for rewards.

3. Backend-driven configuration Learn how the SDK automatically resolves merchant configuration from the Frak backend.

4. Placements Customize SDK component text and behavior per page or section of your website.

Understanding the flow

The Frak SDK operates on a simple flow:

1. Configuration: You set up the SDK with your merchant parameters.
2. Sharing: Customers share a personal, tracked link for your product or store.
3. Interactions: As users interact with your application (arrivals, shares, purchases), you record these with the SDK.
4. Purchase tracking: A confirmed sale, tracked from the browser and validated by your backend webhook, triggers a reward.
5. Rewards and campaigns: Based on these interactions, the ambassador and the friend who bought both get a reward, defined by the campaign you set up in the business dashboard.

Key features

• Flexible integration: The SDK works with React, vanilla JavaScript, and native Android and iOS apps.
• Interaction tracking: Record arrivals, shares, and custom events for your referral program.
• Double-sided rewards: Reward both the ambassador and the friend who bought, tied to your campaign rules.
• Backend-driven config: Manage branding, text, and placements from the business dashboard without redeploying.
• Referral tracking: Attribute a sale back to the link that drove it.

Dive into each concept to learn how it works and how to use it in your integration.

Note

For implementation details, see the Developers overview and the Get started guides.