Nhóm dàn xếp

API AdMob cho phép bạn tạo, liệt kê và cập nhật các nhóm dàn xếp, bao gồm:

  • Chỉ định tiêu chí nhắm mục tiêu theo nhóm dàn xếp bao gồm cả việc nhắm mục tiêu theo khu vực, định dạng, nền tảng và IDFA
  • Thêm các dòng nhóm dàn xếp mới cho một nhóm dàn xếp hiện có
  • Xem những nhóm dàn xếp nào là một phần của thử nghiệm A/B dàn xếp và những gì các dòng nhóm dàn xếp thuộc về từng biến thể: A hoặc B

Ví dụ

Khi tạo thông tin đăng nhập 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 sẽ cần thông tin về phạm vi.

Dưới đây là thông tin về phạm vi của 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. Quá trình này có thể bao gồm cả tài khoản thông tin, chế độ cài đặt khoảng không quảng cáo và dàn xếp, báo cáo và 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).

Tạo

Để tạo một nhóm dàn xếp, bạn phải chỉ định tiêu chí nhắm mục tiêu theo nhóm dàn xếp bao gồm cả đơn vị quảng cáo có liên quan. Ví dụ sau đây sẽ tạo một phương thức nhóm dàn xếp cho quảng cáo xen kẽ trên Android cho 2 đơn vị quảng cáo. Một nhóm dàn xếp sẽ được thêm vào lúc tạo nguồn quảng cáo GUID. Bạn không cần thêm mạng AdMob vì miền này sẽ được thêm tại thời điểm tạo theo mặc định.

Trong đoạn mã bên dưới, hãy thay thế pub-XXXXXXXXXXXXXXXX bằng nhà xuất bản của bạn Mã nhận dạng.

Sau đó, thay thế YYYYYYYYYY bằng 10 chữ số cuối của đơn vị quảng cáo của bạn Mã nhận dạng, đang tuân thủ sang định dạng:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Do có hai đơn vị quảng cáo trong ví dụ này, nên YYYYY11111 đề cập đến quảng cáo đầu tiên và WWWWW11111 đến mối liên kết của đơn vị quảng cáo đầu tiên. YYYYY22222 và WWWWW22222 là mối liên kết đơn vị quảng cáo và đơn vị quảng cáo thứ hai.

curl (dòng lệnh)

Thay thế WWWWWWWWWW bằng mã liên kết đơn vị quảng cáo của bạn. Mã liên kết đơn vị quảng cáo có thể được tìm thấy bằng cách sử dụng accounts.adUnits.adUnitMappings.list .

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

Danh sách

Thay thế pub-XXXXXXXXXXXXXXXX bằng nhà xuất bản của bạn Mã nhận dạng để xem các nhóm dàn xếp của mình.

curl (dòng lệnh)

Yêu cầu mẫu:

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

Câu trả lời mẫu:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

Bản vá

Dưới đây là danh sách trường khẩu trang để cập nhật nhóm dàn xếp. Nội dung cập nhật đối với các trường lặp lại, chẳng hạn như các mục trong một hãy thay thế hoàn toàn các giá trị hiện có bằng các giá trị mới. Nội dung cập nhật cho từng tài khoản các giá trị trong bản đồ có thể được thực hiện thông qua việc lập chỉ mục bằng khoá.

Các mặt nạ trường sau đây được hỗ trợ cho nội dung cập nhật về nhóm dàn xếp:

  • targeting.adUnitIds
  • mediationGroupLines[mediationGroupLineId]
  • mediationGroupLines[mediationGroupLineId].state
  • mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

Để cập nhật một nhóm dàn xếp bằng một dòng nhóm dàn xếp mới, hãy sử dụng một dòng số âm của mediationGroupLineId. Cách cập nhật tính năng dàn xếp hiện tại nhóm dàn xếp, hãy tham chiếu đến mã dòng của nhóm dàn xếp trong cả update_mask và tải trọng như bên dưới.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl (dòng lệnh)

Ví dụ dưới đây thêm 3 dòng dàn xếp mới vào một nhóm dàn xếp hiện có. updateMask bao gồm 3 dòng nhóm dàn xếp có phủ định riêng biệt làm trình giữ chỗ:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

Bạn cần dịch các ký tự đặc biệt vì tất cả các URL cần phải tuân theo cú pháp do thông số kỹ thuật Giá trị nhận dạng tài nguyên thống nhất (URI) chỉ định, để updateMask trở thành:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

Để chạy ví dụ sau, hãy thay thế pub-XXXXXXXXXXXXXXXX bằng mã nhà xuất bản và ZZZZZZZZZZ cùng với mã nhóm dàn xếp của bạn. Dàn xếp Bạn có thể tìm thấy mã nhóm trong giao diện người dùng AdMob hoặc thông qua accounts.mediationGroups:list .

Thay thế YYYYYYYYYY bằng 10 chữ số cuối của đơn vị quảng cáo của bạn ID, theo định dạng:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Thay thế WWWWWWWWWW bằng mã liên kết đơn vị quảng cáo của bạn. Mã liên kết đơn vị quảng cáo có thể được tìm thấy bằng cách sử dụng accounts.adUnits.adUnitMappings.list .

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF