For the complete documentation index, see llms.txt. This page is also available as Markdown.

Event

Describes the APIs used on the event page, which call event information registered in the X2BEE BO.

Event types

  • Drawing events: simple click, survey, comment, purchaser drawing

  • Non-drawing events: purchase gift, attendance check, coupon download, roulette

On November 6, 2023, the roulette and purchaser drawing event features were added, and descriptions for each event were added.


PC

Mobile


Event Page (Common)

Events commonly use the same APIs.

APIs needed for events beyond these are described separately.

1. List Lookup

You can look up the event list using various conditions, such as display period, display status, and progress status.

The results include the registered events' images, titles, and schedule information.

-Applicable event types: general entry / comment / attendance check / purchase gift / coupon download

  • Look up event list(🔗View API >) Looks up events matching conditions such as display period, display status, and progress status.

2. Event Detail Lookup

You can look up detailed event information. Use this API to look up detailed information for general entry, comment, attendance check, purchase gift, and coupon download events.

  • Look up event details (🔗View API >) Looks up detailed information about the event.

3. Event Entry

The API for entering any event type provided by X2BEE. Use this API to enter general entry, comment, attendance check, purchase gift, coupon download, and survey events, among other types.

  • Integrated event entry(🔗View API >)

    • Provides an event entry format for each of the following event types:

      • Drawing events: simple click, survey, comment, purchaser drawing

      • Non-drawing events: attendance check, purchase gift, coupon download, roulette

Describes how the “Look up event details” and “Event entry” APIs behave depending on the event type. For the API for the following event types, please refer to Event Page (Common)

4. Attendance Check Event

4.1 Look Up Attendance Check Event Details

You can look up the event's basic information, the customer's attendance check information, and the number of times attendance has already been checked.

4.2 Enter Clicking the [Check In] button processes attendance and grants the benefit.

5. Purchase Gift Event

5.1 Look Up Purchase Gift Event Details

You can look up the event's basic information and the member's order information list to check whether the specified target amount has been reached.

5.2 Enter

Once your purchase amount meets the event conditions, you can click the [Enter] button to enter the event.

6. Comment Event

6.1 Look Up Comment Event Details

You can look up the comment event's basic information and the list of registered comments.

6.2 Register (Enter)

Once a comment is entered in that event's comment field, the [Register] button becomes active; clicking it registers the comment and enters the event at the same time.

7. Coupon Event

7.1 Look Up Coupon Event Details

You can look up the coupon event's basic information.

7.2 Download Coupon

Clicking the [Download] button for a coupon registered to that event downloads the coupon.

8. Roulette Event

8.1 Look Up Event Details

You can look up the roulette event's basic information.

8.2 Enter the Event

You can participate in a roulette event by clicking the [START] button, and immediately receive the prize based on the winning result.

9. Purchaser Drawing Event

9.1 Look Up Event Details

You can look up the event's basic information and the member's order information list to check whether the specified target amount has been reached. The screen is the same as the purchase gift event.

9.2 Enter the Event

Clicking the [Enter] button registered for that event completes the entry.

The difference between 5. Purchase Gift Event and 9. Purchaser Drawing Event is as follows, being non-drawing and drawing events respectively:

  • Purchase gift: After reaching the target amount and entering the event, the winner is determined and the gift is provided *14 days after the event end date *The winner determination and gift provision date can be set by the operator.

  • Purchaser drawing: After reaching the target amount and entering the event, the operator carries out a winner drawing process and provides the prize to the winner


Comment Event - Edit/Delete Comment

Provides a feature for logged-in users to participate in comment events and view comments.

1. View More Comments

  • Look up event comments (🔗View API >) Looks up the list of comments written for the event number, with pagination.


Survey Event - List and Detail Page

The survey event can be accessed via customer reviews.

1. Survey Event List

You can create a list by looking up the status, title, and period information of registered survey events.

  • Look up event customer review (survey) list (🔗View API >) Looks up events registered in the BO.

2. Survey Event Detail Page

You can look up the detailed content of the survey event and select and click items.

  • Look up event customer review (survey) details (🔗View API >) Looks up the survey event's content and questions.

3. Survey Event Entry

Once a survey selection is complete, the Enter button becomes active.

Clicking the [Enter] button completes the entry.

For the survey event entry API, please refer to 3. Event Entry in the event document.


Event Participation History Page

You can check information about events the customer has participated in.

1. Event Participation History

Customers can view a list of their event participation history.

  • Look up event participation history (🔗View API >) Looks up the history of events participated in.