Endpoint
GET/shops/{SHOP_ID}/ads_manager/ad_accountsDanh sách tài khoản quảng cáoGET/shops/{SHOP_ID}/ads_manager/campaigns_v2Danh sách chiến dịch quảng cáoGET/shops/{SHOP_ID}/ads_manager/ad_sets_v2Danh sách nhóm quảng cáoGET/shops/{SHOP_ID}/ads_manager/ads_v2Danh sách quảng cáoDanh sách tài khoản quảng cáo
GET
/shops/{SHOP_ID}/ads_manager/ad_accountsLấy danh sách tài khoản quảng cáo
Tham số đường dẫn
SHOP_IDintegerbắt buộcMã shop
Tham số truy vấn
pageintegerSố trang
page_sizeintegerSố bản ghi mỗi trang
Phản hồi
AdAccountDanh sách tài khoản quảng cáo
successbooleanTrạng thái thành công
dataarray<object>Danh sách tài khoản quảng cáo
page_numberintegerTrang hiện tại
page_sizeintegerSố bản ghi mỗi trang
total_entriesintegerTổng số tài khoản quảng cáo
total_pagesintegerTổng số trang
Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/ads_manager/ad_accounts?api_key=API_KEY"Phản hồi 200
{
"success": true,
"data": [
{
"id": "786374497414442",
"name": "Jen Nhung",
"account_status": 1,
"currency": "VND",
"is_business": false,
"sync_succeed_at": "2026-05-21T02:00:10",
"tags": [
"thẻ 2"
]
}
],
"page_number": 1,
"page_size": 30,
"total_entries": 14,
"total_pages": 1
}Danh sách chiến dịch quảng cáo
GET
/shops/{SHOP_ID}/ads_manager/campaigns_v2Lấy danh sách chiến dịch quảng cáo
Tham số đường dẫn
SHOP_IDintegerbắt buộcMã shop
Tham số truy vấn
pageintegerSố trang
page_sizeintegerSố bản ghi mỗi trang
start_timeinteger · int64Thời gian bắt đầu thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp từ thời điểm này.
end_timeinteger · int64Thời gian kết thúc thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp đến thời điểm này.
select_fieldsstringDanh sách các trường trong insights cần trả về, phân cách bằng dấu phẩy. Khi truyền tham số này, chỉ các trường được chỉ định mới xuất hiện trong insights.
Hiệu quả
ad_performance_session— Hiệu quảspend— Số tiền đã chi tiêureach— Số người tiếp cận Trải nghiệm tức thìimpressions— Lượt hiển thịclicks— Số lần nhấp (tất cả)frequency— Tần suấtcpp— CPPcpm— CPMcpc— CPCctr— CTRcost_per_1000_accounts_center_reach— Chi phí trên mỗi 1000 tài khoản tiếp cậncost_per_result— Chi phí trên mỗi kết quảavg_purchase_conversion_value— Giá trị chuyển đổi trung bình của lượt muaindicator_result— Kết quảresult_roas— Kết quả ROAS
Tương tác
ad_engagement_session— Tương táclink_click— Lượt click vào liên kếtlike— Lượt thích trên Facebookcomment— Bình luận về bài viếtpost_engagement— Lượt tương tác với bài viếtpost_reaction— Cảm xúc về bài viếtpost— Lượt chia sẻ bài viếtonsite_conversion_post_save— Lượt lưu bài viếtphoto_view— Lượt xem ảnhvideo_view— Lượt phát video trong tối thiểu 3 giâyinline_link_click_ctr— CTR (Tỷ lệ nhấp vào liên kết)outbound_click— Lượt click ra ngoàionsite_conversion_messaging_conversation_started_7d— Lượt bắt đầu cuộc trò chuyện qua tin nhắnonsite_conversion_messaging_first_reply— Người liên hệ nhắn tin mớionsite_conversion_messaging_block— Lượt chặnvideo_thruplay_watched_actions— ThruPlaysvideo_play_actions— Lượt phát videovideo_p25_watched_actions— Lượt phát 25% thời lượng videovideo_p50_watched_actions— Lượt phát 50% thời lượng videovideo_p75_watched_actions— Lượt phát 75% thời lượng videovideo_p95_watched_actions— Lượt phát 95% thời lượng videovideo_p100_watched_actions— Lượt phát 100% thời lượng videoestimated_ad_recallers— Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_outbound_click— Chi phí trên mỗi lượt click ra ngoàicost_per_thruplay— Chi phí trên mỗi lượt ThruPlayoutbound_clicks_ctr— CTR ra ngoài (Tỷ lệ nhấp)cost_per_post_engagement— Chi phí trên mỗi lượt tương tác với bài viếtestimated_ad_recall_rate— Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tínhcost_per_estimated_ad_recallers— Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_messaging_conversation_started— Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn
Chuyển đổi
Khách hàng tiềm năng
lead— Khách hàng tiềm năngwebsite_lead— Số khách hàng tiềm năng trên trang weboffline_lead— Số khách hàng tiềm năng offlinemeta_lead— Khách hàng tiềm năng trên Metalead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năngwebsite_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng trên trang weboffline_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng offlinemeta_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng của Metacost_per_lead— Chi phí trên mỗi khách hàng tiềm năng
Lượt mua
omni_purchase— Lượt muainapp_omni_purchase— Lượt khách hàng trong ứng dụngwebsite_omni_purchase— Lượt mua trên weboffline_omni_purchase— Lượt mua hàng offlinemeta_omni_purchase— Lượt mua trên Metaomni_purchase_conversion_value— Giá trị chuyển đổi từ lượt muainapp_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua hàng trong ứng dụngwebsite_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên weboffline_omni_purchase_conversion_value— Giá trị chuyển đổi từ lượt mua hàng offlinemeta_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên Metacost_per_omni_purchase— Chi phí trên mỗi lượt mua
Lượt bắt đầu thanh toán
omni_initiated_checkout— Lượt bắt đầu thanh toáninapp_omni_initiated_checkout— Lượt bắt đầu thanh toán trên ứng dụng di độngwebsite_omni_initiated_checkout— Lượt bắt đầu thanh toán trên weboffline_omni_initiated_checkout— Lượt bắt đầu thanh toán offlinemeta_omni_initiated_checkout— Lượt bắt đầu thanh toán trên Metaomni_initiated_checkout_conversion_value— Giá trị của chuyển đổi bắt đầu thanh toáninapp_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụngwebsite_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang weboffline_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toánmeta_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Metacost_per_omni_initiated_checkout— Chi phí trên mỗi lượt bắt đầu thanh toán
Lượt hoàn tất đăng ký
omni_complete_registration— Lượt hoàn tất đăng kýinapp_omni_complete_registration— Lượt hoàn tất đăng ký trên ứng dụng di độngwebsite_omni_complete_registration— Lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration— Lượt hoàn tất đăng ký offlineomni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng kýinapp_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụngwebsite_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký offlinecost_per_omni_complete_registration— Chi phí trên mỗi lượt hoàn tất đăng ký
Lượt xem nội dung
omni_view_content— Lượt xem nội dunginapp_omni_view_content— Lượt xem nội dung trong ứng dụngwebsite_omni_view_content— Lượt xem nội dung trên trang weboffline_omni_view_content— Lượt xem nội dung offlinemeta_omni_view_content— Lượt xem nội dung trên Metaomni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dunginapp_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụngwebsite_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên trang weboffline_omni_view_content_conversion_value— Giá trị chuyển đổi offline từ sự kiện xem nội dungmeta_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên Metacost_per_omni_view_content— Chi phí trên mỗi lượt xem nội dung
Tìm kiếm
omni_search— Tìm kiếminapp_omni_search— Lượt tìm kiếm trong ứng dụngwebsite_omni_search— Lượt tìm kiếm trên trang weboffline_omni_search— Lượt tìm kiếm offlineomni_search_conversion_value— Giá trị chuyển đổi của tìm kiếminapp_omni_search_conversion_value— Giá trị chuyển đổi tìm kiếm ứng dụng di độngwebsite_omni_search_conversion_value— Giá trị chuyển đổi của tìm kiếm trên trang weboffline_omni_search_conversion_value— Giá trị chuyển đổi từ lượt tìm kiếm offlinecost_per_omni_search— Chi phí trên mỗi lượt tìm kiếm
Lượt thêm vào giỏ hàng
omni_add_to_cart— Lượt thêm vào giỏ hànginapp_omni_add_to_cart— Lượt thêm vào giỏ hàng trong ứng dụngwebsite_omni_add_to_cart— Lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart— Lượt thêm vào giỏ hàng offlinemeta_omni_add_to_cart— Lượt thêm vào giỏ hàng trên Metaomni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hànginapp_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàngwebsite_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart_conversion_value— Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàngmeta_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Metacost_per_omni_add_to_cart— Chi phí trên mỗi lượt thêm vào giỏ hàng
Thêm vào danh sách mong ước
omni_add_to_wishlist— Thêm vào danh sách mong ướcinapp_omni_add_to_wishlist— Thêm vào danh sách mong ước trong ứng dụng di độngwebsite_omni_add_to_wishlist— Thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist— Thêm vào danh sách mong ước offlinemeta_omni_add_to_wishlist— Thêm vào danh sách mong ước trên Metaomni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ướcinapp_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụngwebsite_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ướcmeta_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Metacost_per_omni_add_to_wishlist— Chi phí trên mỗi lượt thêm vào danh sách mong ước
Lượt tuỳ chỉnh sản phẩm
customize_product_total— Lượt tuỳ chỉnh sản phẩminapp_customize_product_total— Lượt tuỳ chỉnh sản phẩm trong ứng dụng di độngwebsite_customize_product_total— Lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total— Lượt tuỳ chỉnh sản phẩm offlinecustomize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩminapp_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụngwebsite_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offlinecost_per_customize_product_total— Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm
Lượt bắt đầu dùng thử
start_trial_total— Lượt bắt đầu dùng thửinapp_start_trial_total— Lượt bắt đầu dùng thử trong ứng dụng di độngwebsite_start_trial_total— Lượt bắt đầu dùng thử trên trang weboffline_start_trial_total— Lượt bắt đầu dùng thử offlinestart_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thửinapp_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụngwebsite_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang weboffline_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử offlinecost_per_start_trial_total— Chi phí trên mỗi lượt bắt đầu dùng thử
Lượt đăng ký
subscribe_total— Lượt đăng kýinapp_subscribe_total— Lượt đăng ký trong ứng dụng di độngwebsite_subscribe_total— Lượt đăng ký trên trang weboffline_subscribe_total— Lượt đăng ký offlinesubscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng kýinapp_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trong ứng dụngwebsite_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trên trang weboffline_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký offlinecost_per_subscribe_total— Chi phí trên mỗi lượt đăng ký
Lượt gửi đơn
submit_application_total— Lượt gửi đơninapp_submit_application_total— Lượt gửi đơn trong ứng dụng di độngwebsite_submit_application_total— Lượt gửi đơn trên trang weboffline_submit_application_total— Lượt gửi đơn offlinemeta_submit_application_total— Lượt gửi đơn đăng ký trên Metasubmit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơninapp_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụngwebsite_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang weboffline_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký offlinemeta_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Metacost_per_submit_application_total— Chi phí trên mỗi lượt gửi đơn
Người liên hệ
contact_total— Người liên hệinapp_contact_total— Người liên hệ trong ứng dụng di độngwebsite_contact_total— Người liên hệ trên trang weboffline_contact_total— Người liên hệ offlinecontact_total_conversion_value— Giá trị chuyển đổi từ người liên hệinapp_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trong ứng dụngwebsite_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trên trang weboffline_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ offlinecost_per_contact_total— Chi phí trên mỗi lượt liên hệ
Số lượt xem trang đích
landing_page_view— Số lượt xem trang đíchinapp_landing_page_view— Lượt xem trang đích trong ứng dụngwebsite_landing_page_view— Lượt xem trang đích trên trang webcost_per_landing_page_view— Chi phí trên mỗi lượt xem trang đích
Đơn đặt hàng
order_created— Đơn đặt hàng đã tạoorder_shipped— Đơn đặt hàng đã vận chuyển
ROAS của lượt mua
purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt muainapp_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụngwebsite_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web
Phản hồi
CampaignListResponse
successbooleanTrạng thái thành công
dataarray<object>Danh sách chiến dịch
summaryobjectTổng hợp chỉ số hiệu suất của tất cả chiến dịch
page_numberintegerTrang hiện tại
page_sizeintegerSố bản ghi mỗi trang
total_entriesintegerTổng số chiến dịch
total_pagesintegerTổng số trang
Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/ads_manager/campaigns_v2?api_key=API_KEY"Phản hồi 200
{
"success": true,
"data": [
{
"id": "120239433707310738",
"name": "Chiến dịch Valentine 2026",
"status": "ACTIVE",
"effective_status": "ACTIVE",
"objective": "OUTCOME_TRAFFIC",
"created_time": "2026-02-02T10:00:29",
"start_time": "2026-02-02T16:00:00",
"end_time": "2026-02-03T16:00:00",
"marketer_id": null,
"product_id": "8d5e65f5-f1da-42bc-95b4-380f356388a9",
"product_category_id": null,
"ad_account": {
"id": "1427880307614733",
"name": "Quỳnh Dương",
"currency": "VND"
},
"insights": {
"ad_ids": [
"120239433707300738"
],
"impressions": 572,
"clicks": 14,
"reach": 512,
"spend": 59381,
"cpc": 4241.5,
"cpm": 103812.937063,
"cpp": 115978.515625,
"ctr": 2.44755244755245,
"frequency": 1.117188,
"order_statistics": [
{
"id": 0,
"order_count": 0
},
{
"id": 1,
"order_count": 0
}
]
}
}
],
"summary": {
"impressions": 11462,
"clicks": 19,
"reach": 11243,
"spend": 135140,
"cpc": 6827.631579,
"cpm": 11790.263479,
"cpp": 54927.700908,
"ctr": 0.165765137,
"frequency": 1.019478774
},
"page_number": 1,
"page_size": 30,
"total_entries": 3,
"total_pages": 1
}Danh sách nhóm quảng cáo
GET
/shops/{SHOP_ID}/ads_manager/ad_sets_v2Lấy danh sách nhóm quảng cáo
Tham số đường dẫn
SHOP_IDintegerbắt buộcMã shop
Tham số truy vấn
pageintegerSố trang
page_sizeintegerSố bản ghi mỗi trang
start_timeinteger · int64Thời gian bắt đầu thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp từ thời điểm này.
end_timeinteger · int64Thời gian kết thúc thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp đến thời điểm này.
select_fieldsstringDanh sách các trường trong insights cần trả về, phân cách bằng dấu phẩy. Khi truyền tham số này, chỉ các trường được chỉ định mới xuất hiện trong insights.
Hiệu quả
ad_performance_session— Hiệu quảspend— Số tiền đã chi tiêureach— Số người tiếp cận Trải nghiệm tức thìimpressions— Lượt hiển thịclicks— Số lần nhấp (tất cả)frequency— Tần suấtcpp— CPPcpm— CPMcpc— CPCctr— CTRcost_per_1000_accounts_center_reach— Chi phí trên mỗi 1000 tài khoản tiếp cậncost_per_result— Chi phí trên mỗi kết quảavg_purchase_conversion_value— Giá trị chuyển đổi trung bình của lượt muaindicator_result— Kết quảresult_roas— Kết quả ROAS
Tương tác
ad_engagement_session— Tương táclink_click— Lượt click vào liên kếtlike— Lượt thích trên Facebookcomment— Bình luận về bài viếtpost_engagement— Lượt tương tác với bài viếtpost_reaction— Cảm xúc về bài viếtpost— Lượt chia sẻ bài viếtonsite_conversion_post_save— Lượt lưu bài viếtphoto_view— Lượt xem ảnhvideo_view— Lượt phát video trong tối thiểu 3 giâyinline_link_click_ctr— CTR (Tỷ lệ nhấp vào liên kết)outbound_click— Lượt click ra ngoàionsite_conversion_messaging_conversation_started_7d— Lượt bắt đầu cuộc trò chuyện qua tin nhắnonsite_conversion_messaging_first_reply— Người liên hệ nhắn tin mớionsite_conversion_messaging_block— Lượt chặnvideo_thruplay_watched_actions— ThruPlaysvideo_play_actions— Lượt phát videovideo_p25_watched_actions— Lượt phát 25% thời lượng videovideo_p50_watched_actions— Lượt phát 50% thời lượng videovideo_p75_watched_actions— Lượt phát 75% thời lượng videovideo_p95_watched_actions— Lượt phát 95% thời lượng videovideo_p100_watched_actions— Lượt phát 100% thời lượng videoestimated_ad_recallers— Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_outbound_click— Chi phí trên mỗi lượt click ra ngoàicost_per_thruplay— Chi phí trên mỗi lượt ThruPlayoutbound_clicks_ctr— CTR ra ngoài (Tỷ lệ nhấp)cost_per_post_engagement— Chi phí trên mỗi lượt tương tác với bài viếtestimated_ad_recall_rate— Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tínhcost_per_estimated_ad_recallers— Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_messaging_conversation_started— Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn
Chuyển đổi
Khách hàng tiềm năng
lead— Khách hàng tiềm năngwebsite_lead— Số khách hàng tiềm năng trên trang weboffline_lead— Số khách hàng tiềm năng offlinemeta_lead— Khách hàng tiềm năng trên Metalead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năngwebsite_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng trên trang weboffline_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng offlinemeta_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng của Metacost_per_lead— Chi phí trên mỗi khách hàng tiềm năng
Lượt mua
omni_purchase— Lượt muainapp_omni_purchase— Lượt khách hàng trong ứng dụngwebsite_omni_purchase— Lượt mua trên weboffline_omni_purchase— Lượt mua hàng offlinemeta_omni_purchase— Lượt mua trên Metaomni_purchase_conversion_value— Giá trị chuyển đổi từ lượt muainapp_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua hàng trong ứng dụngwebsite_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên weboffline_omni_purchase_conversion_value— Giá trị chuyển đổi từ lượt mua hàng offlinemeta_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên Metacost_per_omni_purchase— Chi phí trên mỗi lượt mua
Lượt bắt đầu thanh toán
omni_initiated_checkout— Lượt bắt đầu thanh toáninapp_omni_initiated_checkout— Lượt bắt đầu thanh toán trên ứng dụng di độngwebsite_omni_initiated_checkout— Lượt bắt đầu thanh toán trên weboffline_omni_initiated_checkout— Lượt bắt đầu thanh toán offlinemeta_omni_initiated_checkout— Lượt bắt đầu thanh toán trên Metaomni_initiated_checkout_conversion_value— Giá trị của chuyển đổi bắt đầu thanh toáninapp_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụngwebsite_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang weboffline_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toánmeta_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Metacost_per_omni_initiated_checkout— Chi phí trên mỗi lượt bắt đầu thanh toán
Lượt hoàn tất đăng ký
omni_complete_registration— Lượt hoàn tất đăng kýinapp_omni_complete_registration— Lượt hoàn tất đăng ký trên ứng dụng di độngwebsite_omni_complete_registration— Lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration— Lượt hoàn tất đăng ký offlineomni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng kýinapp_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụngwebsite_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký offlinecost_per_omni_complete_registration— Chi phí trên mỗi lượt hoàn tất đăng ký
Lượt xem nội dung
omni_view_content— Lượt xem nội dunginapp_omni_view_content— Lượt xem nội dung trong ứng dụngwebsite_omni_view_content— Lượt xem nội dung trên trang weboffline_omni_view_content— Lượt xem nội dung offlinemeta_omni_view_content— Lượt xem nội dung trên Metaomni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dunginapp_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụngwebsite_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên trang weboffline_omni_view_content_conversion_value— Giá trị chuyển đổi offline từ sự kiện xem nội dungmeta_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên Metacost_per_omni_view_content— Chi phí trên mỗi lượt xem nội dung
Tìm kiếm
omni_search— Tìm kiếminapp_omni_search— Lượt tìm kiếm trong ứng dụngwebsite_omni_search— Lượt tìm kiếm trên trang weboffline_omni_search— Lượt tìm kiếm offlineomni_search_conversion_value— Giá trị chuyển đổi của tìm kiếminapp_omni_search_conversion_value— Giá trị chuyển đổi tìm kiếm ứng dụng di độngwebsite_omni_search_conversion_value— Giá trị chuyển đổi của tìm kiếm trên trang weboffline_omni_search_conversion_value— Giá trị chuyển đổi từ lượt tìm kiếm offlinecost_per_omni_search— Chi phí trên mỗi lượt tìm kiếm
Lượt thêm vào giỏ hàng
omni_add_to_cart— Lượt thêm vào giỏ hànginapp_omni_add_to_cart— Lượt thêm vào giỏ hàng trong ứng dụngwebsite_omni_add_to_cart— Lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart— Lượt thêm vào giỏ hàng offlinemeta_omni_add_to_cart— Lượt thêm vào giỏ hàng trên Metaomni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hànginapp_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàngwebsite_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart_conversion_value— Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàngmeta_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Metacost_per_omni_add_to_cart— Chi phí trên mỗi lượt thêm vào giỏ hàng
Thêm vào danh sách mong ước
omni_add_to_wishlist— Thêm vào danh sách mong ướcinapp_omni_add_to_wishlist— Thêm vào danh sách mong ước trong ứng dụng di độngwebsite_omni_add_to_wishlist— Thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist— Thêm vào danh sách mong ước offlinemeta_omni_add_to_wishlist— Thêm vào danh sách mong ước trên Metaomni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ướcinapp_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụngwebsite_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ướcmeta_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Metacost_per_omni_add_to_wishlist— Chi phí trên mỗi lượt thêm vào danh sách mong ước
Lượt tuỳ chỉnh sản phẩm
customize_product_total— Lượt tuỳ chỉnh sản phẩminapp_customize_product_total— Lượt tuỳ chỉnh sản phẩm trong ứng dụng di độngwebsite_customize_product_total— Lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total— Lượt tuỳ chỉnh sản phẩm offlinecustomize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩminapp_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụngwebsite_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offlinecost_per_customize_product_total— Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm
Lượt bắt đầu dùng thử
start_trial_total— Lượt bắt đầu dùng thửinapp_start_trial_total— Lượt bắt đầu dùng thử trong ứng dụng di độngwebsite_start_trial_total— Lượt bắt đầu dùng thử trên trang weboffline_start_trial_total— Lượt bắt đầu dùng thử offlinestart_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thửinapp_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụngwebsite_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang weboffline_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử offlinecost_per_start_trial_total— Chi phí trên mỗi lượt bắt đầu dùng thử
Lượt đăng ký
subscribe_total— Lượt đăng kýinapp_subscribe_total— Lượt đăng ký trong ứng dụng di độngwebsite_subscribe_total— Lượt đăng ký trên trang weboffline_subscribe_total— Lượt đăng ký offlinesubscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng kýinapp_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trong ứng dụngwebsite_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trên trang weboffline_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký offlinecost_per_subscribe_total— Chi phí trên mỗi lượt đăng ký
Lượt gửi đơn
submit_application_total— Lượt gửi đơninapp_submit_application_total— Lượt gửi đơn trong ứng dụng di độngwebsite_submit_application_total— Lượt gửi đơn trên trang weboffline_submit_application_total— Lượt gửi đơn offlinemeta_submit_application_total— Lượt gửi đơn đăng ký trên Metasubmit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơninapp_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụngwebsite_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang weboffline_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký offlinemeta_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Metacost_per_submit_application_total— Chi phí trên mỗi lượt gửi đơn
Người liên hệ
contact_total— Người liên hệinapp_contact_total— Người liên hệ trong ứng dụng di độngwebsite_contact_total— Người liên hệ trên trang weboffline_contact_total— Người liên hệ offlinecontact_total_conversion_value— Giá trị chuyển đổi từ người liên hệinapp_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trong ứng dụngwebsite_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trên trang weboffline_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ offlinecost_per_contact_total— Chi phí trên mỗi lượt liên hệ
Số lượt xem trang đích
landing_page_view— Số lượt xem trang đíchinapp_landing_page_view— Lượt xem trang đích trong ứng dụngwebsite_landing_page_view— Lượt xem trang đích trên trang webcost_per_landing_page_view— Chi phí trên mỗi lượt xem trang đích
Đơn đặt hàng
order_created— Đơn đặt hàng đã tạoorder_shipped— Đơn đặt hàng đã vận chuyển
ROAS của lượt mua
purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt muainapp_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụngwebsite_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web
Phản hồi
AdSetListResponse
successbooleanTrạng thái thành công
dataarray<object>Danh sách nhóm quảng cáo
summaryobjectTổng hợp chỉ số hiệu suất của tất cả nhóm quảng cáo
page_numberintegerTrang hiện tại
page_sizeintegerSố bản ghi mỗi trang
total_entriesintegerTổng số nhóm quảng cáo
total_pagesintegerTổng số trang
Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/ads_manager/ad_sets_v2?api_key=API_KEY"Phản hồi 200
{
"success": true,
"data": [
{
"id": "120239433707290738",
"name": "Nhóm nam giới",
"status": "ACTIVE",
"effective_status": "ACTIVE",
"created_time": "2026-02-02T10:00:30",
"start_time": "2026-02-02T16:00:00",
"end_time": "2026-02-03T16:00:00",
"bid_amount": 0,
"bid_strategy": null,
"billing_event": "IMPRESSIONS",
"daily_budget": 0,
"lifetime_budget": 0,
"destination_type": "FACEBOOK_PAGE",
"optimization_goal": "PROFILE_VISIT",
"marketer_id": null,
"product_id": null,
"product_category_id": null,
"ad_account": {
"id": "1427880307614733",
"name": "Quỳnh Dương",
"currency": "VND"
},
"ad_campaign": {
"id": "120239433707310738",
"name": "Chiến dịch Valentine 2026"
},
"insights": {
"ad_ids": [
"120239433707300738"
],
"impressions": 572,
"clicks": 14,
"reach": 512,
"spend": 59381,
"cpc": 4241.5,
"cpm": 103812.937063,
"cpp": 115978.515625,
"ctr": 2.44755244755245,
"frequency": 1.117188
},
"targeting": {
"age_min": 18,
"age_max": 65,
"age_range": [
18,
45
],
"genders": [
1
],
"device_platforms": [
"mobile",
"desktop"
],
"publisher_platforms": [
"facebook"
],
"facebook_positions": [
"feed",
"facebook_reels",
"story"
],
"locales": [
27
],
"geo_locations": {
"countries": [
"VN"
],
"location_types": [
"home",
"recent"
]
},
"flexible_spec": [
{
"interests": [
{
"id": "6003070856229",
"name": "Game (giải trí)"
}
],
"behaviors": [
{
"id": "6002714895372",
"name": "Frequent Travelers"
}
],
"life_events": [
{
"id": "6002714398172",
"name": "Newlywed (1 year)"
}
],
"relationship_statuses": [
2,
4,
3
]
}
],
"targeting_automation": {
"advantage_audience": 1
}
}
}
],
"summary": {
"impressions": 11462,
"clicks": 19,
"reach": 11243,
"spend": 135140,
"cpc": 6827.631579,
"cpm": 11790.263479,
"cpp": 54927.700908,
"ctr": 0.165765137,
"frequency": 1.019478774
},
"page_number": 1,
"page_size": 30,
"total_entries": 4,
"total_pages": 1
}Danh sách quảng cáo
GET
/shops/{SHOP_ID}/ads_manager/ads_v2Lấy danh sách quảng cáo
Tham số đường dẫn
SHOP_IDintegerbắt buộcMã shop
Tham số truy vấn
pageintegerSố trang
page_sizeintegerSố bản ghi mỗi trang
start_timeinteger · int64Thời gian bắt đầu thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp từ thời điểm này.
end_timeinteger · int64Thời gian kết thúc thống kê, dạng Unix timestamp (giây). Các chỉ số trong insights được tổng hợp đến thời điểm này.
select_fieldsstringDanh sách các trường trong insights cần trả về, phân cách bằng dấu phẩy. Khi truyền tham số này, chỉ các trường được chỉ định mới xuất hiện trong insights.
Hiệu quả
ad_performance_session— Hiệu quảspend— Số tiền đã chi tiêureach— Số người tiếp cận Trải nghiệm tức thìimpressions— Lượt hiển thịclicks— Số lần nhấp (tất cả)frequency— Tần suấtcpp— CPPcpm— CPMcpc— CPCctr— CTRcost_per_1000_accounts_center_reach— Chi phí trên mỗi 1000 tài khoản tiếp cậncost_per_result— Chi phí trên mỗi kết quảavg_purchase_conversion_value— Giá trị chuyển đổi trung bình của lượt muaindicator_result— Kết quảresult_roas— Kết quả ROAS
Tương tác
ad_engagement_session— Tương táclink_click— Lượt click vào liên kếtlike— Lượt thích trên Facebookcomment— Bình luận về bài viếtpost_engagement— Lượt tương tác với bài viếtpost_reaction— Cảm xúc về bài viếtpost— Lượt chia sẻ bài viếtonsite_conversion_post_save— Lượt lưu bài viếtphoto_view— Lượt xem ảnhvideo_view— Lượt phát video trong tối thiểu 3 giâyinline_link_click_ctr— CTR (Tỷ lệ nhấp vào liên kết)outbound_click— Lượt click ra ngoàionsite_conversion_messaging_conversation_started_7d— Lượt bắt đầu cuộc trò chuyện qua tin nhắnonsite_conversion_messaging_first_reply— Người liên hệ nhắn tin mớionsite_conversion_messaging_block— Lượt chặnvideo_thruplay_watched_actions— ThruPlaysvideo_play_actions— Lượt phát videovideo_p25_watched_actions— Lượt phát 25% thời lượng videovideo_p50_watched_actions— Lượt phát 50% thời lượng videovideo_p75_watched_actions— Lượt phát 75% thời lượng videovideo_p95_watched_actions— Lượt phát 95% thời lượng videovideo_p100_watched_actions— Lượt phát 100% thời lượng videoestimated_ad_recallers— Độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_outbound_click— Chi phí trên mỗi lượt click ra ngoàicost_per_thruplay— Chi phí trên mỗi lượt ThruPlayoutbound_clicks_ctr— CTR ra ngoài (Tỷ lệ nhấp)cost_per_post_engagement— Chi phí trên mỗi lượt tương tác với bài viếtestimated_ad_recall_rate— Tỷ lệ độ cải thiện khả năng nhớ đến quảng cáo theo ước tínhcost_per_estimated_ad_recallers— Chi phí trên độ cải thiện khả năng nhớ đến quảng cáo theo ước tính (Người)cost_per_messaging_conversation_started— Chi phí trên mỗi lượt bắt đầu cuộc trò chuyện qua tin nhắn
Chuyển đổi
Khách hàng tiềm năng
lead— Khách hàng tiềm năngwebsite_lead— Số khách hàng tiềm năng trên trang weboffline_lead— Số khách hàng tiềm năng offlinemeta_lead— Khách hàng tiềm năng trên Metalead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năngwebsite_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng trên trang weboffline_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng offlinemeta_lead_conversion_value— Giá trị chuyển đổi khách hàng tiềm năng của Metacost_per_lead— Chi phí trên mỗi khách hàng tiềm năng
Lượt mua
omni_purchase— Lượt muainapp_omni_purchase— Lượt khách hàng trong ứng dụngwebsite_omni_purchase— Lượt mua trên weboffline_omni_purchase— Lượt mua hàng offlinemeta_omni_purchase— Lượt mua trên Metaomni_purchase_conversion_value— Giá trị chuyển đổi từ lượt muainapp_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua hàng trong ứng dụngwebsite_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên weboffline_omni_purchase_conversion_value— Giá trị chuyển đổi từ lượt mua hàng offlinemeta_omni_purchase_conversion_value— Giá trị chuyển đổi của lượt mua trên Metacost_per_omni_purchase— Chi phí trên mỗi lượt mua
Lượt bắt đầu thanh toán
omni_initiated_checkout— Lượt bắt đầu thanh toáninapp_omni_initiated_checkout— Lượt bắt đầu thanh toán trên ứng dụng di độngwebsite_omni_initiated_checkout— Lượt bắt đầu thanh toán trên weboffline_omni_initiated_checkout— Lượt bắt đầu thanh toán offlinemeta_omni_initiated_checkout— Lượt bắt đầu thanh toán trên Metaomni_initiated_checkout_conversion_value— Giá trị của chuyển đổi bắt đầu thanh toáninapp_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trong ứng dụngwebsite_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi của số lượt bắt đầu thanh toán trên trang weboffline_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi offline từ sự kiện bắt đầu thanh toánmeta_omni_initiated_checkout_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu thanh toán trên Metacost_per_omni_initiated_checkout— Chi phí trên mỗi lượt bắt đầu thanh toán
Lượt hoàn tất đăng ký
omni_complete_registration— Lượt hoàn tất đăng kýinapp_omni_complete_registration— Lượt hoàn tất đăng ký trên ứng dụng di độngwebsite_omni_complete_registration— Lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration— Lượt hoàn tất đăng ký offlineomni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng kýinapp_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trong ứng dụngwebsite_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký trên trang weboffline_omni_complete_registration_conversion_value— Giá trị chuyển đổi từ lượt hoàn tất đăng ký offlinecost_per_omni_complete_registration— Chi phí trên mỗi lượt hoàn tất đăng ký
Lượt xem nội dung
omni_view_content— Lượt xem nội dunginapp_omni_view_content— Lượt xem nội dung trong ứng dụngwebsite_omni_view_content— Lượt xem nội dung trên trang weboffline_omni_view_content— Lượt xem nội dung offlinemeta_omni_view_content— Lượt xem nội dung trên Metaomni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dunginapp_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trong ứng dụngwebsite_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên trang weboffline_omni_view_content_conversion_value— Giá trị chuyển đổi offline từ sự kiện xem nội dungmeta_omni_view_content_conversion_value— Giá trị chuyển đổi từ lượt xem nội dung trên Metacost_per_omni_view_content— Chi phí trên mỗi lượt xem nội dung
Tìm kiếm
omni_search— Tìm kiếminapp_omni_search— Lượt tìm kiếm trong ứng dụngwebsite_omni_search— Lượt tìm kiếm trên trang weboffline_omni_search— Lượt tìm kiếm offlineomni_search_conversion_value— Giá trị chuyển đổi của tìm kiếminapp_omni_search_conversion_value— Giá trị chuyển đổi tìm kiếm ứng dụng di độngwebsite_omni_search_conversion_value— Giá trị chuyển đổi của tìm kiếm trên trang weboffline_omni_search_conversion_value— Giá trị chuyển đổi từ lượt tìm kiếm offlinecost_per_omni_search— Chi phí trên mỗi lượt tìm kiếm
Lượt thêm vào giỏ hàng
omni_add_to_cart— Lượt thêm vào giỏ hànginapp_omni_add_to_cart— Lượt thêm vào giỏ hàng trong ứng dụngwebsite_omni_add_to_cart— Lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart— Lượt thêm vào giỏ hàng offlinemeta_omni_add_to_cart— Lượt thêm vào giỏ hàng trên Metaomni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hànginapp_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm ứng dụng vào giỏ hàngwebsite_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên trang weboffline_omni_add_to_cart_conversion_value— Giá trị chuyển đổi offline từ các lượt thêm vào giỏ hàngmeta_omni_add_to_cart_conversion_value— Giá trị chuyển đổi từ lượt thêm vào giỏ hàng trên Metacost_per_omni_add_to_cart— Chi phí trên mỗi lượt thêm vào giỏ hàng
Thêm vào danh sách mong ước
omni_add_to_wishlist— Thêm vào danh sách mong ướcinapp_omni_add_to_wishlist— Thêm vào danh sách mong ước trong ứng dụng di độngwebsite_omni_add_to_wishlist— Thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist— Thêm vào danh sách mong ước offlinemeta_omni_add_to_wishlist— Thêm vào danh sách mong ước trên Metaomni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ướcinapp_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trong ứng dụngwebsite_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên trang weboffline_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi offline từ lượt thêm vào danh sách mong ướcmeta_omni_add_to_wishlist_conversion_value— Giá trị chuyển đổi từ lượt thêm vào danh sách mong ước trên Metacost_per_omni_add_to_wishlist— Chi phí trên mỗi lượt thêm vào danh sách mong ước
Lượt tuỳ chỉnh sản phẩm
customize_product_total— Lượt tuỳ chỉnh sản phẩminapp_customize_product_total— Lượt tuỳ chỉnh sản phẩm trong ứng dụng di độngwebsite_customize_product_total— Lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total— Lượt tuỳ chỉnh sản phẩm offlinecustomize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩminapp_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trong ứng dụngwebsite_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm trên trang weboffline_customize_product_total_conversion_value— Giá trị chuyển đổi từ lượt tuỳ chỉnh sản phẩm offlinecost_per_customize_product_total— Chi phí trên mỗi lượt tuỳ chỉnh sản phẩm
Lượt bắt đầu dùng thử
start_trial_total— Lượt bắt đầu dùng thửinapp_start_trial_total— Lượt bắt đầu dùng thử trong ứng dụng di độngwebsite_start_trial_total— Lượt bắt đầu dùng thử trên trang weboffline_start_trial_total— Lượt bắt đầu dùng thử offlinestart_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thửinapp_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trong ứng dụngwebsite_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử trên trang weboffline_start_trial_total_conversion_value— Giá trị chuyển đổi từ lượt bắt đầu dùng thử offlinecost_per_start_trial_total— Chi phí trên mỗi lượt bắt đầu dùng thử
Lượt đăng ký
subscribe_total— Lượt đăng kýinapp_subscribe_total— Lượt đăng ký trong ứng dụng di độngwebsite_subscribe_total— Lượt đăng ký trên trang weboffline_subscribe_total— Lượt đăng ký offlinesubscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng kýinapp_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trong ứng dụngwebsite_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký trên trang weboffline_subscribe_total_conversion_value— Giá trị chuyển đổi từ lượt đăng ký offlinecost_per_subscribe_total— Chi phí trên mỗi lượt đăng ký
Lượt gửi đơn
submit_application_total— Lượt gửi đơninapp_submit_application_total— Lượt gửi đơn trong ứng dụng di độngwebsite_submit_application_total— Lượt gửi đơn trên trang weboffline_submit_application_total— Lượt gửi đơn offlinemeta_submit_application_total— Lượt gửi đơn đăng ký trên Metasubmit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơninapp_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trong ứng dụngwebsite_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên trang weboffline_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký offlinemeta_submit_application_total_conversion_value— Giá trị chuyển đổi từ lượt gửi đơn đăng ký trên Metacost_per_submit_application_total— Chi phí trên mỗi lượt gửi đơn
Người liên hệ
contact_total— Người liên hệinapp_contact_total— Người liên hệ trong ứng dụng di độngwebsite_contact_total— Người liên hệ trên trang weboffline_contact_total— Người liên hệ offlinecontact_total_conversion_value— Giá trị chuyển đổi từ người liên hệinapp_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trong ứng dụngwebsite_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ trên trang weboffline_contact_total_conversion_value— Giá trị chuyển đổi từ người liên hệ offlinecost_per_contact_total— Chi phí trên mỗi lượt liên hệ
Số lượt xem trang đích
landing_page_view— Số lượt xem trang đíchinapp_landing_page_view— Lượt xem trang đích trong ứng dụngwebsite_landing_page_view— Lượt xem trang đích trên trang webcost_per_landing_page_view— Chi phí trên mỗi lượt xem trang đích
Đơn đặt hàng
order_created— Đơn đặt hàng đã tạoorder_shipped— Đơn đặt hàng đã vận chuyển
ROAS của lượt mua
purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt muainapp_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trong ứng dụngwebsite_purchase_roas— ROAS (Lợi nhuận trên chi tiêu quảng cáo) của lượt mua trên trang web
Phản hồi
AdListResponse
successbooleanTrạng thái thành công
dataarray<object>Danh sách quảng cáo
summaryobjectTổng hợp chỉ số hiệu suất của tất cả quảng cáo
page_numberintegerTrang hiện tại
page_sizeintegerSố bản ghi mỗi trang
total_entriesintegerTổng số quảng cáo
total_pagesintegerTổng số trang
Yêu cầu
curl "https://pos.pages.fm/api/v1/shops/{SHOP_ID}/ads_manager/ads_v2?api_key=API_KEY"Phản hồi 200
{
"success": true,
"data": [
{
"id": "120238954106070738",
"name": "Quảng cáo sale nam giới",
"status": "ACTIVE",
"effective_status": "ACTIVE",
"created_time": "2026-01-21T09:12:15",
"marketer_id": null,
"product_id": null,
"product_category_id": null,
"ad_account": {
"id": "1427880307614733",
"name": "Quỳnh Dương",
"currency": "VND"
},
"ad_campaign": {
"id": "120238946624470738",
"name": "Chiến dịch siêu sale tháng 2/2026"
},
"ad_set": {
"id": "120238954106080738",
"name": "Nhóm nam giới"
},
"ad_creative": {
"id": "1175732824344796",
"name": "✨ CƠ HỘI DUY NHẤT ĐỂ SỞ HỮU TRANG SỨC NIMORA VỚI ƯU ĐÃI ĐẾN 70% ✨",
"object_story_id": "926757717191948_122108102433202138",
"object_story_spec": null
},
"insights": {
"ad_ids": [
"120238954106070738"
],
"impressions": 8252,
"clicks": 4,
"reach": 8121,
"spend": 57381,
"cpc": 14345.25000025,
"cpm": 6953.58700888221,
"cpp": 7078.91138298451,
"ctr": 0.0484730974309258,
"frequency": 1.011012
}
}
],
"summary": {
"impressions": 11462,
"clicks": 19,
"reach": 11243,
"spend": 135140,
"cpc": 6827.631579,
"cpm": 11790.263479,
"cpp": 54927.700908,
"ctr": 0.165765137,
"frequency": 1.019478774
},
"page_number": 1,
"page_size": 30,
"total_entries": 4,
"total_pages": 1
}