# Start Here Pick a path and finish your first milestone. * **Partner Seller**: first sale setup (Shopify + fulfillment). * **Creator**: first reward withdrawal (events + wallet). ### Choose your path
TitleTarget
Partner Seller onboarding (recommended)/spaces/KmVnLoHDk5ZkU3shqZqa/pages/UNrLhw6O1Vm7MB7Dz2NX
Creator onboarding (recommended)/pages/kxOAPXbVfA3qb7B26ppz
Policies and troubleshooting (Reference)/spaces/KmVnLoHDk5ZkU3shqZqa/pages/FAxXyY34nBr4Ijwn0edw
### Partner Seller: what you need before starting * Shopify store admin access * Hypercape BIZ account access * A test product and a test order scenario ### Partner Seller: recommended first run (do this in order) {% stepper %} {% step %} ### 1) Connect Shopify Connect your store and verify API permissions. Go to [Step 1. Connect Shopify](/connect-shopify-guide/step-1.-connect-shopify). {% endstep %} {% step %} ### 2) Import products Import 3 products, send to Shopify, and activate them. Go to [Step 2. Import Products](/connect-shopify-guide/step-2.-import-products). {% endstep %} {% step %} ### 3) Run one real paid order end-to-end Sync the order, pay (PayPal + Prepayments), then confirm tracking. Go to [Step 3. Sync & Fulfill Orders](/connect-shopify-guide/step-3.-sync-and-fulfill-orders). {% endstep %} {% endstepper %} {% hint style="info" %} Customs/duty in the destination country is generally borne by the importer (your customer). {% endhint %} ### Partner Seller: if something breaks Most common issues are already covered here: * Common questions: [\[Partner Seller\] FAQ](/reference/partner-seller-faq) * Orders don’t appear after sync: [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting) * Shipping cost and margin basics: [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin) * Customs/duty and returns: [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance) ### Creator: recommended flow {% stepper %} {% step %} ### 1) Discover events Go to [Step 1. Discover Events](/creator-guide/step-1.-discover-events). {% endstep %} {% step %} ### 2) Apply to an event Go to [Step 2. Apply to an Event](/creator-guide/step-2.-apply-to-an-event). {% endstep %} {% step %} ### 3) After selection Shipping address + (content campaigns only) submission. Go to [Step 3. After Selection](/creator-guide/step-3.-after-selection). {% endstep %} {% step %} ### 4) Shipping & tracking Go to [Step 4. Shipping & Tracking](/creator-guide/step-4.-shipping-and-tracking). {% endstep %} {% step %} ### 5) Earnings & withdrawal Go to [Step 5. Earnings & Withdrawal](/creator-guide/step-5.-earnings-and-withdrawal). {% endstep %} {% endstepper %} ### Creator: reference * Profile, eligibility, payout: [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile) * Common questions: [\[Creator\] FAQ](/reference/creator-faq) ### Support Email: **** # Kangaroo Brand Preview 브랜드가 캠페인을 생성하고 운영하는 전체 흐름을 안내합니다. ### 1. 캠페인 생성 1. 좌측 메뉴에서 \*\*\[캠페인] → \[이벤트]\*\*를 클릭합니다. 2. 우측 상단의 \*\*\[캠페인 생성]\*\*을 클릭합니다. 3. 새 캠페인 설정을 시작합니다. ### 2. 기본 설정 항목 * **참가 방식**: 회원 전용 또는 비회원 포함 여부를 선택합니다. * **배송 방식**: Hypercape 위탁 배송 또는 브랜드 직접 배송을 선택합니다. * **문의 메일**: CS 대응용 브랜드 담당자 메일을 입력합니다. * **제품 굿즈**: 시딩할 제품 또는 굿즈를 지정합니다. ### 3. 상세 정보 및 양식 설정 * **캠페인 설명**: 크리에이터 페이지에 노출될 상세 내용을 입력합니다. * 에디터를 사용해 이벤트 내용을 보기 쉽게 구성할 수 있습니다. 실제 이벤트 예시: [creator.hypercape.com 이벤트 예시](https://creator.hypercape.com/events/2297ea44-4c5c-4b1d-b559-54d0c5de27d4) * **참가 양식**: 이름, 주소, 연락처 외에도 필요한 정보를 추가 문항으로 수집할 수 있습니다. ### 4. 운영 관리 탭 가이드
* **신청자 탭**: 신청자 목록을 확인하고 최종 시딩 대상을 선정합니다.
* **배송 탭**: 선정된 인원의 배송 상태를 관리합니다. * 브랜드 직접 배송 시 배송사와 운송장 번호를 엑셀로 일괄 업로드할 수 있습니다.
* **콘텐츠 탭**: 크리에이터 제출 콘텐츠를 검수합니다. * 가이드라인 준수 여부를 확인한 뒤 확정 또는 미확정 처리합니다. # Mini Mall Simple Guide ## Mini Mall Simple Guide This guide explains Mini Mall in the simplest way possible. Mini Mall is a small public shopping page you can make in Hypercape. It shows your intro image, your product list, and a public link that visitors can open.\ \ 🛍️ **mini-mall example** : {% hint style="success" %} **You can earn H-Point from eligible Mini Mall sales.** The current Mini Shop sales reward is `15%` of product sales, excluding shipping, customs duties, and tax. {% endhint %} {% hint style="info" %} The fastest way to get familiar with Mini Mall is to **try it yourself** — and we’ll **continue adding more features** to help you **grow**. {% endhint %} *** ### 1. What Is Mini Mall?
Mini Mall is a quick shopping page for creators. Use it when you want to: * Show a simple brand intro. * Pick products you want to recommend. * Share one public shopping link. * Check orders after people buy. * Convert earned H-Point through Olivo later. The important idea is simple: | If this happens | What it means | | ------------------------------------------------------- | ------------------------------------------------------------- | | A visitor buys eligible products through your Mini Mall | You can earn H-Point from the product sales amount. | | The order includes shipping, customs duties, or tax | Those amounts are not included in the 15% reward calculation. | | The order is refunded or returned | The related H-Point may not become available. | {% hint style="info" %} Think of Mini Mall as your short shopping link, not a full website. First, make it clear and easy to buy. You can improve the design later. {% endhint %} *** ### 2. Build Mini Mall In 4 Steps
Do not try to understand every button on the first day. Build the page in this order: 1. `Theme` - choose Mini Mall and set the first look. 2. `Products` - choose what you want to sell. 3. `Sections` - edit the banner, product area, and footer. 4. `Publish` - check the public page and share the link. {% hint style="info" %} Detailed pages for Theme settings, product badges, Creator notes, Main banner controls, and Product section controls will be added later. This page only covers the fastest path. {% endhint %} #### Step 1. Theme Choose the Mini Mall page type and set the basic look.
In this step, you mainly check the first look: | Area | What to set | | ----------------- | --------------------------------------------- | | Text logo | Logo text, font style, color, and size. | | Subtitle | One short line that explains the shop mood. | | Theme live canvas | The desktop and mobile preview before saving. | Do this: * Select `Theme`. * Check the `Text logo` settings. * Add or edit the `Subtitle`. * Check the `Theme live canvas` on the right. * Use `Desktop` and `Mobile` preview if you need to check both layouts. * Select `Save`. Before moving on, make sure the wordmark and subtitle are easy to read on the main image. #### Step 2. Products Choose the products that will appear in your Mini Mall.
Do this: * Search for products. * Add the products you want to recommend. * Put the most important products near the top. * Add a short `BADGE` or `CREATOR NOTE` only when it helps visitors understand the product. * Select `Save`. Before moving on, remove test products, sold-out products, and products that are not ready to sell. #### Step 3. Sections Sections are the parts of your public page.
For a simple Mini Mall, focus on these things: | Section | What to check | | ----------- | -------------------------------------------------------------------------------------- | | Main banner | The first image, web and mobile ratio, background color, and short intro mood. | | Info | Brand, social, and custom information cards. | | Social Feed | The compact feed dock on the main banner and the social media tiles visitors can open. | | Products | Product card size and collections. | | Footer | Support, company, and legal information. | Do this: * Select `Main banner` and check the desktop image, mobile image, ratio, and background color. * Select `Info` and keep only useful cards, such as brand, social, contact, or custom information. * Select `Social Feed`, add a tile, paste an Instagram post/reel/tv URL, then select `Fetch thumbnail`. * Select `Products` and check the product card size, product order, and collection labels. * Select `Footer` and confirm support, company, social, and legal information. For Social Feed, use a direct Instagram content URL such as `https://instagram.com/p/...` or `https://instagram.com/reel/...`, then select `Fetch thumbnail`. If the thumbnail does not load, try another Instagram URL before saving.
For `Products`, use `Collections` to group related products, such as bestsellers, routines, or body care, so visitors can browse faster.
Keep the text short. Visitors should understand what the page sells in a few seconds. #### Step 4. Publish Publish is the final check before visitors see the page.
Do this: * Confirm the version is `Mini Mall`. * Check the public link. * Fix any footer warning. * Open `Visit Shop` and look at the real public page. * If it looks correct, publish or keep it public. {% hint style="warning" %} `Save` stores your edits. `Publish` applies the saved page to the public page visitors can see. {% endhint %} *** ### 3. Check Order History
After visitors buy from your Mini Mall, check the order in `Orders`. Open it from: `Profile` -> `Mini Shop` -> `Orders`
Use this page to check: | Area | What to look at | | -------------- | -------------------------------------------------------------------- | | Order card | Order number, order date, product count, and payment amount. | | Status badge | Whether the order is paid, cancelled, refunded, or in another state. | | Line items | Which products were ordered and how many. | | Order timeline | What happened to the order over time. | If something looks wrong, open `Order timeline` first. It usually explains whether the order was paid, cancelled, refunded, or updated. *** ### 4. Convert Through Olivo
Use `My Wallet` to check H-Point and request conversion. Open it from: `Profile` -> `Wallet` -> `My Wallet`
#### H-Point Policy {% hint style="warning" %} **Policy:** `Pending H-Point` cannot be converted. Only `Available H-Point` can be used for conversion. {% endhint %} | Policy | Simple explanation | | -------------- | ------------------------------------------------------------------------------------------------------------------- | | Sales reward | Eligible Mini Mall product sales currently earn `15%`, excluding shipping, customs duties, and tax. | | Pending period | H-Point from Mini Mall sales becomes available 7 days after delivery only if there is no refund or return issue. | | Minimum amount | Conversion currently starts from `1,000 HP`. Olivo also checks a `10 USD` minimum. | | Quote first | Use `Get Quote` before submitting. It shows whether the request can continue. | | Wallet check | You need a verified `One Vault Email` so the recipient wallet can be found. | | Not instant | Submitting creates an Olivo payout request. H-Point is debited only after admin and payout processing are complete. | #### Simple Conversion Flow 1. Check `Available H-Point`. 2. Select `Convert to USDC`. 3. Enter the amount. 4. Verify the `One Vault Email`. 5. Select `Get Quote`. 6. If the quote is eligible, submit the request. 7. Check the request status in `Olivo Requests`. 8. Check the final ledger in `Transactions`. *** ### Quick Final Checklist
Before sharing your Mini Mall link, check these: | Check | Done | | -------------------------------------------------------- | ---- | | Storefront version is `Mini Mall`. | | | Main image and logo are easy to read. | | | Products are ready to sell. | | | Important products are near the top. | | | Footer information is complete. | | | The public link opens correctly. | | | You know where to check `Orders`. | | | You know that only `Available H-Point` can be converted. | | Start simple: choose the page style, add products, check the page sections, publish, then review orders and H-Point after sales happen. # Storefront Mall ## Storefront Mall Storefront Mall is a public shopping page created and managed in Hypercape.\ It is not just a product listing page. It is a storefront where you can organize products, banners, reviews, guide messages, and brand content in one place. The editor is designed so you can build the storefront step by step on one screen. First, choose the overall design, then add products, arrange the sections that will appear on the page, and finally preview and publish the storefront for visitors. {% hint style="info" %} In this guide, **Save** means saving your current edits as a draft.\ **Publish** means applying the saved content to the public storefront that visitors can see. {% endhint %} ### Terms to Know First
Term shown on screenSimple explanation
Storefront MallA public shopping page created in Hypercape.
ThemeThe overall design of the storefront, including logo, colors, typography, and layout style.
ProductsThe step where you choose which products appear in the storefront and decide their order.
SectionsContent areas shown on the storefront, such as banners, product blocks, reviews, guide messages, and footer content.
PreviewA feature that lets you check how the storefront will look before visitors see it.
SaveSaves your current edits. Saving alone may not update the public storefront yet.
PublishApplies the saved content to the public storefront that visitors can access.
### Basic Creation Flow | Step | What you do | What gets saved | | -------- | ----------------------------------------------------- | --------------------------------------------------------------------------- | | Theme | Choose the basic design of the storefront. | Logo, colors, typography, and page layout. | | Products | Add products to sell or introduce. | Selected products, product order, visibility, and product notes. | | Sections | Organize the content areas shown on the public page. | Banners, text, reviews, product blocks, links, and visible/hidden sections. | | Publish | Preview, review, and open the storefront to visitors. | The final public version of the storefront. | # Storefront Mall How-to Use ## Storefront Mall How-to Use Guide This guide explains how brand operators, MDs, marketers, and content managers can create and publish a Storefront Mall without developer support. A Storefront Mall is an online shopping storefront where customers can discover products, open product detail pages, add items to cart, and continue to checkout. The setup flow is organized into four main steps: `Theme`, `Products`, `Sections`, and `Publish`. *** ### 1. Storefront Mall Overview A Storefront Mall is not only a brand introduction page. It is a sales storefront designed to guide customers from product discovery to purchase. In a Storefront Mall, you manage the following areas. | Area | What it means | | -------- | ------------------------------------------------------------------------------------------------- | | Theme | Sets the overall design, colors, fonts, and page structure. | | Products | Selects the products shown in the storefront and controls their order. | | Sections | Builds the homepage: banners, menus, product areas, reviews, Instagram, trust badges, and footer. | | Publish | Reviews the storefront and makes it visible to visitors. | The safest setup order is: 1. Choose the overall design in `Theme`. 2. Select the products to sell in `Products`. 3. Build the homepage and menus in `Sections`. 4. Review the storefront, then publish it when everything is ready. It is important to understand the difference between `Save` and `Publish`. | Button | Meaning | | ------- | -------------------------------------------------------------------------------- | | Save | Saves your edits. Saving alone may not make the storefront visible to customers. | | Preview | Shows how the storefront will look to customers. | | Publish | Makes the storefront available to visitors. | *** ### 2. Before You Start Prepare the following materials before building the Storefront Mall. This makes the setup process faster and reduces the risk of publishing incomplete content. #### Brand Materials * Brand name * Logo image * Brand introduction copy * Official social media links * Customer service information * Company or seller information #### Product Materials * List of products to sell * Hero products * New arrivals * Best sellers * Sold-out or discontinued product status * Product images and price information #### Content Materials * Main banner images * Mobile banner images * Promotion copy * Review content * Instagram post links * Customer guidance copy such as shipping, returns, authenticity, or support messages If images or copy are not ready, it is better to hide the related section instead of publishing placeholder text or empty images. Incomplete content can reduce customer trust. *** ### 3. Overall Creation Flow The Storefront Mall editor is usually organized into four steps.
As shown above, the editor is divided into `Theme`, `Products`, `Sections`, and `Publish`. The preview area shows how the current settings will appear to customers. | Step | Screen label | What you do | | ------ | ------------ | ------------------------------------------------------------ | | Step 1 | Theme | Set the storefront design and base layout. | | Step 2 | Products | Select and organize products for the storefront. | | Step 3 | Sections | Configure the homepage, menus, banners, reviews, and footer. | | Step 4 | Publish | Review the final storefront and make it public. | These steps are connected. For example, if no products are selected in `Products`, product-based sections in `Sections` may appear empty. If you change the `Theme`, the same sections can look different. For a new storefront, work through the steps in order from 1 to 4. *** ## Step 1. Theme Setup The Theme step defines the overall design and structure of the Storefront Mall. This is not just about choosing a beautiful look. It decides the first impression customers get and how they browse products.
In the Theme step, you can review and adjust the base design in one place. Main items to check: * Theme template * Storefront version * Brand logo * Palette * Typography * Layout * Product display * Header style * Background mood * Card style * Desktop and mobile preview Theme is the foundation of the storefront. Before configuring products and sections, choose the Theme so you can predict how products and content will be displayed. *** ### 1.1 Choose a Theme Template A Theme template is the base design template for the Storefront Mall. For example, selecting a theme such as `Aesthe Journal` applies that theme's layout and visual mood. Use the following criteria when choosing a template. | Checkpoint | Description | | ------------------- | --------------------------------------------------------------------------------- | | Brand mood | Does the design match the brand: premium, trendy, practical, editorial, or clean? | | Product readability | Are product images and names easy to see? | | Visual complexity | Do decorative elements distract from products? | | Mobile fit | Does the first screen and product card layout work well on mobile? | If this is your first Storefront Mall, choose a stable Theme first, then customize colors and typography in the detailed settings. *** ### 1.2 Choose a Storefront Version The Storefront version changes the public storefront structure within the selected Theme. In simple terms, it controls how products and content are arranged. | Option | Simple explanation | Recommended use | | ----------- | --------------------------------------------------------------------- | ----------------------------------------------------- | | Classic | A standard shopping mall layout with balanced products and content. | When you want a familiar brand shopping experience. | | Framed Mall | Uses more spacing and clearer boundaries for a polished look. | When you need a premium or content-led storefront. | | Storefront | A shorter, simpler format for showing the brand and products quickly. | When the storefront is used like a public sales link. | Changing the Storefront version can change how the same products and sections appear. After changing it, always review the `Products`, `Sections`, desktop preview, and mobile preview again. *** ### 1.3 Set the Brand Logo The Brand logo is the key identity element shown in the top area of the Storefront Mall. It helps customers recognize the brand as soon as they arrive. You can usually use either a text logo or an image logo. Check the following: * Is the logo too small or too large? * Is it cut off on mobile? * Is it visible on the selected background color? * Does it match the official brand logo? * Does it overlap with the header menu? If a logo image is not ready, it is safer to show the brand name as clean text than to publish a temporary image. *** ### 1.4 Set the Palette The Palette controls the overall color mood of the Storefront Mall. Background colors, accent colors, button colors, and text colors may all be affected. In a shopping storefront, color should not interfere with products. Customers should notice the product image, product name, price, and action buttons first. Check the following: * Do product images stand out from the background? * Are buttons easy to notice? * Is text easy to read? * Does the color palette match the brand? * Is the overall screen too dark, too strong, or too noisy? Recommended direction: | Brand or product type | Suggested direction | | ------------------------ | ------------------------------------------------ | | Skincare or beauty | Bright, clean colors with soft accents. | | Premium brand | Controlled monochrome or low-saturation accents. | | Campaign storefront | One clear accent color. | | Large product assortment | Simple background so products are easy to scan. | *** ### 1.5 Set Typography Typography controls the style of text across the storefront: titles, descriptions, buttons, product names, and footer information. The most important rule is readability. A font can look attractive but still be unsuitable for a sales page if it is hard to read. Main settings: | Item | Description | | ------------------ | --------------------------------------- | | Heading style | The mood of large titles. | | Heading weight | The thickness of title text. | | Letter spacing | The spacing between letters. | | Title align | Aligns section titles left or center. | | Uppercase headings | Displays English headings in uppercase. | Be careful with: * Wide letter spacing can make small text difficult to read. * Uppercase headings can work for short English titles but feel awkward for long sentences. * Check that Korean, English, and numbers all look natural if the storefront uses multiple languages. * On mobile, readability matters more than decorative style. *** ### 1.6 Set the Layout Layout controls the storefront width, side padding, section spacing, and product arrangement. | Item | Description | What to check | | --------------- | ---------------------------------------------- | ---------------------------------------------------------------- | | Product layout | Controls how products are displayed. | A grid may be easier when there are many products. | | Max width | Controls the maximum content width on desktop. | Too wide can feel scattered; too narrow can feel cramped. | | Side padding | Controls horizontal spacing. | Make sure products do not become too small on mobile. | | Section spacing | Controls vertical spacing between sections. | Reduce it for dense content; increase it for a premium feel. | | Spacing | Quickly chooses the overall spacing mood. | Pick Compact, Regular, or Spacious based on the storefront goal. | | Header layout | Controls logo and menu placement. | Check that logo and menus do not overlap. | Selection tips: * Reduce spacing if you want to show many products quickly. * Increase spacing if you want a more premium and relaxed look. * If product images look too small, adjust max width or card size. * If mobile scrolling feels too long, reduce section spacing. *** ### 1.7 Product Display and Card Style Product display and Card style control the size and spacing of repeated cards, such as product cards, review cards, and Instagram tiles.
In the `Cards` tab, you can adjust the width and gap of product cards, review cards, and Instagram cards. After changing settings, check the live preview to confirm the card size feels natural. Check the following: * Are product images large enough? * Are product names and prices readable? * Is the gap between cards too narrow or too wide? * Are cards consistent within the same section? * Is the mobile view easy to scan? If product cards are too small, product appeal is reduced. If they are too large, customers see fewer products at once. Balance card size based on image quality and product count. *** ### 1.8 Set the Header Style The Header is the top area containing the logo and navigation menu. In the Theme step, you can decide how the header appears. Examples: * Center-aligned logo * Left-aligned logo * Compact header * Floating header * Header style that changes after scrolling Check the following: * Do the logo and menu overlap? * Are there too many menu items? * Is the menu easy to access on mobile? * Does the header still look natural after scrolling? * Are text and icons visible over the background? The Header is used throughout the shopping journey, so usability is more important than decoration. *** ### 1.9 Check Desktop and Mobile Preview After completing Theme settings, always check both desktop and mobile previews. A screen that looks good on desktop can have cropped images or overlapping text on mobile. Check the following: * Is the logo visible? * Does the header menu display correctly? * Is the main banner image cropped properly? * Are product cards an appropriate size? * Do titles and descriptions overlap? * Do buttons stay inside the screen? * Is section spacing too wide or too narrow? If most visitors are expected to use mobile, review the mobile version first. *** ### 1.10 Theme Completion Checklist The Theme step can be considered complete when: * A Theme template is selected. * The Storefront version matches the brand goal. * The logo displays correctly. * Colors and fonts match the brand mood. * Product cards look clean and readable. * The Header works on desktop and mobile. * Spacing and section gaps feel natural. * The first screen does not look awkward in Preview. After completing Theme, move to `Products`. *** ## Step 2. Select Products In the Products step, you choose which products will appear in the Storefront Mall. These products are used in product lists, keyword product sections, recommendation areas, review-linked products, and other product-based modules.
In this step, search for products on the left, manage selected product order and visibility in the middle, and review the storefront preview on the right. The important point is that not every catalog product is automatically displayed. Only products added to this Storefront Mall are shown to customers. *** ### 2.1 What You Do on the Products Screen The Products screen is usually split into product discovery and selected product management. | Area | What you do | | ------------------------- | ------------------------------------------------------------------ | | Search | Find products by product name, brand name, or keyword. | | Brand filter | Narrow the list to a specific brand. | | Product card | Check product image, name, price, and selling status. | | Add | Add an individual product to the Storefront Mall. | | Add all available results | Add all available products from the current search result. | | Added product list | Manage order, visibility, badges, and notes for selected products. | *** ### 2.2 Product Selection Flow 1. Go to the `Products` step. 2. Enter a product name, brand name, or keyword in the search field. 3. Use the brand filter if needed. 4. Check product image, name, price, and availability on the product card. 5. Add products one by one, or use `Add all available results`. 6. Arrange the order in the added product list. 7. Hide or show products if needed. 8. Add short badges or recommendation notes if useful. 9. Click `Save` to save product changes. 10. Use Preview to check the product list and product detail navigation. *** ### 2.3 Values Managed on Added Products | Value | Description | | ------------ | ------------------------------------------------------------------------------------------------- | | Order | Controls the order products appear in the public storefront. | | Show / hide | Controls whether a product is visible to visitors. | | Badge | A short label such as `Best seller` or `Staff pick`. | | Creator note | A short reason for recommending the product. | | Delete | Removes the product from this Storefront Mall only. It does not delete the original product data. | Adding or removing products here does not change the original product record. It only controls which products this storefront displays and how they are described. *** ### 2.4 Product Selection Criteria When building a Storefront Mall for the first time, prioritize: * Products that represent the brand * Products you want to sell right now * New arrivals * Best sellers * Promotion items * Products connected to reviews or content Review the following carefully before publishing: * Sold-out products * Products without prices * Products without images * Test products * Products that should not be sold * Products with incomplete detail information *** ### 2.5 Decide Product Order Product order controls the order in which customers discover products. A natural order is: 1. Hero products 2. Best sellers 3. Current promotion products 4. New arrivals 5. Category products 6. Add-on or supporting products The first row is especially important. The first products customers see can affect the brand impression and purchase intent. *** ### 2.6 Products Step Checklist | Checkpoint | Why it matters | | ---------------------------------------------- | ------------------------------------------------------------ | | Are all products you want to sell added? | Product sections cannot work well without selected products. | | Are products that should not be sold excluded? | Unprepared products could be published. | | Are sold-out products not placed at the front? | Customers should not see unavailable products first. | | Do product images load correctly? | Image quality directly affects trust. | | Is the product order saved as intended? | Recheck after saving in Preview. | | Are badges and notes free of placeholder text? | Avoid publishing labels such as `Sample` or `Test`. | *** ## Step 3. Configure Sections The Sections step builds the homepage and top/bottom areas of the Storefront Mall. You can think of it as the homepage builder.
Select a section on the left, edit it in the center panel, and review the customer-facing result on the right. This step controls what customers see first and in what order. Banners, menus, keyword products, recommendation cards, reviews, Instagram, trust badges, and footer information are all managed here. *** ### 3.1 Common Section Controls Most sections include the following controls. | Control | Description | | --------------- | ----------------------------------------------------------------------------------------- | | Edit | Changes copy, images, links, colors, products, or other section content. | | On / off toggle | Shows or hides the section for visitors. | | Move up / down | Changes the section order. | | Delete | Removes some user-added sections. Default sections are usually hidden instead of deleted. | | Preview | Shows the real display in the preview area. | Turning off a section does not immediately delete its content. When you turn it back on, check whether the previous copy and images are still there. *** ### 3.2 When to Show or Hide Sections Showing every section can make the page too long and push key products too far down. Use the following rules. | State | When to use it | | ------- | -------------------------------------------------------------------------- | | Show | Use when real content is ready and should be visible to visitors. | | Hide | Use when images, copy, or links are not ready or placeholder copy remains. | | Reorder | Use when important products, campaigns, or reviews should appear higher. | | Delete | Use when a user-added Card showcase is no longer needed. | Recommended default flow: 1. Announcement bar 2. Header 3. Main banner 4. Contents strip 5. Shop by keywords 6. Featured edit or Card showcase 7. Promo banner 8. Real Reviews 9. Trust badges 10. Instagram feed 11. Footer This creates a natural customer path: notice, brand recognition, product discovery, recommended products, trust signals, and official information. *** ### 3.3 Common Section Title Style Some sections include `Section title style`. This changes only the title inside that section. | Item | Description | | --------------- | ------------------------------------------------------ | | Title align | Aligns the section title left or center. | | Title treatment | Shows the title as plain text or with a bar treatment. | | Title size | Adjusts title size. | | Section CTA | Adds a button below the section. | If `Section CTA` is enabled, choose one of the following destinations. | CTA destination | Description | | --------------- | -------------------------------------------------------------------- | | Custom link | Opens a URL or an anchor inside the storefront. | | Product page | Opens a product page containing selected products. | | Content page | Opens a separate content page with text, images, and product blocks. | Operational tips: * Use Product page when you want to show more products. * Use Content page for brand stories or campaign explanations. * Use Custom link for external pages or specific sections. *** ### 3.4 Announcement Bar The Announcement bar is a short message displayed at the very top of the storefront. Use it for notices, shipping information, discount codes, or event messages that all visitors should see. Editable items: | Item | Description | | ---------------- | --------------------------------- | | Bar text | The message displayed at the top. | | Background color | The bar background color. | | Text color | The message text color. | Good copy examples: * Free shipping over $50 * Get 15% off your first order * Shipping options and delivery rates are calculated at checkout * New arrivals are updated every Friday Writing tips: * Keep the message short. * Communicate only one message at a time. * Avoid long sentences that are hard to read on mobile. * If you include a discount code, enter it exactly. Before publishing, check: * Is contrast between background and text strong enough? * Is the message cut off on mobile? * Does the copy match the real shipping or discount policy? * Are there any typos? *** ### 3.5 Header The Header contains the logo, navigation, account area, cart, and social links. It is the most important navigation area in the storefront.
In the Header editor, you manage social links and top navigation. Menu types can connect to internal pages, sections, external URLs, or hover menus. Main Header items: | Item | Description | | ------------ | ------------------------------------------------------------------ | | Logo | The brand logo or brand name shown at the top. | | Social links | Instagram, TikTok, YouTube, and Facebook links. | | Nav links | Top navigation links. Up to 8 can be configured. | | Points badge | A short badge next to the account icon. Leave empty if not needed. | *** #### 3.5.1 Nav Links Nav links are the menu items shown in the Header. They help customers move to products, collections, content, and external links. Menu types: | Type | Description | Example | | --------------------- | ------------------------------------------------------------------- | ---------------------------------- | | Page | Opens an internal Storefront page. | Contact, About, FAQ | | Multi-brand directory | Automatically displays multiple brands connected to the Storefront. | Brand menu, A-Z brand list | | Section | Moves to a section on the homepage. | `#shop`, `#reviews` | | Link | Opens a manually entered URL. | External brand site, campaign page | | Menu | Shows a hover menu when the customer hovers over the nav item. | Brand, Shop, Category | Tips: * Keep menu names short. * Do not create too many menu items. * If the mobile menu becomes difficult to use, keep only the core links. * Always test external links. * Multi-brand directory is suitable for multi-brand Storefronts. For a single-brand Storefront, Page or Section links usually feel more natural. *** #### 3.5.2 Hover Menu A Hover menu opens when the customer places the cursor over a Header menu item. Use it to show multiple brands, categories, product groups, or visual panels at once. Configurable items: | Item | Description | | ------------------ | ------------------------------------------------------------------ | | Group | A large group inside the menu. Up to 4 groups can be created. | | Menu item | Individual links inside each group. Up to 12 items per group. | | Menu products | Small product cards shown inside the hover menu. Up to 6 products. | | Menu visual panels | Image-based visual panels shown beside the menu. Up to 2 panels. | Hover menu destinations: | Destination | Description | | ------------ | ----------------------------------------------------------- | | Custom link | Opens a manually entered URL. | | Product page | Opens a page containing selected products. | | Content page | Opens a content page with text, images, and product blocks. | Good examples: * Add an A-Z brand list under `Brand`. * Add categories such as Skin care, Makeup, and Hair care under `Shop`. * Add best sellers and recommended product cards under `Best`. * Link routine guides or ingredient guides under `Guide`. Be careful: * A long brand hover menu may not be necessary for a single-brand Storefront. * Too many items make it difficult for customers to choose. * Group names and item names should not be confusing or duplicated. * Menu products should be selected from products added in the Products step. * Check image, title, description, and button link for every visual panel. Before publishing, check: * Does the menu open correctly on hover? * Does each menu item open the correct page? * Is the menu accessible on mobile? * Do product cards open real products? * Do visual panel images load correctly? *** ### 3.6 Main Banner The Main banner is the large banner customers see first. It shapes the first impression and is useful for hero campaigns, new arrivals, seasonal promotions, and key products.
In the Main banner editor, manage banner images, copy, buttons, desktop/mobile ratios, and banner order. Since this area appears on the first screen, always check the mobile preview. You can manage up to 4 main banners. If there are multiple banners, put the most important message first. Editable items: | Item | Description | | ------------------ | ----------------------------------------------------------------- | | Section size | Controls how large the banner appears. | | Transition speed | Controls autoplay speed when multiple banners exist. | | Desktop ratio | Controls the banner ratio on desktop. | | Mobile ratio | Controls the banner ratio on mobile. | | Desktop image | Banner image for desktop. | | Mobile image | Banner image for mobile. If empty, the desktop image may be used. | | Image alt text | Image description for accessibility and image loading fallback. | | Layout | Controls how image and copy are arranged. | | Image position | Sets whether the image appears on the left or right. | | Headline | Main banner title. | | Subhead | Supporting copy under the headline. | | CTA label | Button text. | | CTA URL | Destination opened by the button. | | Soft edge | Softens the image edge so it blends with the background. | | Banner destination | Destination for banner or CTA clicks. | | Banner order | Display order when multiple banners exist. | Setup flow: 1. Prepare the banner image. 2. Choose the Section size. 3. Add separate desktop and mobile images if possible. 4. Check desktop and mobile ratios. 5. Enter the Headline and Subhead. 6. Add CTA label and destination if needed. 7. Choose the Banner destination. 8. Put the most important banner first. 9. Confirm transition speed is not too fast or too slow. 10. Check both desktop and mobile preview. Banner destination options: | Option | Description | Example | | ------------ | ------------------------------------------------ | ----------------------------------- | | No click | Shows only the banner image with no destination. | Brand mood image | | Custom link | Opens a manually entered URL. | External campaign page, page anchor | | Product page | Opens a page containing selected products. | New arrivals, best sellers | | Content page | Opens a content page with text and images. | Brand story, campaign guide | Good banner criteria: * Customers can understand what is being sold from the first screen. * Important products or copy are not placed too close to the image edge. * The main subject is not cropped on mobile. * Button copy is short and action-oriented. * Multiple banners do not repeat the same message. CTA examples: * Shop now * View collection * Explore routine * Get the offer Before publishing, check: * Is the image clear and not pixelated? * Are faces, products, and text not cropped on mobile? * Does the CTA link open the correct destination? * Is the banner order natural? * Is autoplay speed slow enough for customers to read? *** #### 3.6.1 When Storefront Intro Is Available Some Storefront versions include a `Storefront intro` area together with the Main banner. This area can manage a short brand intro, banner list, social links, and contact details. Editable items: | Item | Description | | --------------------- | ------------------------------------------------------------------- | | One-line memo | A short sentence describing the storefront. | | Banner Manager | Adds, edits, hides, shows, and reorders banners. | | Transition speed | Controls autoplay speed for multiple banners. | | Web ratio | Banner ratio on desktop. | | Mobile ratio | Banner ratio on mobile. | | Entrance animation | Controls how the intro appears when customers enter. | | Scrolled header style | Controls how the Header looks after scrolling. | | Header social | Instagram, TikTok, YouTube, and Facebook links shown in the Header. | | Contact | Information opened from the Header Contact button. | Tips: * Keep the One-line memo short. * Add customer service, shipping/return guidance, or support email in Contact. * Make sure social links open real accounts. * Entrance animation can create a strong first impression, but avoid overusing it if product discovery should be fast. *** ### 3.7 Contents Strip The Contents strip is a compact horizontal link section. It helps customers move quickly to important content or sections.
Use it to place short links in the middle of the homepage. Good use cases: * Quick links such as Brand story, Best sellers, or New arrivals * Links to important homepage sections * Links to content pages or collections Tips: * Keep link names short. * 3 to 5 links usually work well. * Each link should have a clear destination. * Test each link in Preview. Avoid: * Long link names * Links that do not open anything * Multiple links with similar names *** ### 3.8 Shop by Keywords Shop by keywords groups products by keyword. It helps customers browse by concern, category, benefit, or use case.
Create keyword tabs and decide which products appear in each tab. The default product order from `Products` and the keyword-specific product order are managed separately. Up to 6 keywords can be used. Editable items: | Item | Description | | ------------------ | --------------------------------------------------------- | | Section title | Title for the keyword product area. | | Keywords | Tabs customers can click. | | Shown in this tab | Products displayed under the selected keyword. | | Available products | Products not yet added to the selected keyword. | | Reset order | Resets this keyword's product order to the default order. | Keyword examples: * Hydrating * Calming * Acne Care * Brightening * Sensitive Skin * Best Sellers Setup flow: 1. Enter the Section title. 2. Add the keywords you need. 3. Rename keywords so customers can understand them. 4. Select one keyword. 5. Choose products for that keyword from Available products. 6. Adjust product order in Shown in this tab. 7. Repeat for other keywords. 8. Use Preview to confirm each tab changes products correctly. Important difference: | Area | Meaning | | --------------------------------- | --------------------------------------------------- | | Product order in Products step | Default Storefront product order. | | Product order in Shop by keywords | Product order only inside the selected keyword tab. | Before publishing, check: * Does every visible keyword contain products? * Are keyword names easy for customers to understand? * Are empty keywords hidden? * Is the product order natural in each keyword? *** ### 3.9 Card Showcase Card showcase is a flexible card section that can be added by the operator. It can be used for product groups, image links, campaign banners, content pages, brand cards, and more.
First choose the section purpose, then combine card images, titles, descriptions, links, product pages, or content pages. A Card showcase can contain up to 16 cards. A keyword-style Card showcase can use up to 6 keywords. *** #### 3.9.1 Add a Card Showcase 1. Go to the `Sections` step. 2. Click `Add card showcase`. 3. Click `Edit` on the new Card showcase. 4. Select the Section purpose. 5. Enter title, image, link, and connected products. 6. Adjust card order. 7. Check desktop and mobile card spacing in Preview. 8. Click `Save`. *** #### 3.9.2 Choose Section Purpose | Option | Simple explanation | Recommended use | | ------------------- | ------------------------------------------------ | ----------------------------------------------- | | Keyword product row | Shows product groups by keyword in one row. | Routines, categories, or recommendation groups. | | Image link cards | Shows multiple image cards with links. | Brand, campaign, or category entry cards. | | Wide image carousel | Shows wide image cards in a horizontal carousel. | Visual campaigns or collections. | | Content cards | Looks like article or content cards. | Articles, how-to guides, brand stories. | | Banner cards | Shows multiple mixed banners. | Promotions, curated edits, seasonal campaigns. | *** #### 3.9.3 Card Showcase Layout Settings | Item | Description | | -------------- | --------------------------------------------------------------------------------------- | | Tile flow | Controls whether cards wrap into rows or scroll in one row. | | Card size | Sets card size to regular or compact. | | Layout preset | For Banner cards, choose layouts such as hero stack, three equal, two column, or bento. | | Text placement | Controls whether copy appears below, over, or in a separate band on the image. | | Text align | Aligns card copy left or center. | | Tone | Sets the card color mood: soft, light, brand, or dark. | Tips: * Use Keyword product row for product-led sections. * Use Image link cards for category entry points. * Use Wide image carousel when campaign images are important. * Use Content cards for articles or brand stories. * Use Banner cards for sales, events, and seasonal campaigns. *** #### 3.9.4 Card Input Fields | Item | Description | | ----------- | ------------------------------------------ | | Image | Image shown on the card. | | Title | Card title. | | Subtitle | Short supporting copy. | | CTA label | Button copy. | | Destination | Where customers go when clicking the card. | Destination options: | Option | Description | Example | | ------------ | ------------------------------------------ | --------------------------------------- | | No click | Decorative card with no destination. | Brand mood image | | Custom link | Opens a manually entered URL. | External campaign page | | Product page | Opens a page containing selected products. | Toner picks, Sunscreen edit | | Content page | Opens a content page with text and images. | Brand story, how-to guide, event notice | *** #### 3.9.5 Link to a Product Page A Product page shows only selected products. Setup flow: 1. Select `Product page` as the Destination. 2. Enter the Page URL. 3. Enter the Page title. 4. Enter the Page description. 5. Select products to include. 6. Confirm the page opens in Preview. Be careful: * If no products are selected, the page can appear empty. * Page URLs may be visible to customers, so keep them short and readable. * Avoid creating multiple pages with the same name. *** #### 3.9.6 Link to a Content Page A Content page combines text, images, quotes, and product blocks instead of showing only products. Available blocks: | Block | Description | | ------------ | ------------------------------------- | | Text | Basic title and body text block. | | Two columns | Two-column text layout. | | Image + text | Image and explanation shown together. | | Image | Large image block. | | Products | Shows selected products. | | Quote | Highlighted quote block. | A Content page can use up to 12 blocks. Recommended use cases: * Brand story * How-to guide * Ingredient explanation * Event announcement * Routine recommendation page Before publishing, check: * Is the Page title clear? * Is the body text not too long? * Are images not cropped on mobile? * Are real products connected to product blocks? * Do CTA and card links open the correct page? *** ### 3.10 Quote Block Quote block highlights a short quote or brand message. It is more useful for building mood and trust than for direct shopping.
If you do not have a prepared message, it is usually cleaner to hide this section. Editable items: | Item | Description | | --------- | --------------------------------------- | | Quote | Highlighted italic-style copy. | | Body | Supporting copy under the quote. | | CTA label | Button copy. Leave empty if not needed. | | CTA link | Destination opened by the button. | Good use cases: * Showing a short brand philosophy * Highlighting a customer review sentence * Telling a short product development story Be careful: * Long copy weakens the quote effect. * Placing a large Quote block before product discovery can slow down the shopping flow. * Hide it if no strong message is ready. *** ### 3.11 Featured Edit Featured edit highlights products or content curated by the operator.
Use it for recommended products, editor's picks, seasonal edits, or key campaign items. Good use cases: * This week's recommendations * Editor's picks * Routine by skin concern * Seasonal products * Core campaign products Tips: * Use a clear title. * Keep recommendation copy to one or two sentences. * Do not connect too many products. * Place the most important product first. Before publishing, check: * Are recommended products added in the Products step? * Does the title match the product selection? * Does the CTA open the correct page? * Does the card layout stay manageable on mobile? *** ### 3.12 Promo Banner Promo banner highlights promotions, discounts, collections, or events. It is a lighter CTA area than the Main banner.
Use an image or video to emphasize a specific campaign or benefit. Make sure CTA copy and links match the actual promotion. Editable items: | Item | Description | | -------------- | ------------------------------------------------------------------- | | Section size | Banner size. | | Layout | Split image or Full image layout. | | Image side | For split layout, controls whether the image appears left or right. | | Text alignment | Controls copy alignment. | | Media type | Image or video. | | Text position | Controls where copy appears over a full image or video. | | Background dim | Dark overlay to improve text readability over media. | | Promo image | Banner image. | | CTA label | Button copy. | | CTA link | Button destination. | Video notes: * MP4, WebM, and QuickTime formats can be used. * Keeping video files under 40 MB is safer. * If copy appears over video, adjust Background dim for readability. Examples: * Limited time offer * Shop bundles * New collection * Free shipping campaign * Holiday sale Before publishing, check: * Does the image or video load correctly? * Is copy readable over the media? * Does the CTA open the right page? * Does the button stay inside the mobile screen? * Does the promotion period and copy match the real operation? *** ### 3.13 Special Feature Special feature is a high-impact visual section used in the middle of the storefront. It can show brand names, campaign copy, or special visual effects.
This section is useful for emphasizing a brand lineup or campaign message. If it includes movement, check that it does not feel excessive on mobile. Editable items: | Item | Description | | -------------- | -------------------------------------------- | | Highlight text | Short number or word shown before the title. | | Heading text | Main title. | | Subcopy | Supporting copy under the title. | | Brand names | Names shown in moving or repeated text. | | Background | Section background color. | | Base text | Base text color. | | Accent color | Accent color. | Brand name input examples: ``` Jumiso LA PIGNE Lilybyred makeprem MEDICUBE ``` Or: ``` Jumiso, LA PIGNE, Lilybyred, makeprem, MEDICUBE ``` Good use cases: * Multi-brand Mall with many brands * Highlighting a specific brand lineup * Creating a strong campaign mood Be careful: * This may not be necessary for a single-brand Mall. * Moving text can feel fast on mobile. * If there are too few brand names, repetition may look awkward. * After changing background color, confirm text is still readable. *** ### 3.14 Real Reviews Real Reviews shows review videos or Instagram reviews. It can increase customer trust before purchase.
Manage review links, thumbnails, and connected products here. The review and connected product should match. Up to 12 reviews can be added. Editable items: | Item | Description | | ------------- | ---------------------------------------------------- | | Section title | Review section title. | | Review link | Instagram link, video link, or original review link. | | Fetch media | Imports thumbnail or video from an Instagram link. | | Thumbnail | Image shown on the review card. | | Product | Product connected to the review. | Setup flow: 1. Enter the Section title. 2. Click `Add review`. 3. Enter an Instagram or video link. 4. Click `Fetch media` to import the thumbnail. 5. If fetching fails, upload a thumbnail manually. 6. Select the related product. 7. Check the review card and product connection in Preview. Be careful: * If the review and product do not match, customers may be confused. * Instagram thumbnail fetching can fail, so prepare a manual image if possible. * Hide the section if you do not have enough real reviews. * Confirm the original review link opens. *** ### 3.15 Featured Articles Featured Articles shows short article cards for brand stories, how-to guides, ingredient explanations, and routine guides.
If content is not ready, hide this section before publishing. Up to 8 articles can be added. Editable items: | Item | Description | | -------------- | ---------------------------------------- | | Section title | Section title. | | Columns | Number of article cards per row. | | Article title | Title shown on the article card. | | Excerpt | Short article description. | | Read More link | Destination opened when customers click. | | Reorder | Changes article card order. | Good use cases: * Ingredient explanation * Product usage guide * Brand journal * Routine guide * Campaign introduction Tips: * Keep titles short and specific. * One or two sentences are enough for the excerpt. * Without a Read More link, customers cannot continue reading. * Hide the section if content is not ready. Before publishing, check: * Does each link open a real page? * Does the article title match the linked content? * Does the Columns setting look natural on mobile? * Is there any placeholder article copy? *** ### 3.16 Instagram Feed Instagram feed shows brand mood using Instagram-style image tiles.
Manage the account handle, post links, tile images, and captions here. The image tone should match the brand. Up to 16 tiles can be added. Editable items: | Item | Description | | ---------------- | ---------------------------------------- | | Section title | Section title. | | Instagram handle | Instagram account name to display. | | Tile image | Image shown in each tile. | | Link | Instagram post link opened by the tile. | | Caption | Short image description. | | Fetch thumbnail | Imports an image from an Instagram link. | Instagram link types: * Instagram post * Instagram reel * Instagram TV link Tips: * Keep image tone consistent. * Avoid blurry or overly dark images. * Confirm external links open correctly. * Do not add posts unrelated to the brand. Before publishing, check: * Do images load correctly? * Do Instagram links open? * Are tiles large enough on mobile? * Does the overall image tone match the brand? *** ### 3.17 Trust Badges Trust badges show three short trust messages for customers. The three badge cards are fixed.
Use this section for shipping, authenticity, secure checkout, and customer support information. Do not write messages that differ from real policy. Editable items: | Item | Description | | ------------- | ----------------------------------------- | | Section title | Section title. Leave empty if not needed. | | Icon | Icon shown on each card. | | Title | Short trust message. | | Body | Supporting explanation. | Available icon examples: * Gift * Leaf * Truck * Star * Heart * Package * Shield * Sparkles Copy examples: | Title | Body | | ------------------ | ------------------------------------------------------ | | Authentic Products | We source directly from verified brand partners. | | Secure Checkout | Payments are processed through a secure checkout flow. | | Fast Delivery | Shipping options are shown clearly at checkout. | | Easy Support | Contact us if you need help with your order. | Be careful: * Do not promise anything that does not match the real operation. * Free shipping, returns, and authenticity copy must match official policy. * Keep trust messages short and clear. *** ### 3.18 Footer The Footer is the official information area at the bottom of the storefront. If the Storefront Mall is used as a real sales page, this information must be accurate.
The Footer includes customer center information, company information, social links, quick links, and copyright copy. Confirm everything matches the real operation before publishing. Editable areas: | Area | Input | | --------------- | ------------------------------------------------------------------------------------------- | | Customer center | Customer service phone number and operating hours. | | Company info | Legal name, CEO, address, business registration number, e-commerce permit, privacy manager. | | Social links | Instagram, TikTok, YouTube, Facebook links. | | Quick links | Help, Contact, Shipping, Refund, and other quick links. | | Copyright | Footer copyright copy. | Up to 12 Quick links can be added. Footer tips: * Customer service information must match actual operating hours. * Company information must match official seller information. * Social links must open real accounts. * Missing policy links can increase customer inquiries. * Remove placeholder addresses or test copy. Before publishing, check: * Is customer service information real? * Is company information accurate? * Do social links open correctly? * Do all Quick links open the correct pages? * Does the copyright copy look natural? *** ### 3.19 Sections Checklist | Checkpoint | What to confirm | | ---------------------------------------- | ------------------------------------------------------------------------- | | Are only necessary sections turned on? | Hide sections with placeholder content. | | Is section order natural? | Check the flow from notice, header, banner, products, reviews, to footer. | | Do all buttons and cards have links? | Click them in Preview. | | Are product sections not empty? | Check Shop by keywords and Card showcase. | | Do desktop and mobile both look natural? | Check image cropping, text overlap, and button placement. | | Is Footer information real? | Check customer center, company info, and policy links. | *** ## Step 4. Preview, Review, and Publish In the final step, review the customer-facing storefront before making it public. Publishing is not just clicking a button. It is the final check that customers can browse and shop without issues.
In the Publish step, confirm the final state of Theme, Products, Sections, and the public link. *** ### 4.1 Check Preview Preview should be reviewed as close to the customer experience as possible. Check the following: * Does the homepage display correctly? * Does the Header menu work? * Does the Hover menu open? * Does the Main banner look natural on desktop and mobile? * Are product cards visible and readable? * Do product cards open product detail pages? * Do CTA buttons open the correct destinations? * Is Footer information accurate? The Preview state and the public link can sometimes differ. After publishing, always open the public link as well. *** ### 4.2 Design Checklist Before Publishing | Checkpoint | What to confirm | | ---------------------------------------------- | ------------------------------------------------- | | Is the Storefront version correct? | Classic / Framed Mall / Storefront | | Is the logo not cropped on desktop or mobile? | Be careful with long brand names. | | Is color contrast strong enough? | Check buttons, announcement bar, and banner copy. | | Do fonts look natural for all languages used? | Check titles, product names, and Footer. | | Are product card size and spacing appropriate? | Not too small and not too wide. | | Do images and text not overlap on mobile? | Check banners, cards, and Footer. | *** ### 4.3 Product Checklist Before Publishing | Checkpoint | What to confirm | | -------------------------------------------------------- | ------------------------- | | Are all products to sell added? | Check the Products step. | | Are sold-out or missing-price products not placed first? | Check product cards. | | Is product order saved as intended? | Save, then check Preview. | | Are hidden products not visible publicly? | Check Preview. | | Are badges and notes not placeholder text? | Check Added products. | | Do product detail pages open correctly? | Click product cards. | *** ### 4.4 Section Checklist Before Publishing | Checkpoint | What to confirm | | ---------------------------------------------------- | -------------------------------------------- | | Are unnecessary sections turned off? | Check toggles in Sections. | | Is section order natural? | Review the flow from first screen to Footer. | | Are banner images not cropped on desktop or mobile? | Check Main banner and Promo banner. | | Are keyword tabs not empty? | Check Shop by keywords. | | Do Card showcase cards open the correct links? | Click cards. | | Is Special feature not too fast or visually complex? | Check desktop and mobile preview. | | Do review and Instagram links work? | Check Real Reviews and Instagram feed. | | Is Footer information real? | Check customer center and company info. | *** ### 4.5 Publish the Storefront After all checks are complete, publish from the Publish step. Summary items shown in the Publish step: | Item | What to confirm | | --------------------------- | ------------------------------------------- | | Theme | Confirm the selected design is correct. | | Version | Confirm the Storefront version is correct. | | Storefront name / Shop name | Confirm the public name is correct. | | Products | Confirm the number of selected products. | | Sections | Confirm visible and hidden sections. | | Status | Confirm Draft, Live, or Unpublished status. | | Share link | Public link to share with visitors. | Status meanings: | Status | Meaning | | ----------- | ------------------------------------------------------------------ | | Draft | Not public yet. Edits can be saved, but visitors cannot see it. | | Live | Public and visible to visitors. | | Unpublished | Publishing has been stopped. Visitors cannot access it. | | Suspended | Restricted for operational reasons. Internal review may be needed. | If you only click `Save`, visitors may not be able to see the Storefront. To share the link with customers, complete `Publish`. *** ### 4.6 Check After Publishing After publishing, open the Share link in a new window and review the real visitor view. Must-check items: * Does the public link open? * Does the homepage look similar to Preview? * Does the Header menu work? * Do product detail pages open? * Does cart or purchase flow work correctly? * Does mobile display correctly? * Is there no placeholder copy? For anything that affects purchase, such as price, stock, shipping, or payment, recheck after every update. *** ## Common Confusing Situations | Situation | Likely reason | What to do | | -------------------------------------------------------------- | ----------------------------------------------------------------------------- | -------------------------------------------------- | | I saved it, but visitors cannot see it. | You may have clicked Save but not Publish. | Complete the Publish step. | | It looks correct in Preview, but different on the public link. | You may be viewing unsaved or unpublished edits. | Save, publish, then reopen the public link. | | Sections changed after switching Theme. | Each storefront version has different structure and density. | Recheck Products and Sections. | | Product order looks different in keyword tabs. | Default product order and keyword-specific order are separate. | Adjust order inside Shop by keywords. | | Card showcase looks empty. | Cards may not be added, or images/links may be empty. | Enter card content in Card showcase Edit. | | Instagram thumbnail cannot be fetched. | The link format may be unsupported, or the external image cannot be imported. | Upload the thumbnail manually. | | Publishing is blocked. | Required information may be missing, or placeholder copy may remain. | Check Footer, products, sections, and links again. | *** ## Final Summary Storefront Mall is a sales storefront feature that manages design, products, sections, and publishing status together. Remember the operation flow: 1. Set the base design and layout in Theme. 2. Add and order products in Products. 3. Configure banners, menus, keyword products, reviews, and Footer in Sections. 4. Check desktop and mobile in Preview. 5. Save your edits. 6. Publish the Storefront for visitors. 7. After publishing, open the real link and check the shopping flow. The most important point is that `Save` and `Publish` are different. `Save` stores edits. `Publish` makes the Storefront visible to visitors. # Storefront Mall How-to Use - simple ## Storefront Mall Quick Start Guide This guide is based on the latest local UI. It is written for non-technical users who need to quickly understand the Storefront Mall editor, review one storefront, and publish it with confidence. The brand name, product count, and public link shown in the screenshots are examples. Your actual screen may look slightly different depending on the selected brand and mall data, but the editing flow stays the same. For a more detailed feature-by-feature manual, see the full How-to guide. {% hint style="info" %} We will continue adding more design options and storefront layouts so you can build a wider variety of shopping experiences in the future. {% endhint %} {% hint style="info" %} This is a simplified guide, so the best way to understand Storefront Mall is to try each setting one by one as you build. {% endhint %} *** ### Overall Flow
Storefront Mall is edited from left to right using the four steps at the top of the editor. | Step | What you do here | What to check | | ----------- | ------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | 1. Theme | Choose the storefront version, theme, logo, and design tone. | The brand style feels right, and desktop/mobile previews look clean. | | 2. Products | Add products, reorder them, and write short product notes. | Only sellable products are included, and key products appear first. | | 3. Sections | Turn homepage sections on/off and edit text, images, links, and product blocks. | Only needed sections are enabled, and all buttons/links work. | | 4. Publish | Review the final state, open the public page, and publish. | The live storefront works correctly from the public link. | The top `Preview` button opens the customer-facing storefront preview. The `Save` button stores your current edits. Saving and publishing are different actions, so always confirm the public status in the final step. *** ### Step 1. Set the Theme Theme controls the first impression of the storefront. In the latest UI, you can review `Storefront version`, the selected theme card, logo settings, design settings, and the live preview in one place.
#### What to do 1. Select `Theme` from the top step navigation.
2. Choose `Classic` or `Framed Mall` under `Storefront version`.
3. Confirm that the selected theme card is correct.
4. Set the text logo or image logo in `Brand logo`.
5. Adjust logo style, palette, background, typography, spacing, and button style in `Design settings`. 6. Check the right-side `Theme live preview`.
7. Use `Open full preview` if you need a larger view. 8. Click `Save` when the theme looks ready. #### Watch out for * Make sure the logo is not too small, stretched, or cropped. * Avoid backgrounds or decorative effects that distract from products. * Check both `Desktop` and `Mobile`, not just one preview size. * Changing the theme can make the same products and sections feel very different. *** ### Step 2. Add and Organize Products Products is where you choose which products appear in the storefront and manage the order and display information for added items. The latest UI is split into `Catalog products` on the left and `Added to your storefront` on the right.
#### How to read this screen | Area | Meaning | | --------------------------- | ------------------------------------------------------------------ | | `Catalog products` | Search and select products that can be added to the storefront. | | `All brands` | Filter the catalog by brand. | | `Add all available results` | Add all currently available results from the active search/filter. | | `Added to your storefront` | Review and manage products already added to the storefront. | | `Save` | Save product additions, order changes, badges, and creator notes. | #### What to do 1. Search by product name or brand name in `Catalog products`.
2. Add individual products with the `+` button.
3. Use `Add all available results` only when you really want to add the whole filtered result set.
4. Check the product count in `Added to your storefront`.
5. Adjust product order so the most important products appear first.
6. Hide or remove products that should not be shown.
7. Use `BADGE` for short labels like "best", "new", or "staff pick".
8. Use `CREATOR NOTE` for a short recommendation or selling point.
9. If there are many products, use pagination to review the next pages. 10. Click `Save` when product selection and order are ready. #### Watch out for * Check any item marked `Price missing` before publishing. * Do not place test products or not-ready products near the top. * The first page of products strongly shapes the customer's first impression. * Product-based sections will look better when Products is already organized. *** ### Step 3. Build the Homepage with Sections Sections is where you build the actual storefront homepage. You can enable or disable sections, reorder them, and edit each selected section's text, images, links, product picks, and display options.
#### How to read this screen | Area | Meaning | | ------------------------------- | -------------------------------------------------------------------------------- | | Left `Sections` list | Select sections, turn them on/off, and change their order. | | Middle settings panel | Edit the selected section through `Content`, `Blocks`, `Design`, and `Advanced`. | | Right `Editing now` preview | Quickly check only the section you are editing right now. | | Right `Full storefront` preview | Check how the section feels inside the full customer-facing page. | | `Collapse sections` | Hide the left section list to give more space to the preview. | | `Preview focus` | Focus the workspace on preview review. | #### Common sections to review | Section | What to check | | ------------------- | ----------------------------------------------------------------------------- | | `Announcement bar` | Shipping, discount, or notice text is correct. | | `Header` | Logo, navigation, and links are accurate. | | `Main banner` | Hero image, headline, and CTA are ready. | | `Contents strip` | Shortcut links lead to the intended places. | | `Shop by keywords` | Keyword tabs and connected products match. | | `Quote block` | Brand or editorial copy feels natural. | | `Special feature` | Motion or visual effects are not too distracting. | | `Promo banner` | Promotion text, image, and button link are correct. | | `Real Reviews` | Reviews and linked products match. | | `Featured Articles` | Article titles, links, and visibility are correct. | | `Instagram feed` | Images and links are appropriate. | | `Trust badges` | Shipping, authenticity, payment, and support messages match the real policy. | | `Footer` | Customer support, company info, social links, and copyright text are correct. | #### What to do 1. Select a section from the left list.
2. Turn off sections that are not ready or not needed.
3. Use the up/down controls to change section order.
4. Fill in the main text and links in `Content` first.
5. Use `Blocks` for repeated cards, product groups, or visual items.
6. Adjust colors, spacing, and display style in `Design`.
7. Check extra display conditions or detailed options in `Advanced`.
8. Use `Editing now` to review the section you just changed.
9. Use `Full storefront` to check the full page flow.
10. Click `Save` when the homepage structure is ready. #### Watch out for * Do not publish with unfinished sections turned on. * Empty or incorrect button links can break the customer journey. * Keyword tabs without products may look like empty content. * Footer information should not be left as placeholder text. *** ### Step 4. Preview, Review, and Publish Publish is the final review step. If the storefront is already live, you may see `Visit Storefront` and `Unpublish`. If it is not live yet, you may see a `Publish` action instead.
#### What to do 1. Select `Publish` from the top step navigation.
2. Review `Theme`, `Version`, `Storefront name`, `Products`, `Sections`, and `Status`.
3. Confirm that `Share link` is the intended public URL.
4. Open the customer-facing page with the top `Preview` button or `Visit Storefront`.
5. Click through header navigation, banner buttons, card links, and product detail links. 6. Check both desktop and mobile views. 7. If everything is ready, publish the storefront. 8. If the storefront is already live, use `Visit Storefront` to confirm the actual public page.
#### Button meanings | Button | Meaning | | ------------------ | ---------------------------------------------------------------------------- | | `Save` | Saves the current edits. This does not automatically publish the storefront. | | `Preview` | Opens a customer-facing preview. | | `Publish` | Makes the storefront available to visitors. | | `Visit Storefront` | Opens the already published storefront. | | `Unpublish` | Takes a live storefront offline. | *** ### 1-Minute Pre-Publish Checklist * [ ] The logo looks correct on desktop and mobile. * [ ] Only sellable products are included in Products. * [ ] No price-missing, test, or not-ready products appear near the top. * [ ] The main banner image is not cropped badly on mobile. * [ ] Header navigation and banner buttons open the correct pages. * [ ] Product cards open product detail pages. * [ ] Unneeded sections are turned off. * [ ] Reviews, Instagram links, and social links work. * [ ] Footer customer support and company information are accurate. * [ ] After publishing, the public link has been opened in a new window and checked. *** ### Remember This Flow ``` Set Theme -> Add Products -> Organize Sections -> Review with Preview -> Publish ``` You do not need to use every feature on the first pass. A good starting storefront only needs clear products, correct links, clean mobile layout, and no unfinished sections. # How to Connect Shopify {% hint style="success" %} This guide will help you connect your Shopify store to Hypercape using the Dev Dashboard App method. {% endhint %} ### Steps #### 1. Log in to Hypercape BIZ
Log in to Hypercape BIZ

Log in to your Hypercape BIZ account at biz.hypercape.com. Enter your email address and password, then click "Sign in". You can also sign in with your Google account.

#### 2. Navigate to Setup
Navigate to Setup

After logging in, navigate to the left sidebar and click on "Setup".

#### 3. Setup Page
Hypercape BIZ Setup page

On the Setup page, you'll need your Shop domain along with your Shopify store's Client ID and Client Secret to connect your Shopify account. To find this information, go to your Shopify admin page.

#### 4. Open Shopify Admin Site
Open Shopify Admin

Go to your Shopify admin site at admin.shopify.com.

#### 5. Access Dev Dashboard Go to your Shopify admin site and follow these steps: 1. Click **Settings** at the bottom left. 2. In the left-hand menu, click **Apps**. 3. On the Apps page, click **Develop apps** in the top right. 4. Click **Build apps in Dev Dashboard**.
Open Shopify Settings

Click "Settings" at the bottom left of Shopify Admin.

Open Apps menu

Open "Apps" from the Settings menu.

Open Develop apps

Click "Develop apps" in the top right.

Build apps in Dev Dashboard

Click "Build apps in Dev Dashboard".

#### 6. Click Create App
Click Create app

On the Dev Dashboard page, click "Create app" in the top right corner.

#### 7. Enter App Name
Enter app name

Enter your desired app name (e.g., "hypercape") and click the "Create" button.

#### 8. Configure API Scopes
Configure API scopes

After your app is created, you'll be taken to the app configuration page. Scroll down to the "Access" section and click "Select scopes" to configure the API permissions.

{% hint style="info" %} These scopes define exactly which parts of your store Hypercape can access — Hypercape can never access anything outside the scopes you approve here. {% endhint %} #### 9. Select Required Scopes In the "Select scopes" modal, search and enable the following Admin API scopes: * **Products**: `read_products`, `write_products` * **Order editing**: `read_order_edits`, `write_order_edits` * **Orders**: `read_orders`, `write_orders` * **Fulfillment services**: `read_fulfillments`, `write_fulfillments` * **Merchant managed fulfillment**: `read_merchant_managed_fulfillment_orders`, `write_merchant_managed_fulfillment_orders` * **Third party fulfillment**: `read_third_party_fulfillment_orders`, `write_third_party_fulfillment_orders` * **Custom fulfillment services**: `read_custom_fulfillment_services`, `write_custom_fulfillment_services` * **Assigned fulfillment**: `read_assigned_fulfillment_orders`, `write_assigned_fulfillment_orders` Click "Done" after selecting all scopes.
Select Products Scope

Select the Products scope: read_products, write_products.

Select Order Editing Scope

Select the Order editing scope: read_order_edits, write_order_edits.

Select Orders Scope

Select the Orders scope: read_orders, write_orders.

Select Fulfillment Scopes

Select fulfillment-related scopes as shown in the modal.

Select Custom Fulfillment Services Scope

Select the Custom fulfillment services scope: read_custom_fulfillment_services, write_custom_fulfillment_services.

Select Assigned Fulfillment Scope

Select the Assigned fulfillment scope: read_assigned_fulfillment_orders, write_assigned_fulfillment_orders.

{% hint style="warning" %} #### For Existing Users: How to Update Permissions If you already have a connected store and need to update your app permissions, follow these steps: 1. Go to Shopify Settings → Apps and sales channels 2. Click **Develop apps** in the top right corner 3. Select the **HYPERCAPE app** (or your custom app name) 4. Click **Configure Admin API scopes** 5. Enable ALL of the following permissions: * Assigned fulfillment orders (read & write) * Custom fulfillment services (read & write) * Fulfillment services (read & write) * Merchant-managed fulfillment orders (read & write) * Orders (read & write) * Third-party fulfillment orders (read & write) **⚠️ You must manually grant all 6 permissions above in your Shopify admin panel.** {% endhint %} #### 10. Release Your App After configuring your scopes, scroll down to the bottom of the page and click the "Release" button to publish your app version with the selected permissions.
Release the app

Click "Release" after configuring the required API scopes.

Release app version

Confirm the release to publish the app version with the selected permissions.

#### 11. Install App to Your Store After releasing your app, install it on your Shopify store. In the "Overview" section, click the "Install app" button. A confirmation dialog will show the permissions your app needs; click "Install" to complete the installation.
Open the active app version

Open the active version of your released app.

Click Install app

Click the "Install app" button.

Select a Shopify store

Select the Shopify store where you want to install the app.

Confirm app installation

Review the requested permissions and click "Install".

{% hint style="info" %} Installing the app only grants Hypercape the permissions you configured. This does not complete the connection yet — you will finish connecting on the Hypercape BIZ Setup page in Step 14. You do not need to open or use the app itself. {% endhint %} #### 12. Go to Settings
Go to app Settings

Navigate to the "Settings" tab in the left sidebar.

#### 13. Copy Your Credentials
Copy Client ID and Client Secret

In the Settings page, you'll find the "Credentials" section containing your Client ID and Client Secret. Click the copy icon next to each field to copy these values.

{% hint style="info" %} These two values are what actually connect your store to Hypercape — the app itself is not used after this point. {% endhint %} #### 14. Enter Your Credentials
Enter Shopify credentials in Hypercape BIZ

Return to the Hypercape BIZ "Setup" page. Paste your copied Client ID and Client Secret into the corresponding fields. Enter your Shopify store URL (the part before .myshopify.com). Click "Save Shopify connection" to complete the connection.

#### 15. Connection Complete!
Shopify connection complete

If you see the screen below with your store name listed, congratulations! Your Shopify store has been successfully connected to Hypercape. You can now start importing and managing products.

{% hint style="info" %} Need help? If you encounter any issues during the setup process, contact us at . {% endhint %} # Step 1. Connect Shopify {% hint style="success" %} This guide will help you connect your Shopify store to Hypercape using the Dev Dashboard App method. {% endhint %} ### Steps #### 1. Log in to Hypercape BIZ
Hypercape BIZ Login

Log in to your Hypercape BIZ account at biz.hypercape.com. Enter your email address and password, then click \"Sign in\". You can also sign in with your Google account.

#### 2. Navigate to Shopify Home
Navigate to Shopify Home

After logging in, navigate to the left sidebar and click on \"Shopify\" to expand the menu. Then select \"Home\" from the submenu.

#### 3. Click Connect a Store
Click Connect a Store

On the Shopify Home page, click the green \"Connect a store\" button to begin connecting your Shopify store to Hypercape.

#### 4. Go to Shopify Admin
Go to Shopify Admin

A modal window will appear asking for your Shopify credentials. Keep this window open and navigate to your Shopify Admin at admin.shopify.com in a new browser tab.

#### 5. Open Account Menu
Open Account Menu

In your Shopify Admin dashboard, click on your account name in the top right corner of the screen to open the account menu.

#### 6. Access Dev Dashboard
Access Dev Dashboard

From the dropdown menu, click on \"Dev Dashboard\" to access the Shopify Developer Dashboard where you can create and manage your apps.

#### 7. Click Create App
Click Create App

In the Dev Dashboard, click the \"Create app\" button in the top right corner.

#### 8. Enter App Name
Enter App Name

On the \"Create an app\" page, in the \"Start from Dev Dashboard\" section on the right, enter your desired app name (e.g., \"hypercape\") and click the \"Create\" button.

#### 9. Configure API Scopes
Configure API Scopes

After your app is created, you'll be taken to the app configuration page. Scroll down to the \"Access\" section and click \"Select scopes\" to configure the API permissions.

#### 10. Select Required Scopes In the "Select scopes" modal, search and enable the following Admin API scopes: * **Products**: `read_products`, `write_products` * **Order editing**: `read_order_edits`, `write_order_edits` * **Orders**: `read_orders`, `write_orders` * **Fulfillment services**: `read_fulfillments`, `write_fulfillments` * **Merchant managed fulfillment**: `read_merchant_managed_fulfillment_orders`, `write_merchant_managed_fulfillment_orders` * **Third party fulfillment**: `read_third_party_fulfillment_orders`, `write_third_party_fulfillment_orders` * **Custom fulfillment services**: `read_custom_fulfillment_services`, `write_custom_fulfillment_services` * **Assigned fulfillment**: `read_assigned_fulfillment_orders`, `write_assigned_fulfillment_orders` Click "Done" after selecting all scopes.
Select Products Scope

Select the Products scope: read_products, write_products.

Select Order Editing Scope

Select the Order editing scope: read_order_edits, write_order_edits.

Select Orders Scope

Select the Orders scope: read_orders, write_orders.

Select Fulfillment Scopes

Select fulfillment-related scopes (as shown in the modal).

Select Custom Fulfillment Services Scope

Select the Custom fulfillment services scope: read_custom_fulfillment_services, write_custom_fulfillment_services.

Select Assigned Fulfillment Scope

Select the Assigned fulfillment scope: read_assigned_fulfillment_orders, write_assigned_fulfillment_orders.

{% hint style="warning" %} #### For Existing Users: How to Update Permissions If you already have a connected store and need to update your app permissions, follow these steps: 1. Go to Shopify Settings → Apps and sales channels 2. Click **Develop apps** in the top right corner 3. Select the **HYPERCAPE app** (or your custom app name) 4. Click **Configure Admin API scopes** 5. Enable ALL of the following permissions: * Assigned fulfillment orders (read & write) * Custom fulfillment services (read & write) * Fulfillment services (read & write) * Merchant-managed fulfillment orders (read & write) * Orders (read & write) * Third-party fulfillment orders (read & write) **⚠️ You must manually grant all 6 permissions above in your Shopify admin panel.** {% endhint %} #### 11. Release Your App
Release Your App

After configuring your scopes, scroll down to the bottom of the page and click the \"Release\" button to publish your app version with the selected permissions.

#### 12. Install App to Your Store
Click Install App Button

In the \"Overview\" section, click the Install app button.

Confirm Installation

A confirmation dialog will appear showing the permissions your app needs. Click Install to complete the installation.

#### 13. Go to Settings
Go to Settings

Navigate to the \"Settings\" tab in the left sidebar to access your app credentials.

#### 14. Copy Your Credentials
Copy Your Credentials

In the Settings page, you'll find your \"Credentials\" section containing your Client ID and Secret. Click the copy icon next to each field to copy these values.

#### 15. Enter Your Credentials
Enter Your Credentials

Return to the Hypercape BIZ connection modal. Paste your copied Client ID and Client Secret into the corresponding fields. Enter your Shopify store URL (the part before .myshopify.com). Click \"Connect my store\" to complete the connection.

#### 16. Connection Complete!
Connection Complete

If you see the screen below with your store name listed, congratulations! Your Shopify store has been successfully connected to Hypercape. You can now start importing and managing products.

{% hint style="info" %} Need help? If you encounter any issues during the setup process, contact us at . {% endhint %} # Step 2. Import Products {% hint style="info" %} Importing a product and making it sellable are different actions. You still need to **send it to Shopify**. Then set it to **Active**. {% endhint %} ### Steps #### 1. Open Search Products Open [**Search Products**](https://biz.hypercape.com/goods) in Hypercape BIZ. #### 2. Add products to your Import List Select target products. Send them to **Import List**.
Send products to Import List

Select products, then send them to your Import List.

#### 3. Review imported products (Import List) Open [**Import List**](https://biz.hypercape.com/store/shopify/import). Review the products you imported. {% hint style="warning" %} #### Attention needed * This page shows a list of the products that you have imported. This list hasn't been sent to your Shopify store yet. Once you've confirmed your imported products, click **Send to Shopify** to send them to your Shopify store. * Shopify allows up to three pieces of information per second. When you hit **Send to Shopify,** it might take longer to load than you think. It's not an error, just be patient - it's a lot faster than sourcing products from Korea yourself. {% endhint %} #### 4. (Optional) Set selling prices and product details If you want to set a selling price, click **Variants**. Enter the selling price, then send it to your Shopify store.
Edit variants and pricing

Use Variants to set pricing and product details before sending to Shopify.

#### 5. Send to Shopify Click **Send to Shopify**.
Send to Shopify button

After review (and optional edits), send products to Shopify.

{% hint style="info" %} #### Tips * If you want to set a selling price, then click **Variants** and enter the selling price and send it to your Shopify store. * If you want to change your product pricing and information after you've sent the product to your Shopify store, then you can do so from your Shopify Admin page. * Start with **3–5 products** first. Validate margin and fulfillment flow before scaling. {% endhint %} {% hint style="danger" %} #### DONT DO! * You can change any information about a product in your Shopify admin page however you want, but you shouldn't change the product itself to another product. Our system recognizes your product as the product it was when you sent it to Shopify. * Don't **copy** an imported product, sell the copy, then delete the original. Orders will NOT sync. {% endhint %} #### 6. Activate the product in Shopify In Shopify, make sure product status is **Active** (not Draft).
Shopify product status

Imported products are created as Draft by default.

Set product to Active

Switch status to Active to start selling.


### Important Notes * The product is **Draft by default** in Shopify. To sell, set it to **Active**. * If you rename products in Shopify, order sync is not affected. ### Can't find a product? Email us with product info or URL: **** # Step 3. Sync & Fulfill Orders Process one test order end-to-end: sync → pay → shipment → tracking. {% hint style="info" %} #### Before you start * Your store must be connected. See [Step 1. Connect Shopify](/connect-shopify-guide/step-1.-connect-shopify). * The ordered product must be imported via Hypercape. See [Step 2. Import Products](/connect-shopify-guide/step-2.-import-products). {% endhint %} ### What you will do 1. Customer places an order on Shopify 2. Sync orders in [Hypercape BIZ](https://biz.hypercape.com/orders) 3. Pay (supply price + shipping cost) 4. Hypercape ships 5. Tracking appears in the order list ### Steps (recommended for your first test order) #### 1) Create a real paid order in Shopify Create a test order for one imported product. Make sure it is a normal, paid order (not a draft). #### 2) Open your order list in Hypercape BIZ
Hypercape BIZ Orders page

Open the Orders page in Hypercape BIZ.

Go to the Shopify orders area in [Hypercape BIZ](https://biz.hypercape.com/orders). You should see a **Sync Orders** button. #### 3) Sync orders Click **Sync Orders**. Wait a few seconds for the list to refresh.
Order appears in the list after syncing

After syncing, your Shopify order should appear in the list.

{% hint style="warning" %} If your order doesn’t appear after syncing, jump to [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting). {% endhint %} #### 4) Review the payable amount Open the synced order details.
Order detail shows supply price and shipping cost

Check the supply price and shipping cost on the order detail page.

Confirm the payable total: * **Supply price** (Hypercape cost) * **Shipping cost** (freight) Shipping cost is charged per order. It is not per product. {% hint style="info" %} Your customer pays your Shopify retail price. You pay Hypercape (supply + shipping). Your margin logic is in [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin). {% endhint %} #### 5) Pay to trigger fulfillment Pay from the order detail page. Payment method: **PayPal** (you can apply **Prepayments** credits first). Prepayments are credits in your Hypercape account that reduce what you pay via PayPal. {% hint style="warning" %} If you don’t have enough prepayments, you will pay more via PayPal. If PayPal payment fails, try again or contact support. {% endhint %} 1. Choose **Payment** on the checkout screen. 2. Apply **Prepayments** if available. 3. Complete payment with **PayPal** for the remaining amount.
Checkout window for Payment (Prepayments + PayPal)

Example: Payment checkout window (Prepayments + PayPal).

Order status changes to Fulfilled after payment

After payment, the order status changes to Fulfilled.

After payment, Hypercape starts fulfillment. {% hint style="info" %} If you plan to cancel/refund the end customer, contact support first. Policies vary by case. See [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance). {% endhint %} ### Payment Requirement **You must pay for the order BEFORE Hypercape ships to your customer.** * Your customer places an order at your Shopify store price * You pay Hypercape supply price + shipping fee * Hypercape ships the order directly to your customer ### Order Processing Time * **0-2 business days** (may take longer depending on product/situation) Processing starts after your payment is completed. ### After shipment
Tracking number appears after shipment

After shipment, tracking number and tracking link appear in the order list.

Open the Orders page anytime: ### Common exceptions (link only) For out-of-stock, quantity limits, and sync failures, see: * [Troubleshooting](/reference/partner-seller-troubleshooting) * [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting) For customs/duty and return rules, see: * [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance) ### Need help? Email: **** # Step 1. Discover Events {% hint style="success" %} This guide shows you how to browse campaigns and find events to apply for. {% endhint %} ### Before you start * You’re signed in to your Hypercape Creator account. {% hint style="info" %} You can browse events before your profile is fully ready. But you may need an approved profile to apply. See [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile). {% endhint %} ### What you will do 1. Open the Events page. 2. Search or filter events. 3. Open event details and check eligibility. ### Steps #### 1) Open Events Sign in, then click **Events**. Events is the main hub for campaigns. #### 2) Search or filter * Use the **search bar** to find events by name or brand. * Filter by status: * **All** * **Ongoing** * **Upcoming** * **Ended** #### 3) Read an event card Each card typically shows: * Brand name and logo * Event title and category * Event type badge (**Content Campaign** or **Product Gifting**) * Countdown / remaining time * Applicants count * Reward amount (H‑Points) #### 4) Open event details Click an event card to see: * **Description** * **Requirements** (content campaigns only) * **Product gifting notice** (product gifting only) * **Rewards** * **Products** * **Timeline** #### 5) Check eligibility {% hint style="info" %} If you match the requirements, you’ll see a green check. If not, you’ll see what’s missing. {% endhint %} ### Expected result You found an event you want to join. You understand what it requires. ### Tips * Check the **Timeline** first. * Read the requirements before you apply. * Apply early for competitive events. ### Need help? Email ****. Include the event name and a screenshot. # Step 2. Apply to an Event {% hint style="success" %} This guide walks you through submitting your application to a campaign. {% endhint %} {% hint style="info" %} If you’re applying via a **public form link** (no login), you’re in the **Form Events** flow. Follow [Form Events](/creator-guide/form-events) instead. {% endhint %} ### Before you start * You found an event you want to join. See [Step 1. Discover Events](/creator-guide/step-1.-discover-events). * The event is accepting applications (usually **Ongoing**). * You meet the eligibility requirements shown on the event detail page. ### What you will do 1. Open the event detail page. 2. Fill in the application form. 3. Submit your application. 4. Confirm status in **Applications**. ### Steps #### 1) Click Apply Now Open the event detail page. Click **Apply Now**. {% hint style="info" %} If the button isn’t available, it usually means one of these: * You already applied. * Applications are not open yet. * Applications are closed. * Your profile is missing required info. {% endhint %} #### 2) Fill in the application form Typical fields: * **Why do you want to join?** (required) * **Content idea** (required) * **Social media links** (optional) #### 3) Click Submit Application Review carefully, then click **Submit Application**. {% hint style="warning" %} You can’t edit an application after submission. Double-check before you submit. {% endhint %} #### 4) Check your application status Go to **Applications**. Statuses: * **Under Review**: the brand is reviewing. * **Selected**: you were chosen. Next: [Step 3. After Selection](/creator-guide/step-3.-after-selection). * **Not Selected**: you were not chosen. ### Expected result Your application shows **Under Review** in **Applications**. ### Troubleshooting * **Apply Now is disabled**: check eligibility and complete your profile. See [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile). * **Form won’t submit**: confirm required fields are filled. * **Application not visible**: refresh the Applications list. ### Need help? Email **** with the event name and a screenshot. # Form Events {% hint style="success" %} This guide covers the Form Event flow — a different entry point where you apply through a public form and track everything from a personal ticket page. {% endhint %} ### How Form Events are different | | Regular Events | Form Events | | -------------------------- | --------------------------- | --------------------------------------------- | | **How you find it** | Browse in the app | Direct link shared by the brand | | **How you apply** | Tap Apply Now in the app | Fill out a public form (no login needed) | | **Where you track status** | Applications tab in the app | Personal ticket page (token link) | | **Login required?** | Yes | No — the entire flow works without an account | {% hint style="info" %} Form Events and Regular Events share the same shipping and content submission process. For shipping details, see [Step 4. Shipping & Tracking](/creator-guide/step-4.-shipping-and-tracking). For earnings, see [Step 5. Earnings & Withdrawal](/creator-guide/step-5.-earnings-and-withdrawal). {% endhint %} *** ### Part A — Apply to a Form Event #### Before you start * You have a link to a Form Event page (shared by the brand, social media, or email). #### What you will do 1. Open the Form Event link. 2. Fill in your information. 3. Submit the form. 4. Save your personal ticket link. #### Steps **1) Open the Form Event page** Open the link you received. The page shows: * Event title and description * Application period and countdown (if not yet open) * The application form {% hint style="info" %} Some Form Events are **restricted** — only pre-selected email addresses can apply. If the event is restricted, you will be asked to verify your email before the form appears. {% endhint %} **2) Fill in contact information** * **Email** (required) * **Full Name** (required — must match your ID for KYC) * **Phone Country** + **Phone Number** **3) Fill in your shipping address** Enter your address using the search bar (Google Maps autocomplete) or fill in the fields manually: * Street Address * Apartment / Unit (optional) * City * State / Region * Postal Code * Country {% hint style="warning" %} Double-check your address. After submission, you cannot change it yourself — you would need to contact support. {% endhint %} **4) Complete custom fields** Some events include additional questions set by the brand (e.g. skin type, preferred product, social handle). Fill in all required fields. **5) Agree to terms** Check each consent box or tap **Agree to all terms**: * Terms of Service * Privacy Policy * Third-party data collection * Marketing communications * Content usage for promotional purposes * Cross-border data transfer **6) Submit** Tap **Submit**. A confirmation dialog will show your info summary. Type **yes** to confirm. You will be redirected to your **personal ticket page**. {% hint style="warning" %} **Bookmark your ticket page URL.** This is your only way to check status and submit content. If you lose it, contact **** with your email and the event name. {% endhint %} #### Expected result You see your ticket page with status **Under Review** and the 4-step progress indicator. *** ### Part B — Track Status & Submit Content #### Before you start * You have submitted a Form Event application. * You have your ticket page URL. #### What you will do 1. Check your selection status. 2. Track shipping (if selected). 3. Submit content URLs (if required). #### Steps **1) Open your ticket page** Go to your bookmarked ticket URL. The page shows a **4-step progress indicator**: | Step | Label | What it means | | -------------- | ------------------------------------------- | -------------------------------- | | **Invite** | Application submitted | Always complete after you apply | | **Selection** | Under review / Selected / Not selected | Brand is deciding or has decided | | **Shipping** | Preparing / Dispatched | Product shipment status | | **Submission** | Content required / Submitted / Not required | Content submission status | **2) Check your status** | Status | What you see | Next action | | ------------------------- | -------------------------------------------------------------------- | ----------------------------------------- | | **Under Review** | "Your entry has been received and is currently under review." | Wait for notification | | **Confirmed** (Selected) | "Congratulations! You have been selected for this event." | Check shipping and content sections below | | **Denied** (Not Selected) | "Thank you for participating. Unfortunately, you were not selected." | Browse other events | **3) Track shipping** Once selected, the **Shipping** section appears with: * Carrier name and tracking number * **Track Package** button (opens carrier tracking page) * Local carrier info (for international shipments with handoff) Multiple packages are shown separately (Package 1, Package 2, etc.). For more details see [Step 4. Shipping & Tracking](/creator-guide/step-4.-shipping-and-tracking). **4) Submit content (if required)** If the event requires content submission: 1. **Verify your email** — enter the email you used when applying. 2. **Add URLs** — select a platform and paste the link. Repeat for each post. 3. Tap **Submit Content**. {% hint style="info" %} If you are logged in and your account email matches, email verification is skipped automatically. {% endhint %} Supported platforms: * Instagram * TikTok * YouTube * Facebook * Threads * Other Up to **10 URLs** per event. {% hint style="warning" %} You **cannot** re-submit after confirming. Double-check all URLs before tapping Submit Content. {% endhint %} After submission, the form is replaced by a read-only list of your submitted URLs. #### Expected result * **If content required**: your ticket shows "Submitted" on the Submission step with all URLs listed. * **If no content required**: your ticket shows "Not required" and the event completes after delivery. #### Troubleshooting | Problem | Cause | Fix | | --------------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------- | | Can't access my ticket page | Lost the URL | Email **** with your email and event name | | Email verification fails | Entered a different email than the one you applied with | Use the exact same email | | Form says "restricted" and won't let me apply | Event is limited to pre-selected emails | Contact the brand or check if you received an invitation | | Event page says "Ended" | Application period closed | No action — check for other events | | Event shows "cancelled" notice | Brand cancelled the event | No action — check for other events | | Submitted wrong URL | Submission is locked | Contact **** immediately | #### Need help? Email ****. Include: * Event name * Your email address * Ticket page URL or screenshot * Description of the issue # Step 3. After Selection {% hint style="success" %} This guide explains what to do after you’re selected. {% endhint %} {% hint style="info" %} If you joined via a **Form Event**, you track selection, shipping, and submission from your **ticket page**. See [Form Events](/creator-guide/form-events). {% endhint %} ### Before you start * Your application status is **Selected**. * Your shipping address is up to date. {% hint style="warning" %} If you need to change your address, update it in your profile first. Profile changes can require admin review. See [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile). {% endhint %} ### What you will do #### Content Campaign 1. Confirm shipping address. 2. Receive the product. 3. Create content that matches requirements. 4. Submit content URLs. #### Product Gifting 1. Confirm shipping address. 2. Receive the product. No content submission is required. ### Steps (Content Campaign) #### 1) Confirm your shipping address Open your application detail page. Confirm your shipping address if prompted. #### 2) Track shipping Shipping info appears in your application detail. See [Step 4. Shipping & Tracking](/creator-guide/step-4.-shipping-and-tracking). #### 3) Create your content Check the event **Requirements** for: * Platforms * Hashtags / mentions * Content guidelines * Deadline in the **Timeline** {% hint style="info" %} Some events require your post to be **Public**. Follow the event requirements shown on the detail page. {% endhint %} #### 4) Submit content URLs Submit from your **application detail** page. 1. Verify your email (use the email you applied with). 2. Click **Add URL**. 3. Choose the platform. 4. Paste the link. 5. Review and agree to terms. 6. Click **Submit Content**. Supported platforms: * Instagram * TikTok * YouTube * Facebook * Threads {% hint style="warning" %} You can’t modify your submission after confirming. Double-check every URL first. {% endhint %} ### Steps (Product Gifting) #### 1) Confirm your shipping address Same as above. #### 2) Receive your product No further action is required in Hypercape. ### Expected result * Content Campaign: your content submission is accepted and visible in the application detail. * Product Gifting: shipping progresses to **Delivered**. ### Troubleshooting * **Email verification fails**: use the exact email you applied with. * **URL looks wrong**: open it in an incognito window to confirm it loads. * **Submitted the wrong URL**: contact **** immediately. ### Need help? Email **** with the event name and a screenshot. # Step 4. Shipping & Tracking {% hint style="success" %} This guide explains how to track your shipment after selection. {% endhint %} {% hint style="info" %} If you joined via a **Form Event**, shipping status and tracking show on your **ticket page**. See [Form Events](/creator-guide/form-events). {% endhint %} ### Before you start * Your application status is **Selected**. * Your shipping address is confirmed. ### What you will do 1. Check shipping status. 2. Open the carrier tracking page. 3. Report issues with the right info. ### Steps #### 1) Open shipping details Open your application detail page. The **Shipping** section appears after selection. #### 2) Check shipping status * **Pending**: waiting to be shipped * **Shipped**: in transit * **Delivered**: delivered successfully * **Cancelled**: shipping cancelled * **Failed**: shipping had an issue #### 3) Track your package When status is **Shipped**, you can see: * Carrier name (example: FedEx, DHL Express, EMS) * Tracking number * Link to the carrier tracking page * Estimated delivery date (if available) ### Expected result You can track the package on the carrier site. You can confirm delivery status in your application detail. ### Troubleshooting * **Tracking link doesn’t show updates**: carrier scans can lag behind. * **Status is stuck**: contact support with the details below. * **Damage / wrong / missing item**: take photos before discarding packaging. * **Marked delivered but not received**: check with the carrier, then contact support. ### Need help? Email ****. Include: * Event name * Your application ID or screenshot * Tracking number (if you have it) * Photos (damage / wrong / missing item) # Step 5. Earnings & Withdrawal {% hint style="success" %} This guide explains how you earn H‑Points and withdraw them to PayPal. {% endhint %} ### Before you start * You completed at least one event. * Your PayPal account is set in your profile. See [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile). ### What you will do 1. Check your H‑Points balance. 2. Review transaction history. 3. Request a withdrawal. 4. Track withdrawal status. ### How H‑Points work H‑Points are your reward balance. You can view balance and history in **Wallet**. {% hint style="info" %} Reward timing depends on the event rules. Some events credit after submission. Some events require brand review first. {% endhint %} ### Steps #### 1) Open Wallet Open **Wallet** to see: * **Available balance** (withdrawable) * **Total earned** * **Total withdrawn** #### 2) Review transaction history Filter by: * **All** * **Earned** * **Withdrawn** * **Bonus** * **Refund** Each item shows description, date, and amount. #### 3) Withdraw H‑Points 1. Open **Wallet**. 2. Click **Withdraw**. 3. Confirm your PayPal account. 4. Review the fee breakdown. 5. Confirm. {% hint style="info" %} A processing fee applies. Minimum withdrawal amount is shown on the withdraw screen. {% endhint %} #### 4) Check withdrawal status * **Pending Review**: processing * **Completed**: sent to your PayPal * **Failed**: contact support * **Cancelled**: withdrawal cancelled ### Expected result Your withdrawal shows **Completed**. Funds appear in your PayPal account. ### Troubleshooting * **Withdraw button is disabled**: check the minimum amount shown on the screen. * **Withdrawal failed**: confirm your PayPal info in your profile, then try again. * **H‑Points not credited yet**: re-check the event timeline and rules. ### Need help? Email **** with a screenshot of the Wallet screen. # 플랫폼 이벤트 플랫폼 이벤트는 브랜드와 크리에이터를 연결하는 캠페인 기능입니다. 이벤트를 생성하고, 크리에이터의 신청을 받아 선발한 후, 콘텐츠 제출과 배송까지 관리할 수 있습니다. *** ### 이벤트 생성 #### 기본 정보 입력 이벤트를 생성하려면 다음 정보를 입력합니다:
| 항목 | 설명 | 제한 | | --------- | ---------------------- | ------------------------ | | **제목** | 이벤트 제목 | 1\~200자 | | **설명** | 이벤트 상세 설명 (리치 텍스트 에디터) | 최대 2,000자 | | **썸네일** | 이벤트 대표 이미지 | JPG/PNG/GIF/WEBP, 5MB 이하 | | **목표 인원** | 선발할 크리에이터 수 | 1\~10,000명 | #### 일정 설정 | 항목 | 설명 | | -------------- | ---------------------------- | | **신청 시작일** | 크리에이터가 신청할 수 있는 시작일 | | **신청 마감일** | 신청 접수 마감일 | | **콘텐츠 제출 마감일** | 선발된 크리에이터의 콘텐츠 제출 기한 | | **콘텐츠 유지 기한** | 제출된 콘텐츠를 유지해야 하는 기간 (기본 30일) | > 💡 일정은 순서대로 설정해야 합니다: 신청 시작 → 신청 마감 → 콘텐츠 제출 마감 → 콘텐츠 유지 기한 플랫폼 및 콘텐츠 설정 * **SNS 플랫폼 선택**: Instagram, TikTok, YouTube, Threads, X(Twitter), LinkedIn, Pinterest * **콘텐츠 타입**: Post, Reels, Short Form Video, Story, Live, Long Form Video, Carousel * **크리에이터 가이드라인**: 콘텐츠 제작 시 참고할 가이드라인 (1줄에 1개씩) *** ### 이벤트 상태 이벤트는 다음과 같은 상태를 거칩니다: ``` 초안(Draft) → 검토 대기(Pending) → 승인(Approved) → 게시(Published) → 완료(Completed) ``` | 상태 | 설명 | | -------------------- | ----------------- | | **Draft** | 작성 중인 이벤트 (수정 가능) | | **Pending** | 관리자 검토 대기 중 | | **Approved** | 관리자 승인 완료 | | **Published** | 크리에이터에게 공개된 상태 | | **Active / Ongoing** | 현재 신청 접수 중 | | **Completed** | 모든 절차가 완료됨 | | **Cancelled** | 이벤트 취소됨 | *** ### 신청자 관리 #### 신청자 상태 | 상태 | 설명 | | ------------- | -------- | | **Applied** | 신청 접수됨 | | **Approved** | 선발됨 | | **Rejected** | 미선발 | | **Completed** | 모든 과정 완료 | | **Cancelled** | 신청 취소됨 | #### 필터 및 검색 신청자 목록에서 다음 기준으로 필터링할 수 있습니다: * **상태별**: 전체 / 승인 대기 / 승인됨 / 반려됨 / 배송 대기 / 배송 중 / 배송 완료 * **검색**: 크리에이터 이름 또는 이메일로 검색 #### 개별 처리 각 신청자에 대해 다음 작업을 수행할 수 있습니다: * ✅ 승인 (선발) * ❌ 거절 (미선발) * 📦 배송 요청 * ⭐ 크리에이터 평가 #### 일괄 처리 체크박스로 여러 신청자를 선택한 후 다음을 일괄 처리할 수 있습니다: * **일괄 승인**: 선택한 신청자 전체 승인 * **일괄 거절**: 선택한 신청자 전체 거절 * **일괄 배송 요청**: 선택한 신청자에 대해 배송 요청 *** ### 콘텐츠 검수 선발된 크리에이터가 콘텐츠를 제출하면 브랜드에서 검수합니다. #### 검수 절차 1. 신청자 상세 정보에서 제출된 콘텐츠 확인 2. SNS 링크 또는 업로드된 영상 확인 3. **승인** 또는 **거절** 처리 > 💡 콘텐츠가 승인되어야 배송 요청이 가능합니다. *** ### 배송 관리 #### 배송 요청 조건 배송 요청을 위해 다음 조건이 충족되어야 합니다: * 신청자가 **선발(Approved)** 상태 * 콘텐츠가 **승인(Approved)** 상태 * 크리에이터의 **배송 주소**가 등록되어 있어야 함 * 제품이 할당되어 있어야 함 #### 배송 상태 | 상태 | 설명 | | -------------- | ----- | | **Pending** | 배송 대기 | | **Processing** | 접수 완료 | | **Shipped** | 배송 중 | | **Delivered** | 배송 완료 | | **Cancelled** | 배송 취소 | | **Failed** | 배송 실패 | *** ### 크리에이터 평가 이벤트 완료 후 크리에이터를 평가할 수 있습니다. #### 평가 항목 | 항목 | 설명 | | ---------- | ------------------------ | | **종합 평점** | 1\~5점 (필수) | | **콘텐츠 품질** | 창의성, 제작 품질, 브랜드 적합성 (선택) | | **전문성** | 협업 태도 및 행동 (선택) | | **커뮤니케이션** | 응답성 및 명확성 (선택) | | **시간 준수** | 마감 준수 및 일정 관리 (선택) | #### 평점 기준 | 점수 | 의미 | | -- | ------ | | 1점 | 매우 불만족 | | 2점 | 불만족 | | 3점 | 보통 | | 4점 | 만족 | | 5점 | 매우 만족 | > 💡 평가에는 코멘트(10\~1,000자)를 추가할 수 있으며, 태그로 크리에이터 특성을 기록할 수 있습니다. # 폼 이벤트 ## 폼 이벤트 사용자 가이드 — 응모형 캠페인을 직접 운영하기 > **이 가이드는 무엇인가요?** 브랜드가 직접 응모 양식을 만들어 응모자를 모집하고, 선정·배송·콘텐츠·이메일 캠페인까지 한 화면에서 처리할 수 있는 **폼 이벤트** 기능을 모두 안내합니다. 이번에 처음 폼 이벤트를 만드는 분, 자체 고객 풀로 시딩·기프티드를 운영해 본 적이 있는 분, 그리고 매일 응모자 검수와 이메일 발송을 다루는 운영자분을 위해 작성되었습니다. > > **읽는 방법**: 처음 한 번은 위에서부터 차례대로 끝까지 훑어 주세요. 폼 이벤트는 화면이 많고 기능이 풍부해서, 한 번 전체를 훑으면 이후 필요한 영역만 찾기가 훨씬 수월해집니다. *** ### 목차 * 시작하기 전에 * Part 1 · 폼 이벤트란 무엇인가요? * Part 2 · 폼 이벤트 목록 페이지 * Part 3 · 새 폼 이벤트 만들기 * Part 4 · 폼 빌더로 응모 양식 설계하기 * Part 5 · 이벤트 상태와 운영 제어 * Part 6 · 이벤트 상세 페이지 둘러보기 (4개 탭) * Part 7 · 신청자 관리 (응답 탭) * Part 8 · 배송 관리 (배송 탭) * Part 9 · 콘텐츠 검토 (콘텐츠 탭) * Part 10 · 이메일 캠페인 * Part 11 · 통합 콘텐츠 관리 페이지 * Part 12 · 배송사 관리 페이지 * Part 12 · 응모자가 보는 공개 폼 페이지 * 자주 묻는 질문 (Q\&A) * 보안·주의사항 통합 * 다음에 할 일 *** ### 시작하기 전에 #### 이 가이드가 다루는 화면 좌측 메뉴 **폼 이벤트** 영역과 그 안의 모든 화면을 다룹니다. * 폼 이벤트 **목록 페이지** (`/dashboard/form-events`) * 새 폼 이벤트 **생성 다이얼로그** (폼 빌더 포함) * 이벤트 **상세 페이지** (4개 탭: 신청자 / 배송 / 콘텐츠 / 개요) * **통합 콘텐츠 관리** 페이지 (`/dashboard/form-events/content`) * **배송사 관리** 페이지 (`/dashboard/form-events/carriers`) * 응모자가 보는 **공개 폼 페이지** (`/form-events/[이벤트ID]`) #### 본 가이드의 표기 규칙 * **굵은 글씨** = 화면에 보이는 정확한 라벨 * 🔴 빨강 = 되돌리기 어려운 작업 * 🟡 노랑 = 주의해서 진행할 작업 * 💡 = 알아 두면 좋은 팁 * 📧 = 이메일 캠페인 관련 팁 * ⭐ = 효율을 크게 올려 주는 기능 * 섹션 번호는 Part 기준으로 표기됩니다 — 예: **7-4**는 "Part 7의 네 번째 섹션"이라는 뜻 *** # 폼 이벤트란 무엇인가요? ### Part 1 · 폼 이벤트란? ### 1-1. 폼 이벤트의 정의 **폼 이벤트**는 브랜드가 **응모 양식을 직접 설계**하고, **자체 채널로 모객**해서, **응모자를 직접 선정·배송·평가**하는 캠페인 기능입니다. 흔한 활용 예: * 신제품 **시딩**(seeding) — 인플루언서·체험단에게 무상 발송 * **기프티드**(giveaway) — 자사 고객 대상 추첨 이벤트 * **리뷰 모집** — 콘텐츠 제출을 조건으로 한 사전 체험단 * **자체 캠페인** — 뉴스레터 구독자 대상 한정 응모 #### 1-1-1. 플랫폼 이벤트와 다른 점 | 구분 | 폼 이벤트 (이 가이드) | 플랫폼 이벤트 | | ---------- | ----------------------------- | -------------------------- | | **이벤트 주체** | 브랜드가 자체 운영 또는 하이퍼케이프 대행 선택 가능 | 하이퍼케이프가 모집·심사·배송까지 전 과정 운영 | | **누가 응모?** | 누구나 (공개 URL로 응모) | 하이퍼케이프 등록 크리에이터만 | | **응모 양식** | 브랜드가 폼 빌더로 직접 설계 | 정해진 형식 (SNS·콘텐츠 타입) | | **모객** | 브랜드가 자체 채널(SNS, 뉴스레터 등)로 홍보 | 플랫폼 크리에이터 풀 자동 노출 | | **승인 절차** | 즉시 게시 (Live) | 운영팀 검토 후 게시 | | **이메일 발송** | 브랜드가 직접 운영 (강력한 캠페인 시스템) | 플랫폼이 자동 처리 | | **비용** | 자체 운영 (별도 청구 없음) | 티어별 단가 자동 계산 | > 💡 **두 기능을 함께 쓰는 게 일반적입니다** 큰 신제품 런칭은 플랫폼 이벤트로 크리에이터 매칭을 받고, 자사 고객 대상 시딩은 폼 이벤트로 따로 운영하는 식입니다. #### 1-1-2. 진입 경로
**좌측 메뉴 > 캠페인 > 폼 이벤트** 를 클릭합니다. # 폼 이벤트 목록 페이지 ## Part 2 · 폼 이벤트 목록 페이지 좌측 메뉴에서 **폼 이벤트**를 클릭하면 가장 먼저 만나는 화면입니다. 지금까지 만든 모든 캠페인이 한 표에 정리되어 있으며, 새 캠페인을 만들거나 응모자 데이터를 내려받는 모든 작업의 시작점입니다.
### 2-1. 페이지 상단 — 안내 영역 페이지 맨 위에는 카테고리 라벨, 페이지 설명, 안내 카드가 차례대로 표시됩니다. * 카테고리: **캠페인 · 폼 이벤트** * 페이지 부제: **"폼 이벤트는 몰 없이도 시작할 수 있는 캠페인 흐름입니다."** * 안내 카드: 폼 이벤트가 무엇인지, 플랫폼 이벤트와 어떻게 다른지 짧게 설명 ### 2-2. 우상단 액션 — 3개 버튼 페이지 우상단에는 자주 쓰는 3개 버튼이 가로로 나열됩니다.
| 버튼 | 아이콘 | 동작 | | ---------- | ------------- | ----------------------------------------------------------- | | **Export** | 📥 (Download) | 여러 이벤트의 응모자 데이터를 한 엑셀 파일(이벤트별 시트 분리)로 내려받기 — 자세한 동작은 7-7 참고 | | **배송사 관리** | 🚚 (Truck) | 배송사 관리 페이지로 이동 (Part 12) | | **캠페인 생성** | ➕ (Plus) | 새 폼 이벤트(캠페인) 만들기 다이얼로그 열기 (Part 3) | ### 2-3. 검색 · 필터 이벤트 목록 표 위쪽에는 검색창과 필터들이 자리합니다.
#### 2-3-1. 검색 원하는 이벤트를 검색합니다. * **이벤트명** * **참가자 이름** * **참가자 이메일** 플레이스홀더에도 "이벤트명, 참가자 이름 또는 이메일 검색..." 으로 표시됩니다. 입력 후 결과가 즉시 좁혀집니다. #### 2-3-2. 상태 필터 | 옵션 | 의미 | | ------------------- | ------------------ | | **모든 상태** | 필터 해제 (기본) | | **Not started yet** | 신청 시작일 이전 (예정 캠페인) | | **Live** | 신청 기간 안 — 응모 접수 중 | | **Ended** | 신청 마감 또는 운영자 수동 종료 | #### 2-3-3. 태그 필터 | 옵션 | 의미 | | ------------ | --------------------- | | **모든 태그** | 필터 해제 | | **Seeding** | 시딩 캠페인 (체험단·인플루언서 발송) | | **Giveaway** | 경품·추첨 캠페인 | #### 2-3-4. 페이지 크기 한 화면에 보일 이벤트 수를 **10 / 25 / 50 / 100** 중에서 선택합니다. 운영하는 캠페인이 많을 때 큰 값으로 두면 한눈에 더 많이 볼 수 있습니다. ### 2-4. 이벤트 목록 표 — 8개 컬럼 표는 다음 컬럼 순서로 구성됩니다.
| 컬럼 | 표시되는 정보 | | -------- | ---------------------------------------------- | | **No.** | 행 번호 (01, 02, …) | | **이벤트명** | 캠페인 제목 + 한 줄 설명. **제목은 링크**로, 클릭하면 상세 페이지로 이동 | | **Tag** | Seeding 또는 Giveaway 배지 (없으면 `-`) | | **상태** | Live(초록) / Ended(파랑) / Not started yet 등 상태 배지 | | **기간** | 📅 신청 시작일 \~ 종료일 | | **신청자** | 👥 누적 응모자 수 (예: "1,182명") | | **선정자** | 🏆 확정된 선정자 수 / 모집 정원 (예: "300 / 300") | | **관리** | `⋯` 더보기 메뉴 (다음 항목 참고) | ### 2-5. 행에서 가능한 작업 행에서 액션을 실행하는 방법은 두 가지입니다. #### 2-5-1. 이벤트명(제목) 클릭 → 상세 페이지로 이동 이벤트명 컬럼의 제목 자체가 링크입니다. 클릭하면 그 캠페인의 **상세 페이지**(Part 6)로 이동합니다. > 행 다른 영역(태그·상태·기간 등)을 클릭해도 이동하지 않습니다. **반드시 제목**을 눌러주세요. #### 2-5-2. 관리 컬럼의 `⋯` 버튼 → 4가지 메뉴 행 우측 끝의 `⋯` 버튼을 누르면 드롭다운이 펼쳐집니다.
| 메뉴 | 아이콘 | 동작 | 표시 조건 | | --------- | --------------- | ------------------------------ | --------------- | | **상세 보기** | 👁 (Eye) | 이벤트 상세 페이지로 이동 | 항상 | | **설정** | ⚙️ (Settings) | 기본 정보·폼 빌더·이메일 템플릿 수정 다이얼로그 열기 | 항상 | | **링크 복사** | 🔗 (Share2) | 응모자에게 공유할 공개 폼 URL을 클립보드에 복사 | **Live 상태**일 때만 | | **삭제** | 🗑 (Trash2, 빨강) | 이벤트 삭제 확인 다이얼로그 | 항상 (구분선 위) | **삭제 시 확인 절차** **삭제** 메뉴를 클릭하면 확인 다이얼로그가 열립니다. 안내 문구 아래의 입력란에 \*\*`Delete`\*\*를 정확히 입력해야 \[삭제] 버튼이 활성화됩니다. 실수로 삭제하는 것을 막기 위한 안전 장치이며, 한 번 삭제된 이벤트는 복구할 수 없습니다. ### 2-6. 페이지 하단 — 페이지네이션 이벤트 수가 페이지 크기를 넘으면 표 아래에 **이전 / 다음** 버튼과 페이지 번호가 표시됩니다. 이벤트가 하나도 없는 빈 상태에서는 안내 문구와 **\[캠페인 생성]** 버튼이 표시됩니다. # 새 캠페인 만들기 ## Part 3 · 새 캠페인 만들기 폼 이벤트 목록 페이지 우상단의 **➕ 캠페인 생성** 버튼을 누르면 큰 다이얼로그가 열립니다. 이 다이얼로그 하나에서 캠페인의 모든 기본 설정을 마칠 수 있습니다.
### 3-1. 다이얼로그 구조 — 탭으로 단계 분리 생성 다이얼로그는 상단에 **3개 탭**이 가로로 나열됩니다 (이미 만든 이벤트를 수정하는 경우엔 4개 탭). | 탭 | 다루는 내용 | 노출 조건 | | ---------- | --------------------------------- | ------------ | | **기본 정보** | 제목·이벤트 상품·일정·선정자 수·태그·콘텐츠 요구 여부 | 항상 | | **캠페인 설명** | 응모자에게 보여줄 본문 (리치 텍스트 + 이미지) | 항상 | | **참가 양식** | 응모자에게서 받을 정보 — 폼 빌더 (Part 4 참고) | 항상 | | **메일 설정** | 자동 발송될 6가지 메일 템플릿 편집 (Part 10 참고) | **수정 모드에서만** | > 💡 **메일 설정은 수정 모드에서만 보입니다** 새 캠페인을 처음 만들 때는 기본 메일 템플릿이 자동으로 설정되며, 캠페인이 만들어진 후에 다시 들어와 메일 내용을 다듬을 수 있습니다. ### 3-2. 기본 정보 탭
#### 3-2-1. 이벤트 제목
| 항목 | 내용 | | ---------- | ------------------------------ | | **라벨** | 이벤트 제목 | | **플레이스홀더** | "예: 신제품 출시 기념 FormEvent Event" | | **제한** | 1\~200자 (입력 중 카운터가 우상단에 표시됨) | #### 3-2-2. 이벤트 상품 — 카탈로그에서 선택
응모자에게 발송할 제품을 **등록된 제품 카탈로그(PIM)에서 직접 선택**합니다. **추가하기** 1. 영역 우측 **\[+ 제품 추가]** 버튼 클릭 2. 검색창에서 **제품명 / SKU / 바코드**로 검색 3. 검색 결과에서 제품 선택 → 제품 카드로 추가됨 **추가된 제품 카드** 각 제품 카드에는 다음이 표시됩니다. * 썸네일 이미지 * 제품명 + 브랜드명 * **수량 입력란** (1 이상) * ✕ 제거 버튼 여러 제품을 추가하면 카드가 세로로 쌓입니다. > 💡 **이 정보는 자동으로 어디에 쓰이나요?** 등록한 이벤트 상품은 **콘텐츠 확인 팝업**(콘텐츠 검수 시)과 **출고지시서**(배송 단계)에 자동 반영됩니다. 별도로 다시 입력할 필요가 없습니다. #### 3-2-3. 신청 기간 — 시작일 / 종료일
신청 시작일과 종료일을 두 개의 날짜 선택기에 입력합니다. * **신청 시작일**: 오늘 이후 날짜만 선택 가능 * **신청 종료일**: 시작일 다음 날 이후만 선택 가능 > 캠페인이 이미 시작되었거나 응모자가 일정 수 이상 모인 경우 일부 날짜는 **수정 불가**(주황색 표기)로 잠깁니다. #### 3-2-4. 선정자 수 · Tag · 콘텐츠 제출 필요
세 항목이 한 줄에 3분할 카드로 배치됩니다. | 항목 | 입력 방식 | 의미 | | -------------------------- | -------------- | ----------------------------------- | | **선정자 수 (Approval Limit)** | 숫자 (1\~10,000) | 몇 명을 뽑을지 (소프트 리밋 — 시스템이 강제로 막지는 않음) | | **Tag** | 드롭다운 | None / **시딩** / **경품** 중 선택 | | **콘텐츠 제출 필요** | 스위치 | 응모자에게 콘텐츠 URL 제출을 요구할지 (On/Off) | > 💡 **"콘텐츠 제출 필요"가 On이면** 응모자가 선정된 뒤 콘텐츠 URL을 제출하는 단계가 추가되며, 이벤트 상세 페이지에 **콘텐츠 탭**이 자동으로 노출됩니다 (Part 9 참고). Off로 두면 단순 추첨·발송 캠페인이 됩니다. #### 3-2-5. 콘텐츠 수집 옵션 (콘텐츠 제출 필요 On일 때만)
콘텐츠 제출 필요를 On으로 두면 그 아래에 **콘텐츠 수집 옵션** 섹션이 펼쳐집니다. | 필드 | 의미 | | ------------------ | ---------------------------------------- | | **이벤트 상품명** | 응모자(creator)의 콘텐츠 제출 확인 팝업에 그대로 노출되는 상품명 | | **이벤트 상품 이미지 URL** | 응모자에게 보여줄 상품 대표 이미지 URL | 여기에 입력한 정보는 **응모자가 콘텐츠를 제출할 때 확인 화면**에 보여, 어떤 제품에 대한 콘텐츠인지 명확히 알리는 역할을 합니다. ### 3-3. 캠페인 설명 탭
응모자가 공개 폼 페이지(Part 13)에서 보게 될 **본문**을 작성하는 탭입니다. * **리치 텍스트 에디터** — 굵게·기울임·목록·링크 등 기본 서식 지원 * **이미지 삽입** — 이벤트 분위기·제품 컷·당첨 혜택 등 시각 자료 첨부 가능 * 길이 제한: 최대 5,000자 > 💡 작성한 내용은 **공개 폼 페이지의 이벤트 정보 카드**(13-5-1 참고)에 그대로 노출됩니다. ### 3-4. 참가 양식 탭
응모자에게서 받을 추가 정보를 **폼 빌더**로 자유롭게 설계하는 탭입니다. * 9가지 필드 타입 (텍스트·장문 텍스트·이메일·전화·숫자·날짜·드롭다운·라디오·체크박스) * 드래그로 순서 변경 / 조건부 표시 / 유효성 규칙 * 실시간 미리보기 자세한 사용법은 **Part 4 · 폼 빌더로 응모 양식 설계하기**에서 다룹니다. ### 3-5. 메일 설정 탭 — 수정 모드에서만
이미 만들어진 캠페인을 **편집**할 때만 노출되는 탭입니다. 응모 → 선정 → 배송 → 콘텐츠 요청 등 단계별로 자동 발송되는 **6가지 메일 템플릿**의 제목·본문을 캠페인 단위로 수정할 수 있습니다. 자세한 내용은 **Part 10 · 이메일 캠페인** 참고. ### 3-6. 생성 완료 화면 — 가이드 투어 (리뉴얼 예정)
\[저장] 또는 \[캠페인 생성] 버튼을 누르면 다음 단계가 진행됩니다. 1. 폼 데이터 유효성 검증 (실패 시 해당 필드로 자동 스크롤) 2. 서버에 캠페인 등록 3. 다이얼로그 내용이 **이벤트 생성 완료 화면**으로 전환 #### 3-6-1. 완료 화면 구성 | 영역 | 내용 | | ----------------- | -------------------------------------------------- | | 초록 체크 + 제목 | ✅ "이벤트가 생성되었습니다" | | **이메일 발송 가이드** 카드 | 클릭하면 자동 발송되는 메일 템플릿과 주요 기능을 안내하는 투어가 시작됨 | | **메일 관리 가이드** 카드 | 첫 가이드 완료 후 노출. 발송 현황·일괄 발송·리마인더 사용법 안내 | | 안내문 | "가이드를 다시 보고 싶다면 **메일 관리** 페이지의 **가이드** 버튼을 이용하세요." | #### 3-6-2. 닫기 / 이벤트 관리 | 버튼 | 노출 조건 | 동작 | | ---------- | --------------- | ---------------------------- | | **이벤트 관리** | 두 가이드 모두 완료한 경우 | 만들어진 캠페인의 상세 페이지(Part 6)로 이동 | | **닫기** | 두 가이드 완료 후 활성화 | 다이얼로그 닫기 | > 🟡 **두 가이드를 완료해야 다이얼로그를 닫을 수 있습니다** 처음 캠페인을 만든 운영자가 메일 발송 흐름을 모르고 지나치는 일을 막기 위한 안전 장치입니다. 두 번째 캠페인부터는 가이드를 다시 보지 않아도 됩니다 (필요할 때 메일 관리 페이지에서 다시 볼 수 있음). ### 3-7. 입력 검증과 자동 스크롤 저장 시 빠진 필드나 잘못된 값이 있으면: * **에러 메시지가 해당 필드 라벨 옆에 빨간 글씨**로 표시됨 * **첫 번째 에러 필드로 자동 스크롤** + 입력란이 잠시 흔들리는 효과 * 탭이 다른 곳에 있는 에러는 해당 탭으로 자동 전환 이 덕분에 큰 폼이라도 어디를 채워야 할지 빠르게 알 수 있습니다. # 폼 빌더로 응모 양식 설계하기 ## Part 4 · 폼 빌더로 응모 양식 설계하기 응모자에게서 받을 정보를 자유롭게 설계하는 화면입니다. 캠페인 생성 다이얼로그(Part 3)의 **참가 양식** 탭에서 사용하며, 9가지 필드 타입을 조합해 원하는 만큼 질문을 만들 수 있습니다. 영역 제목은 **참가 폼 설정**, 안내 문구는 "신청자가 작성할 추가 질문을 설정하세요."로 표시됩니다.
### 4-1. 폼 빌더 화면 구성 폼 빌더는 두 영역으로 분리되어 있습니다. | 영역 | 위치 | 역할 | | ---------------- | ------------- | ------------------------------------------------ | | **필드 추가** 팔레트 | 좌측 (200px 너비) | 9가지 필드 타입 버튼이 세로로 나열 — 클릭 또는 드래그 앤 드롭으로 추가 | | **미리보기 + 편집** 패널 | 우측 (가변 너비) | 추가된 필드가 응모자 시점에서 어떻게 보이는지 실시간 미리보기 + 클릭하면 인라인 편집 | 상단에는 헤더가 있어 **현재 필드 수**(`N/20 필드`)와 우측 액션 버튼을 표시합니다. ### 4-2. 상단 헤더 — 필드 수 + 3개 액션
#### 4-2-1. 필드 카운트 배지 좌상단에 영역 제목 옆으로 **현재 필드 수 / 최대 필드 수** 배지가 표시됩니다 (예: `5/20 필드`). 최대치(20개)에 도달하면 좌측 팔레트의 필드 타입 버튼이 비활성화되고 **"최대 N개까지"** 안내가 노출됩니다. #### 4-2-2. 우상단 3개 버튼 | 버튼 | 아이콘 | 동작 | 활성 조건 | | ------------- | --------------- | ----------------------------------- | -------- | | **현재 템플릿 저장** | 💾 (Save) | 지금 만들어진 양식을 템플릿으로 저장 (다음 캠페인에서 재사용) | 필드 1개 이상 | | **템플릿 관리** | 📥 (FileDown) | 템플릿 라이브러리 다이얼로그 열기 (4-7 참고) | 항상 | | **필드 전체삭제** | 🗑 (Trash2, 빨강) | 추가된 모든 필드를 한 번에 비움 | 필드 1개 이상 | ### 4-3. 9가지 필드 타입
좌측 팔레트의 9개 버튼은 각각 다른 입력 형식을 만듭니다. | 라벨 | 입력 형식 | 짧은 설명 | | ---------- | ------------ | ----------------- | | **텍스트** | 한 줄 입력 | 짧은 텍스트 입력 | | **장문 텍스트** | 여러 줄 입력 | 긴 텍스트 입력 (여러 줄) | | **이메일** | 이메일 입력 | 이메일 주소 입력 (형식 검증) | | **전화번호** | 전화번호 입력 | 전화번호 입력 | | **숫자** | 숫자만 입력 | 숫자만 입력 | | **날짜** | 날짜 선택기 | 날짜 선택 | | **드롭다운** | 단일 선택 (드롭다운) | 드롭다운에서 하나 선택 | | **라디오 버튼** | 단일 선택 (라디오) | 여러 옵션 중 하나 선택 | | **체크박스** | 다중 선택 | 하나 또는 여러 개 선택 | > 💡 **버튼에 마우스를 올리면** 우측에 미리보기 툴팁이 떠올라 그 필드 타입이 응모자에게 어떻게 보이는지를 한눈에 확인할 수 있습니다 (실제 입력란 모양 + 짧은 설명). ### 4-4. 필드 추가 방법 | 방법 | 동작 | | ------------ | ------------------------------------------- | | **클릭** | 좌측 팔레트의 필드 타입을 클릭 → 미리보기 패널 맨 아래에 새 필드가 추가됨 | | **드래그 앤 드롭** | 좌측 팔레트의 필드 타입을 드래그해 미리보기 패널의 원하는 위치에 떨어뜨림 | ### 4-5. 필드 편집 — 인라인 편집
미리보기 패널의 각 필드를 **클릭하면 그 자리에서 바로 편집**할 수 있습니다 (별도 다이얼로그 없이 인라인 편집). #### 4-5-1. 공통 입력란 | 입력 | 의미 | | ------- | ------------------------------ | | **레이블** | 응모자에게 보일 질문 (예: "이름을 입력해 주세요") | | **도움말** | 라벨 아래 작은 글씨로 노출되는 추가 설명 | #### 4-5-2. 필드 타입별 추가 입력란 | 필드 타입 | 추가 입력란 | | ------------------------------ | ---------------------------- | | 텍스트 / 장문 텍스트 / 이메일 / 전화번호 / 숫자 | **플레이스홀더** (입력란에 흐리게 보이는 예시) | | 드롭다운 | 플레이스홀더 + **옵션 목록** | | 라디오 / 체크박스 | **옵션 목록** (각 옵션의 라벨 입력) | | 날짜 | 플레이스홀더 | #### 4-5-3. 우상단 토글 두 개 각 필드 카드의 우상단에 **두 개의 작은 토글**이 있습니다. | 토글 | 의미 | | ------- | ----------------------------- | | **필수** | 응모자가 반드시 입력해야 하는 필드인지 | | **조건부** | 다른 필드의 답변에 따라 보이게 할지 (4-6 참고) | ### 4-6. 템플릿 — 양식을 저장하고 재사용하기 자주 쓰는 양식을 매번 처음부터 만들지 않도록 **템플릿**으로 저장해 두고 다음 캠페인에서 그대로 불러올 수 있습니다. #### 4-6-1. 현재 양식을 템플릿으로 저장
폼 빌더 우상단의 **\[💾 현재 템플릿 저장]** 클릭 → 저장 다이얼로그가 열립니다. | 입력 | 의미 | | ------ | --------------------------- | | **이름** | 템플릿 식별 이름 (예: "K-뷰티 기본 양식") | | **설명** | 간단한 설명 (선택) | 다이얼로그 제목은 **"참가양식 템플릿 저장"** 입니다. 저장된 템플릿은 같은 브랜드의 모든 캠페인에서 사용할 수 있습니다. #### 4-6-2. 템플릿 라이브러리 — 불러오기 / 관리 폼 빌더 우상단의 **\[📥 템플릿 관리]** 클릭 → **참가양식 템플릿 관리** 다이얼로그가 열립니다. 부제: "저장된 템플릿을 불러오거나 다른 폼 이벤트의 양식을 가져올 수 있어요."
**다이얼로그 구성** | 영역 | 내용 | | -------------------- | ------------------------------------------------------ | | **좌측 — 템플릿 목록** | 저장된 템플릿이 카드로 나열. 클릭하면 우측에서 미리보기 | | **우측 — 미리보기** | 선택한 템플릿의 양식을 실제 모습 그대로 표시 | | **미리보기 모드 토글** (우상단) | **템플릿만 보기** ↔ **전체 미리보기** 전환 — 전체 미리보기는 캠페인 정보까지 합친 모습 | **가능한 작업** * **불러오기**: 카드를 클릭한 뒤 \[적용] 또는 더블클릭 → 현재 폼 빌더에 그 양식이 그대로 채워짐 * **삭제**: 더 이상 쓰지 않는 템플릿 제거 **빈 상태** 저장된 템플릿이 0개면 좌측에 "**저장된 템플릿이 없습니다.**", 우측에 "좌측에서 템플릿을 선택하여 전체 참가양식을 미리보기 하세요." 안내가 표시됩니다. ### 4-7. 실시간 미리보기 미리보기 패널은 **응모자가 실제로 보게 될 화면**을 그대로 보여줍니다. 필드를 추가·편집할 때마다 **즉시 반영**되므로, 양식이 너무 길지 않은지·모바일에서도 어색하지 않은지 한눈에 확인할 수 있습니다. > 💡 응모자에게 노출되는 공개 폼 페이지의 정확한 모습은 Part 13에서 다룹니다. # 이벤트 상태와 운영 제어 ## Part 5 · 이벤트 상태와 운영 제어 폼 이벤트는 **두 가지 상태값**을 동시에 가집니다. 하나는 시간이 흐르면 자동으로 바뀌고, 다른 하나는 운영자가 필요할 때 직접 켜고 끕니다. 이 두 상태가 합쳐져서 응모자에게 폼이 노출될지가 결정됩니다.
### 5-1. 두 가지 상태값 — State / Status | 구분 | State (자동) | Status (수동) | | ------------- | ------------------------------ | ------------------- | | **무엇이 결정?** | 시간 (신청 기간) | 운영자가 직접 | | **값** | `scheduled` / `live` / `ended` | `live` / `closed` | | **자동 변경?** | 시간이 흐르면 자동으로 변함 | 운영자가 명시적으로 바꿀 때만 변함 | | **응모 차단 영향?** | `live`가 아니면 응모 불가 | `closed`면 응모 불가 | #### 응모 가능 여부 결정 응모자에게 폼이 노출되려면 **두 상태가 모두 충족되어야** 합니다. 즉, 시간 기반 State가 **Live**이고, 운영자가 설정한 Status가 **진행중**일 때만 응모자가 폼을 작성할 수 있습니다. > 💡 **두 상태가 같은 단어("live")를 쓰는 이유** "응모 기간이 시작됐고(State), 운영자도 받기로 한 상태(Status)"라는 두 조건을 따로 표현하기 위해 같은 단어가 두 곳에서 사용됩니다. 화면에서는 라벨이 다르게 표시되니 헷갈릴 일은 거의 없습니다 (State는 영문, Status는 한국어). ### 5-2. State — 시간 기반 자동 상태 (3가지) 신청 시작일·종료일을 현재 시각과 비교해 시스템이 자동으로 매기는 값입니다. 운영자가 손댈 게 없습니다. | 값 | 화면 라벨 | 색상 | 의미 | | ----------- | ------------------- | --- | ------------------ | | `scheduled` | **Not started yet** | 호박색 | 신청 시작일 이전 (예정 캠페인) | | `live` | **Live** | 초록 | 신청 기간 안 — 응모 폼이 활성 | | `ended` | **Ended** | 파랑 | 신청 종료일 경과 — 응모 차단 | 폼 이벤트 목록 페이지(Part 2)와 응모자 공개 폼(Part 13)에서 이 라벨을 그대로 보게 됩니다. ### 5-3. Status — 운영자 수동 제어 (2가지) 운영자가 직접 켜고 끄는 값입니다. | 값 | 화면 라벨 | 색상 | 의미 | | ------- | ------- | -- | -------------- | | `live` | **진행중** | 초록 | 정상 운영 (기본값) | | `ended` | **종료** | 파랑 | 운영자가 강제로 응모 차단 | 신청 종료일이 아직 남았더라도 응모를 미리 닫고 싶을 때 사용합니다 (5-5 참고). ### 5-4. 응모 페이지에서 보이는 모습
같은 이벤트라도 두 상태의 조합에 따라 응모자가 보는 화면이 달라집니다. | State | Status | 응모자가 보는 화면 | | ----------- | -------- | ---------------------------------- | | `scheduled` | (무관) | "이 이벤트는 아직 시작되지 않았습니다." + 신청 기간 안내 | | `live` | `live` | 응모 폼 + **참가 신청하기** 버튼 (정상 응모 가능) | | `live` | `closed` | "이 이벤트는 종료되었습니다." (운영자가 미리 닫음) | | `ended` | (무관) | "이 이벤트는 종료되었습니다." (기간 만료) | 응모자가 보는 정확한 화면 구성은 **Part 13 · 응모자가 보는 공개 폼 페이지**에서 자세히 다룹니다. ### 5-5. 이벤트 수동 종료 — Status를 `closed`로 신청 종료일 전에 응모를 미리 닫고 싶을 때 사용합니다.
#### 5-5-1. 종료 버튼 위치 이벤트 상세 페이지(Part 6)에서 진행할 수 있습니다. 자세한 헤더 구성은 Part 6에서 다룹니다. #### 5-5-2. 종료 확인 다이얼로그 종료 버튼을 누르면 확인 다이얼로그가 열립니다. * **제목**: 이벤트 종료 * **안내 문구**: "이벤트를 종료하면 더 이상 참가 신청을 받을 수 없습니다. 기존 신청자는 영향받지 않습니다. 계속하시겠습니까?" 확정하면 즉시 Status가 `closed`로 바뀌고, 응모 페이지가 "이 이벤트는 종료되었습니다." 화면으로 전환됩니다. > 🟡 **종료한 이벤트는 다시 진행 상태로 자동 복귀하지 않습니다** 다시 응모를 받으려면 운영팀에 문의하셔야 합니다. 응모자에게 혼란을 줄 수 있어 자주 사용하는 기능은 아니며, 보통은 신청 종료일이 자연스럽게 도래하도록 두는 것이 권장됩니다. ### 5-6. 상태 표시 위치 — 어디서 확인하나요? | 화면 | 표시되는 상태 | | -------------------------- | ----------------------------------------- | | **폼 이벤트 목록 표** (Part 2) | State 배지 (Live / Ended / Not started yet) | | **상세 페이지 헤더** (Part 6) | State + Status 모두 | | **응모자가 보는 공개 폼** (Part 13) | 두 상태의 조합에 따라 다른 화면 | | **메일 관리 페이지** (Part 10-5) | 이벤트 단위 상태 | 상태에 따라 일부 액션(편집·일괄 메일 발송 등)이 잠기거나 풀립니다. 자세한 제약은 각 파트의 해당 항목에서 안내합니다. # 이벤트 상세 페이지 ## Part 6 · 이벤트 상세 페이지 폼 이벤트 목록(Part 2)에서 캠페인 제목을 클릭하면 그 캠페인의 모든 운영 작업을 진행하는 **상세 페이지**로 이동합니다. 응모자 관리·배송·콘텐츠·이메일 발송이 모두 여기에서 이루어집니다.
### 6-1. 페이지 헤더 — 좌측 상세 페이지의 맨 위 좌측 영역에는 다음 요소가 차례대로 배치됩니다.
| 위치 | 요소 | 동작 | | ------- | ------------------------------------------ | ------------------------- | | 좌상단 | **← (돌아가기)** 아이콘 | 폼 이벤트 목록으로 복귀 | | 중앙 | **이벤트 제목** | 큰 글씨로 표시 | | 제목 옆 | **상태 배지** (Live / Ended / Not started yet) | 시간 기반 자동 상태 (Part 5-2 참고) | | 상태 배지 옆 | **Tag 배지** (Seeding / Giveaway) | 캠페인에 태그가 설정된 경우에만 표시 | ### 6-2. 페이지 헤더 — 우상단 액션 5개 헤더 우측에는 자주 쓰는 5개 액션이 가로로 나열됩니다. 처음 3개는 **아이콘 버튼**(마우스 호버 시 툴팁), 뒤 2개는 **라벨이 있는 버튼**입니다.
| 버튼 | 아이콘 | 동작 | 표시 조건 | | ------------- | -------------- | ----------------------------------- | --------------- | | **CS 이메일 관리** | ✉️ (Mail) | 응모자에게 노출되는 고객 문의 이메일 설정 다이얼로그 | 항상 | | **배송사 관리** | 🚚 (Truck) | 배송사 관리 페이지로 이동 (Part 12) | 항상 | | **신청 링크 복사** | 🔗 (Share2) | 응모자에게 공유할 공개 폼 URL을 클립보드로 복사 | 항상 | | **수정** | ✏️ (Edit) | 캠페인 정보·폼 빌더·이메일 템플릿 편집 다이얼로그 | 항상 | | **종료** | ⏹ (Square, 빨강) | 응모를 강제로 닫음 — 확인 다이얼로그 노출 (Part 5-5) | **Live 상태일 때만** | > 💡 **신청 링크 복사** 복사된 링크가 곧 응모자에게 보낼 공개 폼 페이지(Part 13) 주소입니다. SNS·뉴스레터·DM 등 자체 채널로 공유하면 누구나 응모할 수 있습니다. ### 6-3. CS 이메일 관리 — 응모자 문의 받을 이메일
헤더의 **✉️ CS 이메일 관리** 아이콘을 누르면 다이얼로그가 열려 이 캠페인의 고객 문의 이메일을 등록·수정할 수 있습니다. 여기에 등록된 이메일은 응모자에게 자동 발송되는 모든 메일에 **"문의는 ○○○@brand.com 으로"** 형식으로 함께 노출됩니다. 응모자가 의문이 생겼을 때 답장할 곳이 됩니다. ### 6-4. 4개의 탭 — 화면 전환 헤더 영역 아래에는 가로 탭 메뉴가 있습니다. 각 탭에는 **카운트가 괄호 안에** 함께 표시되어 한눈에 양을 파악할 수 있습니다 (예: `신청자 (1,182)`, `배송 (300)`).
| 탭 | 옆에 표시되는 카운트 | 다루는 내용 | 표시 조건 | | ------- | ----------- | ---------------------- | ------------------ | | **신청자** | 총 응모자 수 | 응모자 검색·심사·일괄 처리 | 항상 | | **배송** | 선정된 응모자 수 | 운송장 등록·배송 상태·배송불가 마킹 | 항상 | | **콘텐츠** | 콘텐츠 응모자 수 | 제출된 URL 검수·메모·삭제 요청 처리 | "콘텐츠 제출 필요" On일 때만 | | **개요** | — | 캠페인 정보·통계 종합 표시 | 항상 | 각 탭은 다음 파트에서 자세히 다룹니다. * 신청자 탭 → **Part 7** * 배송 탭 → **Part 8** * 콘텐츠 탭 → **Part 9** ### 6-5. 탭 메뉴 줄 우측 — 운영 액션 3개 탭 메뉴와 같은 줄의 **우측 끝**에는 자주 쓰는 운영 액션 3개가 자리합니다. 신청자 탭에서 가장 많이 쓰지만 다른 탭에서도 그대로 보입니다.
| 버튼 | 아이콘 | 동작 | | ----------- | ------------- | ---------------------------------------------------------- | | **엑셀 다운로드** | 📥 (Download) | 이 캠페인의 응모자 데이터를 엑셀로 받기 — 다운로드 범위·제외 옵션 다이얼로그 (Part 7-6 참고) | | **선정자 추가** | 👥 (Users) | 응모를 거치지 않고 선정자(winner) 1명을 이메일로 직접 등록 (Part 7-5-1) | | **일괄 작업** | 📄 (FileText) | 엑셀로 등록·선정·배송정보·참가자 정보를 한 번에 처리하는 통합 다이얼로그 (Part 7-5-2) | ### 6-6. 개요 탭 — 캠페인 정보 종합
**개요** 탭에는 캠페인의 모든 기본 정보와 통계가 모여 있습니다. 자주 들어가는 화면은 아니지만 다음 정보를 한 화면에서 점검할 수 있습니다. * 제목 / 설명 (캠페인 설명) * 신청 기간 (시작일 \~ 종료일) * 선정자 한도, 태그, 콘텐츠 제출 필요 여부 * 등록된 이벤트 상품 + 수량 * 응모자 수·선정자 수 등 누적 통계 * 자동 발송된 메일 통계 (도달·반송·열람 카운트) 이 탭의 정보는 모두 **수정** 버튼(헤더의 ✏️)으로 편집할 수 있습니다. # 신청자 관리 ## Part 7 · 신청자 관리 이벤트 상세 페이지의 **신청자** 탭에서는 응모자를 검색·심사·일괄 처리합니다. 캠페인을 만들고 나면 가장 자주 들어가는 화면이며, 일반 운영의 90%가 여기서 진행됩니다.
### 7-1. 표 위 영역 — 검색·필터·컬럼 설정 신청자 표 위쪽에는 두 줄에 걸쳐 도구가 배치됩니다. #### 7-1-1. 국가 필터 좌측의 **모든 국가 ▾** 드롭다운으로 응모자가 입력한 국가 코드(BR, US, ES 등)별로 좁힐 수 있습니다. #### 7-1-2. 통합 검색 검색창에 입력하면 **이름·이메일·운송장번호** 세 가지를 동시에 검색합니다. 플레이스홀더에도 "이름, 이메일 또는 운송장번호 검색..." 으로 표시됩니다. > 💡 **운송장번호도 검색에 포함되는 이유** "어제 발송한 DHL 운송장 1234... 의 응모자가 누구였지?" 같은 역추적이 자주 필요해서 검색 대상에 포함되었습니다. #### 7-1-3. 컬럼 설정 ⚙️ 검색창 바로 옆의 **⚙️(슬라이더 아이콘)** 버튼을 누르면 응모자 표에 어떤 컬럼을 보여줄지 선택할 수 있습니다 (자세한 내용은 7-3-2 참고). ### 7-2. 상태 필터 — 9개 가로 탭 검색 줄 아래에 **9개 필터 버튼**이 가로로 나열되며, 각 탭 옆에 카운트가 함께 표시됩니다.
| 탭 라벨 | 색상 | 의미 | 표시 조건 | | ---------- | ---- | ------------------------------ | ------------------ | | **전체** | — | 모든 응모자 (총합) | 항상 | | **대기중** | 노랑 | 아직 심사 안 한 응모자 | 항상 | | **확정** | 파랑 | 확정 마킹된 응모자 (배송 우선 등) | 항상 | | **선정** | 초록 | 선정 처리된 응모자 | 항상 | | **미선정** | 빨강 | 미선정 처리된 응모자 | 항상 | | **제출완료** | 에메랄드 | 콘텐츠 URL을 제출한 응모자 | "콘텐츠 제출 필요" On일 때만 | | **미제출자** | 주황 | 콘텐츠를 아직 제출하지 않은 응모자 | "콘텐츠 제출 필요" On일 때만 | | **데이터 이상** | 빨강 | 필수 정보(이름·이메일·주소 등) 누락 또는 형식 오류 | 항상 | | **데이터 정상** | 초록 | 데이터 검증을 통과한 응모자 | 항상 | #### 7-2-1. 우측 끝 — BlackList / Suspicious 드롭다운 탭 줄의 가장 오른쪽에 **두 개의 드롭다운**이 있습니다. | 드롭다운 | 옵션 | 용도 | | --------------------- | ------------------------------------ | ------------- | | ⚠️ **BlackList (N명)** | 전체 / 블랙리스트만 / 블랙리스트 제외 | 차단된 응모자 필터링 | | ⓘ **Suspicious (N)** | 전체 / Suspicious only / Suspicious 제외 | 부정 응모 의심자 필터링 | > 💡 **Suspicious 자동 표시** 같은 IP·전화번호·주소 등으로 다중 응모한 경우 시스템이 자동으로 Suspicious로 마킹합니다. 이 드롭다운으로 의심 응모자만 빠르게 추려 검토할 수 있습니다. ### 7-3. 응모자 표 응모자 표는 **항상 보이는 시스템 컬럼 5개 + 기본으로 켜져 있는 컬럼 2개 + 컬럼 설정 ⚙️로 켜고 끌 수 있는 토글 컬럼 6그룹**으로 나뉩니다.
#### 7-3-1. 기본 컬럼 — 처음 진입했을 때 보이는 7개 | # | 컬럼 | 분류 | 표시되는 정보 | | - | ------------- | -------- | ----------------------------------- | | 1 | **선택** (체크박스) | 시스템 (항상) | 일괄 처리용 다중 선택 | | 2 | **상태** | 시스템 (항상) | 동그라미 점 — 대기중(회색) / 선정(초록) / 미선정(빨강) | | 3 | **국가** | 시스템 (항상) | 응모자가 입력한 국가 코드 (BR, US, ES…) | | 4 | **이름** | 시스템 (항상) | 응모자 이름 | | 5 | **이메일** | 기본 ON | 연락처 이메일 (정렬 가능) | | 6 | **신청일** | 기본 ON | 응모 시각 (예: "4월 27일 09:47", 정렬 가능) | | 7 | **작업** | 시스템 (항상) | 우측 끝의 👁 (상세 보기) 버튼 | > 💡 **시스템 컬럼은 끌 수 없습니다** 선택·상태·국가·이름·작업 5개는 항상 표시되며 컬럼 설정에서도 토글 옵션으로 노출되지 않습니다. #### 7-3-2. 컬럼 설정 ⚙️ — 더 많은 컬럼 켜고 끄기 검색창 옆 **⚙️** 버튼을 누르면 컬럼 설정 패널이 열립니다. 그룹별로 묶여 있어 필요한 정보만 빠르게 켤 수 있습니다.
| 그룹 | 컬럼 | | --------- | -------------------------------------- | | **기본 정보** | 이메일, 전화번호, Tax ID, 신청일 | | **주소** | 수령인, 주소1, 주소2, Zipcode, 도시, 시/도, 도/군/구 | | **선정/확정** | 선정일 | | **배송** | 배송 상태, 배송사, 운송장번호, 로컬배송사, 로컬운송장 | | **콘텐츠** | 콘텐츠, 제출 날짜 ("콘텐츠 제출 필요" On일 때만) | | **SNS** | IG ID, TT ID, FB, X, YT, IG, TT | **패널 상단의 두 가지 동작** * **모두 선택** — 모든 토글 컬럼을 한 번에 ON * **🔄 초기화** — 시스템 기본값(이메일·신청일만 ON)으로 되돌리기 > 💡 **설정은 브라우저에 저장됩니다** 한 번 컬럼을 켜두면 같은 브라우저·기기에서 다음 방문 시에도 그대로 유지됩니다. 다른 PC에서 접속하면 다시 설정해야 합니다. > 🟡 **컬럼이 너무 많으면 가로 스크롤이 생깁니다** 모니터 폭에 따라 한 번에 보이는 컬럼 수가 제한됩니다. 가장 자주 보는 컬럼만 켜두는 것을 권장합니다 (예: 배송 운영 중에는 "배송 상태 + 운송장번호"만, 콘텐츠 검수 중에는 "콘텐츠 + 제출 날짜"만). ### 7-4. 단일 처리 — 응모자 한 명 다루기 응모자 표의 **우측 끝 👁(눈) 아이콘** 버튼을 누르면 **신청자 상세 정보** 다이얼로그가 열립니다.
> 🟡 **행 자체를 클릭해도 다이얼로그는 열리지 않습니다** 반드시 우측 끝의 작은 눈 아이콘(제목 "상세 보기")을 클릭해야 합니다. #### 7-4-1. 다이얼로그 헤더의 액션 버튼 | 버튼 | 노출 조건 | 동작 | | ------------ | ------------- | ------------------------ | | **메일 발송** ✉️ | **선정** 상태일 때만 | 이 응모자에게 메일 발송 흐름 시작 | | **정보 수정** ✏️ | 항상 | 본문을 편집 모드로 전환 (다음 항목 참고) | #### 7-4-2. 다이얼로그 본문에서 보이는 정보 * **기본 정보**: 이름, 이메일, 전화번호, Tax ID, 신청일 * **배송 주소**: 주소1·주소2·국가·주/지역·도/광역시·시/군/구·우편번호 * **폼 응답**: 폼 빌더로 만든 모든 필드의 응답값 * **콘텐츠 URL** (콘텐츠 제출 필요 캠페인): 제출된 외부 링크 + **삭제 요청 / 삭제 거절** 배지 * **이메일 발송 이력**: **선정 상태일 때 자동 노출** — 발송된 템플릿, 시각, 도달 상태 (별도 버튼 없이 패널이 펼쳐져 있음) * **미선정 사유**: 미선정 상태일 때만 표시 (운영자가 입력한 사유가 빨간 박스로 노출) #### 7-4-3. 정보 수정 모드 헤더의 **정보 수정** 버튼을 누르면 다음 필드를 편집할 수 있습니다. * 신청자 이름 * 배송 주소 (주소1·주소2·국가·주/지역·도/광역시·시/군/구·우편번호) * 전화번호 * 세금식별번호 (Tax ID) **\[변경사항 저장]** / **\[취소]** 버튼으로 마무리합니다. #### 7-4-4. 본문 하단 — 선정 / 미선정 결정 응모자가 **대기중** 상태일 때만 다이얼로그 본문 맨 아래에 두 개의 큰 버튼이 노출됩니다. | 버튼 | 색상 | 동작 | | --------- | -- | ----------------------------------------------------------- | | **선정** ✅ | 초록 | 즉시 선정 처리, 선정 안내 메일 발송 흐름 가능 | | **미선정** ❌ | 빨강 | 별도 확인 다이얼로그 → **미선정 사유** 입력(필수) → 처리. 이 사유는 응모자에게 메일로 안내됩니다 | > 🟡 **미선정 사유는 응모자에게 그대로 발송됩니다** 별도 확인 다이얼로그에 "심사 메모" 칸이 따로 있어 내부용 메모를 분리해서 남길 수 있습니다. ### 7-5. 일괄 처리 — 여러 명 한 번에 응모자 표의 체크박스로 여러 응모자를 선택하면 **화면 하단 가운데**에 알약 모양의 일괄 액션 팝업이 떠오릅니다 (`N명 선택됨` 카운트와 함께).
| 버튼 | 노출 조건 | 동작 | | -------------- | ------- | ----------------------------------------- | | **엑셀 다운로드** 📥 | 항상 | 선택한 응모자만 엑셀로 내보내기 (옵션 다이얼로그는 7-8과 동일) | | **일괄 선정** ✅ | 권한 있을 때 | 선택한 응모자를 즉시 선정 처리 (초록) | | **일괄 미선정** ❌ | 권한 있을 때 | 선택한 응모자를 즉시 미선정 처리 (빨강) — 사유 입력은 별도 다이얼로그 | > 💡 **인라인 일괄 액션은 즉시 처리됩니다** 단일 처리(7-4)와 마찬가지로 별도 미리보기 단계 없이 클릭 즉시 동작합니다. > 💡 **다른 일괄 작업이 필요하면?** 배송정보 일괄 업데이트, 신청자/당첨자 일괄 등록, 콘텐츠 일괄 확인 등은 **헤더의 \[일괄 작업] 버튼**(엑셀 기반 통합 다이얼로그)에서 처리합니다 (7-7 참고). 일괄 메일 발송은 별도 화면(Part 10)에서 진행합니다. ### 7-6. 선정자 추가 — 1명 직접 등록 (이벤트 상세 헤더)
이벤트 상세 페이지의 탭 메뉴 줄 우측에 있는 **\[선정자 추가]** 버튼(Part 6-6 참고)을 누르면 다이얼로그가 열려 응모를 거치지 않고 선정자(winner) 1명을 직접 등록할 수 있습니다. * **용도**: 응모를 거치지 않고 선정자 1명을 바로 등록 * **입력**: 이메일 + 이름 등 기본 정보 * **결과**: 등록 즉시 **선정** 상태로 추가됨 > 💡 일반 응모자(대기중 상태)를 추가하는 게 아니라 **이미 선정된 사람**을 추가하는 기능입니다. 응모 단계 없이 곧장 선정 상태로 만듭니다.
### 7-7. 일괄 작업 — 6가지 작업을 한 다이얼로그에서
이벤트 상세 페이지의 탭 메뉴 줄 우측 **\[일괄 작업]** 버튼을 누르면 통합 다이얼로그가 열립니다. * 다이얼로그 제목: **일괄 작업** * 부제: "엑셀 파일로 등록·선정·배송정보·참가자 정보를 한 번에 처리합니다." 다이얼로그는 두 카테고리 중 하나를 고른 뒤 **6가지 세부 작업** 중 원하는 것을 선택하는 흐름입니다. #### 7-7-1. 새로 추가 — 엑셀로 일괄 등록 응모자·당첨자·확정자를 엑셀 파일로 한 번에 등록합니다.
| 작업 | 의미 | | ------------- | --------------------------------------- | | **신청자 일괄 등록** | 엑셀로 다수 신청자를 한 번에 등록 (상태: **대기중**으로 들어감) | | **당첨자 일괄 등록** | 엑셀로 다수 당첨자(winner)를 한 번에 등록 | | **확정자 일괄 등록** | 엑셀로 다수 확정자를 한 번에 등록 | #### 7-7-2. 정보 갱신 — 기존 응모자 정보 일괄 갱신 이미 등록된 응모자의 상태·정보를 엑셀로 일괄 업데이트합니다.
| 작업 | 의미 | | ---------------- | ------------------------------------------- | | **당첨자 일괄 선정** | 이미 신청한 참여자 중 내부적으로 선정한 인원을 엑셀로 **일괄 선정 처리** | | **배송정보 일괄 업데이트** | 여러 응모자의 배송사·운송장·발송일을 한 번에 입력 (Part 8 참고) | | **참가자 정보 일괄 갱신** | 이름·전화번호·주소·세금식별번호·배송정보·SNS URL 등 한 번에 갱신 | #### 7-7-3. 공통 처리 흐름 (3단계) 각 세부 작업은 일반적으로 다음 3단계로 진행됩니다. 1. **템플릿 다운로드 + 엑셀 작성·업로드** 2. **미리보기** — 처리될 결과를 사전 확인 3. **결과 리포트** — 성공/실패 항목 표시 > 🟡 **이메일 발송 옵션** 신청자·당첨자·확정자 일괄 등록 시 추가된 응모자에게 안내 메일을 보낼지 여부를 선택할 수 있습니다. > > 🟡 **중복 처리** 이미 등록된 이메일이 엑셀에 있는 경우 **건너뛰기(Skip) / 업데이트(Update)** 중 선택할 수 있습니다. ### 7-8. 응모자 내보내기 — 엑셀 다운로드 이 캠페인의 응모자 데이터를 엑셀(.xlsx)로 내보내는 기능입니다.
#### 7-8-1. 두 가지 진입 경로 | 진입점 | 위치 | 대상 응모자 | | ----------------------------- | ------------------------- | ---------------------- | | **엑셀 다운로드** 버튼 (이벤트 상세 헤더 영역) | 탭 메뉴 줄 우측 (Part 6-6) | 이벤트 전체 (다이얼로그에서 범위 선택) | | **엑셀 다운로드** 버튼 (일괄 액션 팝업) | 표에서 응모자 N명 선택 시 화면 가운데 팝업 | **선택한 응모자만** | #### 7-8-2. 다운로드 다이얼로그 옵션 다이얼로그 제목은 **엑셀 다운로드** 입니다. 두 영역으로 구성됩니다.
**A. 다운로드 범위 (라디오, 1개 선택)** | 옵션 | 의미 | | ----------- | ---------------------- | | **전체** | 모든 응모자 (대기중·선정·미선정 포함) | | **선정자만** | 선정 상태인 응모자만 | | **컨텐츠 확정만** | 콘텐츠 URL이 모두 승인된 응모자만 | **B. 제외 옵션 (체크박스, 0\~3개 동시 선택)** | 체크박스 | 부가 설명 | 효과 | | -------------- | ------------- | --------------------- | | **의심자 제외** | (중복 신청 등) | Suspicious 마킹된 응모자 제외 | | **데이터 이상자 제외** | (전화/우편번호 오류) | 데이터 검증 실패 응모자 제외 | | **차단 이메일 제외** | (banned list) | BlackList에 등록된 이메일 제외 | > 💡 **운영 보고용 데이터를 깔끔하게** 의심자·이상자·차단자를 모두 제외하면 정상 응모자만 추린 깨끗한 명단이 나옵니다. 광고주·외부 보고용에 활용하세요. #### 7-8-3. 내보내기 파일에 포함되는 정보 엑셀 파일에는 다음이 모두 포함됩니다. * 응모 정보 (이름, 이메일, 전화, 주소, Tax ID, 신청일) * 폼 응답 (브랜드가 폼 빌더로 만든 모든 커스텀 필드) * 배송 정보 (배송사, 운송장번호, 발송일, 로컬 배송사·운송장) * 콘텐츠 상태 (제출 URL, 승인/거절, 메모) * 선정/미선정 여부 (status), 미선정 사유, 선정일 * 부정 응모(Suspicious)·차단 여부 # 배송 관리 ## Part 8 · 배송 관리 (배송 탭) 이벤트 상세 페이지의 **배송** 탭에서는 선정된 응모자에게 제품을 발송하고, 운송장을 등록하고, 배송이 실패한 응모자를 별도로 관리합니다.
### 8-1. 두 줄 필터 — Shipping / Delivery 배송 탭 상단에는 **두 줄로 분리된 배지 필터**가 있습니다. 같은 응모자에 대해 "운송장이 등록되었는지(Shipping)" 와 "배송 가능한 상태인지(Delivery)" 라는 **두 개의 독립 상태**를 함께 봅니다.
#### 8-1-1. Shipping 필터 — 운송장 등록 여부 | 배지 | 색상 | 의미 | | ----------- | ------------------- | --------------------- | | **All** | 회색 | 선정자 전체 | | **Shipped** | 초록 (📦 Package 아이콘) | 운송장 정보가 1개 이상 등록된 응모자 | | **Pending** | 노랑 | 운송장이 아직 등록되지 않은 응모자 | #### 8-1-2. Delivery 필터 — 배송 가능 여부 | 배지 | 색상 | 의미 | | ----------------- | ----------------------- | ------------------ | | **All** | 회색 | 전체 | | **Deliverable** | 파랑 (✅ PackageCheck 아이콘) | 정상 배송 대상 | | **Undeliverable** | 빨강 (❌ PackageX 아이콘) | 운영자가 배송불가로 마킹한 응모자 | > 💡 **두 필터를 함께 쓸 수 있습니다** 예) "Shipping = Pending + Delivery = Deliverable" → 아직 발송 안 됐고 배송 가능한 응모자만 = **지금 발송해야 할 명단** #### 8-1-3. 검색 필터 아래 검색창이 있습니다. 플레이스홀더는 "**Search by name, email, or tracking number...**" 이며 **이름·이메일·운송장번호** 세 가지를 동시에 검색합니다 (신청자 탭과 동일). ### 8-2. 배송 표 — 7개 컬럼
| 컬럼 | 표시되는 정보 | | ------------------- | ------------------------------------------------------- | | 체크박스 | 일괄 처리용 (일괄 액션 권한 있을 때만 표시) | | **Name** | 응모자 이름 + (배송불가 시) 빨간 **Undeliverable** 배지 | | **Email** | 연락처 이메일 | | **Address** | 배송 주소 (한 줄로 압축, 마우스 호버 시 전체 표시) | | **Carrier** | 등록된 배송사 (여러 개면 콤마로 묶어 표시) | | **Tracking Number** | 운송장번호 + 추적 링크 🔗. 없으면 노랑 **Pending** 배지 (클릭하면 입력 다이얼로그) | | **Delivery** | Undeliverable일 때 빨간 글씨로 사유 표시, 정상은 `-` | | **Actions** (우측) | 배송불가 토글(PackageX/Undo2 아이콘) + **Edit / Enter** 버튼 | > 💡 **행 배경 색** 배송불가로 마킹된 응모자 행은 **연한 빨간색 배경**으로 표시되어 한눈에 구분됩니다. ### 8-3. 단일 응모자 배송 정보 입력 배송 정보를 한 명씩 입력하는 방법입니다. #### 8-3-1. 진입 경로 (3가지) | 위치 | 동작 | 결과 | | ------------ | ---------------------------------------------------------- | -------------- | | 배송 탭 표 | Tracking Number 컬럼의 노랑 **Pending** 배지 클릭 | 배송 정보 입력 다이얼로그 | | 배송 탭 표 | 우측 끝 **\[Enter]** 버튼 (운송장 없을 때) 또는 **\[Edit]** 버튼 (이미 등록됨) | 같은 다이얼로그 | | 신청자 탭 응모자 상세 | 응모자 행 우측 👁 → 다이얼로그 본문의 **배송 정보 수정** 버튼 | 같은 다이얼로그 | #### 8-3-2. 입력 다이얼로그의 필드 — 다중 운송장 지원
한 응모자에게 **여러 운송장 세트**를 등록할 수 있습니다. 한 세트는 다음 6개 필드로 구성됩니다.
| 필드 | 의미 | | --------------------------- | ------------------------------------------------ | | **배송사 (Carrier)** | 등록된 배송사 드롭다운에서 선택 (Part 12에서 미리 등록한 활성 배송사가 노출됨) | | **운송장번호 (Tracking Number)** | 메인 추적번호 | | **로컬 배송사** | 도착지 국가의 로컬 배송 파트너 (선택) | | **로컬 운송장번호** | 국내 추적번호 (선택) | | **발송일** | 실제 발송 일시 | | **메모** | 패키지 내용·수량 등 자유 메모 (선택) | > 💡 **국제·로컬 분리 운송장이 필요한 이유** 해외로 발송한 뒤 도착지 국가에서 로컬 택배사가 이어받는 경우(예: DHL → CJ대한통운), 두 개의 운송장으로 나눠 추적할 수 있게 합니다. ### 8-4. 일괄 배송 정보 업데이트 — 엑셀 여러 명의 운송장을 한 번에 업데이트하는 기능입니다. **신청자 탭의 \[일괄 작업] 버튼**을 통해서만 진입합니다 (배송 탭에는 별도 진입점이 없습니다).
#### 8-4-1. 진입 경로 (1가지) 이벤트 상세 헤더의 \[일괄 작업] 버튼\ ↓\ \[정보 갱신] 카테고리 카드 클릭\ ↓\ \[배송정보 일괄 업데이트] 카드 클릭\ ↓\ 일괄 작업 실행 다이얼로그 자세한 일괄 작업 다이얼로그 구조는 **Part 7-7** 참고. #### 8-4-2. 처리 흐름 (3단계) 1. **템플릿 다운로드** — 이미 선정된 응모자가 한 줄씩 채워진 엑셀이 받아집니다 2. 엑셀에 **배송사·운송장번호·발송일** 등 입력 후 저장 3. 다이얼로그에 **엑셀 업로드** → 미리보기 단계 확인 → 실행 → 결과 리포트 > 🟡 **운송장이 비어 있는 행은 무시됩니다** 엑셀에서 운송장번호 필드를 비워둔 응모자는 업데이트되지 않습니다 (안전 장치). ### 8-5. 배송불가 (Undeliverable) 관리 배송이 실패한 응모자를 별도로 표시해 정상 응모자와 구분하는 기능입니다. #### 8-5-1. 배송불가 사유 8가지 | 라벨 | 의미 | | ---------------------------- | ------------- | | **Customs Duty Unpaid** | 관부가세 미납·납부 거절 | | **Customs Clearance Failed** | 통관 미협조 | | **Invalid Address** | 주소 불명 | | **Recipient Unavailable** | 수취인 부재·미응답 | | **Delivery Refused** | 수취 거절 | | **Lost** | 분실 | | **Damaged** | 파손 | | **Other** | 기타 (직접 사유 입력) | > 💡 **라벨이 모두 영문**입니다. 시스템 차원의 표준 코드라 한국어 번역 라벨이 따로 없습니다. #### 8-5-2. 개별 마킹 — 1명씩 처리 배송 탭 표의 행 **우측 끝 작업 영역**에 마킹 토글이 있습니다.
| 현재 상태 | 노출되는 버튼 | 클릭 시 | | ----- | ------------------------------------------------------- | ------------------------------- | | 정상 | 회색 **PackageX 아이콘** (📦) — 호버 시 "Mark as undeliverable" | 8가지 사유 드롭다운이 열림 → 사유 선택 → 즉시 마킹 | | 배송불가 | 빨간 **Undo2 아이콘** (↩) — "Mark as deliverable" | 즉시 해제 (사유 묻지 않음) | 마킹된 행은 **연한 빨간색 배경**으로 바뀌고, Name 컬럼 옆에 **Undeliverable** 배지가 추가됩니다. #### 8-5-3. 일괄 마킹 — 여러 명을 한 번에 배송 탭 표에서 **체크박스로 여러 명 선택** 시, 검색창 우측에 일괄 액션이 나타납니다.
| 버튼 | 동작 | | ----------------------------- | -------------------------------------- | | ❌ **Mark Undeliverable** (빨강) | 8가지 사유 드롭다운 → 선택 → 모든 대상에 같은 사유로 일괄 마킹 | | ↩ **Mark Deliverable** | 선택한 응모자의 배송불가 일괄 해제 | #### 8-5-4. 배송불가 마킹의 효과 * 응모자가 **Undeliverable** 상태로 표시됨 (행 빨간 배경 + Name 옆 배지) * **Delivery 필터**에서 별도로 분리되어 한눈에 추적 * **콘텐츠 제출 리마인더 이메일 발송에서 자동 제외** * 마킹 해제 시 다시 정상 응모자로 복귀 > 🟡 **콘텐츠 리마인더 자동 제외가 중요한 이유** 배송이 실패한 응모자에게 "콘텐츠 제출해 주세요" 리마인더가 가면 혼란을 줍니다. 배송불가 마킹은 이런 잘못된 자동 발송을 막아주는 안전 장치입니다. # 콘텐츠 검토 ## Part 9 · 콘텐츠 검토 (콘텐츠 탭) 선정된 응모자가 SNS에 콘텐츠를 게시하고 그 URL을 제출하면, 운영자는 콘텐츠 탭에서 검수합니다. 이 탭은 **이벤트 생성 시 "콘텐츠 제출 필요" 옵션을 켠 캠페인에서만** 노출됩니다.
### 9-1. 콘텐츠 탭 상단 — 카운트 배지 페이지 맨 위에는 **두 개의 카운트 배지**가 나란히 표시됩니다.
| 배지 | 색상 | 의미 | | -------------------- | ---- | --------------------- | | 🔗 **콘텐츠 제출 완료: N명** | 이메랄드 | URL을 1개 이상 제출한 응모자 수 | | ✅ **콘텐츠 확정: N명** | 초록 | 제출한 모든 URL이 확정된 응모자 수 | > 💡 **두 카운트의 관계** 제출 완료(N명) 중 **모든 URL이 확정된 사람**만 "콘텐츠 확정"에 포함됩니다. 한 URL이라도 확정되지 않았다면 그 응모자는 확정 카운트에서 빠집니다. ### 9-2. 5개 상태 필터 버튼 상단 카운트 아래에 **가로로 나열된 5개 필터 버튼**이 있습니다. 한 번에 하나만 선택됩니다.
| 라벨 | 색상 | 의미 | | --------- | ----------- | ----------------------- | | **전체** | 이메랄드 (선택 시) | 콘텐츠를 제출한 모든 응모자 | | **확정** | 파랑 | 모든 URL이 확정된 응모자 | | **미확정** | 빨강 | 미확정 URL이 1개 이상 남은 응모자 | | **반려됨** | rose (장미) | 반려된 URL이 있는 응모자 | | **삭제 요청** | 주황 | 응모자가 삭제 요청한 URL이 있는 응모자 | ### 9-3. 검색 필터 버튼 아래에 검색창이 있습니다. 플레이스홀더는 "**이름, 이메일 또는 운송장번호 검색...**" 으로 신청자 탭과 동일하게 **이름·이메일·운송장번호** 세 가지를 통합 검색합니다. ### 9-4. 콘텐츠 표 — 6개 컬럼
| 컬럼 | 너비 | 내용 | | ---------- | ----------- | ------------------------------------------------- | | 체크박스 | 44px | 행 전체 선택 (헤더의 마스터 체크박스 포함) | | **국가** | 80px | 응모자가 입력한 국가 코드 | | **이름** | 200px | 응모자 이름 | | **이메일** | 200px | 응모자 이메일 | | **콘텐츠 링크** | 가변 | 제출된 URL이 한 응모자에 여러 개면 여러 줄로 나열 (이 컬럼이 핵심 영역) | | **상태** | 130px (가운데) | 응모자 단위의 종합 상태 (확정 N건 / 미확정 N건 / 반려 N건 / 삭제 요청 N건) | ### 9-5. 콘텐츠 링크 한 줄의 구성 요소 한 URL마다 다음 요소들이 한 줄에 함께 표시됩니다.
#### 9-5-1. 상태 아이콘 (URL 좌측) | 아이콘 | 색상 | 의미 | | ------------------ | ---- | ------------------------------ | | ✅ **CheckCircle2** | 초록 | **확정됨** | | ❌ **XCircle** | rose | **반려됨** (마우스 호버 시 사유·메모 툴팁 표시) | | ⚪ **Circle** | 회색 | 아직 결정 안 됨 | #### 9-5-2. URL 링크 + 작은 액션 아이콘 (URL 우측) URL 자체는 외부 링크로 새 탭에서 열리며, 그 옆에 작은 아이콘 버튼들이 있습니다.
| 아이콘 | 동작 | | ----------------- | ---------------------------------------------------------------- | | 👁 **Eye** | URL을 한 번이라도 클릭하면 자동으로 **확인됨** 표시 (운영자 활동 추적용) | | ✏️ **Pencil** | URL 수정 다이얼로그 — 같은 이메일로 다른 이벤트에 응모한 내역도 함께 표시되어 잘못 제출된 URL 정정에 유용 | | 📝 **StickyNote** | 검토자 메모 추가/편집. 메모가 있으면 보라색으로 표시됨 | #### 9-5-3. 부가 배지 (URL 줄 아래) 상황에 따라 다음 배지가 노출됩니다. * **메모** 배지 (보라) — 등록된 검토자 메모의 미리보기 (클릭 시 편집 다이얼로그) * **반려: 사유** 배지 (rose) — 반려 사유가 등록되어 있을 때 * **삭제 요청** 배지 (주황) + 작은 ✓ / ✗ 버튼 — 응모자가 삭제 요청한 경우 (9-11 참고) * **삭제 거절** 배지 (회색) — 운영자가 삭제 요청을 거절한 경우 * **삭제됨** (취소선 + 빨강) — 이미 삭제 승인된 콘텐츠 (별도 영역에 이력으로 표시) ### 9-6. 단일 처리 — 한 URL씩 각 URL의 좌측 상태 아이콘 영역에서 **확정 / 반려** 처리를 합니다. 9-5에서 설명한 작은 아이콘으로 메모·URL 수정도 개별 진행할 수 있습니다. > 💡 **확정의 단위는 URL입니다** 응모자가 3개 URL을 제출했으면 운영자도 **각각 따로** 확정·반려를 결정합니다. 3개 모두 확정되어야 그 응모자가 "콘텐츠 확정" 카운트에 들어갑니다. ### 9-7. 일괄 처리 — 여러 URL을 한 번에
콘텐츠 표의 체크박스로 URL을 여러 개 선택하면 화면 **하단 가운데 알약 모양 팝업**이 떠오릅니다 ("**N개 콘텐츠 선택됨**" 표시와 함께). | 버튼 | 색상 | 노출 조건 | 동작 | | ---------- | ------- | --------------------- | ------------------------------------------------------- | | **일괄 확정** | 초록 | 미확정 URL이 1개 이상 선택됨 | 선택한 URL을 모두 확정 처리 | | **일괄 미확정** | outline | 이미 확정된 URL이 1개 이상 선택됨 | 확정을 풀어 미확정 상태로 되돌림 | | **일괄 반려** | 빨강 | 반려 권한이 있을 때 | 반려 다이얼로그 → 사유 코드 1개 + (선택) 내부 메모 → 모든 URL에 같은 사유로 일괄 반려 | > 🟡 **일괄 반려 시 같은 사유가 모든 대상에 적용됩니다** 사유가 URL마다 다르면 개별 처리가 더 정확합니다. ### 9-8. 콘텐츠 반려 사유 반려 시 다이얼로그에서 **5개 표준 사유 + 기타** 중 하나를 선택합니다.
| 라벨 | 의미 | | ------------------- | ------------------ | | **제품 다름** | 발송한 제품과 다른 제품을 보여줌 | | **언박싱만 진행** | 사용 콘텐츠 없이 언박싱만 | | **제출링크 오류(다른 이벤트)** | 다른 이벤트의 콘텐츠 링크를 제출 | | **제출링크 오류(어카운트링크)** | 게시물이 아니라 계정 페이지 링크 | | **링크 사라짐** | 게시물이 이미 삭제됨 | | **기타** (직접 입력) | 위에 해당 없는 경우 자유 입력 | 다이얼로그에서는 추가로 다음을 입력할 수 있습니다. * **공개 사유** — 응모자에게 보여주는 사유 (예: 재제출 안내 문구) * **내부 메모** (선택) — 운영자만 보이는 노트 ### 9-9. 콘텐츠 검토자 메모 (Internal Memo) 각 URL에 **운영자만 보이는 내부 메모**를 남길 수 있습니다. #### 9-9-1. 추가·편집 방법 URL 우측의 **📝 StickyNote 아이콘** 클릭 → 메모 다이얼로그 → 입력 후 저장. 메모가 등록되면: * 아이콘이 **보라색**으로 변함 * 마우스 호버 시 메모 미리보기 툴팁 * URL 줄 아래에 **"메모: …"** 배지가 보라색으로 노출 (클릭하면 다시 편집) #### 9-9-2. 활용 예 * "왜 반려했는지" 내부 기록 * 같은 응모자의 패턴 메모 (예: "지난 캠페인에도 같은 실수") * 다음 검토자에게 인계할 사항 ### 9-10. URL 수정 — 잘못 제출한 링크 정정 응모자가 URL을 잘못 제출한 경우 운영자가 직접 수정할 수 있습니다.
#### 9-10-1. 절차 1. URL 우측 ✏️ **Pencil** 아이콘 클릭 2. URL 수정 다이얼로그 열림 — 새 URL 입력 3. **같은 이메일로 다른 이벤트에 응모한 내역**이 함께 표시됨 (cross-event 조회) — 다른 이벤트의 URL을 잘못 가져온 건 아닌지 확인 가능 4. 필요 시 메모 함께 작성 후 저장 > 💡 **반려 vs URL 수정** 응모자가 URL을 다시 제출해야 한다면 **반려**, 단순 오타·복붙 실수면 **운영자가 직접 수정**이 더 빠릅니다. ### 9-11. 콘텐츠 삭제 요청 처리 응모자가 본인 콘텐츠를 삭제하고 싶을 때 사용하는 기능입니다. #### 9-11-1. 흐름 1. 응모자가 응모자 추적 페이지(Part 13-8 참고)에서 **삭제 요청** 제출 (사유 입력) 2. 콘텐츠 탭의 해당 URL 옆에 주황 **삭제 요청** 배지 + 작은 ✓ / ✗ 버튼이 노출됨 3. URL 줄 아래에 응모자가 적은 **요청 사유** 표시 #### 9-11-2. 처리 — 승인 / 거절 | 작은 버튼 | 동작 | | ------------- | --------------------------------------------------------- | | ✓ **승인** (초록) | 즉시 콘텐츠가 **삭제 이력**으로 이동, 표에 빨간 취소선으로 표시됨 | | ✗ **거절** (빨강) | 거절 사유 입력 다이얼로그 → 응모자에게 거절 안내, 콘텐츠 유지. 회색 **삭제 거절** 배지가 남음 | > 🟡 **삭제 요청은 신중히** 콘텐츠 유지 약속이 있는 캠페인이라면 거절이 정당화됩니다. 그렇지 않은 일반 응모는 가급적 승인이 권장됩니다. # 이메일 캠페인 ## Part 10 · 이메일 캠페인 응모자에게 발송되는 메일은 **자동 발송**(응모 직후·선정 직후 등)과 **수동 일괄 발송**(운영자가 시점을 정해 보냄) 두 가지가 함께 작동합니다. 마감 임박 시 자동으로 미제출자에게 보내는 **리마인더** 기능도 있습니다.
### 10-1. 이메일 시스템의 두 진입점 이메일 관련 화면은 **두 곳**에 분산되어 있습니다. 어느 쪽으로 들어가느냐에 따라 가능한 작업이 다르므로 먼저 이 구조부터 익혀두면 좋습니다. | 진입점 | 위치 | 가능한 작업 | 대상 범위 | | ------------------- | --------------------------------------------------------- | ------------------------------------------ | ------------- | | **A. 이메일 발송 내역 패널** | 폼 이벤트 상세 페이지 안 | 이 캠페인의 일괄 발송, 작업 진행 추적, 재시도 | **이 캠페인 1개** | | **B. 메일 관리 페이지** | 좌측 메뉴 **고객·메시지 > 이메일 관리** (`/dashboard/email-management`) | 멀티 캠페인 동시 발송, **자동 리마인더 설정**, 템플릿 라이브러리 관리 | **여러 캠페인 동시** | > 💡 **선택 가이드** 한 캠페인의 응모자에게만 보낼 때 → **A. 이벤트 상세** 시즌 캠페인 여러 개에 일제히 보내거나 자동 리마인더를 켜려면 → **B. 메일 관리 페이지** ### 10-2. 6가지 이메일 템플릿
| 한국어 라벨 | 자동 발송 시점 | | ------------- | ----------------------------- | | **신청 안내** | 응모 직후 자동 발송 | | **선정 안내** | 응모자 선정 처리 시 | | **미선정 안내** | 응모자 미선정 처리 시 (운영자가 입력한 사유 포함) | | **배송 안내** | 배송 정보 입력 시 | | **콘텐츠 제출 안내** | 콘텐츠 제출 요청 시 (자동 리마인더 대상) | | **이슈 공지** | 운영자 수동 발송 (배송 지연 사과 등) |
\ 🟡 **자동 리마인더 대상 템플릿** 자동 리마인더 기능은 현재 **콘텐츠 제출 안내** 템플릿에만 적용됩니다 (10-6 참고). ### 10-3. 템플릿 편집 — 템플릿 라이브러리
템플릿의 제목·본문을 편집하려면 **메일 관리 페이지** 우상단의 **\[템플릿 관리]** 버튼을 클릭합니다. 각 템플릿은 다음을 가집니다. * **제목 (Subject)** — 메일 제목 * **본문 (HTML)** — 리치 텍스트 에디터로 작성 * **변수(Placeholder)** — 자동 치환되는 값들 #### 10-3-1. 사용 가능한 변수 | 변수 | 치환되는 값 | | ------------------------- | ----------------------------------------- | | `{{name}}` | 응모자 이름 | | `{{email}}` | 응모자 이메일 | | `{{brandName}}` | 브랜드 이름 | | `{{csEmail}}` | CS 문의 이메일 | | `{{formEventTitle}}` | 이벤트 제목 | | `{{entryStatus}}` | 응모자 현재 상태 | | `{{reviewerNote}}` | 검수자 메모 | | `{{cancelReason}}` | 취소·미선정 사유 | | `{{carrierName}}` | 국제 배송사 이름 | | `{{trackingNumber}}` | 국제 운송장번호 | | `{{trackingUrl}}` | 국제 운송장 추적 URL | | `{{localCarrierName}}` | 로컬 배송사 | | `{{localTrackingNumber}}` | 로컬 운송장 | | `{{localTrackingUrl}}` | 로컬 추적 URL | | `{{formResponses.*}}` | 폼 응답의 특정 필드 (예: `{{formResponses.한국이름}}`) | > 💡 **변수는 두 줄 중괄호** `{{...}}` 형식만 인식합니다. 한 줄 중괄호나 오타가 있으면 변수가 치환되지 않고 그대로 본문에 노출됩니다. #### 10-3-2. 미리보기 템플릿 편집기에서 샘플 데이터로 실제 메일이 어떻게 보일지 미리 확인할 수 있습니다. ### 10-4. 메일 관리 페이지의 멀티 캠페인 발송 좌측 메뉴 **이메일 관리** 페이지에서는 **여러 폼 이벤트를 한꺼번에** 골라 일괄 발송할 수 있습니다.
#### 10-4-1. 페이지 헤더 | 영역 | 내용 | | --------- | ----------------------------------------------------------------------- | | 좌상단 제목 | **메일 관리** + "폼이벤트별 이메일 발송 현황을 관리하고 일괄 발송합니다." | | 우상단 액션 | **가이드** 드롭다운 / **\[템플릿 관리]** / **\[일괄 발송 (N)]** / **상태 필터** (전체·진행중·종료) | | 확인 필요 스트립 | 미발송·배송불가 건수가 있을 때만 노란 배경으로 노출 | #### 10-4-2. 이벤트 목록 표 — 10개 컬럼 | 컬럼 | 의미 | | --------- | --------------------------- | | 체크박스 | 일괄 발송용 다중 선택 | | **이벤트명** | 클릭 시 폼 이벤트 상세로 이동 | | **선정** | 선정자 수 | | **발송** | 운송장 등록된 응모자 수 (초록 배지) | | **미발송** | 운송장 미등록 응모자 수 (노랑 배지) | | **배송불가** | Undeliverable 응모자 수 (빨간 배지) | | **최근발송일** | 직전 리마인더 자동 발송 시각 | | **리마인더** | 다음 예정 시각 + 활성/비활성 스위치 | | **자동 종료** | 리마인더 자동 종료 일정 + 연장 팝오버 | | **마감일** | 응모 종료일 (종료된 캠페인은 "종료" 표시) | #### 10-4-3. 멀티 캠페인 일괄 발송 흐름
1. 표에서 발송할 캠페인을 **체크박스로 다중 선택** 2. 우상단 **\[일괄 발송 (N)]** 버튼 클릭 (N=선택 카운트) 3. 다이얼로그에서 템플릿·옵션 설정 후 발송 4. **자동 리마인더 옵션**도 이 다이얼로그에서 함께 설정 가능 (콘텐츠 제출 안내 템플릿 선택 시) ### 10-5. 자동 리마인더 — 메일 관리 페이지에서만 마감 임박 시 응모자에게 자동으로 리마인더 메일을 보내는 기능입니다. **콘텐츠 제출 안내** 발송에 가장 많이 활용됩니다.
#### 10-5-1. 설정 위치 자동 리마인더는 **메일 관리 페이지의 이벤트 목록 표 — 리마인더 컬럼**에서 직접 토글합니다 (폼 이벤트 상세 페이지에는 별도 진입점이 없습니다). | 표시 | 의미 | | -------------------- | ----------------------- | | **다음 예정 시각** (초록 글씨) | 다음 자동 발송 예정 시각 | | **대기중** (회색) | 활성화돼 있지만 다음 시각이 계산되지 않음 | | **Off** (회색) | 자동 리마인더 비활성 | | **스위치** | 활성/비활성 즉시 토글 | #### 10-5-2. 리마인더 시작·간격 설정 — 일괄 발송 다이얼로그에서
리마인더의 **시작 시점·간격**은 **메일 관리 페이지 > \[일괄 발송] 다이얼로그**에서 콘텐츠 제출 안내 템플릿을 선택할 때 함께 설정합니다. | 항목 | 의미 | | ------------------ | -------------------------------- | | **자동 리마인더 활성화** 토글 | 리마인더 사용 여부 | | **간격 (N일)** | 며칠 간격으로 미제출자에게 다시 보낼지 (예: 3일 간격) | | **자동 종료일** | 리마인더가 멈출 시점 (보통 콘텐츠 제출 마감일) | #### 10-5-3. 자동 종료 연장
이벤트 마감일을 미루면 리마인더 자동 종료일도 함께 미뤄야 합니다. 표의 **자동 종료** 컬럼에 있는 **연장 팝오버**(Calendar 아이콘)에서 새 종료일을 선택하면 됩니다. ### 10-6. 응모자별 이메일 발송 이력 특정 응모자에게 어떤 메일이 언제 보내졌는지 추적하려면 **응모자 상세 다이얼로그**(Part 7-4 참고)를 엽니다. 선정 상태 응모자의 다이얼로그 본문에 **이메일 발송 이력 영역**이 자동으로 표시됩니다.
| 표시 | 내용 | | -------------------- | -------------------- | | 발송된 템플릿 | 신청 안내 / 선정 안내 등 | | 발송 시각 | 일시 | | 도달 상태 | 전달 / 반송 / 스팸 신고 / 차단 | | (디버깅용) 메일 서비스 메시지 ID | AWS SES 등의 ID |
### 10-7. 이메일 운영 팁 > 📧 **첫 캠페인은 본인 이메일로 테스트 발송** 일괄 발송 다이얼로그에서 본인 이메일 응모자만 1명 선택해 한 번 발송해 보고 변수·디자인이 정상인지 확인하세요. > 📧 **반송률이 높으면 메일 신뢰도가 떨어집니다** 잘못된 이메일 형식이 많으면 도메인 평판이 깎입니다. 응모자 추가 시 이메일 검증을 활성화하세요. > 📧 **CS 이메일은 명확하게** 응모자가 답장할 때 받는 사람이 실제 운영하는 이메일이어야 합니다. 자동응답 또는 noreply는 피하세요. > 📧 **발송 시점은 평일 오전·오후 권장** 늦은 저녁이나 주말은 도달률·열람률이 떨어지는 경향이 있습니다. > 📧 **1,000명 이상 발송 시 시간이 걸립니다** 다이얼로그에 빨간 경고가 표시되며, 작업 큐에서 순차 처리됩니다. 발송 직후 화면을 닫아도 백그라운드에서 계속 진행됩니다. # 통합 콘텐츠 관리 페이지 ## Part 11 · 통합 콘텐츠 관리 페이지 여러 폼 이벤트의 콘텐츠를 **한 화면에서** 검수할 수 있는 허브 페이지입니다. 콘텐츠 탭(Part 9)이 한 캠페인의 콘텐츠만 다룬다면, 이 페이지는 **모든 캠페인의 콘텐츠를 통합**해서 봅니다. ### 11-1. 진입 경로
| 방법 | 경로 | | ------ | -------------------------------------------- | | 좌측 메뉴 | **캠페인 · 폼 이벤트 콘텐츠** (또는 폼 이벤트 메뉴 하위의 콘텐츠 관리) | | 직접 URL | `/dashboard/form-events/content` | 페이지 제목은 **폼 이벤트 콘텐츠 관리**, 부제는 "모든 폼이벤트의 콘텐츠를 한 곳에서 확인하고 관리합니다." 로 표시됩니다. ### 11-2. 페이지 구성
| # | 영역 | 내용 | | - | ------------------ | ----------------------------------------------------- | | 1 | **상단 안내 카드** | "폼 이벤트 콘텐츠는 몰 없이도 이어지는 캠페인 검수 흐름입니다." | | 2 | **이벤트·태그 필터** | 좌측에 이벤트 선택 + 태그 드롭다운 | | 3 | **콘텐츠 상태 필터 + 검색** | 5개 상태 필터 버튼 + 이름·이메일 검색 | | 4 | **콘텐츠 표** | 7개 컬럼 (체크박스 + 국가 + 이름 + 이메일 + **이벤트명** + 콘텐츠 링크 + 상태) | ### 11-3. 이벤트·태그 필터 (페이지 상단 좌측)
| 드롭다운 | 옵션 | | ---------- | ------------------------------------------------ | | **이벤트 선택** | **전체 이벤트** / 등록된 폼 이벤트 목록에서 선택 | | **태그** | **전체 태그** / **시딩** (seeding) / **경품** (giveaway) | > 💡 **여러 이벤트를 한꺼번에 선택할 수는 없습니다** 한 번에 하나의 이벤트 또는 전체만 볼 수 있습니다. 통합 화면이라 "전체 이벤트"가 기본 사용 시나리오이고, 특정 이벤트로 좁힐 때만 드롭다운을 사용합니다. ### 11-4. 콘텐츠 상태 필터 (5개)
표 위쪽에 가로로 나열된 5개 필터 버튼입니다 — **콘텐츠 탭(Part 9)의 필터와 같은 라벨**입니다. | 라벨 | 의미 | | --------- | --------------------------- | | **전체** | 콘텐츠를 제출한 모든 응모자 (전체 이벤트 기준) | | **확정** | 모든 URL이 확정된 응모자 | | **미확정** | 미확정 URL이 1개 이상 남은 응모자 | | **반려** | 반려된 URL이 있는 응모자 | | **삭제 요청** | 응모자가 삭제 요청한 URL이 있는 응모자 | ### 11-5. 검색 검색 플레이스홀더는 "**이름 또는 이메일 검색...**" 으로, 콘텐츠 탭과 달리 **운송장번호는 검색되지 않습니다**. > 🟡 **검색 범위 차이** > > * 신청자 탭·콘텐츠 탭: 이름·이메일·**운송장번호** 3가지 > * 통합 콘텐츠 페이지: 이름·이메일 2가지 ### 11-6. 콘텐츠 표 — 7개 컬럼
| 컬럼 | 너비 | 내용 | | ---------- | ----------- | ------------------------------------------------- | | 체크박스 | 44px | 일괄 처리용 | | **국가** | 60px | 응모자 국가 코드 | | **이름** | 120px | 응모자 이름 | | **이메일** | 180px | 응모자 이메일 | | **이벤트명** | 200px+ | 콘텐츠 탭에는 없는 컬럼 — 어느 이벤트의 콘텐츠인지 표시 | | **콘텐츠 링크** | 가변 | 제출된 URL과 상태 아이콘·작은 액션 아이콘들 (Part 9-5 참고) | | **상태** | 130px (가운데) | 응모자 단위의 종합 상태 (확정 N건 / 미확정 N건 / 반려 N건 / 삭제 요청 N건) | > 💡 **이벤트명 컬럼이 통합 페이지의 핵심** 같은 응모자가 여러 이벤트에 응모해서 다른 콘텐츠를 제출했을 때, 이벤트별로 행이 분리되어 보입니다. "이 사람이 어느 캠페인 콘텐츠를 냈는지" 한눈에 알 수 있습니다. ### 11-7. URL 행에서의 동작 — 콘텐츠 탭과 동일
콘텐츠 링크 줄의 동작 (상태 아이콘, 체크박스, 외부 링크, Eye / Pencil / StickyNote 아이콘, 메모·반려 배지, 삭제 요청 처리)은 **모두 콘텐츠 탭과 동일**합니다 — 자세한 내용은 **Part 9의 9-5 \~ 9-11**을 참고하세요. 이 페이지에서만 보이는 차이점은 **이벤트명 컬럼**(11-6 참고)입니다. ### 11-8. 일괄 처리 (콘텐츠 탭과 동일) 체크박스로 URL을 여러 개 선택하면 화면 하단 가운데 **알약 모양 팝업**이 떠오르고 3개 액션이 노출됩니다.
| 버튼 | 동작 | | ---------- | ------------------------------------------------------- | | **일괄 확정** | 선택한 URL을 모두 확정 처리 | | **일괄 미확정** | 확정을 풀어 미확정 상태로 되돌림 | | **일괄 반려** | 반려 다이얼로그 → 사유 코드 1개 + (선택) 내부 메모 → 모든 URL에 같은 사유로 일괄 반려 | 자세한 동작은 **Part 9의 9-7** 참고. ### 11-9. 콘텐츠 탭 vs 통합 콘텐츠 페이지 — 어느 것을 쓸까? | 비교 항목 | 콘텐츠 탭 (Part 9) | 통합 콘텐츠 페이지 (Part 11) | | ------------- | ----------------- | ------------------------- | | 대상 범위 | 한 캠페인만 | **모든 캠페인** (또는 1개 캠페인 필터) | | 이벤트명 컬럼 | 없음 (한 이벤트만이라 불필요) | **있음** | | 검색 대상 | 이름·이메일·**운송장번호** | 이름·이메일 | | 단일 처리 / 일괄 처리 | 동일 | 동일 | | 적합한 시나리오 | 한 캠페인 집중 검수 | 멀티 캠페인 동시 운영 시 통합 검수 | # 배송사 관리 페이지 ## Part 11 · 배송사 관리 페이지 자주 쓰는 배송사를 미리 등록해 두고, 운송장 입력 시 드롭다운에서 빠르게 선택할 수 있도록 하는 페이지입니다.
### 11-1. 진입 경로 | 방법 | 경로 | | ------------ | --------------------------------- | | 폼 이벤트 목록 | 우상단의 🚚 **배송사 관리** 버튼 클릭 | | 폼 이벤트 상세 페이지 | 헤더의 🚚 (Truck) 아이콘 클릭 | | 직접 URL | `/dashboard/form-events/carriers` | 페이지 제목은 **배송사 관리**, 부제는 **"경품 배송에 사용할 배송사를 관리합니다."** 입니다. ### 11-2. 페이지 헤더 | 위치 | 요소 | 동작 | | --- | --------------- | --------------------------------- | | 좌상단 | **← 돌아가기** 아이콘 | 폼 이벤트 목록으로 복귀 | | 중앙 | 제목 + 부제 | "배송사 관리 / 경품 배송에 사용할 배송사를 관리합니다." | | 우상단 | ➕ **배송사 추가** 버튼 | 추가 다이얼로그 열기 | ### 11-3. 배송사 표 — 4개 컬럼
| 컬럼 | 너비 | 의미 | | -------- | --------- | ---------------------------------------------- | | **순서** | 12px | `sortOrder` 숫자 (작은 값이 위로 정렬) | | **배송사명** | 가변 | 등록된 이름 (예: "CJ대한통운"). 비활성 상태면 옆에 회색 **비활성** 배지 | | **활성** | 24px | **스위치 토글** — 즉시 활성/비활성 전환 | | **작업** | 24px (우측) | **⋯ 드롭다운** — ✏️ 수정 / 🗑 삭제(빨강) | #### 빈 상태 등록된 배송사가 0개면 표 대신 카드가 표시됩니다 — "**등록된 배송사가 없습니다.**" + 카드 안에 \[+ 배송사 추가] 버튼. ### 11-4. 배송사 추가 / 수정 다이얼로그
페이지 우상단 ➕ **배송사 추가** 버튼 또는 행의 ⋯ > **수정**을 누르면 같은 다이얼로그가 열립니다. 다이얼로그 제목 (🚚 트럭 아이콘과 함께): * 추가 모드: **배송사 추가** * 수정 모드: **배송사 수정** #### 11-4-1. 입력 필드 (3개) | 필드 | 입력 형식 | 비고 | | --------- | ------------- | ------------------- | | **배송사명** | 텍스트 (최대 100자) | 플레이스홀더: "예: CJ대한통운" | | **정렬 순서** | 숫자 (최소 0) | 작은 숫자가 드롭다운 위쪽에 노출됨 | | **활성** | 스위치 | 추가 시 기본 ON | #### 11-4-2. 하단 액션 | 버튼 | 동작 | | ------------------------------- | ------------------------ | | **취소** | 변경사항 버리고 닫기 | | **추가** (추가 모드) / **저장** (수정 모드) | 변경사항 저장. 이름이 비어 있으면 비활성됨 | ### 11-5. 활성/비활성 토글 — 표에서 바로
표의 **활성 컬럼 스위치**를 직접 클릭하면 다이얼로그를 열지 않고도 즉시 켜고 끌 수 있습니다. 토스트로 결과 안내가 표시됩니다. * 활성 → 비활성: "배송사가 비활성화되었습니다." * 비활성 → 활성: "배송사가 활성화되었습니다." 비활성 상태의 배송사는 **운송장 입력 드롭다운에서 노출되지 않습니다** (등록 데이터는 유지됨). ### 11-6. 배송사 삭제 🔴 행의 ⋯ 드롭다운 > **삭제** 클릭 → 즉시 삭제됩니다. 결과는 토스트로 안내됩니다. > 🟡 **삭제 시 주의** 이미 그 배송사로 등록된 운송장 정보가 있어도 삭제됩니다. 운송장 데이터에 저장된 배송사명은 그대로 남지만, 향후 새 운송장 입력 시에는 이 배송사가 드롭다운에 더 이상 나타나지 않습니다. ### 11-7. 운송장 입력 시 어떻게 쓰이나요? 배송 정보 입력 시(Part 8-3 참고) **국제 배송사** 또는 **로컬 배송사** 드롭다운에 **활성 상태인 배송사들**이 정렬 순서대로 노출됩니다. 선택 후 운송장번호를 입력하면 됩니다. > 💡 **자주 쓰는 배송사를 위로** 자주 쓰는 배송사를 작은 sortOrder 값으로 등록하면 운송장 입력 시 드롭다운 맨 위에 노출되어 클릭 횟수가 줄어듭니다 (예: 1=CJ대한통운, 2=DHL, 3=FedEx 등). # 응모자가 보는 공개 폼 페이지 ## Part 12 · 응모자가 보는 공개 폼 페이지 응모자가 실제로 보는 화면을 운영자도 알아두면 운영 중 발생하는 문의에 정확하게 대응할 수 있습니다. ### 12-1. 공개 URL https\://\[브랜드 도메인]/form-events/\[이벤트ID] 이 URL은 두 곳에서 빠르게 복사할 수 있습니다. * 폼 이벤트 목록 한 행의 ⋯ 메뉴 > **링크 복사** (Live 상태일 때만 노출) * 이벤트 상세 페이지 헤더의 🔗 **신청 링크 복사** 아이콘
### 12-2. 페이지의 5가지 상태 응모자가 URL로 접속하면 캠페인 상태와 응모 진행에 따라 **5가지 다른 화면**을 보게 됩니다. | 상태 | 노출 시점 | 응모자가 보는 것 | | --------------- | ---------------------- | ------------------------------- | | **로딩** | 페이지 진입 직후 | 가운데 회전하는 로더 | | **이벤트 없음 (에러)** | 잘못된 URL 또는 삭제된 이벤트 | "이벤트를 찾을 수 없습니다" 카드 | | **종료됨 / 준비중** | 캠페인이 마감됐거나 시작 전 | 정보 카드 + 노랑 안내 박스 (응모 폼 없음) | | **응모 가능** | 응모 기간 안 + 운영자가 종료하지 않음 | 정보 카드 + 동적 응모 폼 + \[참가 신청하기] 버튼 | | **응모 완료** | 응모 제출 성공 후 | 초록 체크 + 티켓 페이지 링크 | ### 12-3. 이벤트 없음 (에러) 화면 | 표시 | 내용 | | ----- | ----------------------------- | | 카드 제목 | "이벤트를 찾을 수 없습니다" | | 부제 | "요청하신 이벤트가 존재하지 않거나 종료되었습니다." | URL이 잘못되었거나 이벤트가 삭제됐을 때 이 화면이 노출됩니다. ### 12-4. 종료됨 / 준비중 화면 응모 기간이 지났거나(종료됨) 아직 시작 전(준비중)이면 응모 폼 대신 안내가 표시됩니다. | 영역 | 내용 | | -------- | ------------------------------------------------------- | | 대표 이미지 | productImageUrl이 등록되어 있으면 4:3 비율로 노출 | | 제목 + 배지 | 이벤트 제목 + 회색 배지 (**종료됨** 또는 **준비중**) | | 설명 | HTML 설명 | | 노랑 안내 박스 | "이 이벤트는 종료되었습니다." 또는 "이 이벤트는 아직 시작되지 않았습니다." + 신청 기간 표시 | ### 12-5. 응모 가능 화면 — 응모자가 보는 본 화면 응모 기간이 활성일 때 보이는 화면입니다. 위에서 아래로 다음 영역이 차례대로 노출됩니다. #### 12-5-1. 이벤트 정보 카드 | 영역 | 내용 | | ----------- | ---------------------------------------------------------- | | 대표 이미지 | productImageUrl 4:3 비율 | | 제목 + 배지 | 이벤트 제목 + 초록 **🎁 신청 가능** 배지 | | 설명 | HTML 설명 (운영자가 캠페인 설명 탭에서 작성한 본문) | | 📅 신청 기간 박스 | 회색 박스에 시작일 \~ 종료일 | | 콘텐츠 요구 안내 | (콘텐츠 요구 On 캠페인만) "※ 선정 시 경품 수령 후 콘텐츠(리뷰, 후기 등)를 제출해야 합니다." | #### 12-5-2. 응모 폼 — 3개 카드 구조 응모자가 입력하는 폼은 **3개 카드**로 분리되어 있습니다.
**A. 연락처 정보** | 필드 | 필수 | 플레이스홀더 | | -------- | ---- | ----------------------------- | | **이름** | ✅ | "홍길동" | | **이메일** | ✅ | "" — 형식 검증 | | **전화번호** | (선택) | "010-0000-0000" | **B. 배송 주소** | 필드 | 필수 | 플레이스홀더 | | ----------------- | ---- | ------------------------------------------------ | | **전체 주소 (직접 입력)** | (선택) | "도로명 주소나 지번 주소를 입력해주세요..." (자유 텍스트, 통합 주소를 한 칸에) | | **주소** (line1) | ✅ | "도로명 주소" | | **상세 주소** (line2) | (선택) | "아파트, 동/호수 등" | | **도시** | ✅ | "서울시" | | **시/도** | (선택) | "경기도" | | **우편번호** | ✅ | "12345" | | **국가** | ✅ | 드롭다운 ("국가 선택") — 2자리 ISO 코드 | **C. 추가 정보** 브랜드가 폼 빌더(Part 4)로 만든 **커스텀 필드**가 여기에 노출됩니다. 폼 빌더에 추가한 필드가 0개면 이 카드 자체가 숨겨집니다. 조건부 표시(Part 4-6)가 설정된 필드는 다른 답변에 따라 보였다 숨겨졌다 합니다. #### 12-5-3. 제출 버튼 폼 맨 아래에 큰 버튼이 있습니다. > **참가 신청하기** (전체 너비, 큰 사이즈. 처리 중에는 로더로 변함) ### 12-6. 응모 실패 시 메시지 (토스트) 폼 제출 시 검증·서버 응답에 따라 **빨간 토스트**로 다음 메시지가 표시됩니다. | 사유 | 메시지 | | ------- | -------------------------------------- | | 중복 이메일 | "이미 동일 이메일로 신청이 접수되었습니다. 이메일을 확인해주세요." | | 신청 기간 외 | "현재 신청 가능한 기간이 아닙니다." | | 유효성 실패 | "입력값을 확인해주세요." | | 기타 오류 | "일시적 오류가 발생했습니다. 잠시 후 다시 시도해주세요." | > 💡 **응모자 문의 시** "이미 동일 이메일로 접수됐다"는 메시지를 받았다면 신청자 탭에서 검색해 본인 응모 내역을 안내하세요. ### 12-7. 응모 완료 화면 — 티켓 페이지 안내 응모 제출이 성공하면 화면이 전환되며 다음이 표시됩니다.
| 영역 | 내용 | | ---------------- | ----------------------------------------------------- | | 초록 체크 아이콘 | ✅ CheckCircle2 (큰 원형) | | 제목 | "**신청 완료!**" | | 안내문 | "신청이 정상적으로 접수되었습니다. 아래 링크로 선정 여부와 배송 현황을 확인할 수 있습니다." | | **티켓 페이지 링크** 박스 | 회색 박스에 URL + **📋 복사** 버튼 + **\[🔗 티켓 페이지 열기]** 큰 버튼 | | 하단 안내 | "이 링크를 저장해두세요. 선정 여부와 배송 현황을 확인할 때 필요합니다." | | 토스트 | "신청 완료! / 신청이 정상적으로 접수되었습니다." | ### 12-8. 티켓 페이지의 의미 응모자는 **로그인하지 않고도** 본인 응모 상태를 확인할 수 있어야 합니다. 이를 위해 응모 후 응모자별 고유 **티켓 URL**(ticketUrl)이 발급됩니다. | 특성 | 설명 | | ------------ | ------------------------------------------------------------- | | **발급 시점** | 응모 직후 (응모 완료 화면 + 자동 발송 메일에 포함) | | **인증 방식** | URL 자체가 토큰 — **링크를 가진 사람은 누구든 접근 가능**하므로 응모자가 외부에 공유하지 않도록 안내 | | **확인 가능 정보** | 본인 응모 상태(대기중·선정·미선정), 콘텐츠 제출 영역, 배송 현황 | | **용도** | 응모자가 본인 한정으로 볼 수 있는 운영자 신청자 탭의 거울 | ### 12-9. 응모 후 백엔드 흐름 (참고) 응모자 화면 뒤에서 시스템이 다음을 처리합니다. 1. 폼 양식 + 필수 필드 + 형식(이메일·국가 코드) 검증 2. 같은 이메일 중복 응모 차단 3. 신청 기간 외 응모 차단 4. 응모 데이터 저장 + **티켓 URL 생성** 5. **신청 안내** 메일 자동 발송 (Part 10-2 참고) 6. 운영자 화면(신청자 탭)에 즉시 노출 이후 운영자가 선정/미선정/콘텐츠 요청 등을 처리하면 그에 맞는 메일이 자동으로 응모자에게 발송됩니다 — 자세한 내용은 Part 10 참고. # 몰 운영 몰 운영은 자사몰 연결부터 일상 운영까지 이어지는 전체 작업 공간입니다. 처음 연결할 때도 여기서 시작합니다.\ 운영 중인 몰을 점검할 때도 여기로 돌아옵니다. ### 1. 이 가이드가 다루는 범위 이 가이드는 다음 흐름을 다룹니다. * 자사몰 첫 연결 * 몰 워크스페이스 진입 * 상품, 주문, 환불, 마케팅 운영 ### 2. 시작 전 체크 진행 전 아래 4가지를 먼저 확인하세요. * 브랜드 계정으로 로그인되어 있어야 합니다. * 우상단 브랜드 선택기가 올바른 브랜드여야 합니다. * 보조 관리 작업은 **Owner** 또는 **Admin** 권한이 필요합니다. * 자사몰 개발자와 연결 정보 전달 경로가 준비되어 있어야 합니다. ### 3. 페이지 바로가기 처음 시작한다면 아래 순서로 보시면 됩니다. 1. [자사몰 연결](/brand-guide/undefined/undefined) 2. [몰 운영 메인 화면](/brand-guide/undefined/undefined-1) 3. [보조 관리 작업 (Owner,admin 전용)](/brand-guide/undefined/owner-admin) 4. [몰 워크스페이스](/brand-guide/undefined/undefined-2) 5. [연결 · 설정 영역](/brand-guide/undefined/undefined-3) 6. [상품·카탈로그 영역](/brand-guide/undefined/undefined-4) 7. [스토어 화면 영역](/brand-guide/undefined/undefined-5) 8. [주문·배송 영역](/brand-guide/undefined/undefined-6) 9. [고객·환불 영역](/brand-guide/undefined/undefined-7) 10. [성장·분석 영역](/brand-guide/undefined/undefined-8) ### 4. 자주 쓰는 운영 흐름 운영을 시작할 때는 이 흐름이 가장 빠릅니다. 1. **몰 운영 메인 화면**에서 추천 작업을 확인합니다. 2. **이 몰로 이동**으로 워크스페이스에 들어갑니다. 3. 필요한 영역에서 바로 작업합니다. #### 4-1. 자주 여는 화면 가장 자주 여는 화면은 보통 아래 4개입니다. * **상품·카탈로그 영역** * **주문·배송 영역** * **고객·환불 영역** * **성장·분석 영역** ### 5. 자주 막히는 지점 #### 5-1. 비밀번호를 복사하지 못했어요 같은 비밀번호를 다시 볼 수는 없습니다.\ **다시 발급하기**로 새 비밀번호를 발급해 전달하세요. #### 5-2. 자사몰과 통신이 끊긴 것 같아요 아래 순서로 확인하세요. 1. **연동 확인** 버튼을 눌러 봅니다. 2. 자사몰 서버 상태를 확인합니다. 3. 필요하면 **다시 발급하기**를 진행합니다. #### 5-3. 상품이 스토어에 보이지 않아요 아래 항목을 차례대로 확인하세요. 1. 상품의 **활성화** 상태 2. 컬렉션 포함 여부 3. 최근 **연동 확인** 성공 여부 #### 5-4. 쿠폰이 적용되지 않아요 아래 조건을 먼저 확인하세요. * 쿠폰이 활성화되어 있는지 * 유효 기간 안인지 * 최소 주문 금액을 충족하는지 * 사용 제한이 남아 있는지 ### 6. 보안과 주의사항 꼭 기억해야 할 항목만 정리했습니다. * 🔴 연결 비밀번호는 한 번만 표시됩니다. * 🔴 연결 해제, 주문 취소, 환불 승인, 리뷰 삭제는 되돌리기 어렵습니다. * 🟡 홈페이지 배포, 롤백, 세율 변경, 메일 발송은 즉시 외부에 영향을 줍니다. * 🟡 멤버 권한은 필요한 최소 범위로만 부여하세요. ### 7. 다음에 할 일 첫 연결과 기본 설정이 끝났다면 이 순서를 권장합니다. 1. 상품 5\~10개를 먼저 등록합니다. 2. **베스트**, **신상품** 같은 컬렉션을 만듭니다. 3. 배너, 정책, FAQ를 정리합니다. 4. 배송 국가와 세금 설정을 점검합니다. 5. 테스트 주문과 환불 흐름을 한 번 확인합니다. 6. 쿠폰과 매출 리포트로 운영을 확장합니다. # 자사몰 연결 이 파트는 **처음 자사몰을 붙이는 한 번의 흐름**입니다. 한 번 끝내면 다시 볼 일이 거의 없으며, 그 뒤로는 Part 2 이후의 운영 화면을 사용하시게 됩니다. ### 1. 몰 운영 페이지 첫 방문 좌측 메뉴 **몰 운영 > 쇼핑몰 목록** 을 클릭합니다. 페이지 상단에 큰 글씨로 **몰 운영** 이 보이고, 그 바로 아래 **추천 작업** 카드가 나타납니다. 처음 진입 시에는 추천 작업 카드에 **첫 연결** 배지와 함께 "**첫 몰을 연결하면 됩니다**" 라는 제목이 떠 있습니다.
> **추천 작업의 5가지 상태** 페이지를 매번 열 때마다 시스템이 그 시점에 가장 우선해야 할 작업을 자동으로 골라 줍니다. > > * **첫 연결** — 아직 연결된 몰이 없을 때 > * **복구 우선** — 막힌 몰이 있을 때 (가장 먼저 풀어야 함) > * **준비 이어가기** — 연결은 됐지만 상품 준비가 끝나지 않았을 때 > * **운영 이어가기** — 준비 끝, 바로 운영 가능 > * **이벤트 먼저 가능** — 몰 없이 이벤트만 운영해도 되는 상태 ### 2. 새 쇼핑몰 연결하기 카드 페이지를 아래로 내리면 **새 쇼핑몰 연결하기** 카드가 있습니다. 이미 연결된 몰이 있는 분은 **다른 쇼핑몰 추가 연동** 으로 제목이 바뀌어 있을 수 있습니다. 카드 우측에는 "보통 30초면 끝나요" 라는 작은 안내가 함께 떠 있습니다.
#### 2-1. 입력란 두 개 (둘 다 선택사항) 1. **쇼핑몰 구분 이름 — 선택** * 목록에서 알아보기 쉬운 별명 * 예: "북미 공식몰", "셀리맥스 일본몰" * 고객에게는 보이지 않습니다. 2. **쇼핑몰 주소 — 선택** * 실제 오픈한 사이트 주소 (예: `https://shop.example.com`) * 적어 두면 목록에 **스토어 열기** 링크가 자동으로 달리고, **연동 확인** 도 더 정확하게 동작합니다. > 둘 다 비워둔 채로 진행해도 됩니다. 다만 나중에 몰이 여러 개로 늘어났을 때 알아보기 위해 채워 두시는 것을 권장합니다. #### 2-2. 관리자(Admin)에서 이미 만들었나요? 입력란 위쪽에 접혀 있는 **관리자(Admin)에서 이미 몰을 만드셨나요?** 영역이 있습니다. 다른 화면에서 이미 같은 브랜드의 몰을 만든 적이 있다면 펼쳐서 안내를 확인해 주세요. **여기서 또 만들면 카드가 중복되어 헷갈립니다.** ### 3. 연결 비밀번호 받기 — 정보 발급 오른쪽 아래의 큰 버튼을 누릅니다. * 처음 연결: **연결 비밀번호 받기** * 추가 연결: **추가 연동 정보 발급받기** 버튼을 누르면 잠시 후 화면 가운데에 큰 팝업이 열립니다. 제목은 **복사만 하면 끝이에요** 입니다.
> 🔴 **이 팝업이 비밀번호를 보여주는 처음이자 마지막 화면입니다.** 창을 닫으면 같은 비밀번호를 다시 볼 수 없으므로, 닫기 전에 반드시 복사를 마쳐 주세요. #### 3-1. 한 번에 복사하기 (가장 안전) 팝업 맨 위 큰 파란 버튼 **모든 설정 한 번에 복사** 를 누르면 4가지 정보가 한꺼번에 클립보드에 담깁니다. 자사몰 개발자에게 전달할 때 이 방법을 가장 추천드립니다. 복사가 끝나면 버튼이 **복사 완료** 로 잠시 바뀝니다. #### 3-2. 항목별로 복사하기 큰 버튼 아래에 5가지 항목 카드가 있습니다. 한 줄씩만 복사할 때 사용합니다. | 보이는 이름 | 개발자가 보는 이름 | 어디에 쓰이나요? | | --------------- | ------------------------------- | -------------------------- | | **브랜드 서버 주소** | `KANGAROO_BRAND_API_URL` | 자사몰이 우리 브랜드 시스템에 연락할 주소 | | **자동 생성된 연결 키** | `KANGAROO_STOREFRONT_CLIENT_ID` | 자사몰 식별 번호 (열쇠의 "번호") | | **연결용 비밀번호** | `KANGAROO_STOREFRONT_SECRET` | 자사몰만 알아야 할 비밀 (열쇠의 "비밀번호") | | **브랜드 고유 번호** | `KANGAROO_ADMIN_BRAND_ID` | 시스템이 어느 브랜드인지 구분 | | **쇼핑몰 등록 번호** | 내부 ID | 문의·지원 시에만 사용 (런타임에는 불필요) | #### 3-3. 자사몰 개발자에게 안전하게 전달하기 **해도 되는 것** * 사내 비밀 저장소(예: 1Password, Bitwarden)에 붙여넣고 개발자에게 항목 공유 * 개발자가 옆에 있을 때 그 자리에서 화면을 보여주며 옮기기 **절대 하면 안 되는 것** * 카카오톡, 일반 슬랙, 이메일 본문에 비밀번호를 그대로 붙여넣기 * 사내 위키, 노션 페이지에 평문 저장 * 외주사·신뢰 미확인 외부 채널로 전송 비밀번호는 **집의 비밀번호와 같습니다**. 한 번 새는 순간 누구든 자사몰처럼 우리 서버에 접속할 수 있습니다. ### 4. 자사몰에 적용된 뒤 — 연동 확인 자사몰 개발자가 정보 4개를 적용하고 자사몰 서버를 다시 켰다고 알려주면, 우리 화면에서 통신을 점검합니다. 1. **몰 운영** 페이지의 **몰 디렉토리** 섹션으로 돌아갑니다. 2. 방금 만든 몰 카드를 찾습니다 (가장 위에 **추천** 배지가 붙어 있을 가능성이 높습니다). 3. 카드 아래쪽 **보조 관리 작업** 영역에서 **연동 확인** 버튼을 누릅니다. 성공하면 "**연동이 확인됐어요**" 안내가 잠시 뜨고, "마지막 확인" 시각이 갱신됩니다.
### 5. 이 몰로 이동 — 운영 시작 연동 확인이 끝나면 카드의 큰 버튼 **이 몰로 이동** 을 누릅니다. 이 버튼이 운영의 입구입니다. 누르는 순간 그 몰만의 작업 공간 — **몰 워크스페이스** — 으로 들어갑니다. 여기까지가 **첫 연결**입니다. 다음 파트부터는 일상 운영 화면입니다. # 몰 운영 메인 화면 매일 운영을 시작할 때 가장 먼저 들르게 되는 화면입니다. 이 화면은 4개 큰 블록으로 구성됩니다. ### 1. 추천 작업 카드 페이지 맨 위에 항상 표시됩니다. 그 시점에 가장 먼저 처리해야 할 작업 한 가지를 시스템이 자동으로 골라 큰 버튼으로 보여줍니다. 매일 운영 시작 시 **이 카드부터 보고**, 카드의 큰 버튼을 따라가시면 그날의 우선순위 작업으로 바로 들어가게 됩니다.
### 2. 몰 디렉토리 — 모든 몰의 상태를 한 화면에 추천 작업 아래에 있는 가장 큰 섹션입니다. 연결된 모든 몰이 카드 형태로 정렬되어 있고, 각 카드에는 그 몰의 **현재 상태**와 **다음에 해야 할 일**이 함께 표시됩니다. #### 2-1. 카드 위에 붙는 배지의 의미 | 배지 | 색 | 무슨 뜻인가요? | 다음에 할 일 | | ----------- | -- | ----------------- | -------------------- | | **추천** | 회색 | 지금 가장 먼저 손대면 좋은 몰 | 카드 큰 버튼을 따라가기 | | **운영 가능** | 파랑 | 연결 + 상품 준비 완료 | 일상 운영 시작 | | **상품 준비** | 회색 | 연결됐지만 상품이 비어 있음 | **이 몰로 이동** → 상품 채우기 | | **연동 확인** | 회색 | 마지막 통신 점검이 안 끝남 | **연동 확인** 버튼 누르기 | | **복구 필요** | 빨강 | 연결이 끊겼거나 막힘 | **복구 설정 보기** 로 이동 | | **첫 연결 필요** | 회색 | 아직 진행된 게 없음 | 아래 입력 폼으로 | #### 2-2. 카드 본문에 보이는 정보 * **상태**: 사용 중 / 해지됨 / 비활성 / 대기 중 * **마지막 확인**: 자사몰과 통신이 마지막으로 오간 시각 (예: "2026. 04. 28. 오후 03:16") * **다음 단계**: 시스템이 추천하는 한 줄짜리 안내문 #### 2-3. 카드의 버튼 * **이 몰로 이동** (주 버튼) — 그 몰의 워크스페이스 진입 * **스토어 열기** (오른쪽 위 링크) — 새 탭에서 실제 쇼핑몰 사이트 열기 (쇼핑몰 주소를 입력했을 때만 표시) Owner/Admin 권한이라면 카드 아래쪽에 **보조 관리 작업** 영역이 추가로 보입니다 (Part 3에서 자세히 설명).
### 3. 고급 도구 바로가기 몰 디렉토리 아래에는 **고급 도구 바로가기** 카드 영역이 있습니다. 평소엔 거의 쓰지 않는 입구로, 익숙해진 뒤에만 사용하시면 됩니다. * **스토어 화면** — 홈페이지·콘텐츠 통합 도구 * **상품·PIM** — 브랜드 전체 상품 카탈로그 (몰을 가리지 않음) * **QR 도구** — QR 코드 발급·관리
> 첫 운영부터 익숙해질 때까지는 **몰 디렉토리** → **이 몰로 이동** → **6개 영역** 흐름만 사용하셔도 충분합니다. ### 4. 다른 쇼핑몰 추가 연동 카드 페이지 맨 아래에 있습니다. Part 1에서 다룬 입력 폼과 같은 모양이고, 다음 자사몰을 추가로 연결할 때 사용합니다. 이미 연결된 몰의 비밀번호는 **건드리지 않으며**, 새 카드만 목록에 추가됩니다. 추가 연결이 당장 필요 없다면 카드 우측 상단의 **추가 연동 접기** 버튼으로 접어둘 수 있습니다. # 보조 관리 작업 (Owner,admin 전용) 각 몰 카드 아래의 **보조 관리 작업** 영역에서 진행하는 작업입니다. **Owner 또는 Admin 권한에서만 보입니다.**
### 1. 연동 확인 — 통신 점검 #### 1-1. 언제 * 자사몰에 새 정보 적용 직후 * 갑자기 통신이 끊긴 것 같을 때 * 정기 점검 #### 1-2. 동작 브랜드 서버가 자사몰의 마지막 통신 기록을 확인합니다. 성공 시 "**연동이 확인됐어요**" 토스트가 뜹니다. #### 1-3. 안전성 누구에게도 영향이 없는 안전한 작업입니다. 부담 없이 눌러도 됩니다. ### 2. 다시 발급하기 — 비밀번호 재발급 🟡 #### 2-1. 언제 * 비밀번호 복사를 못 했을 때 * 비밀번호가 안전하지 않게 다뤄졌을 때 * 정기적인 보안 점검 #### 2-2. 동작 1. **다시 발급하기** 클릭 → 확인 팝업 ("**연결 비밀번호를 다시 발급할까요?**") 2. 한 번 더 **다시 발급하기** 클릭 → 새 비밀번호 팝업 ("**새 비밀번호를 복사해 주세요**") 3. **연결 키는 그대로**, **비밀번호만 새 값**으로 바뀜 4. 자사몰 개발자에게 새 비밀번호 1개만 전달 5. 자사몰에 새 값 반영 전까지는 잠시 동안 예전 비밀번호도 통함 (무중단 교체) 6. 새 값 반영 후 예전 비밀번호는 사용 불가
### 3. 연결 해제하기 — 연결 폐기 🔴 #### 3-1. 언제 * 자사몰 운영을 영구 종료할 때 * 비밀번호가 외부로 새었을 가능성이 있어 즉시 차단해야 할 때 #### 3-2. 동작 1. **연결 해제하기** 클릭 → 확인 팝업 ("**이 쇼핑몰 연결을 해제할까요?**") 2. 빨간 글씨로 "**되돌리기 어려운 작업이에요**" 경고 3. 입력란에 영문 소문자 **revoke** 정확히 입력해야 버튼 활성화 4. 누르는 즉시 자사몰은 더 이상 우리 서버와 통신 불가 5. 카드 상태는 **해지됨** 으로 변경 > 🔴 다시 같은 자사몰을 붙이려면 이 카드를 살리는 게 아니라 **새 쇼핑몰 연결하기** 로 처음부터 다시 만들어야 합니다.
### 4. 삭제하기 — 목록에서 숨기기 #### 4-1. 언제 이미 해지된 (revoked) 몰을 목록에서 더 이상 보고 싶지 않을 때 사용합니다. #### 4-2. 동작 1. 해지된 몰 카드에서만 **삭제하기** 버튼 표시 (해지 전에는 보이지 않음) 2. 클릭 → 확인 팝업, 입력란에 **delete** 정확히 입력 3. 카드가 목록에서 사라짐 4. 데이터가 영구 삭제되는 것은 아니며 단지 **숨겨짐** (지원 시 여전히 조회 가능) ### 5. 복구 설정 보기 #### 5-1. 언제 카드 상태가 "복구 필요" 빨간 배지일 때만 노출됩니다. #### 5-2. 동작 그 몰의 **연결·설정 보기** 화면으로 점프합니다. 자사몰 비밀번호 만료 또는 자사몰 서버 다운이 가장 흔한 원인입니다. # 몰 워크스페이스 **이 몰로 이동** 을 누르면 그 몰만의 작업 공간이 열립니다. 다른 몰의 작업과 섞이지 않도록, 화면 상단에는 항상 **현재 몰 범위** 라는 회색 테두리 배지가 표시됩니다. ### 1. 워크스페이스 상단 — 한눈에 보는 상태
페이지 맨 위에 큰 카드가 있습니다. #### 1-1. 상단 카드 구성 * **현재 몰 범위** 배지와 **운영 가능** 또는 "**N/N 단계 완료**" 배지가 나란히 표시됩니다. * 그 아래 **지금 처리할 일** 박스에 우선 작업 1가지가 큰 버튼으로 제안됩니다. * 다음 줄에는 작은 카드 3개가 있습니다. * **연결 상태** — 마지막 통신 시각 + **연결 테스트** 버튼 * **카탈로그 상태** — 등록된 상품 개수 또는 "상품 확인 필요" * **안전한 돌아가기** — **쇼핑몰 목록** 으로 돌아가는 링크 (브랜드 범위 유지) > 이 몰이 아직 준비 부족이라면, 카드 위에 빨간 띠로 "**먼저 막힌 몰 상태를 복구해야 합니다**" 또는 "**몰 운영 전에 준비 단계를 조금 더 끝내야 합니다**" 안내가 붙습니다. ### 2. 드롭다운 메뉴 (6개) 자주 쓰는 화면으로 한 번에 점프하는 6개 드롭다운 메뉴가 있습니다. #### 2-1. 드롭다운 메뉴 구성 * **개요** — 워크스페이스 메인 (지금 보고 있는 화면) * **주문·배송** * **고객·환불** (빨간색 — 환불은 금전이 오가므로 주의 표시) * **상품·카탈로그** * **스토어 홈페이지** * **연동 / 접근**
### 3. 이 몰의 작업 영역 — 6개 큰 카드 페이지를 내리면 그 몰에서 할 수 있는 모든 작업이 6개 영역 카드로 묶여 있습니다.
#### 3-1. 참고 각 카드의 자세한 내용은 **Part 5 \~ Part 10** 에서 영역별로 다룹니다. ### 4. 여러 몰 사이 전환 브랜드에 몰이 2개 이상 있다면 워크스페이스 상단 우측에 **쇼핑몰 선택** 드롭다운이 표시됩니다. 다른 몰로 점프해도 지금 보던 화면(예: 주문 관리)이 그대로 유지된 채 몰만 바뀝니다.
#### 4-1. 전환 방식 다른 몰로 점프해도 지금 보던 화면은 유지됩니다. # 연결 · 설정 이 영역은 그 몰의 "안전 점검" 영역입니다. 통신·권한·복구가 필요한지를 확인하는 곳이며, 평소엔 자주 들어오지 않습니다. ### 1. 연결·설정 보기 (연동 / 접근) > **경로**: 워크스페이스 > **연결·설정** 영역 카드 > **연결·설정 보기** (또는 상단 탭 **연동 / 접근**) 이 페이지는 자사몰이 우리 브랜드 시스템과 어떻게 연결되어 있는지 **확인만** 하는 화면입니다. 정보 변경은 거의 모두 **몰 운영** 페이지의 보조 관리 작업에서 진행합니다. #### 1-1. 화면에서 볼 수 있는 정보 * **브랜드 서버 주소** — 자사몰이 접속하는 우리 시스템 주소 * **몰 등록 번호** — 내부 식별자 * **연결 키 (Client ID)** — 자사몰의 공개 식별 번호 * **연결 상태** — 사용 중 / 해지됨 등 * **스토어 주소** — 자사몰 실제 사이트 URL * **마지막 통신 시각** #### 1-2. 자사몰 설정 키 섹션 환경변수 형태의 설정값을 항목별로 다시 한 번 복사할 수 있습니다. **단, 비밀번호(Secret)는 보안상 이 화면에서 다시 표시되지 않습니다.** 비밀번호가 필요하면 몰 디렉토리에서 **다시 발급하기** 를 사용해야 합니다. #### 1-3. 위험 작업 동선 페이지 하단에 **쇼핑몰 목록으로 돌아가서 다시 발급/해제하기** 버튼이 있습니다. 누르면 몰 운영 메인으로 이동해 보조 관리 작업 영역에서 비밀번호 재발급이나 연결 해제를 진행할 수 있습니다.
### 2. 관리자 권한 (운영 멤버 관리) > **경로**: 워크스페이스 > **연결·설정** 영역 카드 > **관리자 권한** 이 페이지는 **누가 이 몰을 운영할 수 있는지**를 결정하는 곳입니다. 핵심 사실 한 가지는 멤버 권한이 **브랜드 단위**로 관리된다는 점입니다 — 즉, 이 몰에서 추가한 멤버는 **같은 브랜드 아래의 다른 몰들도 함께 관리**할 수 있게 됩니다.
#### 2-1. 페이지 상단 통계 카드 * **전체 멤버** * **활성 멤버** * **초대 대기** #### 2-2. 거버넌스 주의 박스 페이지 상단에 노란 경고 박스가 있습니다. 권한 변경 전 확인할 사항을 강조합니다 (브랜드 전체에 영향, 되돌리기 어려운 작업 등). #### 2-3. 멤버 목록에서 가능한 작업 * **운영 멤버 초대** — 새 멤버를 이메일로 초대 (Owner/Admin만 가능) * **역할 변경** — Owner / Admin / Member 등 권한 등급 조정 * **멤버 제거** — 운영 권한 회수 🔴 * **초대 재발송** — 초대 메일 만료 시 다시 보내기
#### 2-4. 주의사항 > 🔴 멤버 제거는 그 사람의 다른 몰 접근까지 함께 끊습니다. 같은 브랜드 안에서 한 명이 여러 몰을 함께 운영하는 경우가 많으므로, 제거 전 그 분의 다른 몰 운영 책임을 누가 인계받을지 먼저 정해 두세요. # 상품·카탈로그 이 영역은 판매할 상품을 정리하는 곳입니다.\ 상품을 먼저 등록해야 컬렉션, 번들, 믹스앤매치를 만들 수 있습니다. ### 1. 상품 관리 > **경로**: 워크스페이스 > **상품·카탈로그** 영역 카드 > **상품 관리** 상품 정보를 만들고 수정하는 기본 화면입니다.
#### 1-1. 화면 구성 * 상단 검색·필터 — 상품명 검색, 활성화 상태 필터 * 상품 목록 테이블 — 이미지, 상품명, 가격, 할인 여부, 활성화 상태, FC 정보 * 드래그 핸들 — 노출 순서 변경 * **편집** / **삭제** 버튼 — 행 우측 #### 1-2. 상품 추가·편집 시 입력 항목 * **상품명** * **설명** * **원가**, **판매 가격**, **홍보 가격** * **사용 방법**, **성분** * **SKU** * **이미지** 여러 장 * **활성화** 토글 * **풀필먼트 센터** 연결 #### 1-3. 정렬 순서 변경 드래그 앤 드롭으로 순서를 바꾸면 자동 저장됩니다.\ 고객에게 보이는 노출 순서도 바로 갱신됩니다. ### 2. 컬렉션 > **경로**: 워크스페이스 > **상품·카탈로그** 영역 카드 > **컬렉션 보기** 컬렉션은 상품을 묶어 보여주는 카테고리입니다.\ 예를 들면 **베스트셀러**, **신상품**, **스킨케어**가 있습니다.
#### 2-1. 컬렉션 타입 * **수동(manual)** — 운영자가 상품을 직접 선택합니다. * **자동(auto)** — 조건에 맞는 상품이 자동 포함됩니다. #### 2-2. 컬렉션 설정 항목 * **제목** * **설명** * **대표 이미지** * **활성화** 토글 * **정렬 순서** * **포함 상품** — 수동 타입일 때 #### 2-3. 가능한 작업 * 컬렉션 추가 * 컬렉션 편집 * 컬렉션 삭제 * 컬렉션 안 상품 재정렬 ### 3. 번들 > **경로**: 워크스페이스 > **상품·카탈로그** 영역 카드 > **전체 작업 보기** > **번들** 번들은 여러 상품을 하나의 세트로 묶어 판매할 때 사용합니다.\ 예: **토너 + 세럼 + 크림 세트**
#### 3-1. 번들 설정 항목 * **번들명** * **Slug** * **설명** * **이미지** * 할인 유형 — 없음 / 고정액 / 백분율 * **할인값** * **활성화** 토글 * **정렬 순서** #### 3-2. 번들에 상품 추가 * 검색으로 상품 찾기 * 상품별 수량 설정 * 드래그 앤 드롭 정렬 ### 4. 믹스앤매치 > **경로**: 워크스페이스 > **상품·카탈로그** 영역 카드 > **전체 작업 보기** > **믹스앤매치** 믹스앤매치는 고객이 옵션 그룹에서 직접 골라 담는 세트입니다.\ 예: **토너 1개 + 크림 2개 자유 선택**
#### 4-1. 그룹별 설정 * **그룹명** * **최소 선택 수** * **최대 선택 수** * 그룹 안 후보 상품 #### 4-2. 전체 세트 설정 * 전체 최소 수량 * 전체 최대 수량 * 할인 설정 — 없음 / 고정액 / 백분율 * **활성화** 상태 ### 5. 실무 권장 순서 처음 세팅할 때는 아래 순서가 가장 안정적입니다. #### 5-1. 시작 순서 1. **상품 관리**에서 기본 상품을 먼저 등록합니다. 2. **컬렉션**으로 노출 묶음을 만듭니다. 3. 필요할 때만 **번들**과 **믹스앤매치**를 추가합니다. 상품이 많아지면 먼저 이름과 SKU 규칙을 맞춰 두세요.\ 그 뒤 운영 속도가 훨씬 빨라집니다. # 스토어 화면 이 영역은 고객이 실제로 보는 자사몰 화면을 관리하는 곳입니다.\ 텍스트, 이미지, 정책, 이벤트가 모두 여기서 운영됩니다. ### 1. 스토어 홈페이지 > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **스토어 홈페이지** 메인 페이지를 구성하는 화면입니다.\ 이 화면은 AI 처리, 검토, 배포 흐름으로 동작합니다.
#### 1-1. 요청 상태 * **AI 처리 중** * **검토 중** * **수정 요청** * **배포됨** * **롤백됨** #### 1-2. 가능한 작업 * 섹션 구성과 순서 조정 * 피드백 등록 * **배포** * **롤백** #### 1-3. 인라인 확장 보기 요청 행을 펼치면 아래 내용을 바로 볼 수 있습니다. * AI 처리 결과 * 리뷰 코멘트 * 변경 이력 > 🟡 **배포**와 **롤백**은 고객 화면에 바로 반영됩니다. 진행 전 한 번 더 검토하세요. ### 2. 배너 관리 > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **배너 관리** 홈페이지 상단 hero 배너를 관리합니다.
#### 2-1. 가능한 작업 * 배너 추가 * 배너 편집 * 배너 삭제 * 이미지 업로드 * **활성화** 토글 * 정렬 순서 조정 ### 3. 스토리 > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **전체 작업 보기** > **스토리**
브랜드 배경과 콘텐츠를 소개하는 섹션입니다.\ 예: **브랜드 비하인드**, **원료 이야기** #### 3-1. 구성 항목 각 스토리는 아래 항목으로 구성됩니다. * **제목** * **설명** * **이미지** * **활성화** 토글 * **정렬 순서** #### 3-2. 가능한 작업 가능한 작업은 추가, 편집, 삭제입니다. ### 4. FAQ > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **전체 작업 보기** > **FAQ**
고객이 자주 묻는 질문을 관리합니다. #### 4-1. 구성 항목 각 항목은 아래 값으로 구성됩니다. * **질문** * **답변** * **활성화** 토글 * **정렬 순서** #### 4-2. 가능한 작업 가능한 작업은 추가, 편집, 삭제입니다. ### 5. 정책 > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **전체 작업 보기** > **정책**
반품, 환불, 배송, 개인정보 관련 정책을 작성합니다. #### 5-1. 주의사항 정책은 고객과 회사 모두에 영향을 줍니다.\ 변경 전 책임자 또는 법무 검토를 권장합니다. ### 6. 이벤트 > **경로**: 워크스페이스 > **스토어 화면 영역** 카드 > **전체 작업 보기** > **이벤트**
시즈널 이벤트와 캠페인 정보를 운영합니다. #### 6-1. 구성 항목 각 이벤트는 아래 항목으로 구성됩니다. * **이벤트명** * **설명** * **이미지** * **시작 일시** * **종료 일시** * **활성화** 토글 #### 6-2. 가능한 작업 가능한 작업은 추가, 편집, 삭제입니다. # 주문·배송 이 영역은 주문이 들어온 뒤 가장 자주 보게 되는 화면입니다.\ 처리 빈도가 높으니 기본 흐름을 먼저 익혀 두는 것이 좋습니다. ### 1. 주문 관리
> **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **주문 관리** 주문을 상태별로 확인하는 기본 목록 화면입니다.
> \[스크린샷: 주문 관리 페이지 전체 — 빠른 링크, 상태 탭, 주문 테이블] #### 1-1. 상단 빠른 링크 * **배송 가능 국가** * **Tax ID 설정** * **운송사 관리** * **지역 접근 정책** #### 1-2. 주문 상태 탭 * **전체** * **요청 대기** * **환불 요청** * **취소 요청** #### 1-3. 주문 테이블 컬럼 * **주문 번호** * **결제 상태** * **이행 상태** * **합계** * **생성 날짜** 행을 클릭하면 주문 상세 페이지로 이동합니다. ### 2. 주문 상세 페이지 > **경로**: **주문 관리** 목록에서 주문 행 클릭 주문 한 건의 결제, 배송, 환불 상태를 확인하는 화면입니다.
> \[스크린샷: 주문 상세 페이지 상단 — 주문 번호, 상태 배지, 합계] > > \[스크린샷: 주문 상세 페이지 하단 — Order Timeline, 환불/취소 요청 섹션] #### 2-1. 페이지 구성 * 주문 번호 * 결제 상태 * 이행 상태 * 고객명과 이메일 * 상품 목록 * 소계, 배송료, 세금, 합계 * 쿠폰 이력 * 환불·취소 요청 섹션 * **Order Timeline** #### 2-2. 가능한 작업 **주문 취소 🔴** 주문 상태가 **unpaid** 또는 **paid**일 때 표시됩니다. 1. **주문 취소**를 클릭합니다. 2. 취소 사유를 입력합니다. 3. 취소를 확정합니다. 환불 절차는 자동으로 이어집니다. **환불 요청 검토** 환불 요청이 있을 때 처리합니다. 1. **검토**를 클릭합니다. 2. 메모를 입력합니다. 3. 승인 또는 거절을 선택합니다. 모든 결정은 **Order Timeline**에 기록됩니다. > 🔴 주문 취소와 환불 승인은 실제 금전 이동과 연결됩니다. 결정 전 정책을 먼저 확인하세요. ### 3. 운송사 관리
> **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **운송사 관리** 배송 운송사의 기본 정보와 요금 규칙을 관리합니다.
> \[스크린샷: 운송사 관리 페이지 — 운송사 상세와 요금 계층 표] #### 3-1. 운송사별 설정 항목 * **활성화** 토글 * **설명** * 국가 모드 — 특정 국가만 / 특정 국가 제외 * **배송 예상 일수** * **요금 계층** * **정렬 순서** ### 4. 지역 접근 정책 > **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **전체 작업 보기** > **지역 접근 정책** 국가나 지역별 접근과 배송 정책을 제어합니다. #### 4-1. 예시 예를 들면 아래 규칙을 설정할 수 있습니다. * 특정 국가만 배송 허용 * 특정 국가 결제 제한 * 국가별 노출 정책 분리 ### 5. 배송 국가 > **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **전체 작업 보기** > **배송 국가** 배송 가능한 국가 목록을 관리합니다. #### 5-1. 관리 항목 국가별로 아래 값을 함께 관리합니다. * **활성화** 여부 * **세금 설정** * **지역 정책** 연결 ### 6. 세금 설정 > **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **전체 작업 보기** > **세금 설정** 국가와 지역별 세금 규칙을 설정합니다. #### 6-1. 관리 항목 관리 항목은 보통 아래와 같습니다. * **Tax ID** * **세율** * **세금 유형** * 적용 지역 > 🟡 세율 변경은 이후 신규 주문에 바로 적용됩니다. 변경 전 회계 담당자와 먼저 확인하세요. ### 7. 국가별 풀필먼트 라우팅 > **경로**: 워크스페이스 > **주문·배송 영역** 카드 > **전체 작업 보기** > **국가별 풀필먼트 라우팅** 국가별 주문을 어떤 창고로 보낼지 정하는 규칙입니다. #### 7-1. 운영 예시 예를 들면 아래처럼 운영할 수 있습니다. * 북미 주문 → LA 창고 * 아시아 주문 → 서울 창고 * 유럽 주문 → 현지 파트너 창고 # 고객·환불 이 영역은 금전과 고객 신뢰에 직접 연결됩니다.\ 승인, 삭제, 발송 전에는 한 번 더 확인하세요. ### 1. 환불 관리 🔴 > **경로**: 워크스페이스 > **고객·환불 영역** 카드 > **환불 검토** 환불 요청을 검토하고 처리하는 화면입니다.
> \[스크린샷: 환불 관리 페이지 전체 — 위험 검토 경고 박스와 환불 요청 테이블] #### 1-1. 환불 위험 검토 박스 페이지 상단 경고 박스에서 아래 항목을 먼저 확인하세요. * 대상 주문 또는 고객 * 환불 금액 * 고객 영향 * 되돌릴 수 있는지 여부 #### 1-2. 환불 요청 테이블 컬럼 * **주문 번호** * **상태** * **환불 유형** * **사유** * **환불 금액** * **생성 날짜** * **고객 ID** #### 1-3. 검토 흐름 1. 행 우측 **검토**를 클릭합니다. 2. 메모를 입력합니다. 3. **환불 승인 확정** 또는 **환불 거절 확정**을 선택합니다. 4. 결정은 **Order Timeline**에 기록됩니다. #### 1-4. 필터와 검색 * 상태 필터 — 전체 / 대기 / 승인 / 거절 / 완료 * 검색 — 주문 번호, 고객 ID > 🔴 환불 승인은 되돌릴 수 없습니다. 정책 밖의 케이스는 반드시 책임자 결재를 받으세요. ### 2. 고객 관리 > **경로**: 워크스페이스 > **고객·환불 영역** 카드 > **고객 관리** 고객 정보를 검색하고 상세 이력을 확인하는 화면입니다.
> \[스크린샷: 고객 관리 페이지 — 검색창과 고객 목록 테이블] #### 2-1. 화면 구성 * 검색창 — 이름 / 이메일 / ID * 고객 목록 테이블 * 상세 정보 보기 버튼 * 이전 / 다음 페이지네이션 #### 2-2. 고객 상세 팝업 정보 * **Auth ID** * UTM 파라미터 * **리퍼러** * **랜딩 페이지** #### 2-3. 주의사항 고객 정보는 개인정보입니다.\ 공유와 저장은 사내 정책을 따라야 합니다. ### 3. 리뷰 관리 > **경로**: 워크스페이스 > **고객·환불 영역** 카드 > **전체 작업 보기** > **리뷰 관리** 상품 리뷰를 조회하고 노출 상태를 관리합니다. #### 3-1. 가능한 작업 * 리뷰 조회 * 비공개 처리 * 삭제 🔴 #### 3-2. 자주 쓰는 필터 필터는 보통 아래 기준으로 사용합니다. * 상품별 * 별점별 * 날짜별 > 🔴 삭제는 복구할 수 없습니다. 대부분은 **비공개 처리**가 더 안전합니다. ### 4. 메일 발송 > **경로**: 워크스페이스 > **고객·환불 영역** 카드 > **전체 작업 보기** > **메일 발송** 고객에게 직접 메일을 보내는 화면입니다.
> \[스크린샷: 메일 발송 페이지 — 발송 다이얼로그와 발송 이력 테이블] #### 4-1. 발송 흐름 1. **메일발송**을 클릭합니다. 2. 수신자를 선택합니다. 3. 제목과 본문을 입력합니다. 4. 발송합니다. #### 4-2. 발송 이력 테이블 * **수신자 수** * **제목** * **발송 날짜** * **상태** 최신 상태는 **새로고침**으로 다시 확인할 수 있습니다. #### 4-3. 주의사항 > 🟡 발송한 메일은 취소할 수 없습니다. 처음 보내는 메일은 본인 주소로 먼저 테스트하세요. # 성장·분석 이 영역은 매출을 늘리고 결과를 측정하는 도구 모음입니다.\ 운영이 안정된 뒤 가장 자주 보게 되는 페이지입니다. ### 1. 프로모션 / 쿠폰 > **경로**: 워크스페이스 > **성장·분석 영역** 카드 > **프로모션 / 쿠폰** 할인 쿠폰을 만들고 관리하는 화면입니다.
> \[스크린샷: 프로모션 / 쿠폰 페이지 — 검색, 필터, 쿠폰 목록 테이블] #### 1-1. 쿠폰 설정 항목 * **쿠폰 코드** * 할인 유형 — 고정액 / 백분율 * **할인값** * 적용 범위 — 카트 / 특정 상품 / 배송료 / 첫 주문 * **최소 주문 금액** * **최대 할인액** * 사용 제한 — 무제한 / 1회 / 기간 한정 * **1인당 사용 제한** * **설명** * **자동 적용** 여부 * 대상 상품 #### 1-2. 가능한 작업 * 쿠폰 추가 * 쿠폰 편집 * 쿠폰 삭제 * **활성화** 토글 * 검색과 필터링 > 🟡 이미 배포된 쿠폰은 고객 사용에 영향을 줍니다. 가능하면 삭제보다 만료일 종료를 먼저 검토하세요. ### 2. 뉴스레터 > **경로**: 워크스페이스 > **성장·분석 영역** 카드 > **전체 작업 보기** > **뉴스레터** 정기 발송용 콘텐츠와 구독자를 관리합니다. #### 2-1. 자주 하는 작업 보통 아래 작업을 수행합니다. * 발송 콘텐츠 작성 * 구독자 목록 확인 * 캠페인별 발송 성과 점검 ### 3. 매출 리포트 > **경로**: 워크스페이스 > **성장·분석 영역** 카드 > **매출 리포트** 주문 기반 매출 데이터를 시각화한 대시보드입니다.
> \[스크린샷: 매출 리포트 페이지 — 차트와 핵심 지표 카드] #### 3-1. 주요 지표 * 매출 추이 — 일별 / 주별 / 월별 * 상품별 판매량 순위 * 결제 수단별 분포 * 평균 주문 금액 * 주문 건수 ### 4. 웹분석 (GA4) > **경로**: 워크스페이스 > **성장·분석 영역** 카드 > **전체 작업 보기** > **웹분석 (GA4)** Google Analytics 4 기반 방문자 데이터를 확인합니다. #### 4-1. 확인할 수 있는 지표 * 트래픽 출처 * 사용자 동작 * 목표 달성 현황 * 실시간 또는 기간별 성과 ### 5. 운영 권장 순서 처음부터 모든 도구를 동시에 쓰실 필요는 없습니다. #### 5-1. 권장 흐름 1. 먼저 **쿠폰** 하나로 반응을 봅니다. 2. **매출 리포트**로 주문 변화를 확인합니다. 3. **GA4**로 유입과 전환 경로를 비교합니다. 이 흐름이 가장 빠르게 성과를 읽는 방법입니다. # AI 홈페이지 수정 Shopify 스토어의 홈페이지 섹션을 AI로 수정합니다. 브랜드가 수정할 섹션을 선택하고 요청을 작성합니다. 이후 AI가 코드를 수정하고, 관리자가 검수한 뒤 라이브 스토어에 적용합니다. **워크플로우** ``` 스토어 연결 → 수정 요청 → AI 처리 → 프리뷰/검수 → 배포 ``` ### 요청 상태 | 상태 | 브랜드 표시 | 설명 | | ---------------------- | ------ | --------------------- | | **Submitted** | 요청 접수 | 요청 제출 직후 | | **AI Processing** | 처리 중 | AI 처리 중 | | **AI Completed** | 처리 중 | AI 처리 완료 (다음 단계 진행 전) | | **AI Failed** | 처리 중 | AI 처리 실패 | | **Internal Review** | 검수 중 | 결과 검토 중 | | **Revision Requested** | 수정 요청 | 재처리 필요 | | **Delivered** | 결과 전달 | 전달 완료 | | **Deployed** | 적용 완료 | 라이브 적용됨 | | **Rolled Back** | 원복됨 | 이전 상태로 되돌림 | > 💡 브랜드 대시보드에서는 **AI Processing / AI Completed / AI Failed**를 모두 **처리 중**으로 표시합니다. 세부 상태는 관리자만 확인합니다. *** ### 스토어 연결 \[브랜드] 홈페이지 수정 기능을 사용하려면 먼저 Shopify 스토어를 연결해야 합니다. {% hint style="warning" %} 현재 **자동 연결 기능**을 개발 중입니다. 현재 스토어 연결은 관리자가 수동으로 진행합니다. {% endhint %} #### 스토어 연결하기 브랜드 대시보드의 홈페이지 메뉴에서 연결할 수 있습니다. * 스토어 이름을 입력 (예: `my-store`, `.myshopify.com`은 자동 추가) * Shopify 앱 설치를 승인하면 연결 완료 > 💡 하나의 브랜드에 하나의 Shopify 연결만 가능합니다. #### 연결 관리 \[관리자] 연결 이후 관리자는 Connections 페이지에서 연결 상태 확인, 검증, 비활성화 등을 관리할 수 있습니다. *** ### 수정 요청 \[브랜드]
#### 요청 제출 브랜드 대시보드 → 홈페이지에서 "스토어에서 섹션 선택하기"를 선택합니다. **섹션 선택 (우측 하단 버튼)**:
"스토어에서 섹션 선택하기"를 클릭하면 실제 스토어가 열리며, 수정할 섹션을 직접 클릭하여 선택합니다. 여러 섹션을 한 번에 선택한 후 수정 요청을 할 수 있습니다. **요청 작성**:
섹션을 선택한 후 각 섹션마다 수정 요청을 작성합니다. * 한 섹션에 여러 요청이 있다면 **요청 추가** 버튼으로 추가 * 상품명/파일명은 오른쪽의 **상품/파일 이름 조회**에서 검색하여 확인 * 필요하면 참조 이미지/비디오를 첨부 (최대 10개, 이미지 10MB, 비디오 500MB) * 작성 완료 후 **수정 요청 제출** 클릭 **요청 작성 팁**: | | 예시 | 이유 | | ---- | ------------------------------------------- | -------------------- | | 좋은 예 | "배너 이미지를 `summer-sale-hero.png`으로 변경" | 대상과 파일명이 명확 | | 좋은 예 | "추천 상품에 `Aloe Soothing Emulsion 120ml`를 추가" | 정확한 상품명 사용 | | 좋은 예 | "'Shop Now' 버튼 링크를 `/new-collection`으로 변경" | 대상, 변경값 모두 구체적 | | 나쁜 예 | "배너 이미지 바꿔주세요" | 어떤 이미지로 바꿀지 불명확 | | 나쁜 예 | "추천 상품 변경해주세요" | 어떤 상품을 어떤 순서로 할지 불명확 | | 나쁜 예 | "예쁘게 수정해주세요" | AI가 판단할 수 없는 주관적 표현 | > 💡 정확한 상품명과 파일명은 요청 화면 하단의 **상품/파일 이름 조회**에서 검색 후 복사하세요. AI는 정확한 이름이 있어야 올바르게 처리할 수 있습니다. **관리자 참고사항**: * 관리자에게 전달할 추가적인 내용을 작성합니다. #### 요청 확인 & 피드백
**\[브랜드]** * 브랜드 대시보드의 요청 이력 탭에서 상태별로 필터링하여 확인 * 요청 상세에서 추가 피드백 작성 가능 — AI 재처리 시 참고됨 **\[관리자]** * Admin의 Shopify → Requests에서 모든 브랜드의 요청 관리 * 요청이 모호한 경우 AI 처리 전에 아이템의 memo를 보완 (Edit 버튼) *** ### AI 처리 & 검수 \[관리자] #### AI 처리
요청 상세에서 **Run AI** (AI 실행)를 클릭하면 AI가 각 섹션을 독립적으로 처리합니다. * 화면이 3초마다 자동 갱신되어 진행 상황을 실시간으로 표시 * 페이지를 닫아도 백그라운드에서 계속 진행 **AI가 수정할 수 있는 것**: | 대상 | 예시 | | ------ | ----------------- | | 테마 코드 | 배경색, 레이아웃, CSS 변경 | | 상품 정보 | 상품 설명, 태그, SEO | | 메뉴 | 항목 추가/삭제/순서 | | 페이지 | 제목, 본문 수정 | | 메타필드 | 커스텀 상품 설명, 성분 정보 | | 컬렉션 순서 | 상품 순서 변경 | > 💡 위 항목 외에도 Shopify 테마와 스토어 데이터 범위 내에서 다양한 수정이 가능하니, 필요한 내용을 구체적으로 요청해 주세요. 하나의 섹션이 실패해도 나머지에 영향을 주지 않습니다. 실패 시 에러 메시지를 확인하고, memo를 보완한 뒤 **Run AI**로 재시도합니다. #### 프리뷰
AI 처리가 완료되면 **Preview** (미리보기)를 클릭하여 프리뷰 테마에 결과를 적용한 URL을 생성할 수 있습니다. * 프리뷰는 라이브 스토어에 영향을 주지 않음 * 방문자에게 보이지 않음 #### 검수
AI 결과가 만족스러우면 **Move to Internal Review** (내부 검수로 이동) → 프리뷰와 요청 사항을 대조하여 검수합니다. **검수 체크리스트**: * [ ] 요청 사항이 모두 반영되었는가 * [ ] 레이아웃/디자인이 깨지지 않았는가 * [ ] 링크, 상품이 올바르게 연결되었는가 * [ ] 모바일에서도 정상 표시되는가 검수 결과에 따라: * 문제 없음 → **Mark Delivered** (브랜드에 결과 전달) * 수정 필요 → **Request Revision** (수정 요청 — memo 보완 후 Run AI 재시도) #### 상태별 액션 | 상태 | 가능한 액션 | | ---------------------------------------------- | ----------------------------------------- | | **Submitted / AI Failed / Revision Requested** | Run AI | | **AI Completed** | Move to Internal Review, Preview | | **Internal Review** | Request Revision, Mark Delivered, Preview | | **Delivered** | Deploy to Live, Preview | | **Deployed** | Roll Back | *** ### 배포 & 롤백 \[관리자] #### 배포
Delivered 상태에서 **Deploy to Live** → **Confirm Deploy**를 클릭하면 라이브 스토어에 적용됩니다. 배포 시 시스템이 자동으로: * 라이브 테마 파일을 백업 * 임시 리소스를 실제 데이터에 반영 * 수정된 파일을 라이브 테마에 적용 동시 배포가 시도되면 먼저 시작한 것만 진행되며, 실패 시 변경된 데이터가 자동 복구됩니다. #### 롤백
Deployed 상태에서 **Roll Back** → **Confirm Rollback**을 클릭하면 배포 직전 상태로 되돌립니다. 롤백 시 시스템이 자동으로: * 백업 파일로 라이브 테마를 복원 * 컬렉션 순서와 임시 리소스를 정리 > ⚠️ 배포 후 Shopify에서 직접 수정한 내용은 롤백에 포함되지 않습니다. # 조직 관리 조직 관리에서는 브랜드 계정에 팀 멤버를 초대하고, 역할을 관리할 수 있습니다. *** ### 멤버 초대 #### 초대 방법
1. **브랜드관리를 클릭** 2. **조직 관리** 페이지로 이동 3. **멤버 초대** 버튼 클릭 4. 다음 정보를 입력: * **이메일** (필수): 초대할 멤버의 이메일 주소 * **이름** (선택): 멤버 이름 * **역할** (필수): 부여할 역할 선택 5. **초대 보내기** 클릭 > 💡 초대 이메일이 자동으로 발송됩니다. 수신자가 이메일의 "초대 수락하기" 링크를 클릭하면 가입 절차가 진행됩니다. #### 초대 재발송 초대를 수락하지 않은 멤버에게 초대 이메일을 다시 보낼 수 있습니다. * 멤버 목록에서 해당 멤버의 **더보기(⋯)** 메뉴 클릭 * **초대 재발송** 선택 > ⚠️ 초대 재발송은 **5분 간격**으로 제한됩니다. *** ### 역할 관리 #### 역할 종류 | 역할 | 설명 | 권한 | | ----------- | --- | -------------------- | | **Owner** | 소유자 | 모든 권한 (변경 불가) | | **Admin** | 관리자 | 멤버 관리, 설정 변경, 이벤트 관리 | | **Manager** | 매니저 | 이벤트 관리, 콘텐츠 관리 | | **Member** | 멤버 | 기본 조회 권한 | #### 역할 변경 1. 멤버 목록에서 해당 멤버의 **더보기(⋯)** 메뉴 클릭 2. **역할 변경** 선택 3. 새로운 역할 선택 후 저장 > ⚠️ **Owner** 역할은 변경할 수 없습니다. 자신의 역할도 직접 변경할 수 없습니다. *** ### 멤버 제거 1. 멤버 목록에서 해당 멤버의 **더보기(⋯)** 메뉴 클릭 2. **멤버 제거** 선택 3. 확인 후 제거 완료 > ⚠️ **Owner**는 제거할 수 없으며, 자기 자신도 제거할 수 없습니다. *** ### 멤버 현황 조직 관리 페이지 상단에서 다음 통계를 확인할 수 있습니다: | 항목 | 설명 | | --------- | ---------------- | | **전체 멤버** | 등록된 전체 멤버 수 | | **활성 멤버** | 현재 활동 중인 멤버 수 | | **초대 대기** | 초대 수락을 기다리는 멤버 수 | *** ### 브랜드 전환 여러 브랜드에 소속된 경우, 상단 헤더의 **브랜드 전환** 메뉴에서 다른 브랜드로 전환할 수 있습니다. # 메일 관리 **진입 경로**: 고객·메시지 > 메일 관리 메일 관리에서는 폼 이벤트 메일 템플릿과 발송 방식을 관리합니다. 메일 종류, 발송 시점, 템플릿 변수, 일괄 발송 방식을 한 곳에서 확인할 수 있습니다. ### 무엇을 할 수 있나요 * 폼 이벤트 메일 템플릿을 수정합니다. * 발송 변수와 CS 메일 설정을 확인합니다. * 일괄 발송 방식과 발송 상태를 확인합니다. *** ### 메일 종류 개요 | 카테고리 | 메일 | 발송 시점 | | --------- | --------- | -------------- | | **조직** | 멤버 초대 | 팀 멤버 초대 시 | | **폼 이벤트** | 응모 접수 확인 | 새 응모 접수 시 | | **폼 이벤트** | 선정 안내 | 응모자 선정 시 | | **폼 이벤트** | 미선정 안내 | 응모자 미선정 시 | | **폼 이벤트** | 배송 안내 | 배송 정보 입력 시 | | **폼 이벤트** | 콘텐츠 제출 요청 | 선정자에게 콘텐츠 요청 시 | *** ### 폼 이벤트 메일 템플릿 폼 이벤트에서는 5가지 메일 템플릿을 직접 커스터마이징할 수 있습니다. #### 템플릿 종류 **1. 응모 접수 확인 (Entry Applied)** * **발송 시점**: 새로운 응모가 접수될 때 * **수신 대상**: 응모자 * **용도**: 응모가 정상적으로 접수되었음을 안내 **2. 선정 안내 (Entry Confirmed)** * **발송 시점**: 응모자를 선정 처리할 때 * **수신 대상**: 선정된 응모자 * **용도**: 당첨 사실과 다음 단계 안내 **3. 미선정 안내 (Entry Denied)** * **발송 시점**: 응모자를 미선정 처리할 때 * **수신 대상**: 미선정된 응모자 * **용도**: 미선정 사실 안내 **4. 배송 안내 (Entry Shipped)** * **발송 시점**: 배송 정보(운송장)를 입력할 때 * **수신 대상**: 선정된 응모자 * **용도**: 배송 시작 및 추적 정보 안내 **5. 콘텐츠 제출 요청 (Content Request)** * **발송 시점**: 브랜드에서 일괄 콘텐츠 요청 시 * **수신 대상**: 선정된 응모자 중 콘텐츠 미제출자 * **용도**: 콘텐츠 제출 링크와 방법 안내 > ⚠️ **배송불가(Undeliverable)로 표시된 응모자**는 콘텐츠 제출 요청 메일 발송 대상에서 **자동으로 제외**됩니다. *** ### 템플릿 변수 (Placeholders) 메일 템플릿에서 사용할 수 있는 변수입니다. `{{변수명}}` 형식으로 삽입하면 발송 시 실제 값으로 자동 치환됩니다. #### 기본 정보 | 변수 | 설명 | 사용 가능 템플릿 | | -------------------- | -------- | --------- | | `{{brandName}}` | 브랜드명 | 전체 | | `{{csEmail}}` | CS 이메일 | 전체 | | `{{formEventTitle}}` | 이벤트 제목 | 전체 | | `{{entryName}}` | 응모자 이름 | 전체 | | `{{entryEmail}}` | 응모자 이메일 | 전체 | | `{{entryPhone}}` | 응모자 전화번호 | 전체 | | `{{entryStatus}}` | 응모 상태 | 전체 | #### 심사 관련 | 변수 | 설명 | 사용 가능 템플릿 | | ------------------ | ------ | --------- | | `{{reviewerNote}}` | 심사 메모 | 선정 안내 | | `{{cancelReason}}` | 미선정 사유 | 미선정 안내 | #### 배송 정보 | 변수 | 설명 | 사용 가능 템플릿 | | ------------------------- | --------- | --------- | | `{{carrierName}}` | 국제 배송사명 | 배송 안내 | | `{{trackingNumber}}` | 국제 운송장번호 | 배송 안내 | | `{{trackingUrl}}` | 배송 추적 URL | 배송 안내 | | `{{localCarrierName}}` | 로컬 배송사명 | 배송 안내 | | `{{localTrackingNumber}}` | 로컬 운송장번호 | 배송 안내 | | `{{localTrackingUrl}}` | 로컬 추적 URL | 배송 안내 | #### 배송지 정보 | 변수 | 설명 | 사용 가능 템플릿 | | --------------------------- | -------- | --------- | | `{{shippingRecipientName}}` | 수령자명 | 배송 안내 | | `{{shippingPhone}}` | 수령자 전화번호 | 배송 안내 | | `{{shippingLine1}}` | 주소 1 | 배송 안내 | | `{{shippingLine2}}` | 주소 2 | 배송 안내 | | `{{shippingCity}}` | 도시 | 배송 안내 | | `{{shippingState}}` | 주/도 | 배송 안내 | | `{{shippingPostalCode}}` | 우편번호 | 배송 안내 | | `{{shippingCountry}}` | 국가 | 배송 안내 | | `{{shippingFullAddress}}` | 전체 주소 | 배송 안내 | #### 콘텐츠 관련 | 변수 | 설명 | 사용 가능 템플릿 | | -------------------------- | --------- | --------- | | `{{contentSubmissionUrl}}` | 콘텐츠 제출 링크 | 콘텐츠 제출 요청 | #### 동적 폼 필드 폼 빌더에서 설정한 커스텀 필드의 응답값도 변수로 사용할 수 있습니다: ``` {{formResponses.필드키}} ``` 예시: * `{{formResponses.instagram_handle}}` → 응모자가 입력한 인스타그램 핸들 * `{{formResponses.shoe_size}}` → 응모자가 입력한 신발 사이즈 *** ### 템플릿 관리 #### 템플릿 편집 1. 폼 이벤트 상세 페이지에서 **메일 템플릿** 탭 선택 2. 편집할 템플릿 종류 선택 (5가지 탭) 3. HTML 에디터로 내용 편집 4. **변수 도움말** 패널에서 사용 가능한 변수 확인 5. 저장 #### 템플릿 제한 | 항목 | 제한 | | ----------------- | ---------- | | **제목** | 최대 200자 | | **HTML 본문** | 최대 50,000자 | | **Plain Text 본문** | 최대 10,000자 | #### 기본 템플릿 각 템플릿 타입에는 시스템 기본 템플릿이 제공됩니다. 커스텀 템플릿을 삭제하면 시스템 기본 템플릿으로 복원됩니다. 삭제 없이도 **기본값 해제**로 시스템 기본 템플릿을 다시 적용할 수 있습니다. 기본값 해제 방법: 1. 폼 이벤트 상세 페이지에서 **이메일 템플릿** 탭 선택 2. 기본값으로 되돌릴 템플릿 종류 선택 3. **기본값 해제** 클릭 {% hint style="warning" %} **기본값 해제**는 현재 커스텀 템플릿 내용을 시스템 기본값으로 덮어씁니다. {% endhint %} *** ### CS 메일 설정 메일에 포함되는 CS 연락처를 설정합니다. * **브랜드 레벨**: 폼 이벤트 목록 페이지의 **CS 메일 관리** 버튼에서 설정 * **이벤트 레벨**: 각 이벤트 설정에서 이벤트별 CS 메일 지정 가능 > 💡 이벤트별 CS 메일이 설정되지 않으면 브랜드 레벨 CS 메일이 사용됩니다. *** ### 메일 일괄 발송 #### 선정 안내 일괄 발송 선정된 응모자 전체에게 선정 안내 메일을 일괄 발송합니다. * 이미 메일이 발송된 응모자는 자동으로 제외됩니다. #### 콘텐츠 제출 요청 일괄 발송 선정된 응모자 중 콘텐츠를 아직 제출하지 않은 응모자에게 콘텐츠 제출 요청 메일을 일괄 발송합니다. * 배송불가(Undeliverable) 응모자는 자동으로 제외됩니다. * 이미 콘텐츠를 제출한 응모자는 제외됩니다. #### 개별 메일 재발송 특정 응모자에게 메일을 다시 발송할 수 있습니다: * 응모자 상세 페이지에서 **이메일 재발송** 버튼 클릭 *** ### 메일 발송 방식 #### 대량 발송 처리 방식 대량 메일 발송은 큐(Queue) 기반으로 처리됩니다: 1. **메일 잡(Job) 생성**: 발송 요청 시 잡이 생성됨 2. **백그라운드 처리**: 시스템에서 자동으로 순차 발송 3. **상태 추적**: 발송 진행 상황 실시간 확인 가능 4. **실패 재시도**: 발송 실패한 메일은 개별 재시도 가능 #### 메일 잡 상태 | 상태 | 설명 | | -------------- | ------- | | **Pending** | 발송 대기 중 | | **Processing** | 발송 진행 중 | | **Completed** | 발송 완료 | | **Failed** | 발송 실패 | | **Cancelled** | 취소됨 | #### 발송 전 미리보기 일괄 발송 전에 다음 정보를 미리 확인할 수 있습니다: * 발송 예정 수 * 이미 발송된 수 (중복 제외) * 이전 실패 항목 수 > 💡 한 번에 최대 **5,000건**까지 일괄 발송할 수 있습니다. *** ### 조직 멤버 초대 메일 팀 멤버를 초대하면 자동으로 초대 메일이 발송됩니다. #### 메일 내용 * **발신**: 하이퍼케이프 * **제목**: `[Hypercape] {브랜드명}에서 초대가 도착했습니다` * **내용**: * 초대자명 * 브랜드명 * 부여된 역할 * 초대 수락 버튼 (CTA) # 이벤트 유형 비교 하이퍼케이프 브랜드 플랫폼에서는 두 가지 유형의 이벤트를 제공합니다. 캠페인 목적과 운영 방식에 따라 적합한 유형을 선택하세요. *** ### 한눈에 비교 | 구분 | 플랫폼 이벤트 | 폼 이벤트 | | ----------- | ------------------- | --------------------- | | **목적** | 크리에이터와 브랜드 협업 캠페인 | 응모형 이벤트 (체험단, 서포터즈 등) | | **참가 대상** | 플랫폼에 등록된 크리에이터 | 누구나 (이메일 기반 응모) | | **참가 방식** | 크리에이터가 플랫폼에서 직접 신청 | 공개 응모 폼에서 정보 입력 후 신청 | | **승인 절차** | 관리자 검토 → 승인 후 게시 | 브랜드가 직접 생성 → 바로 운영 | | **콘텐츠 관리** | 플랫폼 내 콘텐츠 제출/검수 시스템 | URL 기반 콘텐츠 제출 (선택 기능) | | **배송 관리** | PIM 시스템 연동 자동 배송 | 운송장 직접 입력 (다중 운송장 지원) | | **보상 체계** | H-Point 자동 지급 | 제품 제공 (배송) | | **이메일 시스템** | 플랫폼 기본 알림 | 5가지 커스텀 이메일 템플릿 | | **데이터 수집** | 크리에이터 프로필 기반 | 커스텀 폼 빌더 (최대 20개 필드) | | **참가자 추가** | 크리에이터 자발적 신청만 가능 | 수동 추가, 엑셀 일괄 추가 가능 | *** ### 플랫폼 이벤트 #### 이런 경우에 적합합니다 * SNS 콘텐츠 제작이 핵심인 **인플루언서 마케팅 캠페인** * 크리에이터의 **팔로워 수, 채널 정보** 등을 기반으로 선발해야 할 때 * 콘텐츠 **검수 및 승인 프로세스**가 필요할 때 * **H-Point 보상**을 통한 체계적인 크리에이터 보상이 필요할 때 * 크리에이터 **평가 및 이력 관리**가 필요할 때 #### 운영 흐름 ``` 이벤트 생성 → 관리자 승인 → 게시 → 크리에이터 신청 → 신청자 선발 → 제품 배송 → 콘텐츠 제출 → 콘텐츠 검수 → H-Point 지급 → 크리에이터 평가 → 이벤트 완료 ``` #### 핵심 특징 * **크리에이터 프로필 기반 선발**: SNS 채널, 팔로워 수, 과거 평가 등을 확인하고 선발 * **콘텐츠 검수 시스템**: 제출된 콘텐츠를 승인/거절하는 체계적 프로세스 * **H-Point 보상**: 콘텐츠 승인 후 자동으로 H-Point 지급 * **크리에이터 평가**: 이벤트 완료 후 종합 평점, 전문성, 커뮤니케이션 등 평가 * **PIM 연동 배송**: 상품 관리 시스템과 연동된 자동 배송 처리 *** ### 폼 이벤트 #### 이런 경우에 적합합니다 * **체험단, 서포터즈** 등 일반 소비자 대상 이벤트 * 플랫폼 미가입자도 참여할 수 있는 **공개 응모 이벤트** * 사이즈, 선호 제품 등 **맞춤 정보 수집**이 필요할 때 * **대량 배송**과 운송장 관리가 중심인 이벤트 * 브랜드가 **이메일 내용을 직접 커스터마이징**하고 싶을 때 * 기존 인플루언서 리스트를 **엑셀로 일괄 등록**해야 할 때 #### 운영 흐름 ``` 폼 이벤트 생성 → 응모 양식 설계 → 이메일 템플릿 설정 → 응모 접수 → 선정/미선정 처리 → 선정 안내 이메일 발송 → 제품 배송 → 배송 안내 이메일 발송 → (콘텐츠 제출 요청) → (콘텐츠 확인) → 이벤트 종료 ``` #### 핵심 특징 * **커스텀 폼 빌더**: 텍스트, 선택, 날짜 등 다양한 필드로 응모 양식 설계 * **공개 응모**: 플랫폼 가입 없이 누구나 응모 가능 * **커스텀 이메일 템플릿**: 응모 확인, 선정 안내, 배송 안내 등 5가지 이메일을 브랜드 스타일에 맞게 편집 * **다중 운송장 지원**: 국제 배송사 + 로컬 배송사 운송장을 함께 관리 * **배송사 관리**: 자주 사용하는 배송사를 미리 등록하여 효율적 운영 * **배송불가 관리**: 통관 실패, 주소 불명 등 배송 불가 사유 기록 및 이메일 자동 제외 * **엑셀 일괄 처리**: 응모자 추가, 배송 정보 입력, 데이터 내보내기 모두 엑셀 지원 *** ### 기능별 상세 비교 #### 참가자 관리 | 기능 | 플랫폼 이벤트 | 폼 이벤트 | | -------- | ---------------------- | ---------------- | | 참가 신청 | 크리에이터 플랫폼에서 신청 | 공개 응모 폼 또는 수동 추가 | | 참가자 정보 | 크리에이터 프로필 (SNS, 팔로워 등) | 폼 응답 (커스텀 필드) | | 선발 기준 | 프로필, 채널 데이터 기반 | 응모 내용 기반 | | 일괄 처리 | 일괄 승인/거절 | 일괄 선정/미선정, 엑셀 추가 | | 참가자 추가 | 불가 (자발적 신청만) | 수동/엑셀 일괄 추가 가능 | | 데이터 내보내기 | 제한적 | 전체/선택 엑셀 내보내기 | #### 배송 | 기능 | 플랫폼 이벤트 | 폼 이벤트 | | -------- | -------------- | -------------- | | 배송 방식 | PIM 시스템 연동 | 운송장 직접 입력 | | 배송 추적 | PIM 자동 상태 업데이트 | 수동 상태 관리 | | 다중 운송장 | 미지원 | 지원 (국제 + 로컬) | | 배송사 관리 | PIM 설정 | 브랜드별 배송사 등록 | | 일괄 배송 입력 | 배송 요청 일괄 처리 | 엑셀 일괄 배송 정보 입력 | | 배송불가 관리 | 미지원 | 지원 (8가지 사유) | #### 콘텐츠 | 기능 | 플랫폼 이벤트 | 폼 이벤트 | | ------- | ------------------ | ------------------ | | 콘텐츠 제출 | 필수 (플랫폼 내 제출) | 선택 (URL 제출) | | 검수 프로세스 | 브랜드 검수 → 관리자 최종 검수 | 브랜드 URL 확인 (승인/거절) | | 거절 사유 | 자유 텍스트 | 4가지 사유 템플릿 + 커스텀 | | 일괄 처리 | 미지원 | 일괄 승인/거절 | | 삭제 요청 | 미지원 | 삭제 요청 검토 | #### 이메일 | 기능 | 플랫폼 이벤트 | 폼 이벤트 | | ---------- | -------------- | ---------------------- | | 이메일 커스터마이징 | 불가 (시스템 기본 알림) | 5가지 템플릿 자유 편집 | | 변수 삽입 | 미지원 | 30개 이상 플레이스홀더 | | 일괄 발송 | 플랫폼 알림 | 큐 기반 대량 발송 (최대 5,000건) | | 발송 이력 | 기본 로그 | 상세 발송 로그 및 재시도 | | CS 이메일 설정 | 미지원 | 브랜드/이벤트 레벨 설정 | *** ### 어떤 이벤트를 선택해야 할까? #### 플랫폼 이벤트를 선택하세요 > "검증된 크리에이터와 함께 SNS 콘텐츠 캠페인을 진행하고 싶다" * 크리에이터의 채널 데이터를 보고 선발하고 싶을 때 * 콘텐츠 품질 관리가 중요할 때 * H-Point 보상 시스템을 활용하고 싶을 때 * 장기적인 크리에이터 관계 관리가 필요할 때 #### 폼 이벤트를 선택하세요 > "체험단/서포터즈를 모집하고 제품을 배송하고 싶다" * 플랫폼 미가입자도 참여할 수 있어야 할 때 * 커스텀 정보 (사이즈, 선호도 등)를 수집해야 할 때 * 대량 배송 관리가 핵심일 때 * 이메일 내용을 브랜드 스타일로 커스터마이징하고 싶을 때 * 기존 인플루언서 리스트를 활용해야 할 때 # \[Partner Seller] FAQ Quick answers for common questions about pricing, syncing, shipping, payments, and policies. Quick answers first. Deeper details are linked. ### Shopify
How do I connect Hypercape to my Shopify store? Use the Dev Dashboard App method. Go to [Step 1. Connect Shopify](/connect-shopify-guide/step-1.-connect-shopify).
How do I import products to my Shopify store? Importing adds items to your Import List. You still must **Send to Shopify**, then set the Shopify product status to **Active**. Go to [Step 2. Import Products](/connect-shopify-guide/step-2.-import-products).
### Costs & fees
Any extra charge over product cost? No service fee. No transaction fee. You pay: * Product supply cost * Shipping cost Shipping is charged **per order (per shipment)**. It is not charged per product. For margin math, see [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin).
### Orders
I clicked “Sync Orders” but my orders don’t appear. Only orders that contain products **imported via Hypercape** can be synced. Check: * The ordered item exists in your **My Product** page. * The order is a normal paid order (not draft). More fixes: [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting).
Does renaming products in Shopify affect order sync? No. Renaming products imported from Hypercape does not affect sync. You can break syncing in these cases: * You copy an imported product, sell the copy, then delete the original. * You replace the imported product with a different product. See the warning section in [Step 2. Import Products](/connect-shopify-guide/step-2.-import-products).
When do I need to pay for an order? You must pay **before** we ship to your customer. Flow: 1. Your customer pays on your Shopify store. 2. You sync the order in Hypercape. 3. You pay supply price + shipping cost. 4. Hypercape ships direct to your customer. See [Step 3. Sync & Fulfill Orders](/connect-shopify-guide/step-3.-sync-and-fulfill-orders).
How long does order processing take? Typical processing time is **0–2 business days** after payment. It can take longer depending on product and exceptions. See [Step 3. Sync & Fulfill Orders](/connect-shopify-guide/step-3.-sync-and-fulfill-orders).
What happens if the ordered product is out of stock? If an item becomes unavailable after sync, Hypercape credits **$5 per affected order**. More context: [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting).
Is there a limit on order quantity? Max quantity is **99 units per product**. If you need wholesale volume, email ****.
### Payments & credits
What payment options are available? Two options: * **PayPal** for card payments * **Prepayment (WISE)** credits Prepayment credits can reduce what you pay at checkout. See the payment flow in [Step 3. Sync & Fulfill Orders](/connect-shopify-guide/step-3.-sync-and-fulfill-orders).
Is prepayment refundable? Yes. Prepayment can be refunded, even if partially used. Refund is prorated by the original purchase rate. Example (5% bonus credits): * You bought **1,050 credits** with **$1,000**. * You spent **420 credits**. * Remaining credits: **630**. * Refund: **$600** (= 630 / 1.05).
### Shipping
How do shipping fees work? Shipping is: * Charged **per order (per shipment)** * A fixed rate by shipping method Basics: [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin).
Which shipping method will be used if my Shopify customer picks a method? Shopify shipping selection does not control fulfillment shipping. You choose the shipping method at Hypercape checkout. Profit formula and setup guidance: [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin).
What is the difference between K-PACKET and EXPRESS? * **K-PACKET**: cheaper, slower. Typical lead time **2–3 weeks**. * **EXPRESS (FedEx/DHL)**: faster, higher quality. Typical lead time **3–5 business days**. Full breakdown: [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin).
I chose K-PACKET. Why was it shipped by Express? Orders can be upgraded to Express due to weight or carrier constraints. This can happen if the shipping cost difference is minimal. See [\[Partner Seller\] Shipping & Margin](/reference/partner-seller-shipping-and-margin).
Can I choose the Express carrier (DHL, FedEx, etc.)? No. Carrier is selected by Hypercape based on destination and availability.
Do you provide tracking? Yes. Tracking number and link appear in your Hypercape order list after shipment. We also share packing videos via YouTube.
What should I do for damaged, wrong, or missing shipments? Prepare: * Photo of the shipping waybill * Photo of the full box with the waybill attached * Photo of the full product(s) in question Keep the original box and labels. Also see [\[Partner Seller\] Troubleshooting](/reference/partner-seller-troubleshooting).
### Customs & returns
Who pays customs and duty? Customs duties and import taxes are generally paid by the importer (your customer). More detail: [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance).
Can I prepay customs for my customer? No. Customs prepayment is not supported. Reason: global variation + high carrier prepayment fees. More policy detail: [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance).
What is the remorse return policy? Buyer pays return-related costs (both-way shipping, warehousing, duties, carrier fees). Do not refund end customers until Hypercape confirms the return. See [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance).
### Policy
Can I get any certificates issued by brands? No. Hypercape does not issue brand certificates. See [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance).
### Products
I can’t find a product I’m looking for. Email us with product info or URL: ****.
Can I sell bundles or custom sets? Yes. You can create bundles on Shopify and place orders in Hypercape. Auto-sync does not work for custom sets. You must place the order manually: * Enter the customer address per order * Add the items to the cart manually
My customer received a product that looks different from the product photos. Brands sometimes renew packaging or wording without notice. If the formulation is the same, this is not treated as a wrong item. Returns are not available for packaging-only differences.
What about product expiration dates? Most products have a shelf life of **1+ year**. If a brand discontinues or runs out of stock, replacement inventory may have a shorter shelf life.
### Packaging
Do you offer custom packaging? Yes. Additional charges can apply. Common requests: * In-package stickers/flyers: **$1 per order** * Customized box: **$1 per order** You must ship materials to our Korea office. More detail: [\[Partner Seller\] Policy & Compliance](/reference/partner-seller-policy-and-compliance).
### Platform support
Can I use Hypercape with platforms other than Shopify? To use full integration features, you need Shopify. Currently, integration is Shopify-only.
### Need help? Email ****. Include: * Your Shopify store URL * Order number (if relevant) * Screenshots * A short description of the issue # \[Partner Seller] Shipping & Margin Understand shipping options and margin before increasing volume. ### Shipping Options #### K-PACKET * Lower cost, slower lead time * **2-3 weeks** delivery * Available countries: US (except HI/GU/Saipan), AU, BR, CA, CN, DE, ES, FR, GB, HK, JP, MY, PH, RU, SG, TH, TW, VN #### EXPRESS (FedEx/DHL) * Faster and higher quality * **3-5 business days** delivery * All countries available * Carrier automatically selected by Hypercape based on destination ### Important Notes * **Shipping fee is charged PER ORDER, not per product** * K-PACKET orders may be upgraded to EXPRESS automatically if weight/conditions require it (at no extra charge to you if cost difference is minimal) * You select shipping method during checkout in Hypercape BIZ (customer's choice on Shopify does not affect actual shipping method) ### Margin Formula **Your Profit** = (Customer Product Price + Customer Shipping) - (Supply Price + Shipping Cost) #### Example Calculation **Scenario:** Selling a K-beauty serum * Customer pays: **$45** (product) + **$8** (shipping) = **$53** * You pay Hypercape: **$18** (supply) + **$3** (K-PACKET) = **$21** * **Your margin: $32** #### Shipping Cost Structure Shipping is based on freight charges only. Does NOT include: * Customs duties * Value-added tax (VAT) * Import clearance fees in destination country **The importer (customer) is responsible for these costs.** #### Setting Your Shopify Shipping Rates You need to configure shipping rates yourself in Shopify Admin: 1. Go to **Settings → Shipping and delivery** 2. Create shipping zones by region 3. Set rates that cover your costs + desired margin 4. Consider offering free shipping (built into product price) # \[Partner Seller] Policy & Compliance ### Customs and Duty * **Customs and duty tax is the buyer's responsibility** * For accurate import tax info, check your destination country's customs regulations * Shipping fees to Hypercape are freight charges only (do NOT include customs/VAT/clearance fees) * The importer (customer) pays all customs duties, VAT, and incidental costs in the destination country **Customs prepayment is NOT available** due to global shipping complexity and high carrier fees. ### Returns (Remorse Return) * Buyer is responsible for: * Return shipping costs (both directions) * Warehousing fees * Customs duties * Carrier-imposed charges **⚠️ Do NOT refund end customers until Hypercape confirms the return.** ### Brand Certificates Hypercape does NOT issue brand certificates. * Our customers operate independent stores. They are not wholesalers. * Their end customers are individuals importing for personal use * Branding certificates are not required for personal imports ### Custom Packaging Custom packaging is available with additional charges: * **In-package stickers/flyers:** $1 USD per order * **Custom box:** $1 USD per order You must send custom materials (stickers, boxes, etc.) to Hypercape's office in Korea. ### Product Expiration Dates * Most products have **1+ year shelf life** * If a product is discontinued or out of stock from the brand, Hypercape may ship products with shorter shelf life ### Product Renewals If a brand suddenly renews a product (packaging/wording changes), **the product cannot be returned** as long as it's the same product formulation. # \[Partner Seller] Troubleshooting Common issues and solutions for Hypercape partner sellers. ### Connection Issues #### Products Not Syncing from Hypercape **Problem:** Can't see products in Shopify after connecting **Solutions:** 1. Verify API permissions are correctly set (see [Step 1. Connect Shopify](/connect-shopify-guide/step-1.-connect-shopify) for required scopes) 2. Check if app installation completed successfully 3. Try disconnecting and reconnecting the app 4. Contact support if issue persists ### Order Sync Issues #### Orders Don't Appear After Sync **Problem:** Clicked "Sync Orders" but orders don't show up in Hypercape BIZ **Solution:** Only products imported through Hypercape can be synced. Check if the ordered product exists in your "My Product" page. If not, import it first from Hypercape catalog. ### Product Issues #### Product Out of Stock **What happens:** If a product is unavailable after you sync an order, Hypercape credits **$5 per order** to your account and notifies you. **Action needed:** Refund or offer alternative product to your customer. #### Product Has Short Expiration Date **Issue:** Received product with less than 1 year shelf life **Explanation:** If a product is discontinued or out of stock from the brand, Hypercape may ship products with shorter shelf life. This is normal and cannot be returned. ### Payment & Refund #### When to Refund Customers ⚠️ **IMPORTANT:** Do NOT refund customers until Hypercape confirms the return or issue resolution. **Process:** 1. Customer reports issue 2. Contact Hypercape support 3. Wait for Hypercape confirmation 4. Then process refund to customer ### Order Limits #### Maximum Quantity Per Product **Limit:** 99 units per product per order **For bulk orders:** If you need to order more than 99 units of a single product, contact **** for wholesale inquiries. ### Shipping issues #### Damaged, wrong, or missing shipments Send these photos to support: * Shipping waybill (label) photo * Full box photo with the waybill attached * Full product photo showing the issue Do not throw away the original box or labels. We may need them for carrier claims. #### What level of damage is refundable/returnable? If only the outer shipping box or packaging is damaged, we do not treat it as damage. We review cases where the **item itself** is damaged or incorrect. ### Contact Support **Email:** **Response time:** Usually within 1-2 business days **Include in your message:** * Your store name/URL * Order number (if applicable) * Screenshots of the issue * Detailed description of the problem # \[Creator] Managing Your Profile Profile controls your creator identity and eligibility. ### What you can see * Display name, bio, avatar * Verified Creator badge (if applicable) * Connected social channels * Event stats (completed events, H‑Points earned, rating) ### Edit your profile Open **Profile** → **Edit**. Edits are reviewed by admins. #### Editable fields * **Basic Info**: display name, bio * **Address**: address line 1/2, province/state * **Payout**: PayPal account #### Social links Social channels can be read-only. If you need changes, explain it in the request reason. {% hint style="warning" %} All profile changes require admin approval. You must provide a reason (minimum 10 characters). You can’t submit a new request while one is pending. {% endhint %} # \[Creator] FAQ Creators often ask about eligibility, applications, shipping, and payouts. If you need help, email ****. ### Applying
How do I know if I’m eligible for an event? Open the event detail page. If you meet the requirements, you’ll see a green check. If not, you’ll see what’s missing.
Can I apply to multiple events? Yes. Each application is reviewed independently.
Can I edit my application after submitting? No. Applications are locked after submission.
### Selection
How are creators selected? Each brand sets its own criteria. Common factors include audience fit, content quality, and your application message.
I was not selected. Can I re-apply? Usually no. Apply to other events instead.
What’s the difference between Content Campaign and Product Gifting? * **Content Campaign**: you create content and submit URLs based on requirements. * **Product Gifting**: you receive a product. No content submission is required.
### Content submission
What platforms are supported for content submission? Instagram, TikTok, YouTube, Facebook, and Threads.
Can I submit a private post? Follow the event requirements on the detail page. Some events require your post to be **Public**.
I submitted the wrong URL. Can I change it? No. Submissions are locked after you confirm. Email **** as soon as possible.
### Shipping
Where do I find tracking info? Open your application detail page. Tracking appears in the **Shipping** section after selection. See [Step 4. Shipping & Tracking](/creator-guide/step-4.-shipping-and-tracking).
My package shows Delivered but I didn’t receive it Contact the carrier using the tracking link first. Then email **** with the details.
My product arrived damaged / wrong / missing Email **** with photos and the tracking number.
### Earnings & withdrawal
When do I receive H‑Points? Timing depends on the event rules. Some events credit after submission. Some events require brand review first.
Where do I set my PayPal account? Go to **Profile → Edit → Payout**. See [\[Creator\] Managing Your Profile](/reference/creator-managing-your-profile).
My withdrawal failed. Why? Common reasons: * PayPal account info is incorrect. * Your PayPal account has restrictions. Confirm your PayPal info in your profile. If it still fails, email **** with a screenshot.
### Need help? Email ****. Include: * Event name (or link) * Your account email (the one you applied with) * Application status (Applied / Selected / Delivered, etc.) * Screenshots * A short description of the issue