How the Smartfeed Engine Works

The Smartfeed engine takes a product from the content feed from the portal / CMS and creates users and product listings in the Flow database. This data is then used to create ads based on predefined triggers and expected values. The engine is based on two key steps:

1. Feed Parser: Here the feed, whether from an API, XML feed, or CSV, is recursively parsed with listeners attached to predefined fields as triggers for new campaign creation

2. Triggers & Packages: The trigger fields configured for each enterprise integration are mapped to corresponding Campaign Packages. If a corresponding value is found then a campaign and/or subscription is created for that user or property listing

Packages: Trigger values configured for an integration are mapped to a corresponding Flow package template, which is agreed upon and configured upfront with the enterprise partner. These packages define the duration, channels, and budget of the campaigns that will be created from the Smartfeed engine.

Understanding Content Feed Behaviour with Smartfeed

Listing Lifecycle in the Content Feed

• Live Listings: Any listing appearing in the content feed (e.g., CSV or API) is assumed to be live and active in the Flow system

• Removing Listings: When a listing is removed from the content feed, the system interprets this as the listing being unpublished or archived on the client’s side. Consequently:

  • The listing is archived in Flow and no longer considered active.

  • The associated URL (landing page) becomes invalid

Campaign Behaviour in Response to Content Feed Changes

1. Trigger-Based Campaign Creation:

• When a listing enters the system and meets a configured trigger (e.g., listingTier set to gold), a campaign is created automatically.

• The listing is treated as active, and the campaign runs based on the trigger.

1. Impact of Removing Listings During an Active Campaign:

• If a listing is removed from the content feed while its campaign is still active:

  • The system assumes the listing is unpublished.

  • The associated ad is paused (e.g., on platforms like Facebook) to prevent redirection to an invalid landing page.

Important: Listings should remain in the content feed for the full duration of the campaign to avoid issues with ad visibility and user experience.

1. Switching Trigger Fields Off During a Campaign:

• If the trigger field (e.g., listingTier) is changed from a value like gold to null or an invalid state:

  • The system unsubscribes the listing from campaign renewals.

  • Effect on Ongoing Campaigns: The existing campaign continues until its scheduled end. For example:

    • A 7-day campaign that is unsubscribed on day 2 will still run for the remaining 5 days.

1. Recurring Campaign Creation:

• When a trigger remains active (e.g., listingTier set to gold) after a campaign ends:

  • A new campaign is automatically created.

  • This continues recursively for as long as the trigger condition is met.

• Optional One-Time Publishing: If configured, the system can limit campaign creation to one instance per trigger, regardless of the trigger’s duration.