# Những gì đã đổi

Mỗi lần hecigo Ads Insights trả lời được thêm điều gì, nó được ghi ở đây. Trợ lý AI đã nối từ trước được báo một lần, ở cuối câu trả lời kế tiếp, kèm đường dẫn tới trang này.

## ads_insights tách theo tuổi, giới tính và vùng

19/10/2026 · https://ads.hecigo.com/changelog#2026-10-19-breakdown

Ngày 19/10/2026 ads_insights có thêm tham số breakdown: tách mỗi dòng theo tuổi, giới tính, tuổi và giới tính cùng lúc, quốc gia, vùng hoặc thành phố, mỗi lần một cách, ở nền tảng nào có báo cáo.

- Mỗi nền tảng hỗ trợ khác nhau. Meta: age, gender, age_gender, country, region (không có thành phố). Google: age và gender chỉ ở cấp nhóm quảng cáo (level adset), country, region và city ở mọi cấp, không có age_gender. TikTok: age, gender, age_gender, country, region (region là mã tỉnh của TikTok, không có tên), không có thành phố. Nền tảng không tách được thì bị bỏ ra kèm ghi chú, hoặc yêu cầu bị từ chối và nêu rõ mỗi nền tảng tách được gì. Đây là phần hỗ trợ theo tài liệu của từng nền tảng; cách đặt tên vùng và các cột có sẵn khác nhau theo nền tảng và tài khoản (vùng của TikTok là mã số, tên vùng của Meta lặp lại giữa các quốc gia).
- Mỗi dòng có segment (chiều tách, giá trị theo cách nền tảng gọi và nhãn khi nền tảng có tên). Chi tiêu, hiển thị, click và chuyển đổi cộng được qua các segment; phạm vi tiếp cận, tần suất và số người chính xác trong từng segment nhưng không cộng lại thành số người duy nhất.
- Số liệu là số tổng hợp đọc từ nền tảng lúc bạn hỏi, không lưu lại. Mỗi tài khoản giữ tối đa 1000 dòng. Khi có nhiều hơn, kết quả mang truncated: true và ghi chú nói số dòng là chính xác hay chỉ là mức tối thiểu, và các dòng giữ lại được chọn thế nào. Không dùng cùng byDay; compare=true đọc cả hai kỳ theo từng segment, dòng nào có giá trị segment lặp lại trong cùng một kỳ (tên vùng lặp lại giữa các quốc gia) thì được liệt kê riêng, không tính chênh lệch.
- Nền tảng có thể bỏ một số cột khi tách (Meta với results và một số số đếm người, chẳng hạn); cột đó đọc là chưa báo cáo, không bao giờ là 0. Giá trị mà connector không nhận ra được liệt kê trong ghi chú.

**Để Trợ lý AI thấy:** Kết nối mở trước 19/10/2026 thấy tham số mới sau khi làm mới danh sách công cụ.

## Google Analytics 4 mở cho mọi workspace

14/10/2026 · https://ads.hecigo.com/changelog#2026-10-14-google-analytics

Ngày 14/10/2026 Google xác minh app của hecigo cho quyền analytics.readonly, nên mọi workspace nối được Google Analytics 4 từ https://ads.hecigo.com/portal (analytics_report, search_traffic_reconcile).

- Google Analytics nối riêng, quyền chỉ đọc, tách khỏi Google Ads và Search Console. Google không còn hiện màn hình cảnh báo ứng dụng chưa xác minh.
- analytics_report trả chuyện gì xảy ra trên website sau cú click: phiên, người dùng, mức tương tác, sự kiện chính và doanh thu theo kênh, nguồn, chiến dịch, trang đích, thiết bị hoặc ngày, nói rõ khi Google lấy mẫu hay ẩn bớt số.
- search_traffic_reconcile đặt phiên tìm kiếm tự nhiên từ Google trong GA4 cạnh click trên Search Console, theo host và trang, kèm nguyên nhân có thể của từng khoảng lệch.
- analytics_properties liệt kê property GA4 cạnh các site Search Console.

**Để Trợ lý AI thấy:** Kết nối mở trước 14/10/2026 thấy công cụ mới sau khi làm mới danh sách công cụ (claude.ai: Customize › Connectors › Ads Insights › ⋮ › Refresh tools list, rồi mở cuộc trò chuyện mới; Trợ lý AI khác: tắt rồi bật lại connector).

## Google Search Console và chỉ số video

11/10/2026 · https://ads.hecigo.com/changelog#2026-10-11-search-console-video

Ngày 11/10/2026 hecigo Ads Insights thêm Google Search Console (search_console_report, analytics_properties) và chỉ số video trong ads_insights.

- Google Search Console nối riêng từ https://ads.hecigo.com/portal, quyền chỉ đọc. search_console_report trả người ta tìm gì trên Google trước khi vào website mà không qua quảng cáo: click, lượt hiển thị, CTR và vị trí theo từ khoá, trang, quốc gia, thiết bị hoặc ngày, kèm tổng toàn site gồm cả truy vấn Google giấu. analytics_properties liệt kê các site đã nối.
- ads_insights trả chỉ số video: video_views (lượt xem TrueView của Google, ThruPlay của Meta, lượt xem 6 giây của TikTok), trueview_views, thruplays, video_views_2s, video_views_3s, video_views_6s, video_views_30s, video_plays, video_view_rate, giá mỗi loại lượt xem, video_p25 đến video_p100 kèm tỷ lệ, và thời gian xem trung bình.
- Bảng số in đủ tên chiến dịch, quảng cáo và trang, không còn cắt ngắn.

**Để Trợ lý AI thấy:** Kết nối mở trước 11/10/2026 thấy công cụ mới sau khi làm mới danh sách công cụ (claude.ai: Customize › Connectors › Ads Insights › ⋮ › Refresh tools list, rồi mở cuộc trò chuyện mới; Trợ lý AI khác: tắt rồi bật lại connector).

## Tin nhắn Meta tính theo người

24/09/2026 · https://ads.hecigo.com/changelog#2026-09-24-messaging-contacts

Ngày 24/09/2026 tin nhắn Meta trong ads_insights chuyển sang đếm theo người, như Ads Manager.

- Chỉ số mới: new_messaging_contacts, returning_messaging_contacts, messaging_contacts và cost_per_new_messaging_contact. Số người không cộng dồn theo ngày, nên đọc cả khoảng trong một lần hỏi.
- Câu trả lời của Meta kèm bảng giải nghĩa tên hành động trong conversionBreakdown, theo cách gọi của Ads Manager.
- actionTypes đọc mọi hành động khác của Meta theo tên, metaFields đọc mọi trường Ads Insights.

**Để Trợ lý AI thấy:** Kết nối mở trước 24/09/2026 thấy tham số mới sau khi làm mới danh sách công cụ.

## Meta Ads tự nối được

23/09/2026 · https://ads.hecigo.com/changelog#2026-09-23-meta-open

Ngày 23/09/2026 Meta duyệt app của hecigo, nên Meta Ads nối như Google Ads và TikTok Ads: chính người quảng cáo nối, trên màn hình đồng ý của Meta, từ https://ads.hecigo.com/portal.

- Quyền được cấp là ads_read, chỉ đọc.
- Trước đó, tài khoản Facebook ngoài hecigo bị từ chối với lỗi "App not active" và hecigo phải nối giúp.

**Để Trợ lý AI thấy:** Không cần làm gì: danh sách công cụ không đổi.

## Chọn tài khoản quảng cáo được đọc

17/09/2026 · https://ads.hecigo.com/changelog#2026-09-17-choose-accounts

Ngày 17/09/2026 portal liệt kê mọi tài khoản quảng cáo mà mỗi kết nối thấy, và workspace chọn tài khoản nào được đọc, tối đa 10 tài khoản mỗi nền tảng trong giai đoạn thử.

- Danh sách nằm trong https://ads.hecigo.com/portal, dưới từng nền tảng đã nối.
- Câu trả lời nói rõ khi có tài khoản đã nối mà chưa đọc; đó là lựa chọn hoặc giới hạn, không phải lỗi kết nối.

**Để Trợ lý AI thấy:** Không cần làm gì: danh sách công cụ không đổi.

## TikTok Ads và Google Ads nối từ portal

15/09/2026 · https://ads.hecigo.com/changelog#2026-09-15-tiktok-google-open

Ngày 15/09/2026 TikTok Ads nối được từ portal, và mọi workspace tự nối được Google Ads sau khi Google xác minh app.

- Cả hai nối trên màn hình đồng ý của chính nền tảng; hecigo chỉ đọc.

**Để Trợ lý AI thấy:** Không cần làm gì: danh sách công cụ không đổi.

## Giá trị chuyển đổi, cài đặt chiến dịch, từ khoá tìm kiếm và Performance Max

13/09/2026 · https://ads.hecigo.com/changelog#2026-09-13-search-terms

Ngày 13/09/2026 ads_insights có giá trị chuyển đổi và ROAS, kèm ba công cụ mới: ads_settings, ads_search_terms và ads_asset_groups.

- ads_insights trả giá trị chuyển đổi, ROAS và giá trị mỗi chuyển đổi, và nhận metrics để thêm cột: reach, frequency, cpm, conversion_rate, mọi chuyển đổi, chuyển đổi xem qua và tỷ lệ hiển thị trên tìm kiếm.
- ads_settings đọc cách chiến dịch và nhóm quảng cáo được cài: chiến lược giá thầu với target ROAS hoặc CPA thật, ngân sách, mục tiêu chuyển đổi, cửa sổ ghi nhận, địa điểm, ngôn ngữ, tệp đối tượng và điều chỉnh giá thầu, kèm hành động chuyển đổi của từng tài khoản Google.
- ads_search_terms đọc từ khoá tìm kiếm Google kèm chi tiêu và chuyển đổi, gồm cả từ tiêu tiền mà không ra chuyển đổi, và nhóm tìm kiếm của Performance Max.
- ads_asset_groups đọc asset group của Performance Max với độ mạnh quảng cáo và kết quả, từng asset với nhãn hiệu suất, tín hiệu đối tượng và chủ đề tìm kiếm.

**Để Trợ lý AI thấy:** Kết nối mở trước 13/09/2026 thấy công cụ mới khi mở cuộc trò chuyện mới.

Bản cho máy đọc: [/changelog.json](/changelog.json) và [Markdown](/changelog.md?lang=vi).
