en

blog

Nạp trễ GA4 và AdSense trong Next.js static: 1,3 MB JS ra khỏi head

gtag.js và adsbygoogle.js cộng lại khoảng 1,3 MB JS chưa nén. Một component nạp chúng sau tương tác đầu tiên hoặc khi rảnh, chỉ trên domain thật, để không tranh main thread lúc tải trang.

Ngày đăng
GA4AdSenseNext.jsPerformance
Trục thời gian nạp trễ GA4 và AdSense: mốc load, một thanh chờ ghi 4000ms, khối gtag.js và adsbygoogle.js nằm ở cuối thanh, và một đường tắt từ các sự kiện pointerdown, keydown, scroll, touchstart tới thẳng khối đó

Site này nạp trễ GA4 và AdSense: components/DeferredScripts.jsx chỉ thêm gtag.js và adsbygoogle.js sau tương tác đầu tiên của người đọc, hoặc khi browser rảnh 4 giây sau load. AdSense chỉ nạp trên domain thật. GA4 chỉ nạp khi build có NEXT_PUBLIC_GA_ID, mà local để trống nên lúc dev không bị đếm.

1,3 MB JS của GA4 và AdSense không được nằm trong head

AdSense Auto ads khoảng 800 KB, GA khoảng 500 KB, cả hai chưa nén: đó là con số ghi trong chính file DeferredScripts.jsx. Ghi chú trong file nêu lý do: nạp sớm thì 2 script tranh main thread với việc render lúc tải trang và kéo TBT, LCP trên PageSpeed Insights. Luật trong AGENTS.md ngắn hơn: đừng chuyển chúng về <script> trong <head>.

Trong <head> chỉ còn một thẻ meta ở pages/_document.js:

jsx
{/* AdSense: meta xác minh site. Script Auto ads nạp trễ ở components/DeferredScripts.jsx */}
<meta name="google-adsense-account" content={siteMetaData.adsenseClient} />

Việc xác minh site dựa vào meta này nên không cần script nạp sớm. Cũng theo ghi chú ở đó, nếu sau này thêm CSP thì phải mở các domain của Google.

pages/_app.js mount component một lần, ngay sau cây layout:

jsx
<MDXProvider components={MDXComponents}>
  {getLayout(<Component {...pageProps} />, pageProps)}
</MDXProvider>
<DeferredScripts />

DeferredScripts trả về null, nên nó không thêm gì vào DOM ngoài tối đa 2 thẻ <script> tạo lúc chạy.

Nạp trễ GA4 và AdSense: tương tác đầu tiên hoặc 4000ms rảnh sau load

Có 2 đường kích hoạt, đường nào tới trước thì thắng:

js
const EVENTS = ['pointerdown', 'keydown', 'scroll', 'touchstart']
const IDLE_FALLBACK_MS = 4000

useEffect(() => {
  let loaded = false
  let timer

  const cleanup = () => {
    clearTimeout(timer)
    window.removeEventListener('load', startTimer)
    EVENTS.forEach((event) => window.removeEventListener(event, load))
  }

  function load() {
    if (loaded) return
    loaded = true
    cleanup()
    loadAll()
  }

  function startTimer() {
    timer = setTimeout(
      () => ('requestIdleCallback' in window ? window.requestIdleCallback(load, { timeout: 2000 }) : load()),
      IDLE_FALLBACK_MS
    )
  }

  if (document.readyState === 'complete') startTimer()
  else window.addEventListener('load', startTimer, { once: true })
  EVENTS.forEach((event) => window.addEventListener(event, load, { once: true, passive: true }))

  return cleanup
}, [])

Đường 1 là 4 sự kiện pointerdown, keydown, scroll, touchstart, gắn với { once: true, passive: true }. Chuyển động chuột không nằm trong danh sách: chỉ cần di chuột thì chưa tính là tương tác.

Đường 2 là đồng hồ. Nó chỉ bắt đầu sau sự kiện load (hoặc ngay nếu trang đã complete), chờ 4000ms, rồi xin requestIdleCallback với timeout: 2000. Trường hợp xấu nhất là 4000ms cộng 2000ms sau load. Browser không có requestIdleCallback thì load() được gọi thẳng sau 4000ms.

Cờ loaded chặn nạp 2 lần khi cả 2 đường cùng bắn, và cleanup gỡ mọi listener cùng đồng hồ, cũng là hàm trả về của effect. Mảng deps rỗng nên effect chỉ chạy một lần khi _app mount.

loadAll: GA4 chỉ khi có GA_ID, AdSense chỉ trên domain thật

js
const loadAll = () => {
  if (GA_ID) {
    window.dataLayer = window.dataLayer || []
    // gtag.js đọc đúng object `arguments`, không phải mảng rest
    window.gtag = function gtag() {
      window.dataLayer.push(arguments)
    }
    window.gtag('js', new Date())
    window.gtag('config', GA_ID)
    addScript(`https://www.googletagmanager.com/gtag/js?id=${GA_ID}`)
  }

  // Chỉ nạp trên domain thật: AdSense từ chối localhost và đếm nhầm impression khi dev
  if (ADSENSE_CLIENT && window.location.hostname === new URL(siteMetaData.siteUrl).hostname) {
    addScript(`https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=${ADSENSE_CLIENT}`, {
      crossorigin: 'anonymous',
    })
  }
}

Phần GA4: hàm gtag được định nghĩa, rồi 2 lệnh js và config được push vào dataLayer, tất cả trước khi addScript chạy. Hàm push arguments chứ không push mảng rest, vì theo ghi chú trong code, gtag.js đọc đúng object arguments. Lệnh config chạy đúng một lần cho cả phiên tải trang.

NEXT_PUBLIC_GA_ID được inline vào bundle lúc build. Trong .env.example dòng này để comment, nên .env.local trống, GA_ID là undefined và nhánh GA4 không chạy: lúc dev không có hit nào đẩy lên property thật. Workflow deploy đặt biến này cho bản build production. Đổi giá trị thì phải build lại.

Phần AdSense: hostname của trang phải bằng đúng hostname của siteMetaData.siteUrl. So sánh bằng nên localhost, domain preview hay www đều không nạp quảng cáo. Với www, apex là domain duy nhất phục vụ trang, vì www được chuyển về apex bằng Redirect Rule của zone.

Kiểm bằng grep: chỉ một file nhắc tới 2 domain của Google

Luật "không để trong head" kiểm được bằng một lệnh, quét code chạy trên site:

bash
grep -rnE "googletagmanager|googlesyndication" components pages lib theme.config.js layouts
text
components/DeferredScripts.jsx:32:    addScript(`https://www.googletagmanager.com/gtag/js?id=${GA_ID}`)
components/DeferredScripts.jsx:37:    addScript(`https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=${ADSENSE_CLIENT}`, {

Ai thêm một <script src> tới 2 domain đó vào _document.js hay một layout thì lệnh này in thêm dòng. Repo không có script nào kiểm điều này, nên tôi chạy grep sau mỗi lần sửa _document.js.

Page view khi đổi route: để GA4 tự đếm

Site chuyển trang bằng router phía client nên không có lần tải trang mới. Repo không có hook router nào gọi gtag('event', 'page_view'). Ghi chú trong code và AGENTS.md nói cùng một ý: GA4 tự đếm khi đổi route nhờ enhanced measurement, tức tuỳ chọn page changes dựa trên browser history (pageChangesEnabled) của stream.

Đây là chỗ phụ thuộc vào thứ nằm ngoài repo. Tuỳ chọn đó là cấu hình của stream trong GA4, nên nếu ai tắt nó thì page view khi đổi route biến mất mà không file nào trong repo đổi.

Cái giá của nạp trễ: khách rời sớm không được đếm

gtag.js chưa nạp thì GA4 chưa biết có người ghé. Khách mở trang rồi đóng trước khi có pointerdown, keydown, scroll hay touchstart, và trước mốc 4000ms sau load, sẽ không để lại hit nào. Tôi chưa đo tỷ lệ này trên site. Phía quảng cáo cũng vậy: Auto ads chỉ bắt đầu sau cùng mốc đó. Mô tả trong bài đọc từ code, tôi chưa mở Network panel trên bản production để đo mốc nạp thật.

Muốn thêm script bên thứ ba nào nữa thì thêm vào loadAll chứ đừng thêm vào <head>. Dịch vụ nào nhận dữ liệu người đọc còn buộc sửa content/chinh-sach-bao-mat.md và updated của trang đó cùng lúc, vì trang này là điều kiện của AdSense.

Bài viết liên quan

tất cả bài viết →