@redonvn/zalo-ads-sdk 0.2.20 → 0.2.25

package/dist/index.mjs

@@ -2048,7 +2048,24 @@ var VALID_AD_TYPES = {
   COMMERCE: 28,
   // Server trả về 28 (không phải 23)
   ARTICLE: 3,
-  DISPLAY: 21
+  DISPLAY: 21,
+  // Masthead Mobile (Format 1) & Masthead Desktop (Format 2)
+  DISPLAY_HALFPAGE: 26,
+  // Halfpage Mobile (Format 13) & Halfpage PC (Format 14)
+  DISPLAY_MEDIUM_RECTANGLE: 23
+  // Medium Rectangle 300x250 (Format 6)
+};
+var ZALO_DISPLAY_AD_FORMAT = {
+  MASTHEAD_MOBILE: 1,
+  // Kích thước 640x360, Os: [0, 1]
+  MASTHEAD_DESKTOP: 2,
+  // Kích thước 970x250, Os: [3]
+  MEDIUM_RECTANGLE: 6,
+  // Kích thước 300x250, Os: [0, 1]
+  HALFPAGE_MOBILE: 13,
+  // Kích thước 300x600, Os: [0, 1]
+  HALFPAGE_PC: 14
+  // Kích thước 300x600, Os: [3]
 };
 var ALLOWED_CTAS_PER_AD_TYPE = {
   // Website (Type 5): 9 CTAs
@@ -2099,7 +2116,41 @@ var ALLOWED_CTAS_PER_AD_TYPE = {
     ZaloAdsActionType.XEM_THEM
   ],
   // OA (Type 2): Cố định Quan tâm OA (6)
-  [VALID_AD_TYPES.OA]: [ZaloAdsActionType.QUAN_TAM_OA]
+  [VALID_AD_TYPES.OA]: [ZaloAdsActionType.QUAN_TAM_OA],
+  // Display (Type 21) & Display Halfpage (Type 26): Hỗ trợ các hành động cơ bản
+  [VALID_AD_TYPES.DISPLAY]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.NGHE_NGAY,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY,
+    ZaloAdsActionType.GOI_DIEN
+  ],
+  [VALID_AD_TYPES.DISPLAY_HALFPAGE]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.NGHE_NGAY,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY,
+    ZaloAdsActionType.GOI_DIEN
+  ],
+  [VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE]: [
+    ZaloAdsActionType.DAT_NGAY,
+    ZaloAdsActionType.MUA_NGAY,
+    ZaloAdsActionType.THU_NGAY,
+    ZaloAdsActionType.TAI_NGAY,
+    ZaloAdsActionType.XEM_THEM,
+    ZaloAdsActionType.NGHE_NGAY,
+    ZaloAdsActionType.CHOI_NGAY,
+    ZaloAdsActionType.DANG_KY,
+    ZaloAdsActionType.GOI_DIEN
+  ]
 };
 function validateCreateCampaignPayload(payload, options = {}) {
   const errors = [];
@@ -2195,11 +2246,15 @@ function validateUpdateAdPayload(payload, options = {}) {
   if (!adInfo) {
     errors.push("Settings.AdInfo l\xE0 b\u1EAFt bu\u1ED9c.");
   } else {
+    const rawTypeNum = Number(payload.Type);
+    const isDisplayAd = rawTypeNum === 21 || rawTypeNum === 23 || rawTypeNum === 26 || adInfo.AdFormat === 1 || adInfo.AdFormat === 2 || adInfo.AdFormat === 6 || adInfo.AdFormat === 13 || adInfo.AdFormat === 14;
     if (!adInfo.Caption || !adInfo.Caption.trim()) {
-      errors.push("Settings.AdInfo.Caption l\xE0 b\u1EAFt bu\u1ED9c.");
+      if (!isDisplayAd) {
+        errors.push("Settings.AdInfo.Caption l\xE0 b\u1EAFt bu\u1ED9c.");
+      }
     } else {
       const captionLen = adInfo.Caption.trim().length;
-      if (captionLen < 35) {
+      if (!isDisplayAd && captionLen < 35) {
         errors.push(`Settings.AdInfo.Caption qu\xE1 ng\u1EAFn (${captionLen}/35 k\xFD t\u1EF1 t\u1ED1i thi\u1EC3u).`);
       } else if (captionLen > 90) {
         errors.push(`Settings.AdInfo.Caption qu\xE1 d\xE0i (${captionLen}/90 k\xFD t\u1EF1 t\u1ED1i \u0111a).`);
@@ -2223,6 +2278,14 @@ function validateUpdateAdPayload(payload, options = {}) {
         );
       }
     }
+    if (isDisplayAd) {
+      const targetUrl = typeof adInfo.TargetUrl === "object" ? adInfo.TargetUrl?.Url : adInfo.TargetUrl;
+      if (!targetUrl || typeof targetUrl !== "string" || !targetUrl.trim()) {
+        errors.push("Settings.AdInfo.TargetUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Display.");
+      } else if (!/^https?:\/\//i.test(targetUrl.trim())) {
+        errors.push("Settings.AdInfo.TargetUrl ph\u1EA3i l\xE0 m\u1ED9t \u0111\u01B0\u1EDDng d\u1EABn h\u1EE3p l\u1EC7 (b\u1EAFt \u0111\u1EA7u b\u1EB1ng http:// ho\u1EB7c https://).");
+      }
+    }
     if (adInfo.Action !== void 0 && payload.Type) {
       const allowedCtas = ALLOWED_CTAS_PER_AD_TYPE[payload.Type];
       if (allowedCtas && !allowedCtas.includes(adInfo.Action)) {
@@ -2346,6 +2409,65 @@ function validateUpdateAdPayload(payload, options = {}) {
           "Ng\xE2n s\xE1ch t\u1ED1i thi\u1EC3u cho Qu\u1EA3ng c\xE1o Tin nh\u1EAFn l\xE0 600,000 VN\u0110 (Price.Limit >= 600000). N\u1EBFu \u0111\u1EB7t d\u01B0\u1EDBi 600k m\xE1y ch\u1EE7 s\u1EBD t\u1EEB ch\u1ED1i."
         );
       }
+    } else if (Number(payload.Type) === 21 || Number(payload.Type) === 23 || Number(payload.Type) === 26 || payload.Type === VALID_AD_TYPES.DISPLAY || payload.Type === VALID_AD_TYPES.DISPLAY_HALFPAGE || payload.Type === VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE) {
+      const adFormat = payload.Settings?.AdInfo?.AdFormat;
+      const typeNum = Number(payload.Type);
+      const isHalfpage = typeNum === 26 || adFormat === 13 || adFormat === 14 || (payload.AdName || "").toLowerCase().includes("halfpage");
+      const isMediumRectangle = typeNum === 23 || adFormat === 6 || (payload.AdName || "").toLowerCase().includes("medium rectangle") || (payload.AdName || "").toLowerCase().includes("300x250");
+      const adNameLower = (payload.AdName || "").toLowerCase();
+      const isWelcome = adNameLower.includes("welcome");
+      const isMasthead = (adNameLower.includes("masthead") || typeNum === 21 || adFormat === 1 || adFormat === 2) && !isWelcome && !isMediumRectangle;
+      if (price.Type !== 1 && price.Type !== 2) {
+        errors.push(
+          "\u0110\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Display, Price.Type ch\u1EC9 ch\u1EA5p nh\u1EADn 1 (CPM - L\u01B0\u1EE3t hi\u1EC3n th\u1ECB) ho\u1EB7c 2 (CPC - L\u01B0\u1EE3t nh\u1EA5n)."
+        );
+      }
+      if ((isHalfpage || isMasthead) && price.Type === 2) {
+        errors.push(
+          `Qu\u1EA3ng c\xE1o ${isHalfpage ? "Halfpage (Type 26 / AdFormat 13, 14)" : "Masthead (Type 21)"} ch\u1EC9 h\u1ED7 tr\u1EE3 t\xEDnh ti\u1EC1n theo l\u01B0\u1EE3t hi\u1EC3n th\u1ECB CPM (Price.Type = 1), kh\xF4ng h\u1ED7 tr\u1EE3 CPC.`
+        );
+      }
+      if (price.Type === 1) {
+        if (price.Bid !== void 0) {
+          if (isWelcome && price.Bid < 3e4) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Welcome Mobile t\u1ED1i thi\u1EC3u l\xE0 30,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isHalfpage && price.Bid < 16e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Halfpage t\u1ED1i thi\u1EC3u l\xE0 16,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isMasthead && price.Bid < 13e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Masthead t\u1ED1i thi\u1EC3u l\xE0 13,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (isMediumRectangle && price.Bid < 8e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Medium Rectangle CPM t\u1ED1i thi\u1EC3u l\xE0 8,000 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          } else if (price.Bid < 8e3) {
+            errors.push(
+              `Gi\xE1 \u0111\u1EB7t m\u1ED7i 1,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB (Price.Bid) cho Qu\u1EA3ng c\xE1o Display CPM t\u1ED1i thi\u1EC3u l\xE0 8,000 VN\u0110 (s\xE0n h\u1EC7 th\u1ED1ng). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+            );
+          }
+        }
+        if (price.Limit !== void 0 && price.Limit > 0 && price.Limit < 50) {
+          errors.push(
+            "S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t hi\u1EC3n th\u1ECB t\u1ED1i thi\u1EC3u (Price.Limit) cho Qu\u1EA3ng c\xE1o Display CPM l\xE0 50 (t\u01B0\u01A1ng \u1EE9ng 50,000 l\u01B0\u1EE3t hi\u1EC3n th\u1ECB)."
+          );
+        }
+      } else if (price.Type === 2) {
+        if (price.Bid !== void 0 && price.Bid < 1800) {
+          errors.push(
+            `Gi\xE1 \u0111\u1EB7t m\u1ED7i l\u01B0\u1EE3t nh\u1EA5n (Price.Bid) cho Qu\u1EA3ng c\xE1o Display CPC t\u1ED1i thi\u1EC3u l\xE0 1,800 VN\u0110. Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+          );
+        }
+        if (price.Limit !== void 0 && price.Limit > 0 && price.Limit < 50) {
+          errors.push(
+            "S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t nh\u1EA5n t\u1ED1i thi\u1EC3u (Price.Limit) cho Qu\u1EA3ng c\xE1o Display CPC l\xE0 50 l\u01B0\u1EE3t nh\u1EA5n."
+          );
+        }
+      }
     }
     if (payload.Settings && payload.Settings.DeliveryType !== void 0) {
       const deliveryType = payload.Settings.DeliveryType;
@@ -2362,6 +2484,21 @@ function validateUpdateAdPayload(payload, options = {}) {
   }
   const targeting = payload.Settings?.Targeting;
   if (targeting) {
+    if (targeting.Gender !== void 0 && targeting.Gender !== null) {
+      if (![0, 1, 2].includes(Number(targeting.Gender))) {
+        errors.push(`M\xE3 gi\u1EDBi t\xEDnh 'Gender' (${targeting.Gender}) kh\xF4ng h\u1EE3p l\u1EC7. H\u1EE3p l\u1EC7: 0 (T\u1EA5t c\u1EA3), 1 (Nam), 2 (N\u1EEF).`);
+      }
+    }
+    if (targeting.CustomAudienceId !== void 0 && targeting.CustomAudienceId !== null) {
+      if (typeof targeting.CustomAudienceId !== "number" || targeting.CustomAudienceId < 0) {
+        errors.push("CustomAudienceId ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn kh\xF4ng \xE2m (>= 0).");
+      }
+    }
+    if (targeting.ExcludedAudienceId !== void 0 && targeting.ExcludedAudienceId !== null) {
+      if (typeof targeting.ExcludedAudienceId !== "number" || targeting.ExcludedAudienceId < 0) {
+        errors.push("ExcludedAudienceId ph\u1EA3i l\xE0 s\u1ED1 nguy\xEAn kh\xF4ng \xE2m (>= 0).");
+      }
+    }
     const newAges = targeting.NewAgeRanges;
     const oldAges = targeting.AgeRanges;
     if (newAges && newAges.length > 0) {
@@ -2484,6 +2621,14 @@ function validateUpdateAdPayload(payload, options = {}) {
     if (!payload.ZaloFeedId && !payload.articleId) {
       errors.push("ZaloFeedId ho\u1EB7c articleId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i Vi\u1EBFt (Ad Type 3).");
     }
+  } else if (Number(payload.Type) === 21 || Number(payload.Type) === 23 || Number(payload.Type) === 26 || payload.Type === VALID_AD_TYPES.DISPLAY || payload.Type === VALID_AD_TYPES.DISPLAY_HALFPAGE || payload.Type === VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE) {
+    const img = payload.Settings?.Image;
+    const hasImage = img?.LandscapeCoverUrl || img?.BaseLandscapeCoverUrl || img?.PortraitCoverUrl || img?.SquareCoverUrl;
+    if (!hasImage) {
+      errors.push(
+        "Qu\u1EA3ng c\xE1o Display b\u1EAFt bu\u1ED9c ph\u1EA3i c\xF3 \xEDt nh\u1EA5t m\u1ED9t banner h\xECnh \u1EA3nh (Settings.Image.LandscapeCoverUrl ho\u1EB7c BaseLandscapeCoverUrl)."
+      );
+    }
   }
   return {
     isValid: errors.length === 0,
@@ -2725,7 +2870,19 @@ function validateUpdateWebsiteAd(payload, options = {}) {
   return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.WEBSITE }, options);
 }
 function validateUpdateDisplayAd(payload, options = {}) {
-  return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.DISPLAY }, options);
+  const adFormat = payload.Settings?.AdInfo?.AdFormat;
+  const rawType = Number(payload.Type);
+  const isHalfpage = rawType === 26 || adFormat === 13 || adFormat === 14;
+  const isMediumRectangle = rawType === 23 || adFormat === 6;
+  let effectiveType;
+  if (isHalfpage) {
+    effectiveType = VALID_AD_TYPES.DISPLAY_HALFPAGE;
+  } else if (isMediumRectangle) {
+    effectiveType = VALID_AD_TYPES.DISPLAY_MEDIUM_RECTANGLE;
+  } else {
+    effectiveType = payload.Type ?? VALID_AD_TYPES.DISPLAY;
+  }
+  return validateUpdateAdPayload({ ...payload, Type: effectiveType }, options);
 }
 function validateUpdateVideoAd(payload, options = {}) {
   return validateUpdateAdPayload({ ...payload, Type: VALID_AD_TYPES.VIDEO }, options);
@@ -8871,6 +9028,7 @@ export {
   VALID_AD_TYPES,
   VALID_CAMPAIGN_TYPES,
   VIETNAM_PHONE_REGEX,
+  ZALO_DISPLAY_AD_FORMAT,
   ZALO_NEW_REGION_PROVINCE_CODES,
   ZALO_PROFILE_ADS_PROVINCES,
   ZALO_PROFILE_ADS_SUB_CATEGORIES,