{ "url": "https://ads.hecigo.com/changelog", "updated": "2026-10-19", "updates": [ { "id": "2026-10-19-breakdown", "publishedAt": "2026-10-19T03:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-10-19-breakdown", "en": { "title": "ads_insights splits by age, gender and region", "summary": "On 19 October 2026 ads_insights gained breakdown: every row split by age, gender, age and gender together, country, region or city, one split per call, where the platform reports it.", "changes": [ "Support differs by platform. Meta: age, gender, age_gender, country, region (no city). Google: age and gender at level adset only, country, region and city at account, campaign and ad set level (not per ad), no age_gender. TikTok: age, gender, age_gender, country, region (region is TikTok's province id, with no name), no city. A platform that cannot give the split is left out with a note, or the call is refused naming what each reports. This is the support each platform documents; naming and columns vary by platform and account (TikTok regions come as ids, and Meta region names repeat across countries).", "Each row carries segment (the dimension, the platform's value and a label when the platform gives a name). Spend, impressions, clicks and conversions add up across segments; reach, frequency and people counts are exact for each segment but do not add up to unique people.", "The figures are aggregates read from the platform when asked, and are not stored. At most 1000 rows per account are kept. When there are more, the answer carries truncated: true, and a note says whether the count is exact or a minimum and how the kept rows were chosen. Not combinable with byDay; compare=true reads both periods by segment, and a segment value that repeats within a period (region names repeat across countries) is listed without a change.", "A platform may leave some columns out of a split (Meta, for results and some people counts, for one); such a column reads as not reported, never zero. A value the connector cannot map is listed in a note." ], "refresh": "Connections opened before 19 October 2026 show the new parameter after a refresh of the tool list." }, "vi": { "title": "ads_insights tách theo tuổi, giới tính và vùng", "summary": "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.", "changes": [ "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ú." ], "refresh": "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ụ." } }, { "id": "2026-10-14-google-analytics", "publishedAt": "2026-10-14T03:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-10-14-google-analytics", "en": { "title": "Google Analytics 4 for every workspace", "summary": "On 14 October 2026 Google verified hecigo's app for analytics.readonly, so Google Analytics 4 connects from https://ads.hecigo.com/portal in every workspace (analytics_report, search_traffic_reconcile).", "changes": [ "Google Analytics connects on its own, with read-only access, separately from Google Ads and Search Console. Google no longer shows its unverified-app screen.", "analytics_report returns what happened on the site after the click: sessions, users, engagement, key events and revenue by channel, source, campaign, landing page, device or date, with sampling and thresholding said out loud.", "search_traffic_reconcile puts Google organic sessions in GA4 next to Search Console clicks, by host and page, each gap with its likely causes.", "analytics_properties lists the GA4 properties next to the Search Console sites." ], "refresh": "Connections opened before 14 October 2026 show the new tools after a refresh of the tool list (claude.ai: Customize › Connectors › Ads Insights › ⋮ › Refresh tools list, then a new conversation; other assistants: the connector turned off and on)." }, "vi": { "title": "Google Analytics 4 mở cho mọi workspace", "summary": "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).", "changes": [ "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." ], "refresh": "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)." } }, { "id": "2026-10-11-search-console-video", "publishedAt": "2026-10-11T05:10:00Z", "url": "https://ads.hecigo.com/changelog#2026-10-11-search-console-video", "en": { "title": "Google Search Console and video metrics", "summary": "On 11 October 2026 hecigo Ads Insights added Google Search Console (search_console_report, analytics_properties) and video metrics in ads_insights.", "changes": [ "Google Search Console connects on its own from https://ads.hecigo.com/portal, with read-only access. search_console_report returns organic Google searches before a visit: clicks, impressions, CTR and position by query, page, country, device or date, with site totals that include the queries Google withholds. analytics_properties lists the connected sites.", "ads_insights returns video metrics: video_views (Google TrueView views, Meta ThruPlays, TikTok 6-second views), trueview_views, thruplays, video_views_2s, video_views_3s, video_views_6s, video_views_30s, video_plays, video_view_rate, the cost per each kind of view, video_p25 to video_p100 with their rates, and average watch time.", "Report tables print campaign, ad and page names in full instead of cutting them." ], "refresh": "Connections opened before 11 October 2026 show the new tools after a refresh of the tool list (claude.ai: Customize › Connectors › Ads Insights › ⋮ › Refresh tools list, then a new conversation; other assistants: the connector turned off and on)." }, "vi": { "title": "Google Search Console và chỉ số video", "summary": "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.", "changes": [ "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." ], "refresh": "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)." } }, { "id": "2026-09-24-messaging-contacts", "publishedAt": "2026-09-24T03:24:00Z", "url": "https://ads.hecigo.com/changelog#2026-09-24-messaging-contacts", "en": { "title": "Meta messaging counted in people", "summary": "On 24 September 2026 Meta messaging in ads_insights became a count of people, the way Ads Manager shows it.", "changes": [ "New metrics: new_messaging_contacts, returning_messaging_contacts, messaging_contacts and cost_per_new_messaging_contact. People do not add up across days, so these are read for the whole range in one query.", "Meta answers carry a glossary of the action names in conversionBreakdown, in Ads Manager's words.", "actionTypes reads any other Meta action by name, and metaFields any Ads Insights field." ], "refresh": "Connections opened before 24 September 2026 show the new parameters after a refresh of the tool list." }, "vi": { "title": "Tin nhắn Meta tính theo người", "summary": "Ngày 24/09/2026 tin nhắn Meta trong ads_insights chuyển sang đếm theo người, như Ads Manager.", "changes": [ "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." ], "refresh": "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ụ." } }, { "id": "2026-09-23-meta-open", "publishedAt": "2026-09-23T09:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-09-23-meta-open", "en": { "title": "Meta Ads connects without help", "summary": "On 23 September 2026 Meta approved hecigo's app, so Meta Ads connects the same way as Google Ads and TikTok Ads: by the advertiser, on Meta's own consent screen, from https://ads.hecigo.com/portal.", "changes": [ "The permission granted is ads_read, which only reads.", "Before this, a Facebook account outside hecigo's own was refused with \"App not active\" and hecigo connected it by hand." ], "refresh": "" }, "vi": { "title": "Meta Ads tự nối được", "summary": "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.", "changes": [ "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." ], "refresh": "" } }, { "id": "2026-09-17-choose-accounts", "publishedAt": "2026-09-17T05:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-09-17-choose-accounts", "en": { "title": "Choose which ad accounts are read", "summary": "On 17 September 2026 the portal began listing every ad account each connection reaches, and the workspace chooses which ones are read, up to 10 per platform during the pilot.", "changes": [ "The list is in https://ads.hecigo.com/portal, under each connected platform.", "Answers say when some connected accounts are not read; that is a choice or the limit, not a connection error." ], "refresh": "" }, "vi": { "title": "Chọn tài khoản quảng cáo được đọc", "summary": "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ử.", "changes": [ "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." ], "refresh": "" } }, { "id": "2026-09-15-tiktok-google-open", "publishedAt": "2026-09-15T15:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-09-15-tiktok-google-open", "en": { "title": "TikTok Ads and Google Ads connect from the portal", "summary": "On 15 September 2026 TikTok Ads became connectable from the portal, and every workspace could connect Google Ads on its own once Google verified the app.", "changes": [ "Both connect on the platform's own consent screen; hecigo only reads them." ], "refresh": "" }, "vi": { "title": "TikTok Ads và Google Ads nối từ portal", "summary": "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.", "changes": [ "Cả hai nối trên màn hình đồng ý của chính nền tảng; hecigo chỉ đọc." ], "refresh": "" } }, { "id": "2026-09-13-search-terms", "publishedAt": "2026-09-13T20:00:00Z", "url": "https://ads.hecigo.com/changelog#2026-09-13-search-terms", "en": { "title": "Conversion value, campaign settings, search terms and Performance Max", "summary": "On 13 September 2026 ads_insights added conversion value and ROAS, and three tools were added: ads_settings, ads_search_terms and ads_asset_groups.", "changes": [ "ads_insights returns conversion value, ROAS and value per conversion, and takes metrics for extra columns: reach, frequency, cpm, conversion_rate, all conversions, view-through conversions and search impression share.", "ads_settings reads how campaigns and ad sets are set up: bidding strategy with its real target ROAS or CPA, budget, conversion goals, attribution windows, locations, languages, audiences and bid adjustments, plus each Google account's conversion actions.", "ads_search_terms reads Google search terms with spend and conversions, including terms that spent without converting, and Performance Max search categories.", "ads_asset_groups reads Performance Max asset groups with ad strength and results, every asset with its performance label, audience signals and search themes." ], "refresh": "Connections opened before 13 September 2026 show the new tools in a new conversation." }, "vi": { "title": "Giá trị chuyển đổi, cài đặt chiến dịch, từ khoá tìm kiếm và Performance Max", "summary": "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.", "changes": [ "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." ], "refresh": "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." } } ] }