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: 이 필드는 변경할 수 없으며 시스템에서 설정합니다.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, budgetUnit가 다음인 경우:
    • BUDGET_UNIT_CURRENCY: 이 필드는 광고주의 통화로 지출할 수 있는 최대 예산 금액을 마이크로로 나타냅니다. 예를 들어 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/1,000)입니다. 0~100000(양 끝값 포함) 사이여야 합니다.

예를 들어 클릭 후 전환의 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 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 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를 다시 보게 되기까지의 최소 간격 시간을 나타내는 enum입니다.

열거형
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

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