REST Resource: advertisers.lineItems

리소스: LineItem

단일 광고 항목

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
입력란
name

string

출력 전용. 광고 항목의 리소스 이름입니다.
advertiserId

string (int64 format)

출력 전용. 광고 항목이 속한 광고주의 고유 ID입니다.
campaignId

string (int64 format)

출력 전용. 광고 항목이 속한 캠페인의 고유 ID입니다.
insertionOrderId

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. 광고 항목이 속한 게재 신청서의 고유 ID입니다.
lineItemId

string (int64 format)

출력 전용. 광고 항목의 고유 ID입니다. 시스템에서 할당합니다.
displayName

string

필수 항목입니다. 광고 항목의 표시 이름입니다.

UTF-8 형식으로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다.
lineItemType

enum (LineItemType)

필수 항목입니다. 변경할 수 없습니다. 광고 항목의 유형입니다.
entityStatus

enum (EntityStatus)

필수 항목입니다. 광고 항목이 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다.

  • lineItems.create 메서드의 경우 ENTITY_STATUS_DRAFT만 허용됩니다. 광고 항목을 활성화하려면 lineItems.patch 메서드를 사용하고 생성 후 상태를 ENTITY_STATUS_ACTIVE로 업데이트하세요.
  • 광고 항목은 다른 상태에서 ENTITY_STATUS_DRAFT 상태로 다시 변경할 수 없습니다.
  • 광고 항목의 상위 게재 신청서가 활성 상태가 아닌 경우 광고 항목은 자체 상태가 ENTITY_STATUS_ACTIVE이더라도 예산을 지출할 수 없습니다.
updateTime

string (Timestamp format)

출력 전용. 광고 항목이 마지막으로 업데이트된 타임스탬프입니다. 시스템에서 할당합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
partnerCosts[]

object (PartnerCost)

광고 항목과 연결된 파트너 비용입니다.

lineItems.create 메서드에 없거나 비어 있는 경우 새로 생성된 광고 항목은 상위 게재 신청서에서 파트너 비용을 상속합니다.
flight

object (LineItemFlight)

필수 항목입니다. 광고 항목 광고 게재 기간의 시작 및 종료 시간입니다.
budget

object (LineItemBudget)

필수 항목입니다. 광고 항목의 예산 할당 설정입니다.
pacing

object (Pacing)

필수 항목입니다. 광고 항목의 예산 지출 속도 설정입니다.
frequencyCap

object (FrequencyCap)

필수 항목입니다. 광고 항목의 노출 최대 게재빈도 설정입니다.

제한된 한도를 할당하는 경우 이 설정 객체의 maxImpressions 필드를 사용해야 합니다.
partnerRevenueModel

object (PartnerRevenueModel)

필수 항목입니다. 광고 항목의 파트너 수익 모델 설정입니다.
conversionCounting

object (ConversionCountingConfig)

광고 항목의 전환 추적 설정입니다.
creativeIds[]

string (int64 format)

광고 항목과 연결된 광고 소재의 ID입니다.
bidStrategy

object (BiddingStrategy)

필수 항목입니다. 광고 항목의 입찰 전략입니다.
integrationDetails

object (IntegrationDetails)

광고 항목의 통합 세부정보입니다.
targetingExpansion

object (TargetingExpansionConfig)

광고 항목의 타겟팅 최적화 설정입니다.

이 구성은 자동 입찰을 사용하고 대상 잠재고객 목록을 포함 타겟팅하는 디스플레이, 동영상 또는 오디오 광고 항목에만 적용됩니다.
warningMessages[]

enum (LineItemWarningMessage)

출력 전용. 광고 항목에서 생성된 경고 메시지 이러한 경고로 인해 광고 항목 저장이 차단되지는 않지만, 일부 경고는 광고 항목 실행을 차단할 수 있습니다.
mobileApp

object (MobileApp)

광고 항목에서 홍보하는 모바일 앱입니다.

lineItemType가 LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 또는 LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL인 경우에만 적용됩니다.
reservationType

enum (ReservationType)

출력 전용. 광고 항목의 예약 유형입니다.
excludeNewExchanges

boolean

새 광고 거래소가 광고 항목에 의해 자동으로 타겟팅되지 않도록 제외할지 여부입니다. 이 필드는 기본적으로 false입니다.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

출력 전용. YouTube 및 파트너 광고 항목과 관련된 설정입니다.

LineItemType

가능한 광고 항목의 유형입니다.

광고 항목의 유형에 따라 적용 가능한 설정과 옵션(예: 광고 형식, 타겟팅 옵션)이 결정됩니다.

열거형
LINE_ITEM_TYPE_UNSPECIFIED

이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_DISPLAY_DEFAULT 이미지, HTML5, 네이티브 또는 리치 미디어 광고
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 앱 설치를 유도하는 디스플레이 광고
LINE_ITEM_TYPE_VIDEO_DEFAULT 다양한 환경에서 CPM 기준으로 판매되는 동영상 광고입니다.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL 앱 설치를 유도하는 동영상 광고입니다.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

모바일 앱 인벤토리에 게재되는 디스플레이 광고

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

모바일 앱 인벤토리에 게재된 동영상 광고

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_AUDIO_DEFAULT 다양한 환경에서 판매되는 RTB 오디오 광고입니다.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP OTT 게재 신청서에 있는 오버더톱 광고 이 유형은 게재 신청서가 insertionOrderType OVER_THE_TOP인 광고 항목에만 적용됩니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

전환을 홍보하는 YouTube 동영상 광고입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

건너뛸 수 없는 YouTube 동영상 광고 (최대 15초)입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

여러 형식을 조합하여 특정 순서로 스토리를 보여주는 YouTube 동영상 광고입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

YouTube 오디오 광고

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

더 낮은 비용으로 더 많은 순 사용자에게 도달하는 데 최적화된 YouTube 동영상 광고입니다. 범퍼 광고, 건너뛸 수 있는 인스트림 광고 또는 여러 유형의 광고가 포함될 수 있습니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

기본 YouTube 동영상 광고입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

건너뛸 수 없는 커넥티드 TV YouTube 동영상 광고 (최대 15초)

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

더 낮은 비용으로 더 많은 순 사용자에게 도달하는 데 최적화된 커넥티드 TV YouTube 동영상 광고입니다. 범퍼 광고, 건너뛸 수 있는 인스트림 광고 또는 여러 유형의 광고가 포함될 수 있습니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

커넥티드 TV 기본 YouTube 동영상 광고 인스트림 광고 형식만 포함합니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

이 광고 항목 유형의 목표는 특정 기간 동안 같은 사람에게 YouTube 광고를 타겟팅한 횟수만큼 표시하는 것입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

다양한 광고 형식을 사용하여 조회수를 늘리는 것이 목적인 YouTube 동영상 광고입니다.

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

디지털 옥외 광고 인벤토리에 게재된 디스플레이 광고

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

디지털 옥외 광고 인벤토리에 게재된 동영상 광고

이 유형의 광고 항목과 해당 타겟팅은 API를 사용하여 만들거나 업데이트할 수 없습니다.

LineItemFlight

광고 항목의 활성 기간을 제어하는 설정입니다.

JSON 표현 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
입력란
flightDateType

enum (LineItemFlightDateType)

필수 항목입니다. 광고 항목의 게재 날짜 유형입니다.
dateRange

object (DateRange)

광고 항목의 광고 게재 기간 시작일과 종료일입니다. 상위 광고주의 시간대를 기준으로 결정됩니다.

  • flightDateType이 LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM인 경우 필수입니다. 그 외에는 출력됩니다.
  • 새 광고 게재 기간을 만들 때는 startDate와 endDate가 모두 미래여야 합니다.
  • 이전에 startDate이었던 기존 항공편에는 변경 가능한 endDate가 있지만 변경 불가능한 startDate가 있습니다.
  • endDate는 2037년 이전의 startDate 이후여야 합니다.

LineItemFlightDateType

광고 항목의 게재 날짜의 가능한 유형입니다.

열거형
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED 이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED 광고 항목의 게재 날짜는 상위 게재 신청서에서 상속됩니다.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM 광고 항목은 고유한 맞춤 게재 날짜를 사용합니다.

LineItemBudget

예산 할당 방법을 제어하는 설정입니다.

JSON 표현 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
입력란
budgetAllocationType

enum (LineItemBudgetAllocationType)

필수 항목입니다. 예산 할당의 유형입니다.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC은(는) 상위 게재 신청서에 자동 예산 할당이 사용 설정된 경우에만 적용됩니다.
budgetUnit

enum (BudgetUnit)

출력 전용. 예산 단위는 예산이 통화 기반인지 노출 기반인지 지정합니다. 이 값은 상위 게재 신청서에서 상속됩니다.
maxAmount

string (int64 format)

광고 항목이 지출할 최대 예산 금액입니다. 0보다 커야 합니다.

budgetAllocationType이 다음과 같은 경우:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC: 이 필드는 변경할 수 없으며 시스템에 의해 설정됩니다.
  • budgetUnit이 다음과 같은 경우 LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED:
    • BUDGET_UNIT_CURRENCY: 이 필드는 지출할 최대 예산 금액을 광고주 통화의 마이크로(micro)로 나타냅니다. 예를 들어 1500000은 1.5 표준 통화 단위를 나타냅니다.
    • BUDGET_UNIT_IMPRESSIONS: 이 필드는 게재할 최대 노출수를 나타냅니다.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED: 이 필드는 적용할 수 없으며 시스템에서 무시됩니다.

LineItemBudgetAllocationType

가능한 예산 할당 유형입니다.

열거형
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED 이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC 광고 항목에 자동 예산 할당이 사용 설정됩니다.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED 고정된 최대 예산 금액이 광고 항목에 할당됩니다.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED 광고 항목에 예산 한도가 적용되지 않습니다.

PartnerRevenueModel

파트너 수익 계산 방식을 제어하는 설정입니다.

JSON 표현 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
입력란
markupType

enum (PartnerRevenueModelMarkupType)

필수 항목입니다. 파트너 수익 모델의 마크업 유형입니다.
markupAmount

string (int64 format)

필수 항목입니다. 파트너 수익 모델의 인상폭입니다. 0보다 크거나 같아야 합니다.

  • markupType가 PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM로 설정된 경우 이 필드는 CPM 가격 인상 폭을 광고주 통화의 마이크로(micro)로 나타냅니다. 예를 들어 1500000은 1.5 표준 통화 단위를 나타냅니다.
  • markupType가 PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP로 설정된 경우 이 필드는 미디어 비용 비율 마크업을 밀리초 단위로 나타냅니다. 예를 들어 100은 0.1% (십진수 0.001)를 나타냅니다.
  • markupType가 PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP로 설정된 경우 이 필드는 총 미디어 비용 비율 마크업을 밀리초 단위로 나타냅니다. 예를 들어 100은 0.1% (십진수 0.001)를 나타냅니다.

PartnerRevenueModelMarkupType

파트너 수익 모델의 가능한 마크업 유형입니다.

열거형
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED 이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM 고정 CPM을 기준으로 파트너 수익을 계산합니다.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

미디어 비용의 추가 비율에 따라 파트너 수익을 계산합니다.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP 모든 파트너 비용과 데이터 비용이 포함된 총 미디어 비용의 백분율 추가 요금을 기준으로 파트너 수익을 계산합니다.

ConversionCountingConfig

전환 집계 방법을 관리하는 설정입니다.

클릭 후 전환이 모두 집계됩니다. 조회 후 전환 집계에 대해 비율 값을 설정할 수 있습니다.

JSON 표현 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
입력란
postViewCountPercentageMillis

string (int64 format)

집계할 조회 후 전환수의 비율로, 밀리초 단위입니다 (1/1000퍼센트). 0 이상 100,000 이하여야 합니다.

예를 들어 클릭 후 전환의 50% 를 추적하려면 값을 50,000으로 설정합니다.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

전환을 추적하는 데 사용되는 플러드라이트 활동 구성입니다.

계산된 전환수는 이 입력란에 지정된 모든 플러드라이트 활동 ID로 계산된 모든 전환의 합계입니다.

TrackingFloodlightActivityConfig

단일 플러드라이트 활동 구성의 동작을 제어하는 설정입니다.

JSON 표현 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
입력란
floodlightActivityId

string (int64 format)

필수 항목입니다. 플러드라이트 활동의 ID입니다.
postClickLookbackWindowDays

integer

필수 항목입니다. 광고가 클릭된 후 전환이 집계될 수 있는 기간(일)입니다. 0 이상 90 이하여야 합니다.
postViewLookbackWindowDays

integer

필수 항목입니다. 광고가 조회된 후 전환이 집계될 수 있는 일수입니다. 0 이상 90 이하여야 합니다.

LineItemWarningMessage

광고 항목에서 생성된 경고 메시지 이러한 유형의 경고는 광고 항목 저장을 차단하지는 않지만 광고 항목이 실행되지 않도록 차단할 수 있습니다.

열거형
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
INVALID_FLIGHT_DATES 이 광고 항목에 잘못된 광고 게재 기간 날짜가 있습니다. 광고 항목이 게재되지 않습니다.
EXPIRED 이 광고 항목의 종료일이 과거입니다.
PENDING_FLIGHT 이 광고 항목은 향후에 게재됩니다.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED 파트너를 사용하도록 설정된 모든 교환이 제외 타겟팅되어 있습니다. 광고 항목이 게재되지 않습니다.
INVALID_INVENTORY_SOURCE 타겟팅하고 있는 활성 인벤토리 소스가 없습니다. 광고 항목이 게재되지 않습니다.
APP_INVENTORY_INVALID_SITE_TARGETING 이 광고 항목의 앱 및 URL 타겟팅에 모바일 앱이 포함되어 있지 않습니다. 이 광고 항목 유형을 사용하려면 채널, 사이트 목록 또는 앱 타겟팅에 모바일 앱을 포함해야 합니다. 광고 항목이 게재되지 않습니다.
APP_INVENTORY_INVALID_AUDIENCE_LISTS 이 광고 항목은 모바일 사용자를 타겟팅하지 않습니다. 이 광고 항목 유형을 사용하려면 사용자 목록을 모바일 사용자로 타겟팅해야 합니다. 광고 항목이 게재되지 않습니다.
NO_VALID_CREATIVE 이 광고 항목에 유효한 광고 소재가 없습니다. 광고 항목이 게재되지 않습니다.
PARENT_INSERTION_ORDER_PAUSED 이 광고 항목의 게재 신청서가 일시 중지되어 있습니다. 광고 항목이 게재되지 않습니다.
PARENT_INSERTION_ORDER_EXPIRED 이 광고 항목의 게재 신청서 종료일이 과거로 설정되어 있습니다. 광고 항목이 게재되지 않습니다.

MobileApp

모바일 앱 설치 광고 항목에서 홍보하는 모바일 앱

JSON 표현 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
입력란
appId

string

필수 항목입니다. 플랫폼 스토어에서 제공하는 앱의 ID입니다.

Android 앱은 Android의 Play 스토어에서 사용하는 번들 ID(예: com.google.android.gm)로 식별됩니다.

iOS 앱은 Apple의 App Store에서 사용하는 9자리 앱 ID(예: 422689480)로 식별됩니다.
platform

enum (Platform)

출력 전용. 앱 플랫폼
displayName

string

출력 전용. 앱 이름입니다.
publisher

string

출력 전용. 앱 게시자입니다.

플랫폼

가능한 모바일 앱 플랫폼입니다.

열거형
PLATFORM_UNSPECIFIED 플랫폼이 지정되지 않았습니다.
IOS 있습니다.
ANDROID Android 플랫폼입니다.

YoutubeAndPartnersSettings

YouTube 및 파트너 광고 항목의 설정입니다.

JSON 표현 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
입력란
viewFrequencyCap

object (FrequencyCap)

광고 항목의 조회 게재빈도 설정입니다.

제한된 한도를 할당하는 경우 이 설정 객체의 maxViews 필드를 사용해야 합니다.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

선택사항입니다. 광고 항목의 서드 파티 측정 구성입니다.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

광고 항목이 타겟팅할 YouTube 및 파트너 인벤토리를 제어하는 설정입니다.
contentCategory

enum (YoutubeAndPartnersContentCategory)

YouTube 및 파트너 광고가 게재될 콘텐츠의 종류입니다.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

출력 전용. 광고 항목을 게재할 때 적용되는 콘텐츠 카테고리입니다. 광고 항목과 광고주 모두에 콘텐츠 카테고리가 설정된 경우 광고 항목을 게재할 때 더 엄격한 카테고리가 적용됩니다.
targetFrequency

object (TargetFrequency)

일정 기간 동안 이 광고 항목의 광고를 같은 사람에게 게재하려는 평균 횟수입니다.
linkedMerchantId

string (int64 format)

제품 피드의 광고 항목에 연결된 판매자의 ID입니다.
relatedVideoIds[]

string

동영상 ID는 휴대기기의 YouTube 앱에서 광고가 재생될 때 기본 동영상 광고 아래에 표시됩니다.
leadFormId

string (int64 format)

리드 생성을 위한 양식의 ID입니다.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

VideoAdSequence와 관련된 설정입니다.

ThirdPartyMeasurementConfigs

특정 광고 항목 측정항목을 측정하는 타사 공급업체를 제어하는 설정입니다.

JSON 표현 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
입력란
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

선택사항입니다. 조회가능성을 측정하는 서드 파티 공급업체입니다.

다음 서드 파티 공급업체가 적용됩니다.

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

선택사항입니다. 브랜드 안전성을 측정하는 서드 파티 공급업체.

다음 서드 파티 공급업체가 적용됩니다.

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

선택사항입니다. 도달범위를 측정하는 서드 파티 공급업체.

다음 서드 파티 공급업체가 적용됩니다.

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

선택사항입니다. 브랜드 광고효과를 측정하는 서드 파티 공급업체.

다음 서드 파티 공급업체가 적용됩니다.

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

서드 파티 측정 공급업체의 구성 방식을 제어하는 설정입니다.

JSON 표현 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
입력란
vendor

enum (ThirdPartyVendor)

서드 파티 측정 공급업체
placementId

string

서드 파티 공급업체의 플랫폼에서 광고 항목을 식별하는 데 사용하는 ID입니다.

ThirdPartyVendor

서드 파티 측정을 수행하는 공급업체

열거형
THIRD_PARTY_VENDOR_UNSPECIFIED 알 수 없는 서드 파티 공급업체입니다.
THIRD_PARTY_VENDOR_MOAT 해자.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE Integral Ad Science
THIRD_PARTY_VENDOR_COMSCORE Comscore
THIRD_PARTY_VENDOR_TELEMETRY 원격 분석.
THIRD_PARTY_VENDOR_MEETRICS Meetrics
THIRD_PARTY_VENDOR_ZEFR ZEFR
THIRD_PARTY_VENDOR_NIELSEN Nielsen
THIRD_PARTY_VENDOR_KANTAR Kantar입니다.
THIRD_PARTY_VENDOR_DYNATA 디나타.

YoutubeAndPartnersInventorySourceConfig

YouTube 및 파트너 광고 항목이 타겟팅할 YouTube 관련 인벤토리를 제어하는 설정입니다.

JSON 표현 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
입력란
includeYoutube

boolean

선택사항입니다. YouTube에서 인벤토리를 타겟팅할지 여부입니다. 여기에는 검색, 채널 및 동영상이 모두 포함됩니다.
includeGoogleTv

boolean

선택사항입니다. Google TV에서 사용할 수 있는 동영상 앱의 인벤토리를 타겟팅할지 여부입니다.
includeYoutubeVideoPartners

boolean

YouTube와 동일한 브랜드 안전성 표준을 준수하는 파트너 사이트 및 앱 모음의 인벤토리를 타겟팅할지 여부입니다.

YoutubeAndPartnersContentCategory

YouTube 및 파트너 콘텐츠의 브랜드 안전성 카테고리

열거형
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED 이 버전에서 컨텐츠 카테고리가 지정되지 않았거나 알 수 없습니다.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD 대부분의 브랜드에 적합한 광범위한 콘텐츠로 구성된 카테고리입니다. 이 콘텐츠는 YouTube의 광고주 친화적인 콘텐츠 가이드라인을 기반으로 합니다.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED 수익 창출 기준을 충족하는 YouTube 및 동영상 파트너의 모든 콘텐츠를 포함하는 카테고리입니다.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED 특히 부적절한 언어 및 외설적인 내용과 관련해 더욱 강화된 요건을 충족하며 콘텐츠의 범위를 축소한 카테고리로 구성된 카테고리입니다.

TargetFrequency

일정 기간 동안 동일한 사용자에게 광고가 게재되는 평균 횟수를 제어하는 설정

JSON 표현 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
입력란
targetCount

string (int64 format)

timeUnit 및 timeUnitCount로 지정된 기간 동안 동일한 사용자에게 광고가 게재되는 평균 횟수입니다.
timeUnit

enum (TimeUnit)

타겟 게재빈도가 적용될 시간 단위입니다.

다음 시간 단위를 적용할 수 있습니다.

  • TIME_UNIT_WEEKS
timeUnitCount

integer

타겟 게재빈도가 지속될 timeUnit 수입니다.

timeUnit 값에 따라 다음 제한사항이 적용됩니다.

  • TIME_UNIT_WEEKS - 1이어야 합니다.

VideoAdSequenceSettings

VideoAdSequence와 관련된 설정입니다.

JSON 표현 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
입력란
minimumDuration

enum (VideoAdSequenceMinimumDuration)

동일한 사용자가 이 시퀀스를 다시 볼 수 있게 되는 최소 시간 간격입니다.
steps[]

object (VideoAdSequenceStep)

시퀀스가 구성되는 단계입니다.

VideoAdSequenceMinimumDuration

동일한 사용자가 VideoAdSequence를 다시 보기 전에 가능한 최소 간격 시간의 열거형입니다.

열거형
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED 지정되지 않았거나 알 수 없습니다.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7일.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30일

VideoAdSequenceStep

VideoAdSequence 내 단일 단계의 세부정보입니다.

JSON 표현 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
입력란
stepId

string (int64 format)

단계의 ID입니다.
adGroupId

string (int64 format)

단계의 해당 광고 그룹 ID입니다.
previousStepId

string (int64 format)

이전 단계의 ID입니다. 첫 번째 단계에는 이전 단계가 없습니다.
interactionType

enum (InteractionType)

시청자를 이 단계로 유도하는 이전 단계의 상호작용입니다. 첫 번째 단계에 상호작용 유형이 없습니다.

InteractionType

단계의 상호작용 유형입니다.

열거형
INTERACTION_TYPE_UNSPECIFIED 지정되지 않거나 알 수 없음
INTERACTION_TYPE_PAID_VIEW 유료 보기
INTERACTION_TYPE_SKIP 시청자가 건너뜁니다.
INTERACTION_TYPE_IMPRESSION 조회된 광고 노출
INTERACTION_TYPE_ENGAGED_IMPRESSION 시청자가 바로 건너뛰지 않았지만 청구 가능 이벤트에 도달하지 못한 광고 노출입니다.

방법

bulkEditAssignedTargetingOptions

 여러 광고 항목의 타겟팅 옵션을 일괄 수정합니다.

bulkListAssignedTargetingOptions

 타겟팅 유형 전체에서 여러 광고 항목에 할당된 타겟팅 옵션을 나열합니다.

bulkUpdate

 여러 광고 항목을 업데이트합니다.

create

 새 광고 항목을 만듭니다.

delete

 광고 항목을 삭제합니다.

duplicate

 광고 항목을 복제합니다.

generateDefault

 게재 신청서 및 ENTITY_STATUS_DRAFT entity_status에서 상속된 설정 (타겟팅 포함)으로 새 광고 항목을 만듭니다.

get

 광고 항목을 가져옵니다.

list

 광고주의 광고 항목을 나열합니다.

patch

 기존 광고 항목을 업데이트합니다.