@redonvn/zalo-ads-sdk 0.2.30 → 0.2.33

package/dist/index.mjs

@@ -2059,7 +2059,7 @@ var VALID_AD_TYPES = {
   OA: 2,
   VIDEO: 11,
   COMMERCE: 28,
-  // Server trả về 28 (không phải 23)
+  // Mã chuẩn cho Commerce Ad
   ARTICLE: 3,
   DISPLAY: 21,
   // Masthead Mobile (Format 1) & Masthead Desktop (Format 2)
@@ -2329,15 +2329,46 @@ function validateUpdateAdPayload(payload, options = {}) {
     errors.push("Settings.Price l\xE0 b\u1EAFt bu\u1ED9c.");
   } else {
     if (payload.Type === VALID_AD_TYPES.WEBSITE) {
-      if (price.Type !== 1) {
+      if (price.Type !== 2 && price.Type !== 1) {
         errors.push(
-          "\u0110\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website (Type 5), Price.Type b\u1EAFt bu\u1ED9c ph\u1EA3i b\u1EB1ng 1 (CPC). N\u1EBFu truy\u1EC1n 2 s\u1EBD b\u1ECB m\xE1y ch\u1EE7 l\u1ED7i."
+          "\u0110\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website (Type 5), Price.Type b\u1EAFt bu\u1ED9c ph\u1EA3i b\u1EB1ng 2 (L\u01B0\u1EE3t nh\u1EA5n - CPC)."
         );
       }
-      if (price.LimitType === 1) {
-        errors.push(
-          "Qu\u1EA3ng c\xE1o Website kh\xF4ng h\u1ED7 tr\u1EE3 LimitType: 1 (t\u1ED5ng ng\xE2n s\xE1ch). B\u1EAFt bu\u1ED9c ph\u1EA3i d\xF9ng LimitType: 0 (ng\xE2n s\xE1ch ng\xE0y)."
-        );
+      if (price.SpendingMethod === 1) {
+        if (price.Bid !== void 0 && price.Bid !== 0) {
+          warnings.push(
+            "Khi ch\u1ECDn 'T\u1ED5ng ng\xE2n s\xE1ch qu\u1EA3ng c\xE1o' (SpendingMethod = 1) cho Qu\u1EA3ng c\xE1o Website, tr\u01B0\u1EDDng Price.Bid n\xEAn \u0111\u1EC3 b\u1EB1ng 0 (h\u1EC7 th\u1ED1ng t\u1EF1 \u0111\u1ED9ng \u0111\u1EA5u th\u1EA7u)."
+          );
+        }
+        if (price.LimitType === 1) {
+          let days = 1;
+          if (payload.StartDate && payload.EndDate && payload.EndDate > payload.StartDate) {
+            days = Math.max(1, Math.ceil((payload.EndDate - payload.StartDate) / 86400));
+          }
+          const minTotalBudget = days * 2e5;
+          if (price.Limit !== void 0 && price.Limit < minTotalBudget) {
+            errors.push(
+              `Ng\xE2n s\xE1ch To\xE0n l\u1ECBch ch\u1EA1y cho Qu\u1EA3ng c\xE1o Website (${days} ng\xE0y) t\u1ED1i thi\u1EC3u l\xE0 ${minTotalBudget.toLocaleString("vi-VN")} VN\u0110 (${days} ng\xE0y x 200,000\u0111/ng\xE0y). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Limit.toLocaleString("vi-VN")}\u0111.`
+            );
+          }
+        } else if (price.LimitType === 2 || price.LimitType === 0) {
+          if (price.Limit !== void 0 && price.Limit < 2e5) {
+            errors.push(
+              `Ng\xE2n s\xE1ch M\u1ED7i ng\xE0y cho Qu\u1EA3ng c\xE1o Website (SpendingMethod = 1) t\u1ED1i thi\u1EC3u l\xE0 200,000 VN\u0110 (Price.Limit >= 200000). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Limit.toLocaleString("vi-VN")}\u0111.`
+            );
+          }
+        }
+      } else if (price.SpendingMethod === 0) {
+        if (price.Bid !== void 0 && price.Bid < 650) {
+          errors.push(
+            `Gi\xE1 \u0111\u1EB7t m\u1ED7i l\u01B0\u1EE3t nh\u1EA5n (Price.Bid) cho Qu\u1EA3ng c\xE1o Website t\u1ED1i thi\u1EC3u l\xE0 650 VN\u0110 (s\xE0n h\u1EC7 th\u1ED1ng Zalo Ads). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Bid}\u0111.`
+          );
+        }
+        if (price.Limit !== void 0 && price.Limit < 50) {
+          errors.push(
+            `S\u1ED1 l\u01B0\u1EE3ng l\u01B0\u1EE3t nh\u1EA5n (Price.Limit) cho Qu\u1EA3ng c\xE1o Website t\u1ED1i thi\u1EC3u l\xE0 50 l\u01B0\u1EE3t (minCTA = 50). Hi\u1EC7n t\u1EA1i \u0111ang truy\u1EC1n: ${price.Limit}.`
+          );
+        }
       }
     } else if (payload.Type === VALID_AD_TYPES.VIDEO) {
       if (price.Type !== 1 && price.Type !== 7) {
@@ -2781,14 +2812,31 @@ function validateUpdateAdPayload(payload, options = {}) {
       );
     }
   }
-  if (payload.Type === VALID_AD_TYPES.FORM) {
+  const isNonEmptyStr = (val) => typeof val === "string" && val.trim().length > 0;
+  if (payload.Type === VALID_AD_TYPES.WEBSITE || Number(payload.Type) === 5) {
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Website (Ad Type 5). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.FORM || Number(payload.Type) === 18) {
     if (!payload.ZaloFormId || !payload.ZaloFormId.trim()) {
       errors.push("ZaloFormId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Form (Ad Type 18).");
     }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Form (Ad Type 18). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
   } else if (payload.Type === VALID_AD_TYPES.MESSAGE || payload.Type === VALID_AD_TYPES.MESSAGE_LEGACY || Number(payload.Type) === 19 || Number(payload.Type) === 30) {
-    if (!payload.Settings?.Image?.LogoUrl) {
+    if (!isNonEmptyStr(payload.Settings?.Image?.LogoUrl)) {
       errors.push("Settings.Image.LogoUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn (Ad Type 19/30).");
     }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn (Ad Type 19/30). Vui l\xF2ng upload \u1EA3nh b\xECa t\u1EC9 l\u1EC7 16:9 (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
     const hasFlow = payload.ZaloFlowId && Number(payload.ZaloFlowId) > 0;
     const hasMiniPage = payload.MiniPageId && Number(payload.MiniPageId) > 0;
     if (!hasFlow && !hasMiniPage) {
@@ -2796,30 +2844,58 @@ function validateUpdateAdPayload(payload, options = {}) {
         "Qu\u1EA3ng c\xE1o Tin Nh\u1EAFn y\xEAu c\u1EA7u ph\u1EA3i ch\u1ECDn K\u1ECBch b\u1EA3n tin nh\u1EAFn (ZaloFlowId > 0) ho\u1EB7c Trang gi\u1EDBi thi\u1EC7u th\u01B0\u01A1ng hi\u1EC7u (MiniPageId > 0)."
       );
     }
-  } else if (payload.Type === VALID_AD_TYPES.COMMERCE) {
+  } else if (payload.Type === VALID_AD_TYPES.COMMERCE || Number(payload.Type) === 28) {
     if (!payload.MiniPageId || payload.MiniPageId <= 0) {
       errors.push("MiniPageId l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Commerce (Ad Type 28, Template 1/2/3).");
     }
-  } else if (payload.Type === VALID_AD_TYPES.VIDEO) {
+    const hasSquare = isNonEmptyStr(payload.Settings?.Image?.SquareCoverUrl);
+    const hasLandscape = isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl);
+    if (!hasSquare && !hasLandscape) {
+      errors.push(
+        "Settings.Image.SquareCoverUrl (ho\u1EB7c LandscapeCoverUrl) l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Commerce (Ad Type 28). Vui l\xF2ng upload \u1EA3nh s\u1EA3n ph\u1EA9m (1024x1024 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.OA || Number(payload.Type) === 2) {
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o OA (Ad Type 2). Vui l\xF2ng upload \u1EA3nh b\xECa (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+    if (payload.Settings?.AdInfo?.Action !== void 0 && Number(payload.Settings.AdInfo.Action) !== 6) {
+      warnings.push("Qu\u1EA3ng c\xE1o OA ch\u1EC9 ch\u1EA5p nh\u1EADn Action = 6 (Quan t\xE2m OA).");
+    }
+  } else if (payload.Type === VALID_AD_TYPES.ARTICLE || Number(payload.Type) === 3) {
+    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).");
+    }
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      errors.push(
+        "Settings.Image.LandscapeCoverUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o B\xE0i Vi\u1EBFt (Ad Type 3). Vui l\xF2ng upload \u1EA3nh \u0111\u1EA1i di\u1EC7n b\xE0i vi\u1EBFt (1024x533 px) l\xEAn CDN Zalo Ads tr\u01B0\u1EDBc khi l\u01B0u."
+      );
+    }
+  } else if (payload.Type === VALID_AD_TYPES.VIDEO || Number(payload.Type) === 11) {
     if (!payload.ZaloVideoId && !payload.Settings?.Image?.VideoUrl) {
       errors.push("ZaloVideoId ho\u1EB7c Settings.Image.VideoUrl l\xE0 b\u1EAFt bu\u1ED9c \u0111\u1ED1i v\u1EDBi Qu\u1EA3ng c\xE1o Video (Ad Type 11).");
     }
     if (payload.Settings?.Image?.VideoUrl && !payload.Settings.Image.VideoUrl.includes("zascdn.me")) {
       warnings.push("VideoUrl n\xEAn l\xE0 \u0111\u01B0\u1EDDng d\u1EABn CDN ch\xEDnh th\u1EE9c c\u1EE7a Zalo Ads (*.zascdn.me).");
     }
-  } else if (payload.Type === VALID_AD_TYPES.ARTICLE) {
-    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).");
+    if (!isNonEmptyStr(payload.Settings?.Image?.LandscapeCoverUrl)) {
+      warnings.push("N\xEAn b\u1ED5 sung Settings.Image.LandscapeCoverUrl l\xE0m \u1EA3nh poster \u0111\u1EA1i di\u1EC7n khi video ch\u01B0a t\u1EF1 \u0111\u1ED9ng ph\xE1t.");
     }
   } 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;
+    const hasImage = isNonEmptyStr(img?.LandscapeCoverUrl) || isNonEmptyStr(img?.BaseLandscapeCoverUrl) || isNonEmptyStr(img?.PortraitCoverUrl) || isNonEmptyStr(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)."
       );
     }
   }
+  const coverUrl = payload.Settings?.Image?.LandscapeCoverUrl;
+  if (coverUrl && typeof coverUrl === "string" && !coverUrl.includes("zascdn.me") && !coverUrl.includes("zadn.vn") && !coverUrl.includes("zdn.vn") && !coverUrl.includes("zalo.me")) {
+    warnings.push("\u1EA2nh b\xECa (LandscapeCoverUrl) n\xEAn \u0111\u01B0\u1EE3c t\u1EA3i l\xEAn CDN Zalo Ads (*.zascdn.me) \u0111\u1EC3 \u0111\u1EA3m b\u1EA3o duy\u1EC7t.");
+  }
   return {
     isValid: errors.length === 0,
     errors,