AdMob API를 사용하면 다음과 같은 미디에이션 그룹을 생성, 나열, 업데이트할 수 있습니다.
- 미디에이션 그룹 타겟팅 지정하기 여기에는 지역, 형식, 플랫폼, IDFA 타겟팅 등이 포함됩니다.
- 새 미디에이션 그룹 행 추가 기존 미디에이션 그룹에 추가
- 미디에이션 A/B 실험에 포함된 미디에이션 그룹과 미디에이션 그룹 행이 각 대안 A 또는 B에 속함
예
OAuth 2.0 사용자 인증 정보가 생성되면 AdMob API를 사용할 준비가 되었습니다. OAuth 2.0을 사용하여 액세스를 요청하려면 애플리케이션에 범위 정보도 필요합니다.
다음은 OAuth 2.0 범위 정보입니다.
| 범위 | 의미 |
|---|---|
https://www.googleapis.com/auth/admob.monetization |
AdMob 수익 창출 설정을 확인, 생성, 수정합니다. |
https://www.googleapis.com/auth/admob.readonly |
모든 AdMob 데이터 보기 여기에는 계정 정보, 인벤토리, 미디에이션 설정, 보고서 등의 데이터가 포함됩니다 결제나 캠페인 세부정보와 같은 민감한 정보는 포함되지 않습니다. |
만들기
미디에이션 그룹을 만들려면 미디에이션 그룹 타겟팅을 지정해야 합니다. 정보를 검색할 수 있습니다. 다음 예에서는 새 광고 단위 2개에 대한 Android 전면 광고용 미디에이션 그룹 미디에이션 그룹 1개 행이 InMobi 광고 소스를 만들 때 추가됩니다. 이 매개변수는 생성 시 기본적으로 추가될 예정이므로
아래의 코드 스니펫에서 pub-XXXXXXXXXXXXXXXX를 게시자로 바꿉니다.
ID를 입력합니다.
그런 다음 YYYYYYYYYY를 광고 단위의 마지막 10자리로 바꿉니다.
ID,
다음 형식으로 변환합니다.
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY
이 예에는 2개의 광고 단위가 있으므로 YYYYY11111는 첫 번째 광고를 나타냅니다.
단위 및 WWWWW11111를 첫 번째 광고 단위의 매핑에 전달합니다. YYYYY22222 및
WWWWW22222는 두 번째 광고 단위 및 광고 단위 매핑을 나타냅니다.
curl (명령줄)
WWWWWWWWWW를 광고 단위 매핑 ID로 바꿉니다. 광고 단위 매핑 ID
는
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"
}
}
}
목록
pub-XXXXXXXXXXXXXXXX을 게시자로 대체
ID를 클릭하여 미디에이션 그룹을 볼 수 있습니다.
curl (명령줄)
샘플 요청:
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)"
샘플 응답:
{ "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" } }, }] }
패치
필드의 목록은 다음과 같습니다. 마스크 미디에이션 그룹을 업데이트할 수 있습니다 의 항목과 같이 반복되는 필드에 대한 업데이트 기존 값을 새 값으로 완전히 대체합니다. 개별 항목 업데이트 키의 색인 생성을 통해 수행할 수 있습니다.
미디에이션 그룹 업데이트에 지원되는 필드 마스크는 다음과 같습니다.
targeting.adUnitIdsmediationGroupLines[mediationGroupLineId]mediationGroupLines[mediationGroupLineId].statemediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]
새 미디에이션 그룹 행으로 미디에이션 그룹을 업데이트하려면 고유한
mediationGroupLineId는 음수입니다. 기존 미디에이션을 업데이트하는 방법
행을 그룹화하려면 update_mask 및
페이로드를 전송합니다.
"updateMask" {
paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}
"mediationGroup" {
"mediationGroupLines": {
"123": {
"id": "123"
"adUnitMappings": {
"456": "newAdUnitMappingId"
}
}
}
}
curl (명령줄)
아래 예에서는 기존 미디에이션 그룹에 3개의 새로운 미디에이션 행을 추가합니다.
updateMask에 고유한 음수가 있는 미디에이션 그룹 행 3개가 포함됨
값을 자리표시자로 사용할 수 있습니다.
updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]
모든 URL은
URI (Uniform Resource Identifier) 사양에 의해 지정된 구문
따라서 updateMask는 다음과 같이 됩니다.
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
다음 예를 실행하려면 pub-XXXXXXXXXXXXXXXX를
게시자 ID와 ZZZZZZZZZZ를 미디에이션 그룹 ID로 바꿉니다. 미디에이션
그룹 ID는 AdMob UI 또는 accounts.mediationGroups:list를 사용하여 확인할 수 있습니다.
메서드를 사용하여 축소하도록 요청합니다.
YYYYYYYYYY을(를) 광고 단위의 마지막 10자리로 바꿉니다.
ID로, 다음 형식을 따릅니다.
ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`
WWWWWWWWWW를 광고 단위 매핑 ID로 바꿉니다. 광고 단위 매핑 ID
는
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