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 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 mục hàng trong nhóm 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 đối với 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 AdMob API. Để 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 truy cập.

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 khoảng không quảng cáo và hoạt độ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 đơn vị quảng cáo đầu tiên:

curl (dòng lệnh)

Yêu cầu bằng cách sử dụ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 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 mặt cho bất kỳ tài khoản nào 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 đường dẫn đến tệp credentials.json mà bạn tải xuống khi đăng ký ứng dụng đám mây. Trong lần chạy đầu tiên, lệnh này sẽ hướng dẫn bạn thực hiện 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 để 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 cho đơn vị quảng cáo.

    Thay thế YYYYYYYYYY bằng đoạn mã đơn vị quảng cáo của bạn. Đoạn mã nhận dạng đơ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ã đơn vị quảng cáo của bạn. Đoạn mã nhận dạng đơ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",
     }
   }
}