REST Resource: accounts.mediationGroups

리소스: MediationGroup

AdMob 미디에이션 그룹을 설명합니다.

JSON 표현 
{
  "name": string,
  "mediationGroupId": string,
  "displayName": string,
  "targeting": {
    object (MediationGroupTargeting)
  },
  "state": enum (State),
  "mediationGroupLines": {
    string: {
      object (MediationGroupLine)
    },
    ...
  },
  "mediationAbExperimentState": enum (ExperimentState)
}
필드
name

string

이 미디에이션 그룹의 리소스 이름입니다. 형식은 accounts/{publisherId}/mediationGroups/{mediationGroupId}입니다. 예: accounts/pub-9876543210987654/mediationGroups/0123456789
mediationGroupId

string

미디에이션 그룹의 ID입니다. 예: '0123456789' 읽기 전용 속성입니다.
displayName

string

사용자가 제공한 미디에이션 그룹의 이름입니다. 허용되는 최대 길이는 120자(영문 기준)입니다.
targeting

object (MediationGroupTargeting)

이 미디에이션 그룹에서 타겟팅하는 기준(예: 광고 단위, 지리적 위치)의 집합입니다.
state

enum (State)

미디에이션 그룹의 상태입니다. 사용 설정된 미디에이션 그룹만 게재됩니다.
mediationGroupLines

map (key: string, value: object (MediationGroupLine))

이 미디에이션 그룹의 게재에 사용되는 미디에이션 라인입니다.

키는 미디에이션 그룹 라인의 ID입니다. 생성 시에는 고유한 음수 값을 자리표시자로 사용합니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
mediationAbExperimentState

enum (ExperimentState)

출력 전용입니다. 이 미디에이션 그룹에 속한 미디에이션 A/B 실험의 상태입니다.

MediationGroupTargeting

이 미디에이션 그룹에서 타겟팅하는 기준 세트입니다. 예를 들어 미디에이션 그룹은 특정 광고 단위 ID, 플랫폼, 형식, 지리적 위치를 타겟팅할 수 있습니다.

JSON 표현 
{
  "platform": string,
  "format": string,
  "adUnitIds": [
    string
  ],
  "targetedRegionCodes": [
    string
  ],
  "excludedRegionCodes": [
    string
  ],
  "idfaTargeting": enum (IdfaTargeting)
}
필드
platform

string

앱의 플랫폼을 설명합니다. 예: 'IOS', 'ANDROID'
format

string

이 미디에이션 그룹에서 타겟팅하는 광고 형식입니다. 예: 'BANNER', 'NATIVE'
adUnitIds[]

string

이 미디에이션 그룹에서 타겟팅하는 광고 단위입니다. 예: 'ca-app-pub-1234/8790'
targetedRegionCodes[]

string

위치를 나타내는 Unicode 국가/지역 코드(CLDR)입니다(예: 'US'). 이 미디에이션 그룹이 사용 가능한 모든 지역을 타겟팅하는 경우 설정되지 않습니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#unicode_region_subtag를 참고하세요.
excludedRegionCodes[]

string

위치를 나타내는 Unicode 국가/지역 코드(CLDR)입니다(예: 'US'). 이 미디에이션 그룹에서 제외된 지역이 없는 경우 설정되지 않습니다.
idfaTargeting

enum (IdfaTargeting)

이 매개변수는 IDFA의 사용 가능 여부에 따라 광고 요청을 타겟팅하는 데 사용할 수 있습니다. ALL로 설정하면 미디에이션 그룹이 IDFA 유무와 관계없이 모든 광고 요청에 적용됩니다. AVAILABLE로 설정하면 미디에이션 그룹이 IDFA가 있는 광고 요청에 적용됩니다. NOT_AVAILABLE로 설정하면 미디에이션 그룹이 IDFA가 없는 광고 요청에 적용됩니다. Android 기기에는 지정할 필요가 없습니다.

IdfaTargeting

iOS 기기의 IDFA 사용 가능 여부입니다.

열거형
IDFA_TARGETING_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
ALL IDFA 사용 가능 여부와 관계없이 모든 기기가 타겟팅됩니다.
AVAILABLE IDFA를 사용할 수 있는 기기만 타겟팅됩니다.
NOT_AVAILABLE IDFA를 사용할 수 없는 기기만 타겟팅됩니다.

주

미디에이션 그룹에 사용할 수 있는 상태 유형입니다.

열거형
STATE_UNSPECIFIED 설정되지 않은 필드의 기본값입니다. 사용하지 마세요.
ENABLED 미디에이션 그룹이 활성 상태이며 광고를 게재하거나 통계를 수집하는 데 사용됩니다.
DISABLED 미디에이션 그룹이 사용 중지되어 더 이상 광고를 게재하거나 통계를 수집하지 않습니다. 사용 중지된 미디에이션 그룹은 다시 사용 설정할 수 있습니다.

ExperimentState

미디에이션 그룹의 미디에이션 A/B 실험 상태입니다.

열거형
EXPERIMENT_STATE_UNSPECIFIED 설정되지 않은 필드의 기본값입니다. 사용하지 마세요.
RUNNING 미디에이션 그룹에 RUNNING 상태의 실험이 있습니다.
NOT_RUNNING 미디에이션 그룹에 '실행 중' 상태의 실험이 없습니다.

메서드

create

 특정 AdMob 계정에서 미디에이션 그룹을 만듭니다.

list

 지정된 AdMob 계정의 미디에이션 그룹을 나열합니다.

patch

 지정된 AdMob 계정에서 지정된 미디에이션 그룹을 업데이트합니다.