Bắt đầu

Tài liệu này dành cho những nhà phát triển muốn sử dụng API Quản lý AdSense để nắm bắt thông tin về tài khoản AdSense của họ. Tài liệu này giả định rằng bạn đã quen thuộc với các khái niệm lập trình web và định dạng dữ liệu web.

Trước khi bắt đầu

Nhận tài khoản AdSense

Hãy đăng ký hoặc đăng nhập vào tài khoản AdSense của bạn để bắt đầu.

Làm quen với AdSense

Nếu bạn chưa hiểu rõ các khái niệm về AdSense, hãy đọc thông tin giới thiệu về AdSense và thử nghiệm với Giao diện người dùng AdSense trước khi bắt đầu lập trình.

Chọn thư viện ứng dụng của bạn

Trên trang Thư viện ứng dụng và Mẫu, bạn sẽ tìm thấy thông tin về các thư viện và mẫu có sẵn. Nhấp vào thẻ cho ngôn ngữ bạn đã chọn và nhấp vào các đường liên kết để tải nguồn xuống. Thư viện ứng dụng sẽ xử lý những việc sau cho bạn:

  • xác thực
  • khám phá dịch vụ
  • tạo các yêu cầu đối với API
  • phân tích cú pháp phản hồi

Đọc hướng dẫn để cài đặt và định cấu hình thư viện ứng dụng bạn đã chọn, thường có trong tệp README trong thư mục gốc của kho lưu trữ.

Nếu quá trình triển khai có các nhu cầu đặc biệt, chẳng hạn như sử dụng ngôn ngữ không được hỗ trợ, bạn có thể thực hiện yêu cầu trực tiếp đến API thay vì sử dụng thư viện ứng dụng.

Đăng ký ứng dụng của bạn

Để sử dụng AdSense Management API, bạn phải đăng ký ứng dụng mà bạn đang phát triển bằng cách tạo một dự án và tạo một Mã ứng dụng khách.

Đăng ký ứng dụng

Chỉnh sửa các tệp cấu hình cho dự án thư viện ứng dụng bằng thông tin xác thực mới bạn vừa tạo. Hãy xem tài liệu về thư viện ứng dụng để biết thêm thông tin chi tiết.

Lưu ý: Tài khoản Google dùng để đăng ký phải là tài khoản nhà phát triển của bạn, tức là tài khoản mà bạn muốn người dùng ứng dụng của bạn xem với tư cách là nhà phát triển ứng dụng. Tài khoản này không cần phải liên kết với thông tin đăng nhập AdSense, vì người dùng sẽ cấp quyền truy cập vào tài khoản của họ trong khi sử dụng ứng dụng.

Hướng dẫn bắt đầu nhanh

Hãy làm theo các bước bên dưới để đưa ra yêu cầu đầu tiên. Xin lưu ý rằng các bước này có thể hơi khác nhau tuỳ thuộc vào thư viện hoặc ngôn ngữ bạn đang sử dụng:

  1. Hãy sử dụng mẫu thích hợp để truy xuất danh sách ứng dụng quảng cáo từ tài khoản AdSense. Yêu cầu này sẽ bắt đầu quy trình một lần, trong đó người dùng AdSense xác thực và uỷ quyền cho dự án của bạn.

    Khách hàng quảng cáo thể hiện mối liên kết giữa tài khoản AdSense và một sản phẩm AdSense, chẳng hạn như Quảng cáo nội dung hoặc Quảng cáo tìm kiếm. Một tài khoản AdSense có thể có một hoặc nhiều ứng dụng quảng cáo.

    1. Đối với ứng dụng web, người dùng sẽ được chuyển hướng đến một trang web mà họ có thể chọn cấp quyền truy cập. Sau khi được uỷ quyền, họ sẽ được chuyển hướng đến URL gọi lại được xác định trong bảng điều khiển API.
    2. Ứng dụng đã cài đặt hoạt động tương tự như nhau. Thư viện ứng dụng sẽ cố gắng mở một cửa sổ trình duyệt và sử dụng mã uỷ quyền. Đối với các ứng dụng Android, Chrome và iOS, phương thức này tuỳ theo nền tảng.
  2. Sử dụng trình khám phá API cho reports.generate để yêu cầu báo cáo sau:
    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS

    Báo cáo cung cấp cho bạn thông tin chi tiết về thu nhập của bạn cũng như những yếu tố có tác động đến các khoản thu nhập đó. Các quảng cáo này có thể chạy trên toàn bộ tài khoản hoặc trên một số đơn vị quảng cáo thông qua việc sử dụng các kênh.

  3. Thử yêu cầu báo cáo tương tự từ ứng dụng của bạn.
  4. Bạn có thể lọc báo cáo theo đơn vị quảng cáo. Tìm nạp danh sách đơn vị quảng cáo bằng adunits.list. Xin lưu ý rằng bạn cần có mã ứng dụng khách quảng cáo (lấy mã từ bước 1). Sau khi bạn chọn một đơn vị quảng cáo, hãy sử dụng mã của đơn vị quảng cáo đó trong thông số filter cho reports.generate:

    Đơn vị quảng cáo là phần giữ chỗ do người dùng định cấu hình cho quảng cáo, giúp xác định một số thuộc tính cho quảng cáo đang hiển thị (chẳng hạn như kích thước và hình dạng).

    • date_range: YESTERDAY
    • dimensions: DATE
    • metrics: ESTIMATED_EARNINGS
    • filter: AD_UNIT_ID==ca-pub-123456789:987654321
  5. Hãy thử lọc theo kênh tuỳ chỉnh hay kênh URL hoặc kết hợp nhiều bộ lọc.

    Kênh là công cụ cho phép bạn theo dõi hiệu quả hoạt động của một tập hợp con các đơn vị quảng cáo của bạn. Có hai loại kênh: URL và kênh tuỳ chỉnh. URL theo dõi cho phép bạn theo dõi hiệu suất trên một trang hoặc miền cụ thể, trong khi URL thứ hai giúp bạn theo dõi hiệu suất trên các nhóm đơn vị quảng cáo cụ thể do người dùng chọn.

Bạn đã sẵn sàng bắt đầu triển khai bằng cách khám phá các lệnh gọi và tài nguyên còn lại trong tài liệu tham khảo.