Tài liệu · Cổng thông tin Apps Kit SDK

Chiến dịch (Quảng bá chéo)

Chiến dịch là công cụ quảng bá chéo: cho phép bạn quảng cáo một ứng dụng của mình trong một ứng dụng khác cũng do bạn sở hữu, thông qua ánh xạ "Đơn vị quảng cáo cho vị trí đặt quảng cáo → Quảng bá chéo" được mô tả trong phần Chi tiết ứng dụng.

Danh sách chiến dịch

Trang Chiến dịch (/campaigns) liệt kê tất cả chiến dịch bạn đã tạo dưới dạng bảng, gồm: số thứ tự, Tiêu đề, Ứng dụng được quảng bá (tên và tên gói, hiển thị trên hai dòng), Loại chiến dịch (hiện luôn là "Quảng bá chéo" — Quảng cáo qua mạng có tồn tại về mặt khái niệm trong bộ chọn loại nhưng thực tế chưa được cung cấp để lựa chọn), Trạng thái và Mức độ ưu tiên (đều hiển thị dưới dạng nhãn màu hình viên thuốc và có thể sắp xếp), Ngày bắt đầu, Ngày kết thúc, Thời điểm tạo, Thời điểm cập nhật (hai cột cuối này cũng có thể sắp xếp) và Thao tác (Chỉnh sửa và Xóa).

Bạn có thể lọc danh sách theo Trạng thái chiến dịch, Mức độ ưu tiên hoặc Thương hiệu được nhắm mục tiêu; mỗi bộ lọc đều hỗ trợ chọn nhiều giá trị từ danh sách động. Khi chỉnh sửa chiến dịch (biểu tượng bút chì), bạn sẽ mở trình hướng dẫn được mô tả bên dưới ở chế độ chỉnh sửa; thao tác xóa sẽ yêu cầu xác nhận trước và không thể hoàn tác.

Nút + Tạo chỉ khả dụng nếu gói dịch vụ của bạn vẫn cho phép tạo thêm chiến dịch quảng bá chéo (canCreateCampaign()). Nếu đã đạt giới hạn chiến dịch của gói, nút này sẽ được thay bằng thông tin sử dụng ("Đã dùng X/Y chiến dịch") và liên kết "🔒 Nâng cấp" dẫn đến trang Gói đăng ký.

Tạo hoặc chỉnh sửa chiến dịch — Trình hướng dẫn

Nhấp vào + Tạo (hoặc chỉnh sửa một chiến dịch hiện có) để mở trình hướng dẫn từng bước. Trình hướng dẫn có năm bước, không phải bốn — rất dễ đếm thiếu vì bước đầu tiên sẽ tự động được bỏ qua khi bạn chỉnh sửa chiến dịch hiện có (không thể thay đổi loại chiến dịch sau khi chiến dịch đã được tạo). Mẫu thao tác "nhập bản nháp, rồi lưu" được áp dụng nhất quán ở mọi bước: khi bạn điền thông tin trong một bước, các thay đổi chỉ nằm trong trạng thái cục bộ của component ở bước đó. Không có dữ liệu nào được ghi vào context dùng chung của trình hướng dẫn — và cũng không có dữ liệu nào được lưu lên máy chủ — cho đến khi bạn nhấp vào một nút lưu và lệnh gọi API tương ứng thành công. Nếu bạn rời khỏi trang khi còn thay đổi chưa lưu, hộp thoại xác nhận "Bạn có thay đổi chưa lưu. Bạn có chắc muốn rời đi?" (Có, rời đi / Ở lại) sẽ giúp bạn tránh mất các thay đổi.

Bước 1 — Chọn loại chiến dịch

Chỉ có một thẻ có thể chọn: Quảng bá chéo ("Quảng bá ứng dụng của bạn đến người dùng các ứng dụng khác của bạn"). Đây là lựa chọn thực sự duy nhất — loại thứ hai, "Quảng cáo qua mạng", có trong mã nguồn để dành cho tương lai nhưng hiện không thể chọn trên giao diện. Nhấp vào Tiếp theo để tiếp tục; bản thân bước này không gọi máy chủ vì chưa có gì được tạo cho đến Bước 2. Trong chế độ chỉnh sửa, toàn bộ bước này được bỏ qua — trình hướng dẫn mở thẳng ở Bước 2, với loại của chiến dịch hiện có đã được cố định.

Bước 2 — Cài đặt chiến dịch

Bước này vừa tạo chiến dịch (ở lần lưu đầu tiên trong chế độ tạo), vừa cho phép chỉnh sửa các cài đặt chính (trong chế độ chỉnh sửa). Các trường gồm:

Công tắc Trạng thái chiến dịch — chỉ có trong chế độ chỉnh sửa. Chuyển giữa Đang hoạt động và Tạm dừng (cả hai chiều đều có hộp thoại xác nhận: "Kích hoạt chiến dịch?" / "Tạm dừng chiến dịch?"). Khi bạn kích hoạt chiến dịch, trước khi lưu, hệ thống sẽ kiểm tra xem chiến dịch có ít nhất một mẫu quảng cáo và có ít nhất một mẫu quảng cáo đang hoạt động hay không — nếu không, thao tác sẽ bị chặn với thông báo "Không thể kích hoạt chiến dịch — vui lòng thêm ít nhất một mẫu quảng cáo trước" hoặc "...phải có ít nhất một mẫu quảng cáo ở trạng thái đang hoạt động", và công tắc sẽ không thay đổi trạng thái.
Tiêu đề chiến dịch — trường văn bản bắt buộc.
Chọn thương hiệu — danh sách thả xuống bắt buộc, gồm các thương hiệu của bạn. Khi đổi thương hiệu, ứng dụng đã chọn trong trường "Ứng dụng cần quảng bá" sẽ bị xóa khỏi lựa chọn vì danh sách ứng dụng phụ thuộc vào thương hiệu.
Ứng dụng cần quảng bá — danh sách thả xuống bắt buộc, được điền theo thương hiệu đã chọn; bị vô hiệu hóa cho đến khi bạn chọn thương hiệu.
Mức độ ưu tiên chiến dịch — Cao / Trung bình / Thấp, hiển thị dưới dạng ba nút hình viên thuốc có thể chọn; mặc định là Trung bình.
Bắt đầu chiến dịch — chọn "Ngay lập tức" hoặc một ngày cụ thể. Nếu chọn ngày, ngày đó không được nằm trong quá khứ (kiểm tra so với ngày hiện tại), ngoại trừ trong chế độ chỉnh sửa: việc kiểm tra ngày trong quá khứ sẽ được bỏ qua nếu bạn không thực sự thay đổi ngày đã lưu.
Kết thúc chiến dịch — chọn "Không (Không có ngày kết thúc)" hoặc một ngày cụ thể, với cùng quy tắc không được nằm trong quá khứ, đồng thời kiểm tra ngày kết thúc phải sau ngày bắt đầu.

Khóa trường khi chiến dịch đang hoạt động: khi chiến dịch ở trạng thái Đang hoạt động, bạn không thể thay đổi Thương hiệu, Ứng dụng cần quảng bá hoặc cài đặt Ngày bắt đầu/Ngay lập tức — các trường này bị vô hiệu hóa kèm một ghi chú giải thích ngắn ("...không thể thay đổi khi chiến dịch đang hoạt động"). Bạn vẫn có thể thay đổi tiêu đề, mức độ ưu tiên, ngày kết thúc và tạm dừng chiến dịch (bằng công tắc).

Thao tác lưu (Lưu & Tiếp theo trong chế độ tạo; Lưu trong chế độ chỉnh sửa) gửi tiêu đề, ứng dụng được quảng bá, loại chiến dịch, mức độ ưu tiên, ngày bắt đầu/kết thúc đã tính toán và — trong chế độ chỉnh sửa — trạng thái lên máy chủ. Khi tạo lần đầu, dữ liệu hiện có về nơi hiển thị/khu vực trong phản hồi (nếu có) được dùng để điền sẵn trạng thái ban đầu của Bước 3. Chỉ sau khi lệnh gọi API thành công, các dữ liệu này mới được ghi vào context dùng chung của trình hướng dẫn.

Bước 3 — Nhắm mục tiêu

Nhắm mục tiêu thực chất gồm hai phần độc lập nằm chung trong một bước và dùng chung một nút Lưu: Nơi hiển thị (những thương hiệu/ứng dụng nào của bạn sẽ hiển thị chiến dịch này) và Khu vực (chiến dịch sẽ chạy ở những quốc gia nào).

Nơi hiển thị. Thông qua các danh sách hộp kiểm, bạn chọn một trong hai cách:

Tất cả thương hiệu — một hộp kiểm tổng, cho phép chiến dịch xuất hiện trên mọi thương hiệu và ứng dụng bạn sở hữu, kể cả những thương hiệu và ứng dụng được thêm sau này.
Các thương hiệu cụ thể — chọn một hoặc nhiều thương hiệu từ danh sách có thể cuộn; mỗi thương hiệu có danh sách ứng dụng con riêng. Trong một thương hiệu đã chọn, bạn có thể chọn từng ứng dụng hoặc chọn hộp "Tất cả (kể cả sau này)" của thương hiệu đó để bao gồm mọi ứng dụng thuộc thương hiệu (hiện tại và tương lai) mà không cần chọn từng ứng dụng.

Thông tin tóm tắt "Thương hiệu đã chọn" và "Ứng dụng đã chọn" được cập nhật liên tục dưới dạng chip phía trên các danh sách hộp kiểm, giúp bạn nhanh chóng nắm được phạm vi nhắm mục tiêu hiện tại.

Khu vực. Bộ chọn nhiều quốc gia có tùy chọn nhanh "Chọn tất cả", dùng để giới hạn (hoặc không giới hạn) các quốc gia mà chiến dịch sẽ phân phối quảng cáo. Nếu không giới hạn, chiến dịch sẽ chạy ở tất cả khu vực. Bộ chọn khu vực này được thiết kế tách biệt với tính năng Nhóm khu vực có tên được mô tả ở phần sau của hướng dẫn — đây chỉ là tập hợp quốc gia không có tên, được chọn riêng cho từng chiến dịch, không phải nhóm được lưu để tái sử dụng. (Nếu không tải được danh sách quốc gia động từ máy chủ, bộ chọn sẽ dùng danh sách dự phòng nhỏ hơn gồm 16 quốc gia; vì vậy danh sách tùy chọn dự phòng ở đây ngắn hơn danh sách trong Nhóm khu vực.)

Cả hai phần đều áp dụng cơ chế bản nháp/lưu giống các bước còn lại của trình hướng dẫn: thay đổi chỉ được giữ cục bộ cho đến khi bạn nhấp vào Lưu (hoặc Lưu & Tiếp theo). Khi đó, Nơi hiển thị và Khu vực được lưu bằng các lệnh gọi API riêng, rồi mới được hợp nhất vào trạng thái dùng chung của trình hướng dẫn.

Bước 4 — Mẫu quảng cáo

Đây là nơi bạn tải lên các mẫu quảng cáo thực tế sẽ hiển thị khi chiến dịch phân phối quảng cáo.

Thêm mẫu quảng cáo mới. Biểu mẫu "Thêm mẫu quảng cáo mới" dạng bảng cho phép bạn thêm một hoặc nhiều hàng cùng lúc (liên kết + Thêm mẫu quảng cáo thêm một hàng trống; biểu tượng thùng rác xóa một hàng). Mỗi hàng có:

Hình ảnh — nhấp vào ô vuông trống để tải ảnh lên. Định dạng được chấp nhận: JPEG, PNG, JPG, GIF, WebP; kích thước tối đa 10MB. Tệp không đáp ứng yêu cầu sẽ bị từ chối, kèm lỗi cụ thể ngay trong biểu mẫu (sai định dạng hoặc "Tối đa 10MB (X.XXMB)" cho biết kích thước thực tế).
Tên — trường văn bản bắt buộc.
URL đích — bắt buộc; phải là URL http:// hoặc https:// hợp lệ, được kiểm tra ngay khi bạn nhập.
Loại quảng cáo — interstitial, banner, native, rewarded hoặc appOpen (cùng bộ năm định dạng được dùng cho các đơn vị quảng cáo ở những phần khác).

Nhấp vào Lưu & Tiếp theo (chế độ tạo) hoặc Lưu (chế độ chỉnh sửa) để kiểm tra tính hợp lệ của từng hàng không trống, tải lên từng hình ảnh, rồi tạo từng mẫu quảng cáo qua API. Chỉ những mẫu quảng cáo được tạo thành công mới được thêm vào danh sách đã lưu; nếu có mẫu lưu thất bại, bạn sẽ thấy số lượng thất bại và có thể thử lại. Trong chế độ tạo, bạn cần có ít nhất một mẫu quảng cáo trước khi có thể rời bước này.

Danh sách mẫu quảng cáo đã lưu. Các mẫu quảng cáo đã lưu xuất hiện phía trên biểu mẫu thêm mới dưới dạng danh sách thẻ. Mỗi thẻ hiển thị ảnh thu nhỏ (nhấp để phóng to), tên, loại quảng cáo, URL đích, nhãn trạng thái Đang hoạt động/Không hoạt động hình viên thuốc kèm công tắc, nút chỉnh sửa (bút chì) và nút xóa (thùng rác).

Không thể tắt trạng thái hoạt động của một mẫu quảng cáo nếu đó là mẫu đang hoạt động duy nhất của chiến dịch ("Phải duy trì ít nhất một mẫu quảng cáo đang hoạt động") — mọi trường hợp khác đều yêu cầu xác nhận đơn giản "Kích hoạt/Ngừng kích hoạt mẫu quảng cáo?".
Nút chỉnh sửa (bút chì) mở biểu mẫu chỉnh sửa ngay tại chỗ cho mẫu quảng cáo đó (tên, hình ảnh, URL đích — loại quảng cáo được cố định), với các nút Lưu/Hủy riêng.
Thao tác xóa hiển thị cảnh báo "Bạn sẽ không thể hoàn tác thao tác này!" để xác nhận trước khi xóa vĩnh viễn mẫu quảng cáo.

Bước 5 — Xem lại chiến dịch

Bản tóm tắt chỉ đọc của mọi thông tin đã nhập ở Bước 2–4: Trạng thái chiến dịch, Tiêu đề, Loại, Thương hiệu, Ứng dụng cần quảng bá, Mức độ ưu tiên, Ngày bắt đầu, Ngày kết thúc, phần tóm tắt Nhắm mục tiêu trên một dòng (ví dụ: "Tất cả thương hiệu · Tất cả ứng dụng" hoặc chi tiết theo từng thương hiệu), cùng các Khu vực đã chọn (dạng chip hoặc "Tất cả khu vực") và danh sách đầy đủ các Mẫu quảng cáo với ảnh thu nhỏ, tên, URL đích và nhãn loại quảng cáo.

Chỉ trong chế độ tạo, bước này còn có công tắc Trạng thái có thể thao tác (Đang hoạt động/Tạm dừng) ngay phía trên — áp dụng cùng quy tắc kích hoạt như ở Bước 2 (hệ thống sẽ từ chối kích hoạt chiến dịch không có mẫu quảng cáo hoặc không có mẫu quảng cáo nào đang hoạt động, đồng thời hiển thị "Không thể kích hoạt chiến dịch"). Trong chế độ chỉnh sửa, trạng thái được hiển thị dưới dạng nhãn chỉ đọc — bạn thay đổi trạng thái bằng công tắc ở Bước 2, không phải tại đây.

Nhấp vào Hoàn tất để quay lại danh sách Chiến dịch. Trong chế độ chỉnh sửa, trước tiên bạn sẽ thấy thông báo xác nhận ngắn "Đã lưu chiến dịch thành công"; trong chế độ tạo, bạn được chuyển thẳng về danh sách mà không có xác nhận bổ sung, vì dữ liệu đã được lưu ở từng bước.

← Thương hiệu Mẫu quảng cáo native →