Advertisements(Ads) in Group Landing Page and Homepage

Description / Background

We are implementing a new feature on the group landing page setting. Currently, the advertisement menu on the admin dashboard is only for the static homepage section. Therefore, if there are restaurant ads on the homepage, it is not possible to create an advertisement form from the menu.

To address this, we are creating a new checklist for ads on the group landing page setting. This will allow the admin to add restaurant ads on the group landing page and create a homepage section for that group landing page.

This feature enhances the admin’s ability to promote restaurant ads more flexibly. Previously, the limitation to static homepage ads reduced the visibility of ads on group landing pages.

Glossary

https://app.clickup.com/9003122396/docs/8ca1fpw-35796/8ca1fpw-41516

Objectives

Users can see the ad label on the homepage section
Users can see the ad label on the group landing page section
Admins can set the ad restaurant for group landing page

Scope

Add ads settings on the Group Landing Page(Admin Dashboard)

How to Set Up Ads Restaurant on the Homepage

Open Admin Dashboard
Go to Group Landing Page and create a new group landing page
Select ‘Rank Manually’ as the outlet ranking option.
Choose the specific outlet and assign its rank.
Check the Ads option, then set the ad start and end dates.

Open Homepage Setting
Add a new Homepage setting
Pick GroupLandingPage on the Group Type ➝ Pick the Group Landing Page that you want to show on the homepage.

Sequence Diagram / Flow

sequenceDiagram
    participant Admin
    participant Dashboard
    participant GroupLandingPage
    participant HomepageSetting

    Admin->>Dashboard: Open Admin Dashboard
    Admin->>GroupLandingPage: Create/Edit Group Landing Page
    Admin->>GroupLandingPage: Enable Ads checkbox, set start/end dates
    GroupLandingPage-->>Dashboard: Save ads settings (is_ads, ads_start_date, ads_end_date)
    Admin->>HomepageSetting: Add new Homepage section
    Admin->>HomepageSetting: Select GroupLandingPage as group type
    HomepageSetting-->>Dashboard: Homepage section saved with ads group landing page

ERD

erDiagram
    glp_restaurant_ranks {
        boolean is_ads
        date ads_start_date
        date ads_end_date
    }
    group_landing_pages ||--o{ glp_restaurant_ranks : has

Backend Implementation

Add new ads checkbox, ads start date and ads end date date picker on edit group landing page
Add group landing page on group type on homepage section
Add is_ads, ads_start_date, ads_end_date to hh search service

https://github.com/hungryhub-team/hh-search/pull/69

https://github.com/hungryhub-team/hh-server/pull/6163

Method	Path	URL	Description	Payload

New Query

DB Schema / Database Migration

Add column :is_ads, :ads_start_date, ads_end_date in to glp_restaurant_ranks

{
  "is_ads": true,
  "ads_start_date": "2024-01-01",
  "ads_end_date": "2024-01-31"
}

Improvement:

Feature Name	Date	What Changed	Description

HungryHub Knowledge Base