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

이 미디에이션 그룹에서 타겟팅하는 광고 형식입니다. 예: '배너', '네이티브'

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의 사용 가능 여부에 따라 광고 요청을 타겟팅하는 데 사용할 수 있습니다. 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 계정에서 지정된 미디에이션 그룹을 업데이트합니다.