Mối liên kết với đơn vị quảng cáo

Liên kết đơn vị quảng cáo là chế độ cài đặt cấu hình của bên thứ ba, liên kết với một đơn vị quảng cáo AdMob và cho phép đơn vị đó đưa ra yêu cầu quảng cáo cho một mạng quảng cáo của bên thứ ba.

Khi tạo một nhóm dàn xếp, mối liên kết đơn vị quảng cáo được dùng làm một tham số cho mỗi dòng dàn xếp dưới dạng chế độ cài đặt cho đơn vị quảng cáo được chỉ định để đưa ra yêu cầu mạng quảng cáo của bên thứ ba. Không giống như trên giao diện người dùng AdMob, bạn cần tạo mối liên kết đơn vị quảng cáo một cách độc lập bên ngoài các nhóm dàn xếp và dòng dàn xếp. Sau khi tạo, bạn có thể liệt kê tất cả mối liên kết đơn vị quảng cáo và sử dụng chúng làm tham số khi tạo hoặc cập nhật các dòng nhóm dàn xếp bằng mối liên kết đơn vị quảng cáo mới.

Ví dụ

Sau khi tạo thông tin xác thực OAuth 2.0, bạn đã sẵn sàng bắt đầu sử dụng API AdMob. Để yêu cầu quyền truy cập bằng OAuth 2.0, ứng dụng của bạn cũng cần thông tin về phạm vi.

Dưới đây là thông tin về phạm vi truy cập OAuth 2.0:

Phạm vi Ý nghĩa
https://www.googleapis.com/auth/admob.monetization Xem, tạo và chỉnh sửa các chế độ cài đặt kiếm tiền trong AdMob.
https://www.googleapis.com/auth/admob.readonly Xem tất cả dữ liệu AdMob. Dữ liệu này có thể bao gồm thông tin tài khoản, các chế độ cài đặt về khoảng không quảng cáo và chức năng dàn xếp, báo cáo và các dữ liệu khác. Tuy nhiên, nữ liệu này không bao gồm dữ liệu nhạy cảm (chẳng hạn như thông tin về thanh toán hoặc thông tin chiến dịch).

Bắt đầu tạo mối liên kết đầu tiên với đơn vị quảng cáo:

curl (dòng lệnh)

Yêu cầu bằng curl

  1. Tải tệp khoá bí mật của ứng dụng và tạo thông tin xác thực uỷ quyền.

    Trong lần đầu tiên thực hiện bước này, bạn sẽ được yêu cầu chấp nhận lời nhắc uỷ quyền trong trình duyệt. Trước khi chấp nhận, hãy đảm bảo rằng bạn đã đăng nhập bằng một Tài khoản Google có quyền truy cập vào AdMob API. Ứng dụng của bạn sẽ được uỷ quyền truy cập vào dữ liệu thay cho tài khoản hiện đang đăng nhập.

    Để xác thực và uỷ quyền, bạn nên sử dụng oauth2l, một công cụ dòng lệnh đơn giản để làm việc với Google OAuth 2.0. Cài đặt oauth2l và chạy lệnh bên dưới, thay thế path_to_credentials_json bằng một đường dẫn đến tệp credentials.json mà bạn tải xuống khi đăng ký ứng dụng đám mây. Khi bạn chạy lệnh này lần đầu tiên, bạn sẽ trải qua quy trình uỷ quyền OAuth 2.0. Mã thông báo sẽ được tự động làm mới ở những lần chạy sau.

    oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization

  2. Liệt kê các nguồn quảng cáo.

    Nhận thông tin về nguồn quảng cáo AdMob bằng cách thay thế pub-XXXXXXXXXXXXXXXX bằng mã nhận dạng nhà xuất bản của bạn. Xem hướng dẫn về cách tìm mã nhà xuất bản.

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Phản hồi mẫu:

    {
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

  3. Liệt kê các bộ chuyển đổi.

    Thay thế SSSSSSSSSSSSSSSSSSSS bằng mã nguồn quảng cáo cho các bộ chuyển đổi mà bạn quan tâm.

    Sử dụng lệnh sau để lấy danh sách các bộ chuyển đổi:

    curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    Phản hồi mẫu cho nguồn quảng cáo Mạng AdMob có mã 5450213213286189855:

    {
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

  4. Tạo mối liên kết với đơn vị quảng cáo.

    Thay thế YYYYYYYYYY bằng đoạn mã nhận dạng đơn vị quảng cáo của bạn. Đoạn mã mã đơn vị quảng cáo là 10 chữ số cuối cùng của mã đơn vị quảng cáo theo định dạng "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Xem hướng dẫn để tìm mã đơn vị quảng cáo.

    curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF

  5. Liệt kê tất cả mối liên kết đơn vị quảng cáo.

    Thay thế YYYYYYYYYY bằng đoạn mã nhận dạng đơn vị quảng cáo của bạn. Đoạn mã mã đơn vị quảng cáo là 10 chữ số cuối cùng của mã đơn vị quảng cáo theo định dạng "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". Xem hướng dẫn để tìm mã đơn vị quảng cáo.

     curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

    {
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}