@redonvn/zalo-ads-sdk 0.2.7 → 0.2.14

package/dist/index.d.ts

@@ -449,9 +449,9 @@ interface FileDownloadResponse {
 
 /**
  * Mã trạng thái kỹ thuật & nghiệp vụ của Instant Page:
- * - 0: Bản sao mới tạo (Clone Draft) - vừa nhân bản từ template hoặc trang khác, chưa từng sửa và chưa xuất bản
- * - 1: Bản nháp đang sửa (Draft) - đang biên tập trong trình tạo trang (Canvas Editor), lưu trong draft
- * - 2: Đã xuất bản (Published / Active) - trang chính thức, cấu hình live nằm trong content, sẵn sàng chạy ads
+ * - 0: Bản sao mới tạo (Clone Draft) - vừa nhân bản từ template hoặc trang khác, chưa từng sửa và chưa xuất bản (máy chủ lọc bỏ khỏi danh sách tìm kiếm)
+ * - 1: Đang hoạt động / Đã xuất bản (Active / Published) - trang chính thức, nội dung live nằm trong trường content, máy chủ cấp timestamp published
+ * - 2: Mã trạng thái trung gian cũ trên giao diện
  * - 3: Lưu trữ / Đã kết thúc (Archived / Ended) - trang đã ngưng hoạt động hoặc kết thúc chiến dịch
  */
 type ZaloInstantPageStatus = 0 | 1 | 2 | 3;
@@ -688,6 +688,50 @@ type ZaloInstantPagesListInstantPageSharesResponse = {
         oaPermission: number;
     }>;
 };
+/**
+ * Danh mục mã phân quyền người dùng được chia sẻ trên Instant Page (POST /api/instant-pages/{instantPageId}/shares):
+ * - ADMIN (1): Quản trị viên (Toàn quyền quản trị, phân quyền thành viên, gắn quảng cáo, xuất bản trang).
+ * - UPDATE_PAGE (2): Chỉnh sửa trang (Quyền chỉnh sửa nội dung giao diện trang).
+ * - DOWNLOAD_INFO (3): Tải thông tin khách hàng (Quyền tải file lead/đơn hàng).
+ * - READ_ONLY (4): Chỉ xem (Chỉ xem trước trang và báo cáo).
+ */
+declare const ZaloInstantPageSharePermission: {
+    /** Quản trị viên: Toàn quyền quản trị, chỉnh sửa, phân quyền và gắn quảng cáo. */
+    readonly ADMIN: 1;
+    /** Biên tập viên: Quyền chỉnh sửa nội dung trang. */
+    readonly UPDATE_PAGE: 2;
+    /** Tải dữ liệu: Quyền tải thông tin khách hàng / Leads. */
+    readonly DOWNLOAD_INFO: 3;
+    /** Chỉ xem: Quyền xem trước và thống kê. */
+    readonly READ_ONLY: 4;
+};
+type ZaloInstantPageSharePermissionValue = typeof ZaloInstantPageSharePermission[keyof typeof ZaloInstantPageSharePermission];
+/** Thông tin phân quyền cho một thành viên trên Instant Page. */
+type ZaloInstantPagesShareMemberDto = {
+    /** ID người dùng được phân quyền (ví dụ: 2394323333639486). */
+    userId: number;
+    /** Mã phân quyền: 1 (ADMIN), 2 (UPDATE_PAGE), 3 (DOWNLOAD_INFO), 4 (READ_ONLY). */
+    permission: ZaloInstantPageSharePermissionValue | number;
+};
+/** Cập nhật danh sách người dùng được phân quyền / chia sẻ trên Instant Page (`POST /api/instant-pages/{instantPageId}/shares`). */
+type ZaloInstantPagesUpdateInstantPageSharesRequest = {
+    /** ID Instant Page cần phân quyền chia sẻ. */
+    instantPageId: number;
+    /** Danh sách thành viên và mã quyền tương ứng. Body HTTP là JSON Array: `[{ userId, permission }]`. */
+    shares: Array<ZaloInstantPagesShareMemberDto>;
+};
+type ZaloInstantPagesUpdateInstantPageSharesResponse = {
+    /** Danh sách thành viên được chia sẻ sau khi cập nhật. */
+    data?: Array<{
+        userId: number;
+        permission: number;
+        name?: string;
+        avatar?: string;
+        oaPermission?: number;
+    }>;
+    code?: number;
+    msg?: string;
+};
 /** Lấy các danh sách người dùng có thể dùng trong Instant Page, gồm chủ sở hữu, người tạo và người được chia sẻ. Đây là entry tool thuộc lane zalo-ads-content; dùng để chọn hoặc đối chiếu người dùng trước khi lọc, chia sẻ hay kiểm tra quyền trên Instant Page cụ thể. Khác với tool shares của một trang, kết quả này là danh mục người dùng theo vai trò trên phạm vi Instant Page. */
 type ZaloInstantPagesListInstantPageUsersRequest = Record<string, never>;
 type ZaloInstantPagesListInstantPageUsersResponse = {
@@ -951,6 +995,43 @@ type ZaloInstantPagesUpsertInstantPageFormResponse = {
     }>;
     [key: string]: unknown;
 };
+/**
+ * Khởi tạo một Instant Page mới từ Template mẫu trên domain page.ads.zalo.me.
+ *
+ * Bẫy kỹ thuật & nghiệp vụ:
+ * - templateId = 4: Kịch bản giới thiệu thương hiệu / Tin nhắn (bắt buộc dùng cho Quảng cáo Tin nhắn Type 30).
+ * - oaId: Bắt buộc là chuỗi ID 64-bit của Official Account (ví dụ: '4411301888544366414' từ GET /api/official-accounts), KHÔNG dùng ID số nguyên ngắn.
+ * - Sau khi tạo, Instant Page ở trạng thái nháp (status: 0). Cần gọi updateInstantPage với status: 1 (truyền đồng thời cả draft và content) để xuất bản Live.
+ */
+type ZaloInstantPagesCreateInstantPageRequest = {
+    /** Mã mẫu giao diện: 1 (Trang bán sản phẩm form trực tiếp), 3 (Trang bán sản phẩm form popup), 4 (Kịch bản tin nhắn), 5 (Trang đệm mua sắm). */
+    templateId: 1 | 3 | 4 | 5 | number;
+    /** Mã định danh 64-bit của Official Account liên kết (Lấy từ GET /api/official-accounts). */
+    oaId?: string;
+};
+type ZaloInstantPagesCreateInstantPageResponse = {
+    /** Bản ghi Instant Page mới được khởi tạo từ template. */
+    data: {
+        /** Mã số định danh nội bộ của Instant Page mới được cấp phát. */
+        id: number;
+        /** Mã public dùng cho URL người dùng cuối (https://page.zalo.me/p/{publicId}). */
+        publicId: string;
+        /** Tên mặc định của Instant Page theo template. */
+        name: string;
+        /** Cờ hoạt động: 0 = Tắt, 1 = Bật. */
+        active: ZaloInstantPageActive | number;
+        /** Mã trạng thái: 0 = Nháp mới tạo, 1 = Đã xuất bản Live. */
+        status: ZaloInstantPageStatus | number;
+        /** Phiên bản cấu trúc trang. */
+        version: number;
+        /** Mã mẫu giao diện đã dùng để khởi tạo. */
+        templateId: number;
+        /** Mã định danh 64-bit của Official Account liên kết. */
+        oaId?: string;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+};
 
 type BodyType = "json" | "urlencoded" | "multipart" | "none";
 interface OperationDefinition {
@@ -1064,10 +1145,35 @@ type ZaloAdsUpdateFlowResponse = {
     };
 };
 interface ZaloAdsAdPriceSettingsDto {
+    /**
+     * Mức giá đặt thầu (VNĐ).
+     * - Đặt 0 khi chọn đấu thầu tự động hoặc khi Price.Type = 5 (CPA - Lượt liên hệ).
+     * - Bắt buộc > 0 khi chọn đấu thầu thủ công (CPC).
+     */
     Bid: number;
+    /**
+     * Phương thức tính tiền:
+     * - 1: Lượt hiển thị (CPM) - Website Ads legacy.
+     * - 2: Lượt nhấn (CPC) - Website, Form, Message, OA, Video, Commerce, Article.
+     * - 5: Lượt liên hệ (CPA) - Dành riêng cho Quảng cáo Tin nhắn (Type 30) khi tối ưu theo lượt khách nhắn tin liên hệ.
+     */
     Type: number;
+    /**
+     * Hạn mức chi tiêu (VNĐ).
+     * - Quảng cáo Tin nhắn yêu cầu ngân sách tối thiểu 600,000 VNĐ.
+     */
     Limit: number;
+    /**
+     * Phạm vi áp dụng ngân sách (ZaloAdsPriceLimitType):
+     * - 1: Toàn lịch chạy (LIFE_TIME - áp dụng ngân sách tổng cho toàn bộ thời gian chạy).
+     * - 2: Mỗi ngày (DAILY - hạn mức ngân sách phân bổ theo từng ngày).
+     */
     LimitType: number;
+    /**
+     * Phương thức chi tiêu / tối ưu hóa:
+     * - 0: Đặt giá thầu thủ công (Manual Bid).
+     * - 1: Tự động tối ưu chi phí theo ngân sách (Total budget / Auto optimize, bắt buộc khi Type = 5 CPA).
+     */
     SpendingMethod: number;
 }
 interface ZaloAdsAdMultiImageItemDto {
@@ -1089,31 +1195,124 @@ interface ZaloAdsAdInfoSettingsDto {
     Title?: string;
     Description?: string;
     Caption?: string;
+    /**
+     * Chú thích mở rộng (không bắt buộc).
+     * - Quy chuẩn độ dài: Tối thiểu 90 ký tự, tối đa 2000 ký tự (90 - 2,000 ký tự).
+     * - Nếu để trống "" hoặc không truyền: Hợp lệ.
+     * - Nếu đã nhập: Bắt buộc từ 90 đến 2,000 ký tự.
+     * - Tự động kích hoạt mã bố cục mở rộng XTemplates = 49 (LONG_CAPTION).
+     */
+    LongCaption?: string;
     Action?: number;
     ButtonText?: string;
     MoreInfo?: string;
-    TargetUrl?: string;
+    TargetUrl?: string | {
+        Url?: string;
+        DisplayText?: string;
+    };
     Phone?: string;
+    SupportPhone?: string;
     Address?: string;
+    XTemplates?: Array<number>;
+    Template?: number;
+    WebsiteCategories?: Array<number>;
+    AdtimaAdCategories?: Array<number>;
+    Files?: Array<unknown>;
 }
 interface ZaloAdsAdAppInfoSettingsDto {
     AppType?: number;
     OsType?: number;
     StoreUrl?: string;
 }
+interface ZaloAdsAdTargetingProvinceItemDto {
+    /**
+     * Mã định danh Tỉnh/Thành phố theo danh mục 34 Cụm Tỉnh mới sau sáp nhập 2026 (`newProvinces` trên Zalo Ads).
+     *
+     * QUAN TRỌNG: Giao diện Zalo Ads Angular Web chỉ phân giải cây Xã/Phường theo 34 mã cụm này.
+     * Nếu truyền mã tỉnh lẻ đã bị sáp nhập (ví dụ: 'VN75' - Bình Dương, 'VN45' - Vũng Tàu, 'VN76' - Bình Phước),
+     * giao diện web sẽ bị lỗi ngoại lệ popup: 'Invalid wards params'.
+     *
+     * Quy tắc ánh xạ mã cụm tỉnh:
+     * - Cụm 'VN20' (Hồ Chí Minh): Bao gồm TP.HCM, Bình Dương ('VN75'), Bà Rịa - Vũng Tàu ('VN45').
+     * - Cụm 'VN43' (Đồng Nai): Bao gồm Đồng Nai, Bình Phước ('VN76').
+     * - Cụm 'VN44' (Hà Nội): Giữ nguyên không sáp nhập.
+     * - Cụm 'VN33' (Tây Ninh): Bao gồm Tây Ninh, Long An ('VN24').
+     * - Cụm 'VN01' (An Giang): Bao gồm An Giang, Kiên Giang ('VN21').
+     * - Cụm 'VN87' (Cần Thơ): Bao gồm Cần Thơ, Sóc Trăng ('VN65'), Hậu Giang ('VN93').
+     * - Cụm 'VN77' (Cà Mau): Bao gồm Cà Mau, Bạc Liêu ('VN73').
+     * - Cụm 'VN09' (Đồng Tháp): Bao gồm Đồng Tháp, Tiền Giang ('VN37').
+     * - Cụm 'VN69' (Vĩnh Long): Bao gồm Vĩnh Long, Bến Tre ('VN03'), Trà Vinh ('VN67').
+     */
+    Id: string;
+    /** Danh sách mã xã/phường mục tiêu (mảng rỗng [] biểu thị chọn toàn bộ tỉnh/thành). */
+    Districts: Array<number | string>;
+}
+interface ZaloAdsAdTargetingRegionItemDto {
+    /**
+     * Mã vùng miền:
+     * - 1: Miền Bắc (18 cụm tỉnh mới / 28 tỉnh cũ)
+     * - 2: Miền Trung (8 cụm tỉnh mới / 16 tỉnh cũ)
+     * - 3: Miền Nam (8 cụm tỉnh mới / 19 tỉnh cũ)
+     */
+    Id: number;
+    /**
+     * Danh sách tỉnh/thành phố được chọn trong vùng.
+     * Theo cơ chế compressAdData của Zalo Ads Client Engine:
+     * Nếu mảng Provinces là rỗng ([]), hệ thống hiểu là CHỌN TOÀN BỘ VÙNG MIỀN ĐÓ.
+     */
+    Provinces: Array<ZaloAdsAdTargetingProvinceItemDto>;
+}
+interface ZaloAdsAdTargetingLocationContainerDto {
+    Includes: Array<ZaloAdsAdTargetingRegionItemDto>;
+    Excludes: Array<ZaloAdsAdTargetingRegionItemDto>;
+}
+interface ZaloAdsAdLocationSettingsDto {
+    Cities?: Array<unknown>;
+    Addresses?: Array<unknown>;
+    /** Nhắm chọn cấp Tỉnh/Thành theo cấu trúc phân cấp Vùng miền. */
+    DistrictTargeting?: ZaloAdsAdTargetingLocationContainerDto;
+    /** Nhắm chọn chi tiết cấp Phường/Xã mới theo quy chuẩn 2026. */
+    WardTargeting?: ZaloAdsAdTargetingLocationContainerDto;
+    /** Cờ đánh dấu đã chuyển đổi sang cấp xã/phường. */
+    IsConvertedToWard?: boolean;
+}
 interface ZaloAdsAdTargetingSettingsDto {
     Gender?: number;
     AgeRanges?: Array<number>;
+    NewAgeRanges?: Array<number>;
+    Location?: ZaloAdsAdLocationSettingsDto;
     Locations?: string;
     Provinces?: Array<number>;
     DistrictsTargeting?: string;
     WardsTargeting?: string;
     Platforms?: Array<number>;
     NetworkTypes?: Array<number>;
+    Os?: Array<number>;
     OsTypes?: Array<number>;
+    AdvanceTargeting?: {
+        Includes?: Array<number>;
+        Excludes?: Array<number>;
+    };
     AdvanceTargetings?: Array<number>;
+    CustomAudienceId?: number;
+    ExcludedAudienceId?: number;
+    Retargeting?: string;
+    DmpAudience?: string;
+    PhoneList?: Array<unknown>;
     CustomAudiences?: Array<number>;
     ExcludeCustomAudiences?: Array<number>;
+    IncludedAudiences?: {
+        Phones?: Array<unknown>;
+        LeadSignal?: Array<unknown>;
+    };
+    ExcludedAudiences?: {
+        Phones?: Array<unknown>;
+        Forms?: Array<unknown>;
+        Messages?: Array<unknown>;
+        FormEvents?: Array<unknown>;
+        MessageOAs?: Array<unknown>;
+        MessageNonOAEvents?: Array<unknown>;
+    } | null;
 }
 interface ZaloAdsAdZVideoSettingsDto {
     Url: string;
@@ -1137,6 +1336,11 @@ interface ZaloAdsAdSettingsDto {
     Rating?: number;
     NewFeatures?: Array<number>;
     CreatedClientVersion?: number;
+    /**
+     * Phương thức phân phối quảng cáo (0: Tiêu chuẩn - Standard, 1: Tăng tốc - SpeedUp).
+     * Chỉ có hiệu lực khi Price.LimitType = 1 (Toàn lịch chạy).
+     */
+    DeliveryType?: ZaloAdsDeliveryType | number;
 }
 interface ZaloAdsAdUpdatePayloadDto {
     AdId: number;
@@ -1153,17 +1357,320 @@ interface ZaloAdsAdUpdatePayloadDto {
     ZaloPageId?: number;
     ZaloFormId?: string;
     ZaloFeedId?: string | number;
+    ZaloVideoId?: number;
     MiniPageId?: number;
-    UseConversion?: 0 | 1;
+    UseConversion?: ZaloAdsUseConversionValue | number;
     ConversionId?: number;
     Report?: Record<string, number>;
 }
+/** Danh mục mã hành động / nút CTA chuẩn trên Zalo Ads */
+declare const ZaloAdsActionType: {
+    readonly DAT_NGAY: 1;
+    readonly MUA_NGAY: 2;
+    readonly THU_NGAY: 3;
+    readonly TAI_NGAY: 4;
+    readonly XEM_THEM: 5;
+    readonly NGHE_NGAY: 6;
+    readonly CHOI_NGAY: 7;
+    readonly DANG_KY: 8;
+    readonly GOI_DIEN: 9;
+    /** Dành riêng cho Quảng cáo Official Account (Type 2) */
+    readonly QUAN_TAM_OA: 6;
+};
+/** Danh mục mã nguồn video trên Zalo Ads (Settings.ZVideo.Src) */
+declare const ZaloAdsVideoSrc: {
+    readonly UNUSED: -1;
+    /** Sử dụng mã Zalo Video được cấp từ kênh */
+    readonly VIDEO_CODE: 1;
+    /** Tự tải video lên hoặc chọn từ Thư viện Media */
+    readonly SELF_UPLOAD: 2;
+};
+type ZaloAdsVideoSrcValue = typeof ZaloAdsVideoSrc[keyof typeof ZaloAdsVideoSrc];
+/** Danh mục chu kỳ áp dụng ngân sách trên Zalo Ads (Settings.Price.LimitType) - Alias của ZaloAdsPriceLimitType */
+declare const ZaloAdsBudgetScheduleType: {
+    /** Toàn lịch chạy */
+    readonly TOTAL_SCHEDULE: 1;
+    /** Mỗi ngày */
+    readonly DAILY: 2;
+};
+type ZaloAdsBudgetScheduleTypeValue = typeof ZaloAdsBudgetScheduleType[keyof typeof ZaloAdsBudgetScheduleType];
+/** Danh mục mã khoảng tuổi nhắm chọn đối tượng trên Zalo Ads */
+declare const ZaloAdsAgeRangeId: {
+    readonly UNDER_18: 10282;
+    readonly FROM_18_TO_24: 10283;
+    readonly FROM_25_TO_34: 10284;
+    readonly FROM_35_TO_44: 10285;
+    readonly FROM_45_TO_54: 10286;
+    readonly FROM_55_TO_64: 10287;
+    readonly OVER_64: 10288;
+};
+/** Danh mục mã hệ điều hành */
+declare const ZaloAdsOsId: {
+    readonly ANDROID: 0;
+    readonly IOS: 1;
+    readonly PC: 3;
+};
+type ZaloAdsOsIdValue = typeof ZaloAdsOsId[keyof typeof ZaloAdsOsId];
+/** Danh mục mã 3 Vùng miền chuẩn trên Zalo Ads Targeting Engine */
+declare const ZaloAdsRegionId: {
+    /** Miền Bắc (28 tỉnh/thành phố) */
+    readonly NORTH: 1;
+    /** Miền Trung (16 tỉnh/thành phố) */
+    readonly CENTRAL: 2;
+    /** Miền Nam (19 tỉnh/thành phố) */
+    readonly SOUTH: 3;
+};
+type ZaloAdsRegionIdValue = typeof ZaloAdsRegionId[keyof typeof ZaloAdsRegionId];
+/**
+ * Danh mục mã Tỉnh/Thành phố chuẩn trên Zalo Ads Targeting Engine (theo chuẩn ISO 3166-2:VN tiền tố 'VN')
+ */
+declare const ZaloAdsProvinceCode: {
+    readonly HANOI: "VN44";
+    readonly HAI_PHONG: "VN13";
+    readonly BAC_NINH: "VN74";
+    readonly QUANG_NINH: "VN30";
+    readonly HAI_DUONG: "VN79";
+    readonly HUNG_YEN: "VN81";
+    readonly VINH_PHUC: "VN86";
+    readonly THAI_NGUYEN: "VN85";
+    readonly BAC_GIANG: "VN71";
+    readonly PHU_THO: "VN83";
+    readonly NAM_DINH: "VN82";
+    readonly THAI_BINH: "VN35";
+    readonly NINH_BINH: "VN59";
+    readonly THANH_HOA: "VN34";
+    readonly NGHE_AN: "VN58";
+    readonly HA_TINH: "VN52";
+    readonly HOA_BINH: "VN53";
+    readonly SON_LA: "VN32";
+    readonly DIEN_BIEN: "VN92";
+    readonly LAI_CHAU: "VN89";
+    readonly LAO_CAI: "VN90";
+    readonly YEN_BAI: "VN70";
+    readonly TUYEN_QUANG: "VN68";
+    readonly HA_GIANG: "VN50";
+    readonly CAO_BANG: "VN05";
+    readonly BAC_KAN: "VN72";
+    readonly LANG_SON: "VN39";
+    readonly HA_NAM: "VN80";
+    readonly DA_NANG: "VN78";
+    readonly THUA_THIEN_HUE: "VN66";
+    readonly QUANG_NAM: "VN84";
+    readonly QUANG_NGAI: "VN63";
+    readonly BINH_DINH: "VN46";
+    readonly PHU_YEN: "VN61";
+    readonly KHANH_HOA: "VN54";
+    readonly NINH_THUAN: "VN60";
+    readonly BINH_THUAN: "VN47";
+    readonly KON_TUM: "VN55";
+    readonly GIA_LAI: "VN49";
+    readonly DAK_LAK: "VN88";
+    readonly DAK_NONG: "VN91";
+    readonly LAM_DONG: "VN23";
+    readonly QUANG_BINH: "VN62";
+    readonly QUANG_TRI: "VN64";
+    readonly HO_CHI_MINH: "VN20";
+    readonly BINH_DUONG: "VN75";
+    readonly DONG_NAI: "VN43";
+    readonly BA_RIA_VUNG_TAU: "VN45";
+    readonly LONG_AN: "VN24";
+    readonly TIEN_GIANG: "VN37";
+    readonly BEN_TRE: "VN03";
+    readonly DONG_THAP: "VN09";
+    readonly VINH_LONG: "VN69";
+    readonly CAN_THO: "VN87";
+    readonly HAU_GIANG: "VN93";
+    readonly AN_GIANG: "VN01";
+    readonly KIEN_GIANG: "VN21";
+    readonly SOC_TRANG: "VN65";
+    readonly BAC_LIEU: "VN73";
+    readonly CA_MAU: "VN77";
+    readonly TAY_NINH: "VN33";
+    readonly BINH_PHUOC: "VN76";
+    readonly TRA_VINH: "VN67";
+};
+type ZaloAdsProvinceCodeValue = typeof ZaloAdsProvinceCode[keyof typeof ZaloAdsProvinceCode];
+/**
+ * Chế độ phân phối ngân sách quảng cáo trên Zalo Ads (Settings.DeliveryType):
+ * - 0: Tiêu chuẩn (Standard) - Phân phối ngân sách đồng đều suốt toàn bộ thời gian chạy quảng cáo.
+ * - 1: Tăng tốc (SpeedUp) - Phân phối quảng cáo nhanh nhất có thể cho tới khi cạn ngân sách.
+ *
+ * Lưu ý: Chỉ xuất hiện và có hiệu lực khi Price.LimitType = 1 (Toàn lịch chạy).
+ */
+type ZaloAdsDeliveryType = 0 | 1;
+/**
+ * Danh mục kiểu phân phối ngân sách quảng cáo ("Cách phân phối" trên giao diện Zalo Ads):
+ * Trường dữ liệu lưu trữ tại: `Settings.DeliveryType` (kiểu số nguyên 0 hoặc 1).
+ *
+ * - STANDARD (0): Tiêu chuẩn (Paced Delivery)
+ *   Thuật toán Zalo Ads rải đều ngân sách xuyên suốt các khung giờ trong ngày/toàn lịch chạy
+ *   dựa theo lưu lượng thị trường và tỷ lệ giờ cao điểm. Tự động điều tiết hãm tốc độ cắn tiền
+ *   nếu phát hiện ngân sách tiêu xài quá nhanh. Phù hợp duy trì thương hiệu, ổn định chi phí CPA.
+ *
+ * - SPEED_UP / ACCELERATED (1): Tăng tốc (Uncapped Pacing)
+ *   Gỡ bỏ hoàn toàn bộ điều tiết tốc độ. Miễn là có phiên đấu giá (auction) phù hợp với giá thầu
+ *   và tệp đối tượng nhắm chọn, hệ thống sẽ phân phối tối đa ngay lập tức cho đến khi cạn kiệt ngân sách.
+ *   Phù hợp cho chiến dịch Flash Sale, sự kiện ngắn, hoặc cần tối đa hóa tiếp cận trong thời gian ngắn.
+ *
+ * ĐIỀU KIỆN NGẦM ĐỂ HIỂN THỊ TRÊN UI (hàm `shouldHaveDeliveryType` trong mã nguồn Angular):
+ * 1. `Price.Type in [CPC (2), CPA (5)]`: Hình thức tính tiền phải là CPC hoặc CPA.
+ * 2. `Price.LimitType === LIFE_TIME (1)`: Bắt buộc chọn ngân sách "Toàn lịch chạy" (không áp dụng cho ngân sách mỗi ngày).
+ * 3. `validDaysRun(StartDate, EndDate) >= 2`: Thời gian chạy chiến dịch tối thiểu từ 2 ngày trở lên.
+ */
+declare const ZaloAdsDeliveryType: {
+    /** Tiêu chuẩn (0): Phân phối đồng đều nhất có thể theo giờ cao điểm (Standard). */
+    readonly STANDARD: 0;
+    /** Tăng tốc (1): Phân phối nhanh nhất có thể để tối đa hóa tiếp cận (SpeedUp). */
+    readonly SPEED_UP: 1;
+    /** Alias tương thích ngược cho SPEED_UP (1). */
+    readonly ACCELERATED: 1;
+};
+type ZaloAdsDeliveryTypeValue = typeof ZaloAdsDeliveryType[keyof typeof ZaloAdsDeliveryType];
+/**
+ * Danh mục phương thức phân phối ngân sách chi tiêu (`Settings.Price.SpendingMethod`):
+ * - STANDARD (0): Tiêu chuẩn (rải đều ngân sách).
+ * - FAST / ACCELERATED (1): Nhanh / Tăng tốc (ưu tiên thắng thầu và phân phối tối đa ngay lập tức).
+ */
+declare const ZaloAdsSpendingMethod: {
+    /** Tiêu chuẩn (0): Rải đều ngân sách xuyên suốt ngày. */
+    readonly STANDARD: 0;
+    /** Tăng tốc (1): Phân phối nhanh, ưu tiên thắng thầu ngay khi có phiên đấu giá. */
+    readonly FAST: 1;
+    /** Alias cho FAST (1). */
+    readonly ACCELERATED: 1;
+};
+type ZaloAdsSpendingMethodValue = typeof ZaloAdsSpendingMethod[keyof typeof ZaloAdsSpendingMethod];
+/**
+ * Danh mục phương thức tính tiền quảng cáo (`Settings.Price.Type`):
+ * - CPM (1): Lượt hiển thị (áp dụng cho Display Ads hoặc tối ưu hiển thị).
+ * - CPC (2): Lượt nhấn (Click) - Chuẩn cho Website Ads, Commerce Ads.
+ * - CPI (3): Lượt cài đặt ứng dụng (App Install).
+ * - CPF (4): Lượt quan tâm Official Account (Follow).
+ * - CPA (5): Lượt liên hệ / chuyển đổi mục tiêu (Lead / Message).
+ * - CPO (6): Lượt đặt hàng (Order).
+ * - CPV (7): Lượt xem video hoàn tất (Complete View).
+ * - CPD (8): Chi phí cố định theo ngày.
+ * - CPV1S (9): Lượt xem video từ 1 giây.
+ */
+declare const ZaloAdsPriceType: {
+    readonly CPM: 1;
+    readonly CPC: 2;
+    readonly CPI: 3;
+    readonly CPF: 4;
+    readonly CPA: 5;
+    readonly CPO: 6;
+    readonly CPV: 7;
+    readonly CPD: 8;
+    readonly CPV1S: 9;
+};
+type ZaloAdsPriceTypeValue = typeof ZaloAdsPriceType[keyof typeof ZaloAdsPriceType];
+/**
+ * Danh mục kiểu áp dụng ngân sách (`Settings.Price.LimitType`):
+ * - LIFE_TIME (1): Toàn lịch chạy (ngân sách tổng cho toàn bộ thời gian chiến dịch, tối thiểu 600.000 VNĐ).
+ * - DAILY (2): Mỗi ngày (ngân sách giới hạn theo từng ngày).
+ */
+declare const ZaloAdsPriceLimitType: {
+    /** Áp dụng ngân sách cho toàn lịch chạy (Life time budget). */
+    readonly LIFE_TIME: 1;
+    /** Áp dụng ngân sách cho mỗi ngày (Daily budget). */
+    readonly DAILY: 2;
+};
+type ZaloAdsPriceLimitTypeValue = typeof ZaloAdsPriceLimitType[keyof typeof ZaloAdsPriceLimitType];
+/**
+ * Danh mục mã giao diện bố cục hiển thị mở rộng (`Settings.AdInfo.XTemplates`):
+ * Checkbox "Hiển thị nhiều hình ảnh" trên UI Zalo Ads chỉ được bật khi mảng XTemplates
+ * chứa đồng thời cả 42 (Carousel) và 43 (Album): [42, 43].
+ */
+declare const ZaloAdsXTemplates: {
+    /** Định dạng thẻ quay vòng lướt ngang nhiều hình ảnh. */
+    readonly CAROUSEL: 42;
+    /** Định dạng bộ sưu tập album ảnh (lưới 4 ảnh). */
+    readonly ALBUM: 43;
+    /** Định dạng video tự động phát trên Feed. */
+    readonly ZALO_VIDEO: 44;
+    /** Định dạng ảnh dọc toàn màn hình. */
+    readonly PORTRAIT_IMAGE: 45;
+    /** Định dạng ảnh đơn truyền thống (1024x533). */
+    readonly SINGLE_IMAGE: 46;
+    /** Định dạng ảnh bìa cho quảng cáo video. */
+    readonly COVER_IMAGE_FOR_VIDEO_AD: 47;
+    /** Định dạng ảnh vuông. */
+    readonly SQUARE_IMAGE: 48;
+    /** Định dạng chú thích nội dung dài (tối đa 2.000 ký tự). */
+    readonly LONG_CAPTION: 49;
+};
+type ZaloAdsXTemplatesValue = typeof ZaloAdsXTemplates[keyof typeof ZaloAdsXTemplates];
+/**
+ * Danh mục mã tỉ lệ cắt ảnh chuẩn (`Settings.Image.ExtraImgs[i].Crops[j].Ratio`):
+ * Ma trận 8 lát cắt bắt buộc cho bộ 4 ảnh Album + Carousel:
+ * - Ảnh 0 (Ảnh bìa): Bắt buộc đủ 3 lát cắt: RATIO_4_3 (1), RATIO_2_1 (2 - Bìa Album), RATIO_1_1 (4).
+ *   (Nếu thiếu RATIO_2_1, UI sẽ báo lỗi: "Thiếu ảnh cắt tỉ lệ album").
+ * - Ảnh 1: Bắt buộc 2 lát cắt: RATIO_4_3 (1), RATIO_1_1 (4).
+ * - Ảnh 2: Bắt buộc 2 lát cắt: RATIO_4_3 (1), RATIO_1_1 (4).
+ * - Ảnh 3: Bắt buộc 1 lát cắt: RATIO_1_1 (4).
+ */
+declare const ZaloAdsImageRatio: {
+    /** Tỉ lệ 16:9 (1024x576 px - Video / Banner phong cảnh). */
+    readonly RATIO_16_9: 0;
+    /** Tỉ lệ 4:3 (1024x768 px - Ảnh phụ Album / Carousel). */
+    readonly RATIO_4_3: 1;
+    /** Tỉ lệ 2:1 (1024x512 px - ẢNH BÌA NGANG BẮT BUỘC CỦA ALBUM). */
+    readonly RATIO_2_1: 2;
+    /** Tỉ lệ 3:2. */
+    readonly RATIO_3_2: 3;
+    /** Tỉ lệ 1:1 (1024x1024 px - Ảnh vuông). */
+    readonly RATIO_1_1: 4;
+};
+type ZaloAdsImageRatioValue = typeof ZaloAdsImageRatio[keyof typeof ZaloAdsImageRatio];
+/**
+ * Danh mục cờ và nguồn dữ liệu tối ưu hóa chuyển đổi (`UseConversion`):
+ * - NOT_USE (0): Không chọn pixel - Tắt tối ưu hóa chuyển đổi. Hệ thống chỉ phân phối theo giá thầu lượt click (CPC) hoặc hiển thị (CPM) mà không quan tâm hành vi người dùng trên website.
+ * - USE (1): Pixel của tôi - Nguồn dữ liệu từ Zalo Pixel cá nhân do nhà quảng cáo tự chèn mã JavaScript (window.za(...)) vào mã nguồn website (ví dụ: https://redai.vn). Bắt buộc đi kèm `ConversionId` từ GET /api/conversion/all.
+ * - LADI_PAGE (2): Pixel liên kết Ladipage - Dành cho Landing Page dựng bằng nền tảng LadiPage đã tích hợp Zalo Pixel sẵn. Hệ thống tự động nhận diện sự kiện chuẩn mà không cần tạo conversion thủ công.
+ * - MINI_APP (3): Zalo Mini App - Dành cho các chiến dịch hướng người dùng vào ứng dụng Zalo Mini App.
+ * - USE_OFF (-1): Cờ lưu nháp khi tạm thời tắt hoặc hủy chọn Pixel cá nhân.
+ * - LADI_PAGE_OFF (-2): Cờ lưu nháp khi tắt liên kết Pixel Ladipage.
+ * - MINI_APP_OFF (-3): Cờ lưu nháp khi tắt liên kết Zalo Mini App.
+ */
+declare const ZaloAdsUseConversion: {
+    /** Không chọn pixel (0): Tắt tối ưu hóa chuyển đổi. */
+    readonly NOT_USE: 0;
+    /** Pixel của tôi (1): Zalo Pixel tự host chèn script, cần kèm ConversionId. */
+    readonly USE: 1;
+    /** Pixel liên kết Ladipage (2): Landing Page đối tác LadiPage. */
+    readonly LADI_PAGE: 2;
+    /** Zalo Mini App (3): Ứng dụng Zalo Mini App. */
+    readonly MINI_APP: 3;
+    /** Tạm thời tắt Pixel của tôi (-1): Cờ lưu nháp. */
+    readonly USE_OFF: -1;
+    /** Tạm thời tắt Pixel Ladipage (-2): Cờ lưu nháp. */
+    readonly LADI_PAGE_OFF: -2;
+    /** Tạm thời tắt Pixel Mini App (-3): Cờ lưu nháp. */
+    readonly MINI_APP_OFF: -3;
+};
+type ZaloAdsUseConversionValue = typeof ZaloAdsUseConversion[keyof typeof ZaloAdsUseConversion];
 interface ZaloAdsAdMutationResultDto {
     AdId?: number;
     CampaignId?: number;
     Status?: number;
     RowVersion?: number;
 }
+/** Tham số yêu cầu nhân bản mẫu quảng cáo (POST /zaapi/DuplicateAd) */
+interface ZaloAdsDuplicateAdRequest {
+    /** ID mẫu quảng cáo gốc cần nhân bản (bắt buộc). */
+    adid?: number;
+    /** Alias cho adid. */
+    adId?: number;
+}
+/** Kết quả phản hồi khi nhân bản mẫu quảng cáo */
+interface ZaloAdsDuplicateAdResponse {
+    /** Mã trạng thái: 0 = Thành công, khác 0 = Lỗi */
+    code: number;
+    /** Chuỗi thông báo kết quả (chứa ID của Ad mới tạo) */
+    msg?: string;
+    /** ID số nguyên của Ad mới vừa được nhân bản */
+    data: number;
+}
 interface ZaloAdsCampaignCreatePayloadDto {
     name: string;
     campaignType: number;
@@ -1301,18 +1808,34 @@ type ZaloAdsListFlowsByOfficialAccountResponse = {
         index?: number;
     };
 };
-/** Thay đổi trạng thái của một chiến dịch Zalo Ads theo mã trạng thái được chỉ định. Đây là destructive mutation tool thuộc lane quản lý chiến dịch; dùng khi cần dừng, hủy hoặc chuyển trạng thái chiến dịch và phải xác minh rõ mã trạng thái trước khi gọi. Giá trị -2 trong request đã ghi nhận sẽ xóa chiến dịch. */
+/**
+ * Danh mục mã trạng thái chiến dịch trên Zalo Ads (POST /api/campaign/change-status):
+ * - OFF (0): Tắt / Dừng chiến dịch (Inactive).
+ * - ACTIVE (1): Bật / Tiếp tục / Kích hoạt lại chiến dịch (Active).
+ * - PAUSED (2): Tạm dừng chiến dịch (Lưu ý: Nếu chiến dịch nháp chưa có QC hoạt động sẽ ném HTTP 500).
+ * - DELETED (-2): Xóa vĩnh viễn chiến dịch.
+ */
+declare const ZaloAdsCampaignStatus: {
+    readonly OFF: 0;
+    readonly ACTIVE: 1;
+    readonly PAUSED: 2;
+    readonly DELETED: -2;
+};
+type ZaloAdsCampaignStatusValue = typeof ZaloAdsCampaignStatus[keyof typeof ZaloAdsCampaignStatus];
+/** Thay đổi trạng thái của một chiến dịch Zalo Ads (Bật / Tắt / Tạm dừng / Xóa) theo mã trạng thái được chỉ định (`POST /api/campaign/change-status`). */
 type ZaloAdsChangeCampaignStatusRequest = {
-    /** Mã trạng thái cần áp dụng. Giá trị -2 đã được xác nhận làm xóa chiến dịch; các giá trị khác chưa có ý nghĩa được xác minh từ request cung cấp. */
-    status: number;
+    /** Mã trạng thái cần áp dụng: 1 = Bật lại, 0 = Tắt, 2 = Tạm dừng, -2 = Xóa chiến dịch. */
+    status: 0 | 1 | 2 | -2 | number;
     /** ID chiến dịch cần đổi trạng thái. */
     campaignId: number;
 };
 type ZaloAdsChangeCampaignStatusResponse = {
-    /** Thông điệp kết quả. Với status=-2, mẫu trả 'Xóa chiến dịch thành công.' */
+    /** Thông điệp kết quả từ Zalo Ads (ví dụ: 'Thành công', 'Xóa chiến dịch thành công.'). */
     msg: string;
     /** Mã kết quả; 0 biểu thị thao tác thành công. */
     code: number;
+    /** Trạng thái mới của chiến dịch sau khi thay đổi (1: Đã bật, 0: Đã tắt). */
+    data?: number;
 };
 /** Tạo audience tùy chỉnh từ điều kiện targeting, tệp nguồn hoặc audience loại trừ/bao gồm đã chọn. Đây là mutation tool thuộc lane zalo-ads-audience; dùng khi cấu trúc targeting và quyền xử lý dữ liệu đã được xác nhận. Targeting được gửi dưới dạng chuỗi JSON theo contentSchema. */
 type ZaloAdsCreateCustomAudienceRequest = {
@@ -1508,15 +2031,53 @@ type ZaloAdsDeleteCustomAudienceResponse = {
     /** Mã kết quả; 0 biểu thị thành công trong phản hồi đã quan sát. */
     code: number;
 };
-/** Lấy chi tiết một quảng cáo theo ID. Đây là detail tool thuộc lane zalo-ads-ad; dùng khi cần payload hiện tại trước khi phân tích hoặc cập nhật quảng cáo. */
+/** Lấy chi tiết một quảng cáo theo ID (GET /zaapi/getAdFromAdId?adId=...&v=2&newWard=true). */
 type ZaloAdsGetAdByIdRequest = {
     /** ID mẫu quảng cáo cần lấy chi tiết (query param `adId`). */
     adId?: number | string;
+    /** Phiên bản schema cấu trúc dữ liệu trả về (mặc định: 2). */
+    v?: number | string;
+    /** Cờ kích hoạt định dạng nhắm chọn cấp Phường/Xã mới (mặc định: true). */
+    newWard?: boolean | string;
 };
+/** Thông tin chiến dịch mở rộng đính kèm trong phản hồi getAdById */
+interface ZaloAdsCampaignDetailExtendDto {
+    CampaignId: number;
+    MemberId: number;
+    Name: string;
+    Type: number;
+    StartDate: number;
+    EndDate: number;
+    Status: number;
+    Modified?: number;
+    Created?: number;
+    AdtimaCampaignId?: number;
+    AdtimaOrderId?: number;
+    ReadOnly?: number;
+    CrmCampaignId?: string;
+    Settings?: {
+        BudgetLimit?: {
+            Type?: number;
+            Amount?: number;
+            LimitType?: number;
+        };
+    };
+    CreatedBy?: number;
+    AgencyId?: number;
+    Username?: string;
+    ViewType?: string;
+}
 type ZaloAdsGetAdByIdResponse = {
     code?: number;
     msg?: string;
     data?: ZaloAdsAdUpdatePayloadDto;
+    extend?: ZaloAdsCampaignDetailExtendDto;
+    flags?: {
+        IsOaValidForAd?: boolean;
+        [key: string]: unknown;
+    };
+    report?: number[] | Record<string, number>;
+    viewdata?: unknown[];
     AdId?: number;
     CampaignId?: number;
     MemberId?: number;
@@ -1532,7 +2093,7 @@ type ZaloAdsGetAdByIdResponse = {
     ZaloFormId?: string;
     ZaloFeedId?: string | number;
     MiniPageId?: number;
-    UseConversion?: 0 | 1;
+    UseConversion?: ZaloAdsUseConversionValue | number;
     ConversionId?: number;
     Report?: Record<string, number>;
 };
@@ -1540,8 +2101,8 @@ type ZaloAdsGetAdByIdResponse = {
 type ZaloAdsGetAdChangeLogRequest = {
     /** ID quảng cáo cần xem lịch sử. Có thể lấy từ kết quả tạo quảng cáo hoặc dữ liệu chi tiết quảng cáo. */
     adId: number;
-    /** Mã loại nhật ký. Request đã ghi nhận dùng 1. */
-    type: number;
+    /** Mã loại nhật ký (mặc định: 1). */
+    type?: number;
 };
 type ZaloAdsGetAdChangeLogResponse = {
     /** Thông điệp kết quả từ Zalo Ads. */
@@ -2221,11 +2782,18 @@ type ZaloAdsGetZaapiCheckcamphasmanyadsResponse = {
 type ZaloAdsGetZaapiGetadsfromcampaignidRequest = {
     campaignId?: number | string;
     campId?: number | string;
+    dataType?: number | string;
+    v?: number | string;
 };
 type ZaloAdsGetZaapiGetadsfromcampaignidResponse = {
     code: number;
     msg?: string;
     data: Array<ZaloAdsAdUpdatePayloadDto>;
+    extend?: ZaloAdsCampaignDetailExtendDto;
+    extra?: {
+        appliedRuleInfo?: Array<unknown>;
+        [key: string]: unknown;
+    };
 };
 interface ZaloAdsPageConfigDto {
     /** Hạng tài khoản OA (ví dụ: 0 = Phổ thông, 1 = Xác thực/Nâng cao). */
@@ -2669,10 +3237,15 @@ type ZaloAdsPostZaapiDeleteadResponse = {
 };
 /** Đổi tên hiển thị của một chiến dịch Zalo Ads đã tồn tại. Đây là mutation tool thuộc lane quản lý chiến dịch; dùng khi chỉ cần thay tên mà không thay đổi ngân sách, lịch chạy hoặc quảng cáo bên trong. Kết quả chỉ xác nhận thao tác thành công hoặc trả lỗi từ Zalo Ads. */
 type ZaloAdsRenameCampaignRequest = {
-    /** ID chiến dịch cần đổi tên. Có thể lấy từ kết quả tạo chiến dịch hoặc dữ liệu quảng cáo chi tiết. */
-    campid: number;
-    /** Tên hiển thị mới của chiến dịch. */
-    newname: string;
+    /** ID chiến dịch cần đổi tên (server nhận tham số campid). */
+    campid?: number;
+    /** Alias thân thiện cho campid */
+    campaignId?: number;
+    /** Tên hiển thị mới của chiến dịch (server nhận tham số newname). */
+    newname?: string;
+    /** Alias thân thiện cho newname */
+    campaignName?: string;
+    name?: string;
 };
 type ZaloAdsRenameCampaignResponse = {
     /** Thông điệp kết quả từ Zalo Ads. */
@@ -2724,6 +3297,7 @@ declare class ZaloAdsMessageAdUpdateDataDto {
     ZaloFlowId: number;
     ZaloPageId?: number;
     ZaloFormId?: string;
+    UseConversion?: ZaloAdsUseConversionValue | number;
     ConversionId?: number;
     Report?: Record<string, number>;
 }
@@ -2948,15 +3522,23 @@ type ZaloAdsCreateAutomatedRuleResponse = {
     /** ID quy tắc tự động vừa tạo hoặc cờ kết quả trả về từ hệ thống (ví dụ: 1). */
     data?: number;
 };
-/** Cập nhật quy tắc tự động (Automated Rule) trên Zalo Ads. */
+interface ZaloAdsAutomatedRuleAppliedItemDto {
+    appliedId: number;
+    mode: number;
+}
+/** Cập nhật quy tắc tự động (Automated Rule) trên Zalo Ads (`POST /api/ad/automatedrules/update`). */
 type ZaloAdsUpdateAutomatedRuleRequest = {
     automatedRuleId: number;
-    rowVersion: number;
-    appliedTo: number;
+    scope?: number;
     ruleName: string;
     action: ZaloAdsAutomatedRuleActionDto;
     conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
-    schedule: ZaloAdsAutomatedRuleScheduleDto;
+    frequency?: number;
+    appliedItems?: Array<ZaloAdsAutomatedRuleAppliedItemDto>;
+    appliedIds?: number[];
+    rowVersion?: number;
+    appliedTo?: number;
+    schedule?: ZaloAdsAutomatedRuleScheduleDto;
     campaignIds?: number[];
     adIds?: number[];
 };
@@ -2965,6 +3547,31 @@ type ZaloAdsUpdateAutomatedRuleResponse = {
     msg?: string;
     data?: number | boolean;
 };
+/** Tra cứu chi tiết một quy tắc tự động (Automated Rule) theo ID (`GET /api/automatedrules/{automatedRuleId}`). */
+type ZaloAdsGetAutomatedRuleDetailRequest = {
+    automatedRuleId: number;
+};
+type ZaloAdsGetAutomatedRuleDetailResponse = {
+    code: number;
+    msg?: string;
+    data?: {
+        automatedRule: {
+            automatedRuleId: number;
+            rowVersion?: number;
+            memberId?: number;
+            createdBy?: number;
+            ruleName: string;
+            action: ZaloAdsAutomatedRuleActionDto;
+            conditions: Array<ZaloAdsAutomatedRuleConditionDto>;
+            scope: number;
+            appliedIds?: number[];
+            frequency?: number;
+            created?: number;
+            modified?: number;
+        };
+        status: number;
+    };
+};
 /** Thay đổi trạng thái bật hoặc tắt (active/inactive) của một quy tắc tự động (Automated Rule) trên Zalo Ads theo ID quy tắc (`POST /api/automatedrules/change-status`). Dùng khi đã có `automatedRuleId` và cần tạm dừng (`status = 0`) hoặc kích hoạt lại (`status = 1`) quy tắc tự động. */
 type ZaloAdsChangeAutomatedRuleStatusRequest = {
     /** ID định danh duy nhất của quy tắc tự động cần thay đổi trạng thái (lấy từ `listAutomatedRules`). */
@@ -3327,6 +3934,22 @@ type ZaloAdsListReportFiltersResponse = Array<{
     content: string;
     model: number;
 }>;
+/** Xuất và tải báo cáo hiệu quả quảng cáo dạng file Excel (.xlsx) qua endpoint thu thập và xuất báo cáo (POST https://ads.zalo.me/api/collect). */
+type ZaloAdsDownloadReportRequest = {
+    /** Hành động / chủ đề tải báo cáo; mặc định là "cd.download.report". */
+    t?: "cd.download.report" | string;
+    /** Danh sách ID các mẫu quảng cáo cần xuất báo cáo (ví dụ: [19770157]). */
+    adIds: number[];
+    /** Mã trạng thái lọc quảng cáo khi xuất báo cáo (ví dụ: 2 = Đang chạy). */
+    status?: number;
+    /** Bộ lọc thời gian: 0 = Toàn thời gian / Tùy chỉnh. */
+    dateFilter?: number;
+    /** Loại chỉ số dữ liệu báo cáo (100001: Lượt nhấn / Chi phí / Hiển thị). */
+    reportKind?: number;
+    /** Unix timestamp thời điểm gửi lệnh xuất báo cáo (giây). */
+    et?: number;
+};
+type ZaloAdsDownloadReportResponse = Blob;
 
 /**
  * Tham số đầu vào cho method tiện ích `uploadAndSaveImage`
@@ -3507,12 +4130,22 @@ interface ValidateVideoInput {
     fileName?: string;
 }
 
-/**
- * Dịch vụ Quản lý Chiến dịch & Quảng cáo Zalo Ads (Tạo chiến dịch, đổi trạng thái, cập nhật quảng cáo các định dạng).
- */
-
 declare class ZaloCampaignsService {
     protected readonly client: ZaloSdkHttpClient;
+    readonly validator: {
+        createCampaign: typeof validateCreateCampaignPayload;
+        updateAd: typeof validateUpdateAdPayload;
+        renameCampaign: typeof validateRenameCampaignParams;
+        changeStatus: typeof validateChangeCampaignStatusParams;
+        duplicateAd: typeof validateDuplicateAdParams;
+    };
+    static readonly validator: {
+        createCampaign: typeof validateCreateCampaignPayload;
+        updateAd: typeof validateUpdateAdPayload;
+        renameCampaign: typeof validateRenameCampaignParams;
+        changeStatus: typeof validateChangeCampaignStatusParams;
+        duplicateAd: typeof validateDuplicateAdParams;
+    };
     constructor(client: ZaloSdkHttpClient);
     updateVideoAd(request: ZaloAdsUpdateVideoAdRequest, options?: RequestOptions): Promise<ZaloAdsUpdateVideoAdResponse>;
     changeCampaignStatus(request: ZaloAdsChangeCampaignStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeCampaignStatusResponse>;
@@ -3540,6 +4173,8 @@ declare class ZaloCampaignsService {
     getApiSpellCheckV2(request: ZaloAdsGetApiSpellCheckV2Request, options?: RequestOptions): Promise<ZaloAdsGetApiSpellCheckV2Response>;
     getZaapiCheckcamphasmanyads(request?: ZaloAdsGetZaapiCheckcamphasmanyadsRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiCheckcamphasmanyadsResponse>;
     getZaapiGetadsfromcampaignid(request?: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
+    /** Alias lấy danh sách quảng cáo của chiến dịch kèm metadata extend và extra.appliedRuleInfo */
+    getAdsFromCampaignId(request?: ZaloAdsGetZaapiGetadsfromcampaignidRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetadsfromcampaignidResponse>;
     getZaapiGetallpages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
     getAllPages(request?: ZaloAdsGetZaapiGetallpagesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetallpagesResponse>;
     getZaapiGetownedarticles(request: ZaloAdsGetZaapiGetownedarticlesRequest, options?: RequestOptions): Promise<ZaloAdsGetZaapiGetownedarticlesResponse>;
@@ -3583,6 +4218,11 @@ declare class ZaloCampaignsService {
      * @param timeoutMs Thời gian chờ tối đa (mặc định: 15.000ms = 15 giây).
      */
     checkSpellV3AndWait(request: ZaloAdsCreateSpellCheckV3JobRequest, pollIntervalMs?: number, timeoutMs?: number, options?: RequestOptions): Promise<ZaloAdsGetSpellCheckV3JobResponse>;
+    /**
+     * Nhân bản (sao chép / duplicate) một mẫu quảng cáo đã tồn tại trên Zalo Ads (POST /zaapi/DuplicateAd).
+     * Giúp tạo nhanh một bản sao Ad mới trong cùng chiến dịch để thực hiện A/B testing.
+     */
+    duplicateAd(request: ZaloAdsDuplicateAdRequest, options?: RequestOptions): Promise<ZaloAdsDuplicateAdResponse>;
 }
 
 /**
@@ -3687,6 +4327,8 @@ declare class ZaloReportsService {
     getUniqueUserReport(...args: Parameters<this["getReportapiV2UniqueUser"]>): ReturnType<this["getReportapiV2UniqueUser"]>;
     /** Báo cáo chiến dịch theo ngày/tháng (Legacy ZAAPI) */
     getCampaignReportLegacy(...args: Parameters<this["getZaapiCampaignReportcampaign"]>): ReturnType<this["getZaapiCampaignReportcampaign"]>;
+    /** Xuất và tải trực tiếp tệp tin Excel (.xlsx / Blob) báo cáo hiệu quả quảng cáo (POST /api/collect) */
+    downloadReport(request: ZaloAdsDownloadReportRequest, options?: RequestOptions): Promise<Blob>;
 }
 
 /**
@@ -3721,6 +4363,7 @@ declare class ZaloAutomatedRulesService {
     protected readonly client: ZaloSdkHttpClient;
     constructor(client: ZaloSdkHttpClient);
     listAutomatedRules(request?: ZaloAdsListAutomatedRulesRequest, options?: RequestOptions): Promise<ZaloAdsListAutomatedRulesResponse>;
+    getAutomatedRuleDetail(request: ZaloAdsGetAutomatedRuleDetailRequest, options?: RequestOptions): Promise<ZaloAdsGetAutomatedRuleDetailResponse>;
     createAutomatedRule(request: ZaloAdsCreateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsCreateAutomatedRuleResponse>;
     updateAutomatedRule(request: ZaloAdsUpdateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsUpdateAutomatedRuleResponse>;
     changeAutomatedRuleStatus(request: ZaloAdsChangeAutomatedRuleStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeAutomatedRuleStatusResponse>;
@@ -3931,6 +4574,7 @@ declare class ZaloAdsService extends ZaloCampaignsService {
     /** Alias cho `listConversionNames` (`GET /api/conversion/names`). */
     getApiConversionNames(request?: ZaloAdsListConversionNamesRequest, options?: RequestOptions): Promise<ZaloAdsListConversionNamesResponse>;
     listAutomatedRules(request?: ZaloAdsListAutomatedRulesRequest, options?: RequestOptions): Promise<ZaloAdsListAutomatedRulesResponse>;
+    getAutomatedRuleDetail(request: ZaloAdsGetAutomatedRuleDetailRequest, options?: RequestOptions): Promise<ZaloAdsGetAutomatedRuleDetailResponse>;
     createAutomatedRule(request: ZaloAdsCreateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsCreateAutomatedRuleResponse>;
     updateAutomatedRule(request: ZaloAdsUpdateAutomatedRuleRequest, options?: RequestOptions): Promise<ZaloAdsUpdateAutomatedRuleResponse>;
     changeAutomatedRuleStatus(request: ZaloAdsChangeAutomatedRuleStatusRequest, options?: RequestOptions): Promise<ZaloAdsChangeAutomatedRuleStatusResponse>;
@@ -4405,6 +5049,7 @@ interface ValidationResult<T = unknown> {
     /** Dữ liệu sau khi làm sạch và ép kiểu chuẩn (nếu hợp lệ). */
     data?: T;
 }
+declare function validateCreateInstantPageRequest(input: unknown): ValidationResult<ZaloInstantPagesCreateInstantPageRequest>;
 declare function validateCloneInstantPageRequest(input: unknown): ValidationResult<ZaloInstantPagesCloneInstantPageRequest>;
 declare function validateGetInstantPageDetailRequest(input: unknown): ValidationResult<ZaloInstantPagesGetInstantPageDetailRequest>;
 declare function validateGetInstantPageSharedUserRequest(input: unknown): ValidationResult<ZaloInstantPagesGetInstantPageSharedUserRequest>;
@@ -4419,6 +5064,7 @@ declare function validateListInstantPageLeadsRequest(input: unknown): Validation
 declare function validateListOfficialAccountsRequest(input?: unknown): ValidationResult<ZaloInstantPagesListOfficialAccountsRequest>;
 declare function validateUpsertInstantPageFormRequest(input: unknown): ValidationResult<ZaloInstantPagesUpsertInstantPageFormRequest>;
 declare const ZaloInstantPagesValidator: {
+    validateCreateInstantPage: typeof validateCreateInstantPageRequest;
     validateCloneInstantPage: typeof validateCloneInstantPageRequest;
     validateGetInstantPageDetail: typeof validateGetInstantPageDetailRequest;
     validateGetInstantPageSharedUser: typeof validateGetInstantPageSharedUserRequest;
@@ -4586,6 +5232,7 @@ declare class ZaloInstantPagesService {
      * Dùng ở backend (NestJS/Express/Fastify), middleware hoặc AI Agent để verify payload trước khi gọi SDK.
      */
     static readonly validator: {
+        validateCreateInstantPage: typeof validateCreateInstantPageRequest;
         validateCloneInstantPage: typeof validateCloneInstantPageRequest;
         validateGetInstantPageDetail: typeof validateGetInstantPageDetailRequest;
         validateGetInstantPageSharedUser: typeof validateGetInstantPageSharedUserRequest;
@@ -4601,12 +5248,14 @@ declare class ZaloInstantPagesService {
         validateUpsertInstantPageForm: typeof validateUpsertInstantPageFormRequest;
     };
     constructor(client: ZaloSdkHttpClient);
+    createInstantPage(request: ZaloInstantPagesCreateInstantPageRequest, options?: RequestOptions): Promise<ZaloInstantPagesCreateInstantPageResponse>;
     cloneInstantPage(request: ZaloInstantPagesCloneInstantPageRequest, options?: RequestOptions): Promise<ZaloInstantPagesCloneInstantPageResponse>;
     getInstantPageDetail(request: ZaloInstantPagesGetInstantPageDetailRequest, options?: RequestOptions): Promise<ZaloInstantPagesGetInstantPageDetailResponse>;
     getInstantPageSharedUser(request: ZaloInstantPagesGetInstantPageSharedUserRequest, options?: RequestOptions): Promise<ZaloInstantPagesGetInstantPageSharedUserResponse>;
     listInstantPageEditHistory(request: ZaloInstantPagesListInstantPageEditHistoryRequest, options?: RequestOptions): Promise<ZaloInstantPagesListInstantPageEditHistoryResponse>;
     listInstantPageFormRecords(request: ZaloInstantPagesListInstantPageFormRecordsRequest, options?: RequestOptions): Promise<ZaloInstantPagesListInstantPageFormRecordsResponse>;
     listInstantPageShares(request: ZaloInstantPagesListInstantPageSharesRequest, options?: RequestOptions): Promise<ZaloInstantPagesListInstantPageSharesResponse>;
+    updateInstantPageShares(request: ZaloInstantPagesUpdateInstantPageSharesRequest, options?: RequestOptions): Promise<ZaloInstantPagesUpdateInstantPageSharesResponse>;
     listInstantPageUsers(request?: ZaloInstantPagesListInstantPageUsersRequest, options?: RequestOptions): Promise<ZaloInstantPagesListInstantPageUsersResponse>;
     listMiniPageTemplates(request?: ZaloInstantPagesListMiniPageTemplatesRequest, options?: RequestOptions): Promise<ZaloInstantPagesListMiniPageTemplatesResponse>;
     searchInstantPages(request?: ZaloInstantPagesSearchInstantPagesRequest, options?: RequestOptions): Promise<ZaloInstantPagesSearchInstantPagesResponse>;
@@ -5137,6 +5786,23 @@ declare const ZaloFlowsValidator: {
  * 12. deleteCustomAudience (DELETE /api/ad/audience/{customAudienceId})
  */
 
+/**
+ * Danh mục mã 63 Tỉnh/Thành phố chuẩn theo 3 Vùng miền trên Zalo Ads Targeting Engine (Danh mục cũ):
+ */
+declare const ZALO_REGION_PROVINCE_CODES: Record<number, string[]>;
+/**
+ * Danh mục 34 Cụm Tỉnh/Thành phố mới sau sáp nhập trên Zalo Ads (newProvinces).
+ * Khi cấu hình WardTargeting (từ cải cách hành chính 2026), Zalo Ads Angular UI
+ * BẮT BUỘC tra cứu theo 34 mã mới này. Nếu truyền mã tỉnh đã bị gộp (như VN75 - Bình Dương),
+ * giao diện Zalo Ads sẽ bị lỗi đỏ: 'Invalid wards params'.
+ */
+declare const ZALO_NEW_REGION_PROVINCE_CODES: Record<number, string[]>;
+/** Bảng tra cứu ánh xạ mã tỉnh cũ sang cụm tỉnh mới sau sáp nhập */
+declare const ZALO_PROVINCE_MERGE_MAPPING: Record<string, {
+    newCode: string;
+    regionId: number;
+    name: string;
+}>;
 /**
  * 1. Kiểm tra request Tạo Nhóm đối tượng đã lưu (Saved Audience - caType = 1)
  */
@@ -5211,4 +5877,193 @@ declare const ZaloAudiencesValidator: {
     readonly estimateAudience: typeof validateEstimateAudienceRequest;
 };
 
-export { ALL_ZALO_ADS_DOMAINS, type BodyType, type FileDownloadResponse, type FileInput, type HttpMethod, type MediaValidationResult, MemoryZaloSessionStore, type MemoryZaloSessionStoreOptions, type OperationDefinition, RedisZaloSessionStore, type RedisZaloSessionStoreOptions, type RequestOptions, TieredZaloSessionStore, type TieredZaloSessionStoreOptions, type ValidateImageInput, type ValidateVideoInput, type ValidationResult, ZaloAccountService, type ZaloAdsAccessorItemDto, type ZaloAdsAccountAgencyInfoDto, ZaloAdsIntegrationManager as ZaloAdsAccountPool, type ZaloAdsAdAppInfoSettingsDto, type ZaloAdsAdImageSettingsDto, type ZaloAdsAdInfoSettingsDto, type ZaloAdsAdMultiImageItemDto, type ZaloAdsAdMutationResultDto, type ZaloAdsAdPriceSettingsDto, type ZaloAdsAdReportItemDto, type ZaloAdsAdSettingsDto, type ZaloAdsAdTargetingSettingsDto, type ZaloAdsAdUpdatePayloadDto, type ZaloAdsAdZVideoSettingsDto, type ZaloAdsAutomatedRuleActionDto, type ZaloAdsAutomatedRuleConditionDto, type ZaloAdsAutomatedRuleScheduleDto, type ZaloAdsCampaignCreatePayloadDto, type ZaloAdsCampaignReportItemDto, type ZaloAdsChangeAutomatedRuleStatusRequest, type ZaloAdsChangeAutomatedRuleStatusResponse, type ZaloAdsChangeCampaignStatusRequest, type ZaloAdsChangeCampaignStatusResponse, type ZaloAdsClientRequest, type ZaloAdsCommerceFormAudienceTargetingDto, type ZaloAdsConversionElementSelectorDto, type ZaloAdsConversionItemDto, type ZaloAdsConversionNameItemDto, type ZaloAdsCreateArticleCampaignRequest, type ZaloAdsCreateArticleCampaignResponse, type ZaloAdsCreateAutomatedRuleRequest, type ZaloAdsCreateAutomatedRuleResponse, type ZaloAdsCreateCommerceCampaignRequest, type ZaloAdsCreateCommerceCampaignResponse, type ZaloAdsCreateCommerceFormAudienceRequest, type ZaloAdsCreateCommerceFormAudienceResponse, type ZaloAdsCreateConversionRequest, type ZaloAdsCreateConversionResponse, type ZaloAdsCreateCustomAudienceRequest, type ZaloAdsCreateCustomAudienceResponse, type ZaloAdsCreateDisplayCampaignRequest, type ZaloAdsCreateDisplayCampaignResponse, type ZaloAdsCreateEcommerceCampaignRequest, type ZaloAdsCreateEcommerceCampaignResponse, ZaloAdsCreateFlowRequest, ZaloAdsCreateFlowResponse, type ZaloAdsCreateFormCampaignRequest, type ZaloAdsCreateFormCampaignResponse, type ZaloAdsCreateFormEventAudienceRequest, type ZaloAdsCreateFormEventAudienceResponse, type ZaloAdsCreateFormLeadAudienceRequest, type ZaloAdsCreateFormLeadAudienceResponse, type ZaloAdsCreateFormPayloadDto, type ZaloAdsCreateFormRequest, type ZaloAdsCreateFormResponse, type ZaloAdsCreateLeadSignalAudienceRequest, type ZaloAdsCreateLeadSignalAudienceResponse, type ZaloAdsCreateLookalikeAudienceRequest, type ZaloAdsCreateLookalikeAudienceResponse, type ZaloAdsCreateMessageCampaignRequest, type ZaloAdsCreateMessageCampaignResponse, type ZaloAdsCreateMessageOaEventAudienceRequest, type ZaloAdsCreateMessageOaEventAudienceResponse, type ZaloAdsCreateMessageOaLeadAudienceRequest, type ZaloAdsCreateMessageOaLeadAudienceResponse, type ZaloAdsCreateMessagePersonalEventAudienceRequest, type ZaloAdsCreateMessagePersonalEventAudienceResponse, type ZaloAdsCreateOaCampaignRequest, type ZaloAdsCreateOaCampaignResponse, type ZaloAdsCreateOfficialAccountCampaignRequest, type ZaloAdsCreateOfficialAccountCampaignResponse, type ZaloAdsCreatePhoneAudienceRequest, type ZaloAdsCreatePhoneAudienceResponse, ZaloAdsCreatePostCampaignRequest, ZaloAdsCreatePostCampaignResponse, type ZaloAdsCreateSavedAudienceRequest, type ZaloAdsCreateSavedAudienceResponse, type ZaloAdsCreateSpellCheckV3JobRequest, type ZaloAdsCreateSpellCheckV3JobResponse, type ZaloAdsCreateVideoCampaignRequest, type ZaloAdsCreateVideoCampaignResponse, type ZaloAdsCreateWebsiteCampaignRequest, type ZaloAdsCreateWebsiteCampaignResponse, type ZaloAdsDeleteAutomatedRuleRequest, type ZaloAdsDeleteAutomatedRuleResponse, type ZaloAdsDeleteCampaignRequest, type ZaloAdsDeleteCampaignResponse, type ZaloAdsDeleteConversionRequest, type ZaloAdsDeleteConversionResponse, type ZaloAdsDeleteCustomAudienceRequest, type ZaloAdsDeleteCustomAudienceResponse, type ZaloAdsDeleteCustomReportRequest, type ZaloAdsDeleteCustomReportResponse, type ZaloAdsDomain, type ZaloAdsFileGroupItemDto, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsFormAnswerDto, type ZaloAdsFormEventAudienceTargetingDto, type ZaloAdsFormLeadAudienceTargetingDto, type ZaloAdsFormQuestionDto, type ZaloAdsFormQuestionUiDto, type ZaloAdsFormSectionContentDto, type ZaloAdsFormSectionDto, type ZaloAdsFormSectionImageItemDto, type ZaloAdsFormSectionTableItemDto, type ZaloAdsGetAdByIdRequest, type ZaloAdsGetAdByIdResponse, type ZaloAdsGetAdChangeLogRequest, type ZaloAdsGetAdChangeLogResponse, type ZaloAdsGetApiAdGetlistadadvancetargetingRequest, type ZaloAdsGetApiAdGetlistadadvancetargetingResponse, type ZaloAdsGetApiBaAccountAllaccessorsRequest, type ZaloAdsGetApiBaAccountAllaccessorsResponse, type ZaloAdsGetApiBaAccountAllgrantedmembersRequest, type ZaloAdsGetApiBaAccountAllgrantedmembersResponse, type ZaloAdsGetApiConversionAllRequest, type ZaloAdsGetApiConversionAllResponse, type ZaloAdsGetApiConversionStandardEventsRequest, type ZaloAdsGetApiConversionStandardEventsResponse, type ZaloAdsGetApiCustomAudienceAllRequest, type ZaloAdsGetApiCustomAudienceAllResponse, type ZaloAdsGetApiFilegroupsRequest, type ZaloAdsGetApiFilegroupsResponse, type ZaloAdsGetApiLpNewsRequest, type ZaloAdsGetApiLpNewsResponse, type ZaloAdsGetApiMediaItemsRequest, type ZaloAdsGetApiMediaItemsResponse, type ZaloAdsGetApiMemberFilesRequest, type ZaloAdsGetApiMemberFilesResponse, type ZaloAdsGetApiNotifiesHeaderRequest, type ZaloAdsGetApiNotifiesHeaderResponse, type ZaloAdsGetApiPaymentTransactionHistoryRequest, type ZaloAdsGetApiPaymentTransactionHistoryResponse, type ZaloAdsGetApiPlaceGetalldistrictsRequest, type ZaloAdsGetApiPlaceGetalldistrictsResponse, type ZaloAdsGetApiSpellCheckV2Request, type ZaloAdsGetApiSpellCheckV2Response, type ZaloAdsGetApiWhoamiRequest, type ZaloAdsGetApiWhoamiResponse, type ZaloAdsGetAutomatedRuleHistoryRequest, type ZaloAdsGetAutomatedRuleHistoryResponse, type ZaloAdsGetDemographicsReportRequest, type ZaloAdsGetDemographicsReportResponse, type ZaloAdsGetReportOverviewRequest, type ZaloAdsGetReportOverviewResponse, type ZaloAdsGetReportapiV2AdsRequest, type ZaloAdsGetReportapiV2AdsResponse, type ZaloAdsGetReportapiV2CampaignsRequest, type ZaloAdsGetReportapiV2CampaignsResponse, type ZaloAdsGetReportapiV2UniqueUserRequest, type ZaloAdsGetReportapiV2UniqueUserResponse, type ZaloAdsGetReportapiV3CampaignsRequest, type ZaloAdsGetReportapiV3CampaignsResponse, type ZaloAdsGetSpellCheckV3JobRequest, type ZaloAdsGetSpellCheckV3JobResponse, type ZaloAdsGetZaapiCampaignReportcampaignRequest, type ZaloAdsGetZaapiCampaignReportcampaignResponse, type ZaloAdsGetZaapiCheckcamphasmanyadsRequest, type ZaloAdsGetZaapiCheckcamphasmanyadsResponse, type ZaloAdsGetZaapiGetadsfromcampaignidRequest, type ZaloAdsGetZaapiGetadsfromcampaignidResponse, type ZaloAdsGetZaapiGetallpagesRequest, type ZaloAdsGetZaapiGetallpagesResponse, type ZaloAdsGetZaapiGetownedarticlesRequest, type ZaloAdsGetZaapiGetownedarticlesResponse, type ZaloAdsGetZaapiGetownedpagesRequest, type ZaloAdsGetZaapiGetownedpagesResponse, type ZaloAdsGrantedMemberItemDto, ZaloAdsIntegrationManager, type ZaloAdsIntegrationManagerOptions, type ZaloAdsLeadSignalAudienceTargetingDto, type ZaloAdsLeadSignalOaItem, type ZaloAdsListAgencyCustomersWithBudgetRequest, type ZaloAdsListAgencyCustomersWithBudgetResponse, type ZaloAdsListAutomatedRulesRequest, type ZaloAdsListAutomatedRulesResponse, type ZaloAdsListConversionNamesRequest, type ZaloAdsListConversionNamesResponse, type ZaloAdsListCustomReportsRequest, type ZaloAdsListCustomReportsResponse, type ZaloAdsListFlowsByOfficialAccountRequest, type ZaloAdsListFlowsByOfficialAccountResponse, type ZaloAdsListFormsByOfficialAccountRequest, type ZaloAdsListFormsByOfficialAccountResponse, type ZaloAdsListLeadSignalOasResponse, type ZaloAdsListMiniPagesByTemplateRequest, type ZaloAdsListMiniPagesByTemplateResponse, type ZaloAdsListPersonalPixelLabelsRequest, type ZaloAdsListPersonalPixelLabelsResponse, type ZaloAdsListReportFiltersRequest, type ZaloAdsListReportFiltersResponse, type ZaloAdsLookalikeAudienceTargetingDto, type ZaloAdsLpNewsButtonDto, type ZaloAdsLpNewsItemDto, type ZaloAdsMediaSavePayloadDto, type ZaloAdsMediaSaveSettingsDto, type ZaloAdsMemberFileItemDto, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsMessageOaEventAudienceTargetingDto, type ZaloAdsMessageOaLeadAudienceTargetingDto, type ZaloAdsMessagePersonalEventAudienceTargetingDto, type ZaloAdsNotifyHeaderItemDto, type ZaloAdsOwnedArticleItemDto, type ZaloAdsOwnedPageExtraInfoDto, type ZaloAdsOwnedPageItemDto, type ZaloAdsOwnedPageLocationDto, type ZaloAdsPageConfigDto, type ZaloAdsPaymentTransactionItemDto, type ZaloAdsPhoneAudienceTargetingDto, type ZaloAdsPostApiAdEstimateaudienceRequest, type ZaloAdsPostApiAdEstimateaudienceResponse, type ZaloAdsPostApiMediaSaveRequest, type ZaloAdsPostApiMediaSaveResponse, type ZaloAdsPostApiMemberUploadImageRequest, type ZaloAdsPostApiMemberUploadImageResponse, type ZaloAdsPostZaapiDeleteadRequest, type ZaloAdsPostZaapiDeleteadResponse, type ZaloAdsRenameCampaignRequest, type ZaloAdsRenameCampaignResponse, ZaloAdsSdk, type ZaloAdsSdkOptions, ZaloAdsService, type ZaloAdsSpellCheckIssueDto, type ZaloAdsSpellCheckViolationDto, type ZaloAdsStandardEventItemDto, type ZaloAdsUniqueUserReportDataDto, type ZaloAdsUpdateArticleAdRequest, type ZaloAdsUpdateArticleAdResponse, type ZaloAdsUpdateAutomatedRuleRequest, type ZaloAdsUpdateAutomatedRuleResponse, type ZaloAdsUpdateCommerceAdRequest, type ZaloAdsUpdateCommerceAdResponse, type ZaloAdsUpdateDisplayAdRequest, type ZaloAdsUpdateDisplayAdResponse, type ZaloAdsUpdateEcommerceAdRequest, type ZaloAdsUpdateEcommerceAdResponse, type ZaloAdsUpdateFlowRequest, type ZaloAdsUpdateFlowResponse, type ZaloAdsUpdateFormAdRequest, type ZaloAdsUpdateFormAdResponse, ZaloAdsUpdateMessageAdRequest, ZaloAdsUpdateMessageAdResponse, type ZaloAdsUpdateNewAdsRequest, type ZaloAdsUpdateNewAdsResponse, type ZaloAdsUpdateOaAdRequest, type ZaloAdsUpdateOaAdResponse, type ZaloAdsUpdateOfficialAccountAdRequest, type ZaloAdsUpdateOfficialAccountAdResponse, type ZaloAdsUpdatePostAdRequest, type ZaloAdsUpdatePostAdResponse, ZaloAdsUpdateVideoAdRequest, ZaloAdsUpdateVideoAdResponse, type ZaloAdsUpdateWebsiteAdRequest, type ZaloAdsUpdateWebsiteAdResponse, type ZaloAdsUploadCustomAudiencePhoneListRequest, type ZaloAdsUploadCustomAudiencePhoneListResponse, type ZaloAdsUploadVideoRequest, type ZaloAdsUploadVideoResponse, type ZaloAdsUpsertCustomReportRequest, type ZaloAdsUpsertCustomReportResponse, type ZaloAdsWhoamiProfile, type ZaloAdsZaapiCampaignReportItemDto, ZaloAudiencesService, ZaloAudiencesValidator, type ZaloAuthDomain, ZaloAuthManager, ZaloAutomatedRulesService, ZaloCampaignsService, type ZaloChatWidgetGetChatWidgetLoginConfigRequest, type ZaloChatWidgetGetChatWidgetLoginConfigResponse, type ZaloChatWidgetGetLoginConfigRequest, type ZaloChatWidgetGetLoginConfigResponse, ZaloChatWidgetService, ZaloConversionsService, type ZaloCreateFormCleanPayload, type ZaloCreateFormRequestInput, type ZaloDomainSession, ZaloFlowsService, ZaloFlowsValidator, type ZaloFormQuestionAnswerInput, type ZaloFormQuestionInput, type ZaloFormSectionInput, type ZaloFormSessionProfile, type ZaloFormsAudienceExclusionTargetingItem, type ZaloFormsAuthSessionOaItem, type ZaloFormsConversationLeadItem, type ZaloFormsDisableFormLeadNotificationRequest, type ZaloFormsDisableFormLeadNotificationResponse, type ZaloFormsEnableFormLeadNotificationRequest, type ZaloFormsEnableFormLeadNotificationResponse, type ZaloFormsExportFormLeadReportRequest, type ZaloFormsExportFormLeadReportResponse, type ZaloFormsGetAuthSessionResponse, type ZaloFormsLeadAnswerItem, type ZaloFormsLeadItem, type ZaloFormsListAudienceExclusionTargetingRequest, type ZaloFormsListAudienceExclusionTargetingResponse, type ZaloFormsListConversationLeadsRequest, type ZaloFormsListConversationLeadsResponse, type ZaloFormsListFormLeadsRequest, type ZaloFormsListFormLeadsResponse, type ZaloFormsListManagedFormsByOfficialAccountRequest, type ZaloFormsListManagedFormsByOfficialAccountResponse, type ZaloFormsListScenariosByOfficialAccountRequest, type ZaloFormsListScenariosByOfficialAccountResponse, type ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, type ZaloFormsScenarioItem, ZaloFormsService, type ZaloFormsTrackManageFormEventRequest, type ZaloFormsTrackManageFormEventResponse, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, ZaloFormsValidator, type ZaloInstantPageActive, ZaloInstantPageBlockType, type ZaloInstantPageStatus, type ZaloInstantPagesCloneInstantPageRequest, type ZaloInstantPagesCloneInstantPageResponse, type ZaloInstantPagesFormRecordItem, type ZaloInstantPagesGetInstantPageDetailRequest, type ZaloInstantPagesGetInstantPageDetailResponse, type ZaloInstantPagesGetInstantPageSharedUserRequest, type ZaloInstantPagesGetInstantPageSharedUserResponse, type ZaloInstantPagesListInstantPageEditHistoryRequest, type ZaloInstantPagesListInstantPageEditHistoryResponse, type ZaloInstantPagesListInstantPageFormRecordsRequest, type ZaloInstantPagesListInstantPageFormRecordsResponse, type ZaloInstantPagesListInstantPageLeadsRequest, type ZaloInstantPagesListInstantPageLeadsResponse, type ZaloInstantPagesListInstantPageSharesRequest, type ZaloInstantPagesListInstantPageSharesResponse, type ZaloInstantPagesListInstantPageUsersRequest, type ZaloInstantPagesListInstantPageUsersResponse, type ZaloInstantPagesListMiniPageTemplatesRequest, type ZaloInstantPagesListMiniPageTemplatesResponse, type ZaloInstantPagesListOfficialAccountsRequest, type ZaloInstantPagesListOfficialAccountsResponse, type ZaloInstantPagesOfficialAccountItem, type ZaloInstantPagesSearchInstantPagesRequest, type ZaloInstantPagesSearchInstantPagesResponse, ZaloInstantPagesService, type ZaloInstantPagesUpdateInstantPageRequest, type ZaloInstantPagesUpdateInstantPageResponse, type ZaloInstantPagesUpsertInstantPageFormRequest, type ZaloInstantPagesUpsertInstantPageFormResponse, ZaloInstantPagesValidator, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, ZaloMediaService, type ZaloPlaySessionPayload, type ZaloProfileAdsAdministrativeItem, type ZaloProfileAdsCreateOaPageRequest, type ZaloProfileAdsCreateOaPageResponse, type ZaloProfileAdsGetDistrictsRequest, type ZaloProfileAdsGetDistrictsResponse, type ZaloProfileAdsGetProvincesResponse, type ZaloProfileAdsProvinceId, ZaloProfileAdsService, type ZaloProfileAdsSubCategoryId, type ZaloProfileAdsUploadOaAvatarRequest, type ZaloProfileAdsUploadOaAvatarResponse, type ZaloProfileAdsUploadOaCoverRequest, type ZaloProfileAdsUploadOaCoverResponse, type ZaloRedisLikeClient, ZaloReportsService, type ZaloSdkAuth, type ZaloSdkAuthContext, ZaloSdkError, ZaloSdkHttpClient, type ZaloSessionStore, type ZaloSsoAuthOptions, type ZaloUploadAndSaveImageRequest, type ZaloUploadAndSaveImageResult, type ZaloUploadAndSaveVideoRequest, type ZaloUploadAndSaveVideoResult, type ZaloWidgetAPIGetOfficialAccountInfoRequest, type ZaloWidgetAPIGetOfficialAccountInfoResponse, type ZaloWidgetAPIGetWidgetUserProfileRequest, type ZaloWidgetAPIGetWidgetUserProfileResponse, type ZaloWidgetAPIListStickerCategoriesRequest, type ZaloWidgetAPIListStickerCategoriesResponse, type ZaloWidgetAPIListStickersByCategoryRequest, type ZaloWidgetAPIListStickersByCategoryResponse, ZaloWidgetApiService, computeZpsidFingerprint, createZaloSsoAuth, decodePlaySessionJwt, ZaloAdsSdk as default, defaultSharedMemorySessionStore, deriveAccountKeyFromZpsid, parseZaloCookieInput, validateCloneInstantPageRequest, validateCreateFlowRequest, validateCreateFormEventAudienceRequest, validateCreateFormRequest, validateCreateLookalikeAudienceRequest, validateCreateMessageOaEventAudienceRequest, validateCreateMessagePersonalEventAudienceRequest, validateCreatePhoneAudienceRequest, validateCreateSavedAudienceRequest, validateEstimateAudienceRequest, validateGetInstantPageDetailRequest, validateGetInstantPageSharedUserRequest, validateListFlowsByOfficialAccountRequest, validateListFormLeadsRequest, validateListFormsByOfficialAccountRequest, validateListInstantPageEditHistoryRequest, validateListInstantPageFormRecordsRequest, validateListInstantPageLeadsRequest, validateListInstantPageSharesRequest, validateListInstantPageUsersRequest, validateListMiniPageTemplatesRequest, validateListOfficialAccountsRequest, validateSearchInstantPagesRequest, validateUpdateFlowRequest, validateUpdateInstantPageRequest, validateUpsertInstantPageFormRequest };
+/**
+ * Bộ kiểm tra tính hợp lệ dữ liệu (Request Validators) cho các API Chiến dịch & Quảng cáo Zalo Ads:
+ *  1. Khởi tạo 8 loại chiến dịch (Website, Form, Message, OA, Video, Commerce, Article, Display)
+ *  2. Thiết lập & cập nhật chi tiết mẫu quảng cáo (Ad Types: 5, 18, 30, 2, 11, 28, 3, 21)
+ *  3. Đổi tên, thay đổi trạng thái, xóa chiến dịch và xóa quảng cáo
+ *
+ * Tích hợp toàn bộ quy chuẩn giao diện (UI reverse engineering), giới hạn độ dài ký tự,
+ * quy chuẩn media, mã ID ngầm và bẫy kỹ thuật đúc kết từ live test trên máy chủ Zalo Ads.
+ */
+
+interface CampaignValidationResult<T = unknown> {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    data?: T;
+}
+interface ValidateCampaignOptions {
+    strictMode?: boolean;
+}
+interface ValidateAdOptions {
+    strictMode?: boolean;
+}
+/** Danh sách mã CampaignType hợp lệ trên Zalo Ads */
+declare const VALID_CAMPAIGN_TYPES: {
+    readonly WEBSITE: 6;
+    readonly FORM: 17;
+    readonly MESSAGE: 18;
+    readonly OA: 3;
+    readonly VIDEO: 14;
+    readonly COMMERCE: 22;
+    readonly ARTICLE: 4;
+    readonly DISPLAY: 20;
+};
+/** Danh sách mã AdType hợp lệ thực tế do máy chủ Zalo Ads xử lý */
+declare const VALID_AD_TYPES: {
+    readonly WEBSITE: 5;
+    readonly FORM: 18;
+    readonly MESSAGE: 30;
+    readonly OA: 2;
+    readonly VIDEO: 11;
+    readonly COMMERCE: 28;
+    readonly ARTICLE: 3;
+    readonly DISPLAY: 21;
+};
+/** Danh sách CTA hợp lệ cho từng loại Ad */
+declare const ALLOWED_CTAS_PER_AD_TYPE: Record<number, number[]>;
+/**
+ * Kiểm tra tính hợp lệ payload tạo mới Chiến dịch Zalo Ads (POST /zaapi/addNewCamp).
+ */
+declare function validateCreateCampaignPayload(payload: Partial<ZaloAdsCampaignCreatePayloadDto>, options?: ValidateCampaignOptions): CampaignValidationResult;
+/**
+ * Kiểm tra tính hợp lệ payload Cập nhật Mẫu Quảng cáo (POST /zaapi/UpdateAd).
+ */
+declare function validateUpdateAdPayload(payload: Partial<ZaloAdsAdUpdatePayloadDto>, options?: ValidateAdOptions): CampaignValidationResult;
+/**
+ * Kiểm tra tính hợp lệ của tham số đổi tên chiến dịch (POST /api/campaign/change-name).
+ */
+declare function validateRenameCampaignParams(params: {
+    campid?: number;
+    campaignId?: number;
+    newname?: string;
+    newName?: string;
+    name?: string;
+}): CampaignValidationResult;
+/**
+ * Kiểm tra tính hợp lệ của trạng thái thay đổi chiến dịch (POST /api/campaign/change-status).
+ */
+declare function validateChangeCampaignStatusParams(params: {
+    campaignId: number;
+    status: number;
+    isDraft?: boolean;
+}): CampaignValidationResult;
+/**
+ * Kiểm tra tính hợp lệ của tham số nhân bản quảng cáo (POST /zaapi/DuplicateAd).
+ */
+declare function validateDuplicateAdParams(params: {
+    adid?: number;
+    adId?: number;
+}): CampaignValidationResult;
+declare const ZaloCampaignsValidator: {
+    createCampaign: typeof validateCreateCampaignPayload;
+    updateAd: typeof validateUpdateAdPayload;
+    renameCampaign: typeof validateRenameCampaignParams;
+    changeStatus: typeof validateChangeCampaignStatusParams;
+    duplicateAd: typeof validateDuplicateAdParams;
+};
+
+/**
+ * Bộ kiểm tra tính hợp lệ và chuẩn hóa tham số Quy tắc tự động (Automated Rules Validator) cho Zalo Ads.
+ * Reverse-engineered và kiểm chứng trực tiếp từ Zalo Ads Web Frontend (chunk 183) & Backend API.
+ */
+declare enum AutomatedRuleScopeEnum {
+    Ads = 1
+}
+declare enum AutomatedRuleActionTypeEnum {
+    Resume = 1,// Tiếp tục chạy quảng cáo (Bật)
+    Pause = 2,// Tạm dừng quảng cáo (Tắt)
+    IncreaseByAmount = 3,// Tăng giá đấu thầu theo số tiền cố định (VNĐ)
+    DecreaseByAmount = 4,// Giảm giá đấu thầu theo số tiền cố định (VNĐ)
+    IncreaseByPercentage = 5,// Tăng giá đấu thầu theo %
+    DecreaseByPercentage = 6
+}
+declare enum AutomatedRuleFrequencyEnum {
+    OneHour = 1,// Mỗi tiếng / lần sau lần thực thi trước (1 giờ)
+    HalfDay = 12,// 12 giờ / lần sau lần thực thi trước (12 giờ)
+    OneDay = 24,// Mỗi ngày / lần sau lần thực thi trước (24 giờ)
+    OneWeek = 168
+}
+declare enum AutomatedRuleConditionFieldEnum {
+    Status = 1,// Trạng thái quảng cáo (Đang chạy / Tạm dừng)
+    Impression = 11,// Lượt hiển thị (tối thiểu 500)
+    Click = 16,// Lượt nhấn (tối thiểu 10)
+    CTR = 9999,// CTR (%)
+    Cost = 100001
+}
+declare enum AutomatedRuleOperatorEnum {
+    GreaterThan = 1,// Lớn hơn (>)
+    LessThan = 2,// Nhỏ hơn (<)
+    Between = 3,// Trong khoảng
+    NotBetween = 4,// Không trong khoảng
+    Include = 5,// Bao gồm
+    Exclude = 6
+}
+declare enum AutomatedRuleTimeRangeEnum {
+    AllTime = 1,// Từ lúc bắt đầu tới hiện tại (Lifetime)
+    AllTimeExcludeToday = 2,// Từ lúc bắt đầu tới hết hôm qua
+    Today = 3,// Trong ngày hôm nay
+    Yesterday = 4,// Trong ngày hôm qua
+    Previous2Day = 1002,// 2 ngày trước tới hiện tại
+    Previous3Day = 1003,// 3 ngày trước tới hiện tại
+    Previous4Day = 1004,// 4 ngày trước tới hiện tại
+    Previous5Day = 1005,// 5 ngày trước tới hiện tại
+    Previous6Day = 1006,// 6 ngày trước tới hiện tại
+    Previous7Day = 1007,// 7 ngày trước tới hiện tại
+    Previous14Day = 1014,// 14 ngày trước tới hiện tại
+    Previous21Day = 1021,// 21 ngày trước tới hiện tại
+    Previous30Day = 1030
+}
+interface AutomatedRuleValidationResult<T = any> {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    sanitizedData?: T;
+}
+declare class ZaloAutomatedRulesValidator {
+    /**
+     * Kiểm tra và chuẩn hóa payload tạo mới quy tắc tự động (`POST /api/automatedrules/create`)
+     */
+    static validateCreateRule(payload: any): AutomatedRuleValidationResult;
+    /**
+     * Kiểm tra và chuẩn hóa payload cập nhật quy tắc tự động (`POST /api/ad/automatedrules/update`)
+     */
+    static validateUpdateRule(payload: any): AutomatedRuleValidationResult;
+}
+
+/**
+ * Bộ kiểm tra tính hợp lệ và chuẩn hóa tham số Sự kiện chuyển đổi & Zalo Pixel (Conversions Validator) cho Zalo Ads.
+ * Reverse-engineered và kiểm chứng trực tiếp từ Zalo Ads Web Frontend (chunk 602, chunk 804) & Backend API.
+ */
+declare enum ConversionLabelEnum {
+    AddToCart = 2,// Thêm vào giỏ hàng
+    CompleteRegistration = 4,// Hoàn tất đăng ký
+    Contact = 5,// Liên hệ
+    InitiateCheckout = 9,// Bắt đầu thanh toán
+    Lead = 10,// Trở thành khách hàng tiềm năng
+    Purchase = 11,// Hoàn tất mua hàng
+    Other = 19
+}
+declare enum ConversionUrlTypeEnum {
+    Exact = 0,// URL chính xác
+    Contains = 1
+}
+interface ConversionValidationResult<T = any> {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+    sanitizedData?: T;
+}
+declare class ZaloConversionsValidator {
+    /**
+     * Danh mục 7 nhãn chuẩn được Zalo Ads hỗ trợ chính thức
+     */
+    static readonly SUPPORTED_LABELS: Record<number, string>;
+    /**
+     * Kiểm tra và chuẩn hóa payload tạo mới Conversion (`POST /api/conversion/add`)
+     */
+    static validateCreateConversion(payload: any): ConversionValidationResult;
+}
+
+export { ALLOWED_CTAS_PER_AD_TYPE, ALL_ZALO_ADS_DOMAINS, AutomatedRuleActionTypeEnum, AutomatedRuleConditionFieldEnum, AutomatedRuleFrequencyEnum, AutomatedRuleOperatorEnum, AutomatedRuleScopeEnum, AutomatedRuleTimeRangeEnum, type AutomatedRuleValidationResult, type BodyType, type CampaignValidationResult, ConversionLabelEnum, ConversionUrlTypeEnum, type ConversionValidationResult, type FileDownloadResponse, type FileInput, type HttpMethod, type MediaValidationResult, MemoryZaloSessionStore, type MemoryZaloSessionStoreOptions, type OperationDefinition, RedisZaloSessionStore, type RedisZaloSessionStoreOptions, type RequestOptions, TieredZaloSessionStore, type TieredZaloSessionStoreOptions, VALID_AD_TYPES, VALID_CAMPAIGN_TYPES, type ValidateAdOptions, type ValidateCampaignOptions, type ValidateImageInput, type ValidateVideoInput, type ValidationResult, ZALO_NEW_REGION_PROVINCE_CODES, ZALO_PROVINCE_MERGE_MAPPING, ZALO_REGION_PROVINCE_CODES, ZaloAccountService, type ZaloAdsAccessorItemDto, type ZaloAdsAccountAgencyInfoDto, ZaloAdsIntegrationManager as ZaloAdsAccountPool, ZaloAdsActionType, type ZaloAdsAdAppInfoSettingsDto, type ZaloAdsAdImageSettingsDto, type ZaloAdsAdInfoSettingsDto, type ZaloAdsAdLocationSettingsDto, type ZaloAdsAdMultiImageItemDto, type ZaloAdsAdMutationResultDto, type ZaloAdsAdPriceSettingsDto, type ZaloAdsAdReportItemDto, type ZaloAdsAdSettingsDto, type ZaloAdsAdTargetingLocationContainerDto, type ZaloAdsAdTargetingProvinceItemDto, type ZaloAdsAdTargetingRegionItemDto, type ZaloAdsAdTargetingSettingsDto, type ZaloAdsAdUpdatePayloadDto, type ZaloAdsAdZVideoSettingsDto, ZaloAdsAgeRangeId, type ZaloAdsAutomatedRuleActionDto, type ZaloAdsAutomatedRuleAppliedItemDto, type ZaloAdsAutomatedRuleConditionDto, type ZaloAdsAutomatedRuleScheduleDto, ZaloAdsBudgetScheduleType, type ZaloAdsBudgetScheduleTypeValue, type ZaloAdsCampaignCreatePayloadDto, type ZaloAdsCampaignDetailExtendDto, type ZaloAdsCampaignReportItemDto, ZaloAdsCampaignStatus, type ZaloAdsCampaignStatusValue, type ZaloAdsChangeAutomatedRuleStatusRequest, type ZaloAdsChangeAutomatedRuleStatusResponse, type ZaloAdsChangeCampaignStatusRequest, type ZaloAdsChangeCampaignStatusResponse, type ZaloAdsClientRequest, type ZaloAdsCommerceFormAudienceTargetingDto, type ZaloAdsConversionElementSelectorDto, type ZaloAdsConversionItemDto, type ZaloAdsConversionNameItemDto, type ZaloAdsCreateArticleCampaignRequest, type ZaloAdsCreateArticleCampaignResponse, type ZaloAdsCreateAutomatedRuleRequest, type ZaloAdsCreateAutomatedRuleResponse, type ZaloAdsCreateCommerceCampaignRequest, type ZaloAdsCreateCommerceCampaignResponse, type ZaloAdsCreateCommerceFormAudienceRequest, type ZaloAdsCreateCommerceFormAudienceResponse, type ZaloAdsCreateConversionRequest, type ZaloAdsCreateConversionResponse, type ZaloAdsCreateCustomAudienceRequest, type ZaloAdsCreateCustomAudienceResponse, type ZaloAdsCreateDisplayCampaignRequest, type ZaloAdsCreateDisplayCampaignResponse, type ZaloAdsCreateEcommerceCampaignRequest, type ZaloAdsCreateEcommerceCampaignResponse, ZaloAdsCreateFlowRequest, ZaloAdsCreateFlowResponse, type ZaloAdsCreateFormCampaignRequest, type ZaloAdsCreateFormCampaignResponse, type ZaloAdsCreateFormEventAudienceRequest, type ZaloAdsCreateFormEventAudienceResponse, type ZaloAdsCreateFormLeadAudienceRequest, type ZaloAdsCreateFormLeadAudienceResponse, type ZaloAdsCreateFormPayloadDto, type ZaloAdsCreateFormRequest, type ZaloAdsCreateFormResponse, type ZaloAdsCreateLeadSignalAudienceRequest, type ZaloAdsCreateLeadSignalAudienceResponse, type ZaloAdsCreateLookalikeAudienceRequest, type ZaloAdsCreateLookalikeAudienceResponse, type ZaloAdsCreateMessageCampaignRequest, type ZaloAdsCreateMessageCampaignResponse, type ZaloAdsCreateMessageOaEventAudienceRequest, type ZaloAdsCreateMessageOaEventAudienceResponse, type ZaloAdsCreateMessageOaLeadAudienceRequest, type ZaloAdsCreateMessageOaLeadAudienceResponse, type ZaloAdsCreateMessagePersonalEventAudienceRequest, type ZaloAdsCreateMessagePersonalEventAudienceResponse, type ZaloAdsCreateOaCampaignRequest, type ZaloAdsCreateOaCampaignResponse, type ZaloAdsCreateOfficialAccountCampaignRequest, type ZaloAdsCreateOfficialAccountCampaignResponse, type ZaloAdsCreatePhoneAudienceRequest, type ZaloAdsCreatePhoneAudienceResponse, ZaloAdsCreatePostCampaignRequest, ZaloAdsCreatePostCampaignResponse, type ZaloAdsCreateSavedAudienceRequest, type ZaloAdsCreateSavedAudienceResponse, type ZaloAdsCreateSpellCheckV3JobRequest, type ZaloAdsCreateSpellCheckV3JobResponse, type ZaloAdsCreateVideoCampaignRequest, type ZaloAdsCreateVideoCampaignResponse, type ZaloAdsCreateWebsiteCampaignRequest, type ZaloAdsCreateWebsiteCampaignResponse, type ZaloAdsDeleteAutomatedRuleRequest, type ZaloAdsDeleteAutomatedRuleResponse, type ZaloAdsDeleteCampaignRequest, type ZaloAdsDeleteCampaignResponse, type ZaloAdsDeleteConversionRequest, type ZaloAdsDeleteConversionResponse, type ZaloAdsDeleteCustomAudienceRequest, type ZaloAdsDeleteCustomAudienceResponse, type ZaloAdsDeleteCustomReportRequest, type ZaloAdsDeleteCustomReportResponse, ZaloAdsDeliveryType, type ZaloAdsDeliveryTypeValue, type ZaloAdsDomain, type ZaloAdsDownloadReportRequest, type ZaloAdsDownloadReportResponse, type ZaloAdsDuplicateAdRequest, type ZaloAdsDuplicateAdResponse, type ZaloAdsFileGroupItemDto, ZaloAdsFlowButtonDto, ZaloAdsFlowChildMessageDto, ZaloAdsFlowMessageDto, type ZaloAdsFormAnswerDto, type ZaloAdsFormEventAudienceTargetingDto, type ZaloAdsFormLeadAudienceTargetingDto, type ZaloAdsFormQuestionDto, type ZaloAdsFormQuestionUiDto, type ZaloAdsFormSectionContentDto, type ZaloAdsFormSectionDto, type ZaloAdsFormSectionImageItemDto, type ZaloAdsFormSectionTableItemDto, type ZaloAdsGetAdByIdRequest, type ZaloAdsGetAdByIdResponse, type ZaloAdsGetAdChangeLogRequest, type ZaloAdsGetAdChangeLogResponse, type ZaloAdsGetApiAdGetlistadadvancetargetingRequest, type ZaloAdsGetApiAdGetlistadadvancetargetingResponse, type ZaloAdsGetApiBaAccountAllaccessorsRequest, type ZaloAdsGetApiBaAccountAllaccessorsResponse, type ZaloAdsGetApiBaAccountAllgrantedmembersRequest, type ZaloAdsGetApiBaAccountAllgrantedmembersResponse, type ZaloAdsGetApiConversionAllRequest, type ZaloAdsGetApiConversionAllResponse, type ZaloAdsGetApiConversionStandardEventsRequest, type ZaloAdsGetApiConversionStandardEventsResponse, type ZaloAdsGetApiCustomAudienceAllRequest, type ZaloAdsGetApiCustomAudienceAllResponse, type ZaloAdsGetApiFilegroupsRequest, type ZaloAdsGetApiFilegroupsResponse, type ZaloAdsGetApiLpNewsRequest, type ZaloAdsGetApiLpNewsResponse, type ZaloAdsGetApiMediaItemsRequest, type ZaloAdsGetApiMediaItemsResponse, type ZaloAdsGetApiMemberFilesRequest, type ZaloAdsGetApiMemberFilesResponse, type ZaloAdsGetApiNotifiesHeaderRequest, type ZaloAdsGetApiNotifiesHeaderResponse, type ZaloAdsGetApiPaymentTransactionHistoryRequest, type ZaloAdsGetApiPaymentTransactionHistoryResponse, type ZaloAdsGetApiPlaceGetalldistrictsRequest, type ZaloAdsGetApiPlaceGetalldistrictsResponse, type ZaloAdsGetApiSpellCheckV2Request, type ZaloAdsGetApiSpellCheckV2Response, type ZaloAdsGetApiWhoamiRequest, type ZaloAdsGetApiWhoamiResponse, type ZaloAdsGetAutomatedRuleDetailRequest, type ZaloAdsGetAutomatedRuleDetailResponse, type ZaloAdsGetAutomatedRuleHistoryRequest, type ZaloAdsGetAutomatedRuleHistoryResponse, type ZaloAdsGetDemographicsReportRequest, type ZaloAdsGetDemographicsReportResponse, type ZaloAdsGetReportOverviewRequest, type ZaloAdsGetReportOverviewResponse, type ZaloAdsGetReportapiV2AdsRequest, type ZaloAdsGetReportapiV2AdsResponse, type ZaloAdsGetReportapiV2CampaignsRequest, type ZaloAdsGetReportapiV2CampaignsResponse, type ZaloAdsGetReportapiV2UniqueUserRequest, type ZaloAdsGetReportapiV2UniqueUserResponse, type ZaloAdsGetReportapiV3CampaignsRequest, type ZaloAdsGetReportapiV3CampaignsResponse, type ZaloAdsGetSpellCheckV3JobRequest, type ZaloAdsGetSpellCheckV3JobResponse, type ZaloAdsGetZaapiCampaignReportcampaignRequest, type ZaloAdsGetZaapiCampaignReportcampaignResponse, type ZaloAdsGetZaapiCheckcamphasmanyadsRequest, type ZaloAdsGetZaapiCheckcamphasmanyadsResponse, type ZaloAdsGetZaapiGetadsfromcampaignidRequest, type ZaloAdsGetZaapiGetadsfromcampaignidResponse, type ZaloAdsGetZaapiGetallpagesRequest, type ZaloAdsGetZaapiGetallpagesResponse, type ZaloAdsGetZaapiGetownedarticlesRequest, type ZaloAdsGetZaapiGetownedarticlesResponse, type ZaloAdsGetZaapiGetownedpagesRequest, type ZaloAdsGetZaapiGetownedpagesResponse, type ZaloAdsGrantedMemberItemDto, ZaloAdsImageRatio, type ZaloAdsImageRatioValue, ZaloAdsIntegrationManager, type ZaloAdsIntegrationManagerOptions, type ZaloAdsLeadSignalAudienceTargetingDto, type ZaloAdsLeadSignalOaItem, type ZaloAdsListAgencyCustomersWithBudgetRequest, type ZaloAdsListAgencyCustomersWithBudgetResponse, type ZaloAdsListAutomatedRulesRequest, type ZaloAdsListAutomatedRulesResponse, type ZaloAdsListConversionNamesRequest, type ZaloAdsListConversionNamesResponse, type ZaloAdsListCustomReportsRequest, type ZaloAdsListCustomReportsResponse, type ZaloAdsListFlowsByOfficialAccountRequest, type ZaloAdsListFlowsByOfficialAccountResponse, type ZaloAdsListFormsByOfficialAccountRequest, type ZaloAdsListFormsByOfficialAccountResponse, type ZaloAdsListLeadSignalOasResponse, type ZaloAdsListMiniPagesByTemplateRequest, type ZaloAdsListMiniPagesByTemplateResponse, type ZaloAdsListPersonalPixelLabelsRequest, type ZaloAdsListPersonalPixelLabelsResponse, type ZaloAdsListReportFiltersRequest, type ZaloAdsListReportFiltersResponse, type ZaloAdsLookalikeAudienceTargetingDto, type ZaloAdsLpNewsButtonDto, type ZaloAdsLpNewsItemDto, type ZaloAdsMediaSavePayloadDto, type ZaloAdsMediaSaveSettingsDto, type ZaloAdsMemberFileItemDto, ZaloAdsMessageAdUpdateDataDto, type ZaloAdsMessageOaEventAudienceTargetingDto, type ZaloAdsMessageOaLeadAudienceTargetingDto, type ZaloAdsMessagePersonalEventAudienceTargetingDto, type ZaloAdsNotifyHeaderItemDto, ZaloAdsOsId, type ZaloAdsOsIdValue, type ZaloAdsOwnedArticleItemDto, type ZaloAdsOwnedPageExtraInfoDto, type ZaloAdsOwnedPageItemDto, type ZaloAdsOwnedPageLocationDto, type ZaloAdsPageConfigDto, type ZaloAdsPaymentTransactionItemDto, type ZaloAdsPhoneAudienceTargetingDto, type ZaloAdsPostApiAdEstimateaudienceRequest, type ZaloAdsPostApiAdEstimateaudienceResponse, type ZaloAdsPostApiMediaSaveRequest, type ZaloAdsPostApiMediaSaveResponse, type ZaloAdsPostApiMemberUploadImageRequest, type ZaloAdsPostApiMemberUploadImageResponse, type ZaloAdsPostZaapiDeleteadRequest, type ZaloAdsPostZaapiDeleteadResponse, ZaloAdsPriceLimitType, type ZaloAdsPriceLimitTypeValue, ZaloAdsPriceType, type ZaloAdsPriceTypeValue, ZaloAdsProvinceCode, type ZaloAdsProvinceCodeValue, ZaloAdsRegionId, type ZaloAdsRegionIdValue, type ZaloAdsRenameCampaignRequest, type ZaloAdsRenameCampaignResponse, ZaloAdsSdk, type ZaloAdsSdkOptions, ZaloAdsService, type ZaloAdsSpellCheckIssueDto, type ZaloAdsSpellCheckViolationDto, ZaloAdsSpendingMethod, type ZaloAdsSpendingMethodValue, type ZaloAdsStandardEventItemDto, type ZaloAdsUniqueUserReportDataDto, type ZaloAdsUpdateArticleAdRequest, type ZaloAdsUpdateArticleAdResponse, type ZaloAdsUpdateAutomatedRuleRequest, type ZaloAdsUpdateAutomatedRuleResponse, type ZaloAdsUpdateCommerceAdRequest, type ZaloAdsUpdateCommerceAdResponse, type ZaloAdsUpdateDisplayAdRequest, type ZaloAdsUpdateDisplayAdResponse, type ZaloAdsUpdateEcommerceAdRequest, type ZaloAdsUpdateEcommerceAdResponse, type ZaloAdsUpdateFlowRequest, type ZaloAdsUpdateFlowResponse, type ZaloAdsUpdateFormAdRequest, type ZaloAdsUpdateFormAdResponse, ZaloAdsUpdateMessageAdRequest, ZaloAdsUpdateMessageAdResponse, type ZaloAdsUpdateNewAdsRequest, type ZaloAdsUpdateNewAdsResponse, type ZaloAdsUpdateOaAdRequest, type ZaloAdsUpdateOaAdResponse, type ZaloAdsUpdateOfficialAccountAdRequest, type ZaloAdsUpdateOfficialAccountAdResponse, type ZaloAdsUpdatePostAdRequest, type ZaloAdsUpdatePostAdResponse, ZaloAdsUpdateVideoAdRequest, ZaloAdsUpdateVideoAdResponse, type ZaloAdsUpdateWebsiteAdRequest, type ZaloAdsUpdateWebsiteAdResponse, type ZaloAdsUploadCustomAudiencePhoneListRequest, type ZaloAdsUploadCustomAudiencePhoneListResponse, type ZaloAdsUploadVideoRequest, type ZaloAdsUploadVideoResponse, type ZaloAdsUpsertCustomReportRequest, type ZaloAdsUpsertCustomReportResponse, ZaloAdsUseConversion, type ZaloAdsUseConversionValue, ZaloAdsVideoSrc, type ZaloAdsVideoSrcValue, type ZaloAdsWhoamiProfile, ZaloAdsXTemplates, type ZaloAdsXTemplatesValue, type ZaloAdsZaapiCampaignReportItemDto, ZaloAudiencesService, ZaloAudiencesValidator, type ZaloAuthDomain, ZaloAuthManager, ZaloAutomatedRulesService, ZaloAutomatedRulesValidator, ZaloCampaignsService, ZaloCampaignsValidator, type ZaloChatWidgetGetChatWidgetLoginConfigRequest, type ZaloChatWidgetGetChatWidgetLoginConfigResponse, type ZaloChatWidgetGetLoginConfigRequest, type ZaloChatWidgetGetLoginConfigResponse, ZaloChatWidgetService, ZaloConversionsService, ZaloConversionsValidator, type ZaloCreateFormCleanPayload, type ZaloCreateFormRequestInput, type ZaloDomainSession, ZaloFlowsService, ZaloFlowsValidator, type ZaloFormQuestionAnswerInput, type ZaloFormQuestionInput, type ZaloFormSectionInput, type ZaloFormSessionProfile, type ZaloFormsAudienceExclusionTargetingItem, type ZaloFormsAuthSessionOaItem, type ZaloFormsConversationLeadItem, type ZaloFormsDisableFormLeadNotificationRequest, type ZaloFormsDisableFormLeadNotificationResponse, type ZaloFormsEnableFormLeadNotificationRequest, type ZaloFormsEnableFormLeadNotificationResponse, type ZaloFormsExportFormLeadReportRequest, type ZaloFormsExportFormLeadReportResponse, type ZaloFormsGetAuthSessionResponse, type ZaloFormsLeadAnswerItem, type ZaloFormsLeadItem, type ZaloFormsListAudienceExclusionTargetingRequest, type ZaloFormsListAudienceExclusionTargetingResponse, type ZaloFormsListConversationLeadsRequest, type ZaloFormsListConversationLeadsResponse, type ZaloFormsListFormLeadsRequest, type ZaloFormsListFormLeadsResponse, type ZaloFormsListManagedFormsByOfficialAccountRequest, type ZaloFormsListManagedFormsByOfficialAccountResponse, type ZaloFormsListScenariosByOfficialAccountRequest, type ZaloFormsListScenariosByOfficialAccountResponse, type ZaloFormsListSimpleFormsByOfficialAccountRequest, type ZaloFormsListSimpleFormsByOfficialAccountResponse, type ZaloFormsScenarioItem, ZaloFormsService, type ZaloFormsTrackManageFormEventRequest, type ZaloFormsTrackManageFormEventResponse, type ZaloFormsUpdateFormLeadNotificationIntervalRequest, type ZaloFormsUpdateFormLeadNotificationIntervalResponse, ZaloFormsValidator, type ZaloInstantPageActive, ZaloInstantPageBlockType, ZaloInstantPageSharePermission, type ZaloInstantPageSharePermissionValue, type ZaloInstantPageStatus, type ZaloInstantPagesCloneInstantPageRequest, type ZaloInstantPagesCloneInstantPageResponse, type ZaloInstantPagesCreateInstantPageRequest, type ZaloInstantPagesCreateInstantPageResponse, type ZaloInstantPagesFormRecordItem, type ZaloInstantPagesGetInstantPageDetailRequest, type ZaloInstantPagesGetInstantPageDetailResponse, type ZaloInstantPagesGetInstantPageSharedUserRequest, type ZaloInstantPagesGetInstantPageSharedUserResponse, type ZaloInstantPagesListInstantPageEditHistoryRequest, type ZaloInstantPagesListInstantPageEditHistoryResponse, type ZaloInstantPagesListInstantPageFormRecordsRequest, type ZaloInstantPagesListInstantPageFormRecordsResponse, type ZaloInstantPagesListInstantPageLeadsRequest, type ZaloInstantPagesListInstantPageLeadsResponse, type ZaloInstantPagesListInstantPageSharesRequest, type ZaloInstantPagesListInstantPageSharesResponse, type ZaloInstantPagesListInstantPageUsersRequest, type ZaloInstantPagesListInstantPageUsersResponse, type ZaloInstantPagesListMiniPageTemplatesRequest, type ZaloInstantPagesListMiniPageTemplatesResponse, type ZaloInstantPagesListOfficialAccountsRequest, type ZaloInstantPagesListOfficialAccountsResponse, type ZaloInstantPagesOfficialAccountItem, type ZaloInstantPagesSearchInstantPagesRequest, type ZaloInstantPagesSearchInstantPagesResponse, ZaloInstantPagesService, type ZaloInstantPagesShareMemberDto, type ZaloInstantPagesUpdateInstantPageRequest, type ZaloInstantPagesUpdateInstantPageResponse, type ZaloInstantPagesUpdateInstantPageSharesRequest, type ZaloInstantPagesUpdateInstantPageSharesResponse, type ZaloInstantPagesUpsertInstantPageFormRequest, type ZaloInstantPagesUpsertInstantPageFormResponse, ZaloInstantPagesValidator, type ZaloIntegrationCredentials, type ZaloIntegrationVerificationResult, ZaloMediaService, type ZaloPlaySessionPayload, type ZaloProfileAdsAdministrativeItem, type ZaloProfileAdsCreateOaPageRequest, type ZaloProfileAdsCreateOaPageResponse, type ZaloProfileAdsGetDistrictsRequest, type ZaloProfileAdsGetDistrictsResponse, type ZaloProfileAdsGetProvincesResponse, type ZaloProfileAdsProvinceId, ZaloProfileAdsService, type ZaloProfileAdsSubCategoryId, type ZaloProfileAdsUploadOaAvatarRequest, type ZaloProfileAdsUploadOaAvatarResponse, type ZaloProfileAdsUploadOaCoverRequest, type ZaloProfileAdsUploadOaCoverResponse, type ZaloRedisLikeClient, ZaloReportsService, type ZaloSdkAuth, type ZaloSdkAuthContext, ZaloSdkError, ZaloSdkHttpClient, type ZaloSessionStore, type ZaloSsoAuthOptions, type ZaloUploadAndSaveImageRequest, type ZaloUploadAndSaveImageResult, type ZaloUploadAndSaveVideoRequest, type ZaloUploadAndSaveVideoResult, type ZaloWidgetAPIGetOfficialAccountInfoRequest, type ZaloWidgetAPIGetOfficialAccountInfoResponse, type ZaloWidgetAPIGetWidgetUserProfileRequest, type ZaloWidgetAPIGetWidgetUserProfileResponse, type ZaloWidgetAPIListStickerCategoriesRequest, type ZaloWidgetAPIListStickerCategoriesResponse, type ZaloWidgetAPIListStickersByCategoryRequest, type ZaloWidgetAPIListStickersByCategoryResponse, ZaloWidgetApiService, computeZpsidFingerprint, createZaloSsoAuth, decodePlaySessionJwt, ZaloAdsSdk as default, defaultSharedMemorySessionStore, deriveAccountKeyFromZpsid, parseZaloCookieInput, validateChangeCampaignStatusParams, validateCloneInstantPageRequest, validateCreateCampaignPayload, validateCreateFlowRequest, validateCreateFormEventAudienceRequest, validateCreateFormRequest, validateCreateInstantPageRequest, validateCreateLookalikeAudienceRequest, validateCreateMessageOaEventAudienceRequest, validateCreateMessagePersonalEventAudienceRequest, validateCreatePhoneAudienceRequest, validateCreateSavedAudienceRequest, validateDuplicateAdParams, validateEstimateAudienceRequest, validateGetInstantPageDetailRequest, validateGetInstantPageSharedUserRequest, validateListFlowsByOfficialAccountRequest, validateListFormLeadsRequest, validateListFormsByOfficialAccountRequest, validateListInstantPageEditHistoryRequest, validateListInstantPageFormRecordsRequest, validateListInstantPageLeadsRequest, validateListInstantPageSharesRequest, validateListInstantPageUsersRequest, validateListMiniPageTemplatesRequest, validateListOfficialAccountsRequest, validateRenameCampaignParams, validateSearchInstantPagesRequest, validateUpdateAdPayload, validateUpdateFlowRequest, validateUpdateInstantPageRequest, validateUpsertInstantPageFormRequest };