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

위치의 유니코드 국가/지역 코드(CLDR)입니다(예: 'US'). 이 미디에이션 그룹이 사용 가능한 모든 지역을 타겟팅하는 경우 설정 해제합니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#unicode_region_subtag를 참조하세요.

excludedRegionCodes[]

string

위치의 유니코드 국가/지역 코드(CLDR)입니다(예: 'US'). 이 미디에이션 그룹에서 어떤 지역도 제외하지 않는 경우 설정되지 않습니다.

idfaTargeting

enum (IdfaTargeting)

매개변수는 IDFA의 사용 가능 여부에 따라 광고 요청을 타겟팅하는 데 사용할 수 있습니다. '모두'로 설정하면 미디에이션 그룹이 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 미디에이션 그룹에 실행 중인 실험이 있습니다.
NOT_RUNNING 미디에이션 그룹에 '실행 중' 상태인 실험이 없습니다.

방법

create

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

list

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

patch

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