AdMob API 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ả tiêu chí nhắm mục tiêu theo khu vực, định dạng, nền tảng và giá trị nhận dạng cho nhà quảng cáo (IDFA)
- Thêm các dòng nhóm dàn xếp mới vào một nhóm dàn xếp hiện có
- Xem những nhóm dàn xếp nào thuộc một thử nghiệm A/B dàn xếp và những dòng nhóm dàn xếp nào thuộc mỗi biến thể: A hoặc B
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). |
Tạo
Để tạo một nhóm dàn xếp, bạn phải chỉ định thông tin tiêu chí nhắm mục tiêu của nhóm dàn xếp, bao gồm cả các đơn vị quảng cáo có liên quan. Ví dụ sau đây tạo một nhóm dàn xếp mới cho quảng cáo xen kẽ trên Android cho 2 đơn vị quảng cáo. Một dòng nhóm dàn xếp được thêm khi tạo cho nguồn quảng cáo InMobi. Bạn không cần thêm mạng AdMob vì mạng này sẽ được thêm theo mặc định khi bạn tạo nhóm dàn xếp.
Trong đoạn mã dưới đây, hãy thay thế pub-XXXXXXXXXXXXXXXX bằng mã nhận dạng nhà xuất bản của bạn.
Sau đó, hãy thay thế YYYYYYYYYY bằng 10 chữ số cuối của mã đơn vị quảng cáo, tuân thủ định dạng:
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY
Vì có 2 đơn vị quảng cáo trong ví dụ này, nên YYYYY11111 đề cập đến đơn vị quảng cáo đầu tiên và WWWWW11111 đề cập đến mối liên kết của đơn vị quảng cáo đầu tiên. YYYYY22222 và WWWWW22222 đề cập đến đơn vị quảng cáo và mối liên kết đơn vị quảng cáo thứ hai.
curl (dòng lệnh)
Thay thế WWWWWWWWWW bằng mã mối liên kết đơn vị quảng cáo. Bạn có thể tìm thấy mã liên kết đơn vị quảng cáo bằng phương thức 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 mã nhận dạng nhà xuất bản để xem các nhóm dàn xếp.
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)"
Phản hồ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á
Sau đây là danh sách mặt nạ trường để cập nhật một nhóm dàn xếp. Các nội dung cập nhật cho trường lặp lại, chẳng hạn như các mục trong danh sách, sẽ thay thế hoàn toàn các giá trị hiện có bằng các giá trị mới. Bạn có thể cập nhật từng giá trị trong một bản đồ thông qua việc lập chỉ mục theo khoá.
Các mặt nạ trường sau đây được hỗ trợ cho việc cập nhật nhóm dàn xếp:
targeting.adUnitIdsmediationGroupLines[mediationGroupLineId]mediationGroupLines[mediationGroupLineId].statemediationGroupLines[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 số âm riêng biệt cho mediationGroupLineId. Để cập nhật các dòng nhóm dàn xếp hiện có, hãy tham chiếu mã dòng nhóm dàn xếp trong cả update_mask và tải trọng như bạn thấy 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ụ bên dưới 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ó các giá trị phủ định riêng biệt làm phần 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ả URL đều phải tuân thủ cú pháp do quy cách Mã nhận dạng tài nguyên đồng nhất (URI) chỉ định, vì vậy updateMask sẽ 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 bằng mã nhóm dàn xếp của bạn. Bạn có thể tìm thấy mã nhóm dàn xếp trong giao diện người dùng AdMob hoặc bằng cách sử dụng phương thức accounts.mediationGroups:list.
Thay thế YYYYYYYYYY bằng 10 chữ số cuối cùng của mã đơn vị quảng cáo theo định dạng sau:
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`
Thay thế WWWWWWWWWW bằng mã mối liên kết đơn vị quảng cáo. Bạn có thể tìm thấy mã liên kết đơn vị quảng cáo bằng phương thức 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