Data Studio: xây dựng báo cáo với dữ liệu từ AutoPSEO

AutoPSEO không phát hành trình kết nối cho Data Studio, công cụ dashboard của Google trước đây có tên là Looker Studio. Dù vậy, bạn vẫn có thể hiển thị số liệu của AutoPSEO trên đó theo ba cách: dùng trình kết nối Search Console của Google để lấy dữ liệu thô, dùng tệp CSV xuất từ một báo cáo AutoPSEO, hoặc dùng Google Sheet được một script chạy theo lịch điền dữ liệu từ REST API của AutoPSEO. Cách nào phù hợp tùy thuộc vào việc dashboard cần mới đến mức nào và cần các phân tích của AutoPSEO hay chỉ cần các chỉ số thô.

Cách 1: Trình kết nối Search Console của Google

Trình kết nối của Google đọc trực tiếp từ Search Console, nên chỉ mang về các chỉ số thô chứ không có phần phân tích của AutoPSEO. Theo hướng dẫn về trình kết nối của Google:

• Trình kết nối cung cấp hai bảng, Site Impression và URL Impression, và mỗi nguồn dữ liệu chỉ dùng một trong hai bảng. Hãy thêm hai nguồn dữ liệu vào báo cáo để hiển thị cả hai.
• Bạn cần ít nhất quyền xem trên thuộc tính Search Console, và phải đăng nhập vào cả hai sản phẩm bằng cùng một tài khoản Google.
• Site Impression bao gồm kết quả web, hình ảnh, video và tin tức; URL Impression bổ sung thêm Discover và Google News.

Để thêm trình kết nối, chọn Create → Data Source → Search Console, chọn trang web, bảng và loại tìm kiếm mặc định, rồi nhấn Connect.

Cách 2: Tải lên tệp CSV từ AutoPSEO

Với dashboard dùng một lần hoặc cập nhật hằng tháng, hãy xuất một bảng từ bất kỳ báo cáo nào (Xuất dữ liệu) rồi thêm vào bằng trình kết nối tải tệp CSV của Data Studio. Yêu cầu tải lên của Google quyết định cách bạn nên xuất:

• Các trường phải được phân tách bằng dấu phẩy, vì vậy trước tiên hãy đặt Account → CSV export format thành Standard (US / UK).
• Tệp phải ở định dạng UTF-8 và có dòng tiêu đề; các tệp xuất từ AutoPSEO đều đáp ứng điều này.
• Mọi tệp thêm vào một bộ dữ liệu phải có chính xác cùng các cột theo cùng thứ tự, vì vậy hãy xuất cùng một báo cáo với cùng các cột và cùng thiết lập so sánh mỗi lần.
• Các tệp mới được nối thêm vào và dữ liệu trùng lặp không bị loại bỏ, vì vậy đừng tải lên các khoảng thời gian chồng lấn nhau.
• Mỗi tệp có dung lượng tối đa 100 MB, và mỗi người dùng có 2 GB dung lượng lưu trữ cho các tệp tải lên.

Tỷ lệ phần trăm được xuất kèm ký hiệu phần trăm (27.03%), vì vậy hãy kiểm tra lại kiểu dữ liệu của các trường sau khi tải lên.

Cách 3: Google Sheet được cập nhật qua REST API

Để có dashboard tự cập nhật, hãy dùng một tác vụ chạy theo lịch để ghi số liệu của AutoPSEO vào Google Sheet rồi kết nối trang tính đó. Trình kết nối Sheets của Google kiểm tra giá trị thay đổi và các dòng mới mỗi khi báo cáo truy vấn dữ liệu.

1. Trong AutoPSEO, mở MCP & API và tạo một khóa API với phạm vi Read only. Khóa chỉ hiển thị một lần, vì vậy hãy lưu nó trong phần bí mật (secrets) của tác vụ.
2. Từ tác vụ chạy theo lịch (Google Apps Script, cron job hoặc công cụ workflow), gọi REST API và ghi các dòng dữ liệu vào trang tính.
3. Trong Data Studio, thêm trang tính bằng trình kết nối Google Sheets và chọn Use first row as headers.

Lệnh gọi lấy các truy vấn hàng đầu trong 28 ngày gần nhất trông như sau:

curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
  -H "Authorization: Bearer apk_live_..."

Mỗi phản hồi là JSON, với kết quả nằm trong data và thông tin chi tiết về lệnh gọi nằm trong meta. REST API cung cấp cùng 19 công cụ Search Console và GA4 như máy chủ MCP: thuộc tính, các dòng search analytics, truy vấn, trang và quốc gia hàng đầu, so sánh giữa các kỳ, thay đổi thứ hạng, thứ hạng mới và thứ hạng bị mất, suy giảm nội dung, cannibalisation, CTR benchmark, page poaching, kiểm tra URL, sitemap, chú thích, cùng phần tổng quan, phân tích theo chiều và sự kiện chính của GA4. Các truy vấn hàng đầu và trang hàng đầu trả về tối đa 1.000 dòng, quốc gia hàng đầu tối đa 300 dòng, và search-analytics tối đa 5.000 dòng thô cho một hoặc hai chiều. Số lệnh gọi bị giới hạn ở 60 lần mỗi phút cho mỗi khóa và 1.000 lần mỗi giờ cho mỗi tài khoản, và tài liệu OpenAPI 3.1 tại https://app.autopseo.com/v1/openapi.json mô tả mọi tham số.

Nên chọn cách nào

Nếu dashboard chủ yếu dùng để cho khách hàng xem số liệu, một liên kết báo cáo được chia sẻ hoặc một báo cáo Slack hoặc Teams theo lịch có thể đỡ tốn công hơn. Phần FAQ của chúng tôi về Search Console trong Looker Studio trình bày sâu hơn về trình kết nối của Google.