DEV Community

李强强
李强强

Posted on Originally published at ipvora.substack.com

Kiểm thử bản địa hoá và xác minh quảng cáo theo khu vực bằng Playwright + proxy dân cư

Bạn vừa ra mắt bản tiếng Việt của một landing page, chạy chiến dịch quảng cáo nhắm người dùng tại Việt Nam, Nhật Bản và Mỹ, và muốn chắc rằng mỗi thị trường thấy đúng nội dung: đúng ngôn ngữ, đúng đơn vị tiền tệ, đúng banner khuyến mãi, đúng chính sách cookie. Mở trình duyệt từ văn phòng ở Hà Nội hay TP.HCM chỉ cho bạn thấy phiên bản "Việt Nam". Bật VPN của công ty thì thường ra IP datacenter, và nhiều hệ thống CDN, A/B testing hay ad server xử lý IP datacenter khác với người dùng thật.

Bài viết này hướng dẫn cách dựng một quy trình localization QA và ad verification nhỏ gọn bằng Python + Playwright, chạy qua proxy dân cư theo từng khu vực, chụp ảnh màn hình và tự động kiểm tra một vài dấu hiệu bản địa hoá cơ bản.

Công khai: mình đang làm việc tại ipvora, một dịch vụ proxy dân cư. Các ví dụ dưới đây dùng biến môi trường và không phụ thuộc vào nhà cung cấp cụ thể nào.

1. Vì sao cần IP theo khu vực khi QA?

Một trang web có thể thay đổi nội dung dựa trên nhiều tín hiệu:

  • Địa chỉ IP (GeoIP ở CDN, ở backend, hoặc ở nền tảng quảng cáo).
  • Header Accept-Language mà trình duyệt gửi.
  • Múi giờ và locale của trình duyệt (JavaScript đọc qua Intl API).
  • Cookie / localStorage từ lần truy cập trước.

Nếu chỉ đổi Accept-Language mà IP vẫn ở Việt Nam, bạn đang kiểm tra một tổ hợp mà người dùng Nhật thật gần như không bao giờ tạo ra. Ngược lại, nếu chỉ đổi IP mà trình duyệt vẫn báo múi giờ Asia/Ho_Chi_Minh, một số script chống gian lận hoặc logic hiển thị sẽ cho kết quả khác. Muốn mô phỏng sát thực tế, hãy đổi cả ba: IP, ngôn ngữ, múi giờ.

Proxy dân cư hữu ích ở đây vì IP thuộc nhà mạng phục vụ hộ gia đình, nên cách CDN và ad server phân loại lưu lượng gần với người dùng thật hơn so với IP datacenter.

2. Chọn xoay hay tĩnh cho việc QA?

  • Proxy xoay với sticky session phù hợp cho các lượt kiểm tra ngắn: mở trang, chụp ảnh, kiểm tra vài phần tử. Bạn chỉ cần IP giữ nguyên trong vài phút của một lượt chạy.
  • Proxy tĩnh phù hợp khi bạn cần whitelist IP ở môi trường staging, hoặc chạy cùng một kịch bản hằng ngày và muốn so sánh kết quả giữa các ngày mà không bị nhiễu bởi việc đổi IP.

Ví dụ với ipvora: proxy xoay tính theo GB, giữ phiên 1–120 phút; proxy tĩnh thuê theo IP mỗi tháng, 5 Mbps/IP, không giới hạn lưu lượng trong kỳ thuê; cả hai hỗ trợ HTTP, HTTPS và SOCKS5, có IP tại Việt Nam, Mỹ, Nhật Bản và châu Âu.

Với QA bản địa hoá, mỗi lượt chạy thường chỉ tốn vài MB (một trang + tài nguyên), nên điều quan trọng hơn là đúng khu vực và ổn định trong suốt lượt chạy.

3. Cấu hình theo khu vực bằng biến môi trường

Đừng hard-code thông tin proxy trong mã nguồn. Hãy dùng một biến cho mỗi khu vực:

export PROXY_URL_VN="http://USER:PASS@HOST:PORT"
export PROXY_URL_JP="http://USER:PASS@HOST:PORT"
export PROXY_URL_US="http://USER:PASS@HOST:PORT"
export TARGET_URL="https://example.com/"
Enter fullscreen mode Exit fullscreen mode

Thay USER, PASS, HOST, PORT bằng chuỗi kết nối proxy của khu vực tương ứng từ nhà cung cấp bạn dùng. Lưu ý Playwright yêu cầu tách server, username, password thành các trường riêng, nên ta sẽ tự phân tích URL.

Cài đặt:

pip install playwright
python -m playwright install chromium
Enter fullscreen mode Exit fullscreen mode

4. Script kiểm tra đa khu vực

Script dưới đây, với mỗi khu vực:

  1. Mở một browser context mới với proxy, locale và múi giờ tương ứng.
  2. Kiểm tra IP đầu ra và quốc gia qua một API công khai.
  3. Mở trang cần kiểm tra, đọc thuộc tính lang của thẻ html, tìm ký hiệu tiền tệ mong đợi.
  4. Chụp ảnh toàn trang và ghi kết quả ra file JSON.
import json
import os
import re
from pathlib import Path
from urllib.parse import urlsplit

from playwright.sync_api import sync_playwright

REGIONS = {
    "VN": {"env": "PROXY_URL_VN", "locale": "vi-VN",
           "timezone": "Asia/Ho_Chi_Minh", "currency": r"₫|VND"},
    "JP": {"env": "PROXY_URL_JP", "locale": "ja-JP",
           "timezone": "Asia/Tokyo", "currency": r"¥|円|JPY"},
    "US": {"env": "PROXY_URL_US", "locale": "en-US",
           "timezone": "America/New_York", "currency": r"\$|USD"},
}

TARGET_URL = os.environ.get("TARGET_URL", "https://example.com/")
OUT_DIR = Path("qa_output")


def playwright_proxy(proxy_url):
    """Chuyển http://user:pass@host:port thành dict mà Playwright yêu cầu."""
    parts = urlsplit(proxy_url)
    proxy = {"server": f"{parts.scheme}://{parts.hostname}:{parts.port}"}
    if parts.username:
        proxy["username"] = parts.username
        proxy["password"] = parts.password or ""
    return proxy


def check_region(browser, code, cfg):
    proxy_url = os.environ.get(cfg["env"])
    if not proxy_url:
        return {"region": code, "skipped": f"thiếu biến {cfg['env']}"}

    context = browser.new_context(
        proxy=playwright_proxy(proxy_url),
        locale=cfg["locale"],
        timezone_id=cfg["timezone"],
        viewport={"width": 1366, "height": 900},
    )
    page = context.new_page()
    result = {"region": code}
    try:
        page.goto("https://ipinfo.io/json", timeout=30_000)
        info = json.loads(page.inner_text("body"))
        result["exit_ip"] = info.get("ip")
        result["exit_country"] = info.get("country")
        result["geo_ok"] = info.get("country") == code

        page.goto(TARGET_URL, wait_until="networkidle", timeout=60_000)
        result["html_lang"] = page.get_attribute("html", "lang")
        result["browser_tz"] = page.evaluate(
            "Intl.DateTimeFormat().resolvedOptions().timeZone")
        text = page.inner_text("body")
        result["currency_found"] = bool(re.search(cfg["currency"], text))

        shot = OUT_DIR / f"{code}.png"
        page.screenshot(path=str(shot), full_page=True)
        result["screenshot"] = str(shot)
    except Exception as exc:  # ghi lỗi để lượt sau xem lại
        result["error"] = repr(exc)
    finally:
        context.close()
    return result


def main():
    OUT_DIR.mkdir(exist_ok=True)
    with sync_playwright() as p:
        browser = p.chromium.launch()
        results = [check_region(browser, c, cfg) for c, cfg in REGIONS.items()]
        browser.close()
    (OUT_DIR / "report.json").write_text(
        json.dumps(results, ensure_ascii=False, indent=2), encoding="utf-8")
    for r in results:
        print(r)


if __name__ == "__main__":
    main()
Enter fullscreen mode Exit fullscreen mode

Một vài điểm cần lưu ý:

  • Mỗi khu vực một context riêng. Context trong Playwright tách biệt cookie và storage, nên kết quả khu vực này không "rò" sang khu vực khác.
  • Kiểm tra IP trước rồi mới mở trang. Nếu exit_country không khớp, kết quả bản địa hoá phía sau không có ý nghĩa; hãy đánh dấu lượt chạy đó là không hợp lệ thay vì kết luận trang bị lỗi.
  • Cùng một context cho cả hai bước. Với sticky session, các yêu cầu trong cùng một lượt ngắn sẽ đi qua cùng một IP; nếu bạn dùng proxy xoay theo từng yêu cầu, bước kiểm tra IP và bước mở trang có thể ra hai IP khác nhau.
  • Nếu dùng SOCKS5, Chromium không hỗ trợ xác thực username/password cho SOCKS5 qua Playwright; với trường hợp cần xác thực, hãy dùng HTTP/HTTPS proxy, hoặc dùng IP whitelist nếu nhà cung cấp hỗ trợ.

5. Xác minh quảng cáo (ad verification)

Với quảng cáo, câu hỏi thường là: "Ở thị trường X, landing page có hiển thị đúng banner/ưu đãi mà mình đã duyệt không? Trang đích có chuyển hướng lạ không?". Bạn có thể mở rộng script trên:

def trace_redirects(page, url):
    """Ghi lại chuỗi chuyển hướng khi mở URL quảng cáo/landing page."""
    chain = []
    page.on("response", lambda resp: chain.append((resp.status, resp.url))
            if 300 <= resp.status < 400 else None)
    page.goto(url, wait_until="domcontentloaded", timeout=60_000)
    chain.append((200, page.url))
    return chain
Enter fullscreen mode Exit fullscreen mode

Gợi ý kiểm tra:

  • Chuỗi chuyển hướng của URL có tham số UTM có dẫn đến đúng trang ngôn ngữ không, có bị mất tham số tracking không.
  • Phần tử khuyến mãi theo thị trường: dùng page.locator("text=...") để kiểm tra một chuỗi bắt buộc phải có (ví dụ tên chương trình ưu đãi tiếng Nhật).
  • Banner cookie/consent: người dùng châu Âu thường phải thấy banner đồng ý cookie; bạn có thể thêm khu vực châu Âu vào REGIONS để kiểm tra.

Lưu ý quan trọng: chỉ kiểm tra quảng cáo và trang của chính bạn (hoặc của khách hàng đã uỷ quyền). Không dùng script để tự động nhấp vào quảng cáo, vì điều đó làm sai lệch dữ liệu chiến dịch và vi phạm chính sách của các nền tảng quảng cáo.

6. Đưa vào CI hằng ngày

Khi script đã ổn, bạn có thể chạy nó theo lịch (GitHub Actions, GitLab CI, cron trên server):

  • Lưu PROXY_URL_* dưới dạng secret của CI, không commit vào repo.
  • Lưu thư mục qa_output làm artifact để đội nội dung xem ảnh chụp.
  • Cho job thất bại khi geo_ok là false ở mọi lần thử, hoặc khi currency_found là false ở thị trường bắt buộc phải hiển thị giá.
  • Nếu so sánh ảnh chụp giữa các ngày, proxy tĩnh giúp giảm khác biệt do đổi IP; còn nếu chỉ cần chạy vài lần mỗi ngày, proxy xoay với sticky session thường đủ.

7. Dùng proxy có trách nhiệm

  • Chỉ kiểm thử trang, ứng dụng và quảng cáo bạn sở hữu hoặc được phép kiểm tra.
  • Giữ tần suất thấp: QA bản địa hoá không cần hàng trăm yêu cầu mỗi phút.
  • Tôn trọng điều khoản sử dụng của website và nền tảng quảng cáo.
  • Nếu ảnh chụp màn hình hoặc log có dữ liệu cá nhân (ví dụ khi đăng nhập tài khoản thử nghiệm), hãy xử lý theo quy định bảo vệ dữ liệu cá nhân hiện hành và chính sách nội bộ của bạn; tốt nhất là dùng tài khoản thử nghiệm không chứa dữ liệu thật.

Tổng kết

Localization QA và ad verification hiệu quả nhất khi bạn mô phỏng đủ ba yếu tố: IP theo khu vực, ngôn ngữ và múi giờ. Playwright cho phép làm việc này gọn gàng với mỗi khu vực một context; proxy dân cư giúp lưu lượng được phân loại giống người dùng thật hơn. Hãy bắt đầu với một script nhỏ như trên, kiểm tra IP đầu ra trước mỗi lượt, rồi mới đưa vào CI.

Nếu bạn cần IP dân cư tại Việt Nam, Mỹ, Nhật Bản hoặc châu Âu cho quy trình kiểm thử, có thể tham khảo các gói proxy dân cư xoay và tĩnh của ipvora.

Top comments (0)