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à các 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ị quảng cáo đó đưa ra yêu cầu quảng cáo cho một mạng quảng cáo 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 thông số cho mỗi dòng nhóm dàn xếp dưới dạng chế độ cài đặt cho đơn vị quảng cáo đã chỉ định để tạo yêu cầu mạng quảng cáo 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 các 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 nhóm 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 các mối liên kết đó làm tham số khi tạo hoặc cập nhật 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 có 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, chế độ cài đặt về khoảng không quảng cáo cũng như 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 với đơn vị quảng cáo đầu tiên:

curl (dòng lệnh)

Yêu cầu sử dụng curl

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

    Vào 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 cấp phép trong trình duyệt. Trước khi chấp nhận, hãy đảm bảo bạn đã đăng nhập bằng một Tài khoản Google có quyền truy cập vào API AdMob. Ứng dụng của bạn sẽ được uỷ quyền truy cập vào dữ liệu thay mặt cho bất kỳ tài khoản nào hiện đã đă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 đường dẫn đến tệp credentials.json mà bạn tải xuống khi đăng ký ứng dụng trên đám mây. Trong lần chạy đầu tiên, lệnh này sẽ hướng dẫn bạn qua quy trình uỷ quyền OAuth 2.0. Các lần chạy tiếp theo sẽ tự động làm mới mã thông báo.

    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à xuất bản của bạn. Hãy 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 để nhận danh sách 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 trên 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 đơn vị quảng cáo.

    Thay thế YYYYYYYYYY bằng mảnh mã đơn vị quảng cáo. Phân đoạn mã đơn vị quảng cáo là 10 chữ số cuối 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 mảnh mã đơn vị quảng cáo. Mảnh 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",
     }
   }
}