# Creative

Creative là một video quảng cáo ngắn được cắt từ một tập của phim mà tổ chức của bạn có quyền xuất. Bạn có thể dựng creative hàng loạt trên màn hình **Create**, nơi một formula chọn cảnh giúp bạn, hoặc dựng tay trong **Editor**. Mọi creative đều được render trước thành bản nháp có watermark, sau đó được admin review, và chỉ creative đã duyệt mới có bản render cuối sạch. Admin và marketer dựng được creative; xem [Vai trò và quyền hạn](https://docs.wandura.ai/vi/partners/roles).

## Vòng đời

```mermaid
flowchart LR
  A[Draft] --> B[Rendering preview]
  B --> C[Preview ready]
  C -->|Gửi đi review| D[Awaiting review]
  D -->|Admin duyệt| E[Rendering final]
  E --> F[Approved]
  D -->|Admin trả lại| G[Rejected]
  G -->|Duplicate to edit| A
```

| Trạng thái | Ý nghĩa |
|---|---|
| Draft | Chưa render. Bạn vẫn sửa được. |
| Rendering preview | Bản render nháp có watermark đang chạy. |
| Preview ready | Đã xem được bản xem trước nháp. Người tạo có thể gửi đi review. |
| Awaiting review | Đang chờ admin duyệt hoặc trả lại. |
| Rendering final | Đã duyệt; bản render cuối sạch đang chạy. |
| Approved | Bản render cuối đã sẵn sàng và creative đã được giao vào delivery feed của tổ chức. |
| Rejected | Admin đã trả lại kèm lý do. |

## Ngân sách xuất
Tổ chức của bạn có một ngân sách xuất hằng tháng, tính bằng phút, hiển thị là **Org export budget** trên Home và trên từng trang phim. Thời lượng xuất được tính khi admin duyệt một creative và bản render cuối của nó hoàn tất. Render nháp không tốn ngân sách, nhưng bạn không render được bản nháp dài hơn phần ngân sách còn lại của tháng.

## Dựng creative hàng loạt

Màn hình **Create** là một bảng. Mỗi dòng thành một creative, và tất cả các dòng bạn gửi cùng lúc tạo thành một batch. Một batch chứa tối đa 100 dòng.

| Cột | Cần đặt gì |
|---|---|
| Code | Mã tham chiếu riêng của bạn cho creative. |
| Film | Phim. Chỉ các phim tổ chức của bạn có quyền xuất mới được liệt kê. Gõ để tìm theo tên hoặc mã phim. |
| Formula | Công thức chọn và sắp xếp cảnh. Chỉ các formula admin của bạn đã xuất bản mới xuất hiện. |
| Episode | Một hoặc nhiều tập. Cạnh mỗi tập bạn thấy số cảnh của tập đó khớp với formula đã chọn. |
| Scenes | Tập đã được đọc để tìm khoảnh khắc quảng cáo hay chưa. |
| Brand kit | Brand kit sẽ áp dụng, hoặc **No branding**. Kit mặc định của tổ chức được chọn sẵn. |
| Call to action | Một trong các mẫu CTA của brand kit, hoặc **No CTA**. |
| Status | Tình trạng của dòng: Incomplete, Not checked, Ready, Blocked, rồi đến tiến độ batch sau khi gửi. |

### Các bước

1. Mở **Create**. Nếu bạn bắt đầu từ **New creative** hoặc **Create from episode** trên trang phim, phim và tập đã được điền sẵn.
2. Bấm **Add row** hoặc **Add 5 rows** ở cuối bảng.
3. Trên mỗi dòng, chọn **Film**, rồi **Formula**, rồi **Episode**. Hãy chọn formula trước: khi đó danh sách tập sẽ cho biết tập nào có cảnh khớp với formula.
4. Để dùng nhiều tập, đánh dấu chúng trong danh sách tập và chọn cách dùng:- **Separate creatives**: tập đầu tiên ở lại dòng này và mỗi tập còn lại có một dòng mới riêng.
  - **Combine into one**: một creative được dựng từ tập đầu tiên, và sau đó bạn thêm cảnh từ các tập khác trong Editor.
5. Kiểm tra cột **Scenes**. Nếu một tập chưa được đọc, chọn **Read now** trong danh sách nguồn cảnh để Wandura đọc tập đó trước; dòng sẽ chờ và tự dựng khi đọc xong. **Existing scenes** chỉ dùng được với các tập đã được đọc.
6. Tuỳ chọn: chọn **Brand kit** và **Call to action**.
7. Để đổi nhiều dòng cùng lúc, đánh dấu chúng rồi dùng **Apply formula to … selected** hoặc **Apply brand kit to … selected**.
8. Bấm **Generate creatives**.

Trước khi gửi, Wandura kiểm tra mọi dòng đã điền đủ. Các dòng đạt được gửi đi thành một batch; dòng không đạt ở lại trong bảng với nhãn **Blocked** kèm lý do, và nút đổi thành **Generate N ready** để bạn gửi các dòng còn lại. Dòng bị chặn không bị tính phí.

| Cột Scenes | Ý nghĩa |
|---|---|
| *N* scenes ready | Tập đã được đọc và có cảnh để chọn. |
| Not read yet | Tập chưa được đọc. Chọn **Read now**, hoặc chọn tập khác. |
| Being read · builds when ready | Đang đọc; dòng sẽ dựng khi đọc xong. |
| Not read · cannot build | Tập hiện không dùng được. |
| Processing | Bản thân tập phim vẫn đang được chuẩn bị. |

Trong lúc batch chạy, thanh tóm tắt phía trên bảng đếm số dòng đang chờ, đang chạy, đã xong và bị lỗi, kèm các nút **Pause**, **Resume** và **Open batch**. Khi mọi dòng đã chạy xong, cổng báo cho bạn có bao nhiêu creative sẵn sàng để xem trước. Dùng **Clear finished** hoặc **Clear all** để dọn bảng; thao tác này không xoá creative nào.

## Theo dõi batch

**Batches** liệt kê mọi batch bạn đã gửi (admin thấy batch của tất cả mọi người). Việc xử lý vẫn tiếp tục phía Wandura kể cả khi bạn đóng tab. Mở một batch để xem từng dòng.

| Trạng thái dòng | Ý nghĩa |
|---|---|
| Queued | Đang chờ bắt đầu. |
| Checking selection | Đang kiểm tra phim, tập và formula. |
| Creating draft | Đang dựng bản edit từ formula. |
| Rendering | Đang render bản xem trước có watermark. |
| Checking output | Đang kiểm tra file đã render. |
| Ready | Creative đã có và xem trước được. |
| Waiting for episode analysis | Tập phim đang được đọc trước. |
| Waiting to retry | Lỗi tạm thời; Wandura tự thử lại vào thời điểm hiển thị. |
| Needs attention | Dòng bị lỗi. |
| Retry limit reached | Đã hết lượt tự thử lại. |
| Skipped, Cancelled | Dòng sẽ không chạy. |
| Outcome under review | Kết quả của lần chạy trước phải được xác nhận rồi mới chạy lần khác được. |

Trên trang batch, bạn có thể:

- **Pause**, **Resume** hoặc **Cancel** batch trong lúc đang chạy.
- **Retry this row** trên dòng có nút này.
- Bấm **Why did this fail?** trong mục **Rows that need attention** để xem lỗi thật, tiêu chí của formula, và nội dung của tập. Nguyên nhân hay gặp nhất là tập không có cảnh nào mang nhãn mà formula lọc theo.
- Bấm **View creative** trên dòng đã sẵn sàng.

Nếu phía Wandura render chậm hoặc đang tạm dừng, một thông báo xuất hiện trên Home và Create. Batch mới sẽ chờ trong hàng đợi và tự bắt đầu; bạn không cần làm gì.

## Sửa creative bằng tay

Màn hình **Editor** liệt kê các bản nháp của bạn theo ba nhóm: **Sent back** (người review yêu cầu sửa), **Rendered** (đã có bản xem trước) và **Drafts** (chưa render).

### Bắt đầu một creative trống

1. Mở **Editor** và dùng **Start a new creative**, hoặc bấm **Blank creative** trên **Creatives** hay trên trang phim.
2. Chọn **Film**, **Episode** và **Format**: Reels 9:16, Feed 4:5 hoặc Square 1:1.
3. Bấm **Open editor**. Creative mở ra với một clip khởi đầu dài 5 giây. Chưa có gì được render hay tính phí cho tới khi bạn bấm **Render**.

### Làm việc trong editor

Editor mở toàn màn hình. Thanh bên trái chứa các khung:

| Khung | Dùng để |
|---|---|
| Moments | Duyệt các cảnh Wandura tìm thấy trong tập. Bấm vào một cảnh để xem trước; bấm **+** hoặc kéo cảnh vào timeline để thêm. Tìm theo lời thoại hoặc nhãn. |
| Media | Thêm cảnh quay từ các tập được cấp phép và clip từ skit bank của tổ chức. |
| Text | Thêm mẫu chữ như hook cho 3 giây đầu hoặc thẻ CTA ở cuối. |
| Captions | Thêm các dòng chữ in cứng vào hình, căn theo nhịp cắt. |
| Audio | Nhạc nền. Nhạc hiện chưa được đưa vào bản render; hộp thoại render sẽ cảnh báo bạn. |
| Brand kit | Giao diện brand kit cho bản cắt. |

Thanh trên cùng chứa tên creative, tỉ lệ khung hình, trạng thái lưu (**Unsaved changes** hoặc **All changes saved**), hoàn tác và làm lại, **Save draft** và **Render**. Bấm biểu tượng bàn phím để xem mọi phím tắt.

### Render bản nháp

1. Bấm **Render**.
2. Hộp thoại hiển thị thời lượng, lượng ngân sách xuất mà bản cắt sẽ dùng, và phần còn lại của tháng. Mỗi lần chỉ render được tỉ lệ khung hình hiện tại.
3. Bấm **Render draft (watermarked)**. Creative chuyển sang **Rendering preview**, và trang của nó tiếp tục kiểm tra cho tới khi bản xem trước sẵn sàng.

### Creative chỉ đọc và Duplicate to edit

Creative trở thành chỉ đọc khi đã được gửi đi render, còn creative do batch tạo ra thì chỉ đọc ngay từ đầu. Muốn sửa, hãy bấm **Duplicate to edit** (nhân bản để sửa). Bản sao là một bản nháp mới; không tính phí gì. Mỗi creative cũng chỉ có một số lượt render nháp giới hạn; khi dùng hết, hãy nhân bản để render tiếp.

## Thư viện Creatives

**Creatives** hiển thị creative của bạn dưới dạng thẻ, kèm trạng thái và tỉ lệ khung hình. Admin thấy mọi creative trong tổ chức; những người khác thấy creative của chính mình.

- Lọc theo trạng thái bằng các tab: **All**, **Draft**, **Preview ready**, **Pending**, **Approved**, **Rejected**. Admin có thêm **Awaiting review**.
- Tìm theo tên, và lọc theo phim bằng **All films**.
- Bắt đầu việc mới với **New creative** (mở Create) hoặc **Blank creative** (mở editor).

### Trang của một creative

Bấm vào một thẻ để mở creative. Trang hiển thị:

- **Trình phát xem trước.** Bản xem trước phát trên link sống ngắn; bấm **Refresh preview link** nếu link hết hạn. Làm mới không bao giờ render lại.
- **Lifecycle**: Draft created, Preview render, Pending approval, Approved hoặc Rejected (kèm lý do), Final render, Sent to marketing system.
- **Actions** mà vai trò của bạn được dùng ở giai đoạn này, chẳng hạn **Submit for review**.
- **Open editor**, cho các bản nháp vẫn còn sửa hoặc render lại được.

### Gửi đi review

1. Mở một creative có trạng thái **Preview ready** và xem bản xem trước.
2. Trong **Actions**, bấm **Submit for review**, rồi **Confirm**.
3. Trạng thái chuyển thành **Awaiting review** và creative xuất hiện trong hàng đợi **Review** của admin.

## Review và duyệt (admin)

**Review** là hàng đợi của admin gồm các creative đang chờ quyết định. Thanh bên hiển thị huy hiệu với số creative đang chờ.

1. Mở **Review**. Bản xem trước của creative đầu tiên tải ở bên phải.
2. Xem bản xem trước. Nút **Approve** chỉ mở khoá khi bản xem trước đã tải xong.
3. Bấm **Approve (A)** để duyệt và bắt đầu render bản cuối, hoặc **Send back (R)** để trả lại. Trả lại cần có lý do, người tạo sẽ thấy lý do này; chọn một mẫu có sẵn như "A cut lands mid-sentence" hoặc tự viết.
4. Di chuyển trong hàng đợi bằng **J** và **K** (hoặc phím mũi tên). **Space** để phát hoặc tạm dừng.

Để duyệt nhiều creative cùng lúc, đánh dấu chúng trong danh sách và bấm **Approve selected**. Chỉ đánh dấu được những creative bạn đã xem bản xem trước. Nếu một creative thay đổi sau khi bạn xem, cổng yêu cầu bạn xem bản xem trước mới rồi mới được duyệt.

Bạn cũng có thể duyệt hoặc trả lại ngay trên trang của creative, trong **Actions**.

## Sau khi duyệt

Duyệt sẽ bắt đầu render bản cuối sạch, không watermark. Khi bản này sẵn sàng:

- Admin thấy khung **Final render · no watermark** trên trang của creative. **Load final render** mở bản này ở độ phân giải đầy đủ trên một link có hạn 10 phút, và mọi lượt xem đều được ghi lại.
- Lifecycle của creative hiển thị **Sent to marketing system**, và creative có sẵn cho tích hợp của tổ chức qua creatives feed. Xem [Liệt kê creative](https://docs.wandura.ai/vi/developers/reference/creatives-list).

### Link chia sẻ (admin)
Creative đã duyệt có thể có một **link chia sẻ**: một địa chỉ cố định như `https://www.wandura.ai/api/c/3vQh0x…9fZ.mp4` mà ai cầm link cũng mở được **không cần đăng nhập**. Dán vào nền tảng quảng cáo, nhúng vào trang, hoặc gửi khách, và tải lại bao nhiêu lần cũng được.

- Mỗi lần mở, link chuyển sang một link ký tươi tới bản cuối sạch 1080p, sống 15 phút. Bản thân địa chỉ không hết hạn.
- Chỉ **admin tổ chức** tạo, copy và thu hồi được. Mỗi creative có tối đa một link còn sống; tạo lại sẽ trả đúng link cũ.
- **Thu hồi** làm link chết ngay: ai còn giữ sẽ nhận *410 Gone*. Link cũng tự chết khi creative không còn ở trạng thái duyệt, tổ chức bị tạm ngưng, hoặc quyền xuất phim hết hạn.
- Coi link như mật khẩu của file: ai có link là tải được. Lượt mở được đếm theo ngày, mỗi link tối đa 120 lượt mở mỗi phút.
- Trên cổng: nút **Copy link** ở trang creative (đang triển khai). Qua API: `GET`, `POST` và `DELETE /api/partners/creatives/{id}/share-link`.
- Nếu hệ thống của tổ chức bạn đọc creatives feed, Wandura tự tạo link cho hệ thống đó ngay khi bản cuối sẵn sàng, và `final.file_url` của feed mang link này (`createdBy` khi đó để trống). Thu hồi link cũng xoá `final.file_url`, và Wandura không tự tạo link khác: tạo link mới ở đây khi tích hợp của bạn cần lại. Xem [Tải file cuối](https://docs.wandura.ai/vi/developers/concepts/creatives#downloading-the-final-file).

## Thiết lập cho admin

Hai màn hình chỉ dành cho admin trong mục **Setup** phục vụ quy trình làm creative:

- **Formulas**: tạo formula dưới dạng bản nháp, chạy thử trên một tập, rồi xuất bản. Chỉ các phiên bản đã xuất bản mới chọn được trên Create.
- **Skit bank**: tải lên các clip ngắn để team của bạn thêm vào trong khung Media của editor. Mỗi clip cần có hồ sơ quyền, chẳng hạn tự sản xuất, stock miễn phí hoặc có giấy phép, rồi mới dùng được trong bản render; clip có người nhận diện được cần có giấy đồng ý của người xuất hiện (talent release).

## Bước tiếp theo

- [Branding](https://docs.wandura.ai/vi/partners/branding) — thiết lập brand kit và CTA.
- [Vai trò và quyền hạn](https://docs.wandura.ai/vi/partners/roles)