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 để nhận 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

Đăng ký tài khoản AdSense

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

Làm quen với AdSense

Nếu bạn chưa hiểu rõ về các khái niệm của 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 viết mã.

Chọn thư viện ứng dụng

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ẻ tương ứng với ngôn ngữ bạn chọn và truy cập vào các đường liên kết để tải nguồn xuống. Thư viện ứng dụng 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 đến 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 mà 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ủa bạn có nhu cầu đặc biệt, chẳng hạn như sử dụng một ngôn ngữ không được hỗ trợ, thì bạn có thể đưa ra 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 API Quản lý AdSense, bạn phải đăng ký ứng dụng mà mình đ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 của bạn

Chỉnh sửa 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 mà 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 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 cấp quyền truy cập vào tài khoản của riêng 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 của bạn, xin lưu ý rằng các bước này có thể khác nhau đôi chút 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ừ mộ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 sẽ xác thực và uỷ quyền cho dự án của bạn.

    Ứng dụng quảng cáo đại diện cho mối liên kết giữa tài khoản AdSense và 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 các ứ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 cấp 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 của Google.
    2. Các ứng dụng đã cài đặt hoạt động tương tự như vậy. Thư viện ứng dụng sẽ cố mở một cửa sổ trình duyệt và dùng mã uỷ quyền. Đối với các ứng dụng Android, Chrome và iOS, phương thức này dành riêng cho từng nền tảng.
  2. Sử dụng Trình khám phá API của Google 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ố tác động đến các khoản thu nhập đó. Bạn có thể chạy những quảng cáo nà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. Hãy thử yêu cầu ứng dụng của bạn cung cấp cùng một báo cáo.
  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 cách sử dụ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ã này từ bước 1). Sau khi bạn chọn một đơn vị quảng cáo, hãy sử dụng mã đơ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, xác định một số thuộc tính cho quảng cáo sẽ 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 suất của một tập hợp con đơn vị quảng cáo. Có hai loại kênh: URL và kênh tuỳ chỉnh. Tùy chọn cài đặt trước giúp bạn theo dõi hiệu suất trên một trang hoặc miền cụ thể, trong khi phần sau 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 có thể 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.