Hướng Dẫn Sử Dụng API Thư Viện Quảng Cáo Facebook (Meta)

API Thư viện Quảng cáo Facebook/Meta mà chúng tôi gọi là API Thư viện Quảng cáo Facebook, là một giao diện công khai cho phép các nhà phát triển truy cập vào các quảng cáo được xuất bản trên Facebook, Instagram và các nền tảng khác thuộc sở hữu của Meta (ví dụ: Whatsapp và Threads). Thông qua API này, bạn có thể tìm kiếm quảng cáo theo từ khóa, ID trang, quốc gia hoặc loại quảng cáo, và truy xuất siêu dữ liệu như nội dung quảng cáo, phạm vi chi tiêu, số lần hiển thị, nền tảng xuất bản, và nhiều thông tin khác.

API này đặc biệt hữu ích cho nghiên cứu về tính minh bạch, kiểm toán tiếp thị, phân tích cạnh tranh, phân tích nội dung quảng cáo, hoặc xây dựng các công cụ xoay quanh dữ liệu quảng cáo trên mạng xã hội. Dù bạn muốn giám sát các quảng cáo đang hoạt động, nghiên cứu các quảng cáo chính trị hoặc vấn đề xã hội (quảng cáo SIEP), hay phân tích các chiến lược tiếp thị, API Thư viện Quảng cáo Facebook đều mang đến một cánh cửa mạnh mẽ dẫn vào dữ liệu quảng cáo.

Tại Sao Nên Sử Dụng API Thư Viện Quảng Cáo Facebook Và Nó Cho Phép Bạn Làm Gì?

Một số khả năng chính của API Thư viện Quảng cáo Facebook:

1. Tìm kiếm theo từ khóa, ID trang, quốc gia, loại quảng cáo — bạn có thể thu hẹp quảng cáo theo nội dung, người đặt quảng cáo, nơi chúng chạy và loại chiến dịch.
2. Lọc theo trạng thái: đang hoạt động/không hoạt động, phạm vi chi tiêu, số lần hiển thị — hữu ích khi bạn chỉ muốn các quảng cáo đang chạy hoặc những quảng cáo vượt/dưới các ngưỡng chi tiêu nhất định.
3. Truy xuất siêu dữ liệu quảng cáo — bao gồm các trường như page_name, ad_snapshot_url, spend, impressions, publisher_platforms (Facebook/Instagram) và nhiều hơn nữa.
4. Hỗ trợ phạm vi dữ liệu rộng và dài hạn — ví dụ, trên toàn cầu cho quảng cáo SIEP, và cho nhiều khu vực đối với quảng cáo chung (tùy thuộc vào chính sách khu vực của Meta tính đến năm 2025)
5. Truy cập miễn phí vào dữ liệu công khai — không có chi phí ban đầu để truy xuất dữ liệu quảng cáo công khai, miễn là bạn có thiết lập quyền truy cập phù hợp.

Tóm lại — API cung cấp một cách có cấu trúc, có thể lập trình để khám phá và thu thập dữ liệu quảng cáo ở quy mô lớn.

Hướng Dẫn Từng Bước: Cách Bắt Đầu Với API Thư Viện Quảng Cáo Facebook

Bước 1: Xác Minh Tài Khoản & Danh Tính Facebook/Meta Của Bạn

• Đăng nhập/tạo tài khoản Facebook của bạn (cá nhân hoặc doanh nghiệp).
• Đảm bảo tài khoản của bạn đã được xác minh (Meta đôi khi yêu cầu xác minh danh tính để truy cập API). (Xác minh tài khoản)
• Bước này đặc biệt quan trọng nếu bạn có kế hoạch yêu cầu quyền truy cập dữ liệu thư viện quảng cáo thông qua một ứng dụng.

Bước 2: Đăng Ký Ứng Dụng Nhà Phát Triển Meta

• Truy cập Meta for Developers → “Bắt đầu” và đăng nhập vào nền tảng. (Nhấn vào đây)

• Tạo một Ứng dụng mới: chọn “Khác” hoặc một loại chung nếu bạn không quảng cáo.

• Chọn rằng bạn muốn truy cập Marketing APIs / Thư viện Quảng cáo.

• Ban đầu, ứng dụng sẽ ở chế độ Phát triển — điều này đủ cho việc kiểm thử cơ bản và sử dụng ở quy mô nhỏ.

Bước 3: Tạo Mã Truy Cập (Access Token)

• Sử dụng Graph API Explorer hoặc các công cụ của Meta để tạo mã truy cập người dùng.
• Đảm bảo mã truy cập có các quyền cần thiết (ví dụ: ads_read, có thể là ads_archive hoặc các quyền khác tùy thuộc vào yêu cầu của Meta). (Facebook for Developers)

Lưu ý: mã truy cập sẽ hết hạn; bạn có thể cần gia hạn hoặc tạo mã truy cập có thời hạn dài tùy theo cách sử dụng của bạn.

Bước 4: Thực Hiện Cuộc Gọi API Đầu Tiên Của Bạn

Bạn có thể truy vấn điểm cuối /ads_archive (gốc của API Thư viện Quảng cáo). Sử dụng phiên bản API mới nhất (ví dụ: v23.0 hoặc mới hơn). (Facebook for Developers)

Ví dụ: **sử dụng curl**

curl -G \
  -d "search_terms=skincare" \
  -d "ad_reached_countries=['US']" \
  -d "ad_active_status=ACTIVE" \
  -d "fields=page_name,ad_snapshot_url,spend,impressions,publisher_platforms" \
  -d "access_token=YOUR_ACCESS_TOKEN" \
  "https://graph.facebook.com/v23.0/ads_archive"

Ví dụ: **sử dụng JavaScript (fetch)**

const response = await fetch(
  `https://graph.facebook.com/v23.0/ads_archive?` +
  `search_terms=skincare&ad_reached_countries=['US']&ad_active_status=ACTIVE` +
  `&fields=page_name,spend,impressions,publisher_platforms` +
  `&access_token=YOUR_ACCESS_TOKEN`
);
const data = await response.json();
console.log(data);

Phản hồi JSON sẽ bao gồm một mảng các đối tượng quảng cáo, mỗi đối tượng có siêu dữ liệu như page_name, ad_snapshot_url, phạm vi chi tiêu, phạm vi hiển thị, nền tảng xuất bản và có thể nhiều trường khác.

Bước 5: Xử Lý Phân Trang & Kết Quả Lớn

Vì Thư viện Quảng cáo có thể trả về nhiều kết quả, API sử dụng phân trang. Hãy chuẩn bị để lặp qua các trang tiếp theo — kiểm tra phản hồi để tìm thẻ paging hoặc con trỏ và lặp lại tương ứng. Các nhà phát triển thường xây dựng các vòng lặp trong mã để tổng hợp các tập hợp kết quả lớn.

Bước 6: Các Trường Hợp Sử Dụng — Bạn Có Thể Làm Gì Với Dữ Liệu Này?

Dưới đây là các trường hợp sử dụng phổ biến:

1. Phân tích đối thủ cạnh tranh — truy xuất quảng cáo từ Trang Facebook của đối thủ (thông qua ID trang) để nghiên cứu nội dung sáng tạo, ước tính chi tiêu hoặc phạm vi nhắm mục tiêu của họ.
2. Giám sát & nghiên cứu xu hướng — theo dõi loại quảng cáo nào đang hoạt động theo từ khóa, khu vực, loại phương tiện hoặc loại quảng cáo (ví dụ: chính trị, nhà ở, vấn đề xã hội).
3. Bảng điều khiển thông tin tiếp thị — tổng hợp dữ liệu (phạm vi chi tiêu, số lần hiển thị, tần suất quảng cáo) và trực quan hóa theo thời gian hoặc trên các khu vực.
4. Phân tích / nguồn cảm hứng nội dung quảng cáo — tìm nạp và lưu trữ nội dung quảng cáo (URL hình ảnh/video) để lấy cảm hứng sản phẩm hoặc kiểm toán tuân thủ.
5. Nghiên cứu học thuật / minh bạch — sử dụng dữ liệu quảng cáo cho các nghiên cứu về quảng cáo chính trị, chiến dịch vấn đề xã hội hoặc xu hướng thị trường.

Các trường hợp sử dụng này làm nổi bật giá trị của việc có quyền truy cập dữ liệu quảng cáo một cách có cấu trúc và có thể lập trình.

Kiểm Thử API Thư Viện Quảng Cáo Facebook Bằng Apidog

Sử dụng Apidog làm môi trường kiểm thử cho API Thư viện Quảng cáo Facebook. Dưới đây là cách bắt đầu kiểm thử API của bạn trong Apidog:

1. Trong Apidog, tạo một điểm cuối API mới: đặt phương thức là GET, URL là https://graph.facebook.com/v23.0/ads_archive.

2. Trong phần thông số truy vấn, thêm các thông số như search_terms, ad_reached_countries, fields và access_token.

3. Nhấn “Gửi” — Apidog sẽ tìm nạp dữ liệu và hiển thị phản hồi JSON ở dạng có cấu trúc.

4. Bạn có thể thử nghiệm với nhiều tổ hợp tham số, kiểm tra phân trang và thậm chí lưu các phản hồi mẫu để làm tài liệu hoặc phân tích.

Cách tiếp cận này đặc biệt hữu ích cho việc khám phá dữ liệu quảng cáo nhanh chóng, kiểm tra các truy vấn tìm kiếm và xây dựng tích hợp mà không cần viết toàn bộ mã.

Các Câu Hỏi Thường Gặp

C1. Tôi có cần tài khoản Quảng cáo đặc biệt hay tài khoản doanh nghiệp để sử dụng API Thư viện Quảng cáo Facebook không?
Không — một tài khoản Meta đã được xác minh thường là đủ. Tuy nhiên, bạn phải đăng ký Ứng dụng Nhà phát triển Meta và lấy mã truy cập với các quyền phù hợp (ví dụ: ads_read, ads_archive). Một số người dùng cần hoàn tất xác minh danh tính để có quyền truy cập đầy đủ.

C2. Tôi có thể lấy dữ liệu cho bất kỳ quảng cáo nào (không chỉ quảng cáo chính trị hoặc vấn đề xã hội) không?
Có — API hỗ trợ quảng cáo chung (không chỉ SIEP). Bạn có thể sử dụng ad_type=all (hoặc bỏ qua bộ lọc) tùy thuộc vào khu vực và khả năng cung cấp quảng cáo.

C3. Tôi có thể truy xuất bao nhiêu quảng cáo trong một yêu cầu duy nhất?
Theo mặc định, API trả về một số lượng quảng cáo hạn chế cho mỗi yêu cầu (phân trang). Để truy xuất thêm, bạn cần lặp qua các trang bằng cách sử dụng con trỏ phân trang được cung cấp trong phản hồi.

C4. Tôi có thể truy cập nội dung quảng cáo (hình ảnh, video) thông qua API không?
Bạn sẽ nhận được ad_snapshot_url hoặc các trường tương tự liên kết đến bản xem trước nội dung quảng cáo. Tuy nhiên, Meta không phải lúc nào cũng cung cấp trực tiếp các tệp phương tiện — việc tìm nạp hình ảnh hoặc video thực tế có thể yêu cầu các bước bổ sung.

C5. Có cách nào để tự động hóa việc truy xuất dữ liệu và tránh các vấn đề hết hạn mã truy cập không?
Có — bạn có thể tạo mã truy cập có thời hạn dài trong các công cụ nhà phát triển Meta hoặc thiết lập một hệ thống backend định kỳ làm mới mã truy cập. Đối với việc truy xuất dữ liệu quy mô lớn, việc kết hợp quản lý mã truy cập với các vòng lặp phân trang là phổ biến. Luôn lưu trữ mã truy cập một cách an toàn.

Kết Luận

API Thư viện Quảng cáo Facebook (Meta) cung cấp một cổng truy cập mạnh mẽ, có cấu trúc vào dữ liệu quảng cáo — cho phép các nhà phát triển, nhà tiếp thị, nhà nghiên cứu và nhà phân tích tìm kiếm, thu thập và phân tích các chiến dịch quảng cáo trên các nền tảng của Meta một cách có lập trình. Bằng cách sử dụng nó, bạn có thể xây dựng bảng điều khiển, thực hiện phân tích cạnh tranh, tiến hành nghiên cứu về tính minh bạch hoặc tổng hợp nội dung quảng cáo ở quy mô lớn.

Bằng cách thiết lập một ứng dụng nhà phát triển Meta, lấy mã truy cập phù hợp và thực hiện các yêu cầu tới điểm cuối /ads_archive — tùy chọn kiểm thử thông qua các công cụ như Apidog — bạn có thể mở khóa một lượng lớn dữ liệu thư viện quảng cáo. Mặc dù có những hạn chế (quyền, giới hạn tốc độ, phân trang, truy xuất phương tiện), lợi ích thường lớn hơn công sức bỏ ra.

Đối với bất kỳ ai cần dữ liệu quảng cáo công khai từ Facebook/Meta — API Thư viện Quảng cáo là một lựa chọn có giá trị, chính thức và linh hoạt.