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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
필드
name

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

필수 항목입니다. 변경할 수 없습니다. 품목이 속한 삽입 주문의 고유 ID입니다.
lineItemId

string (int64 format)

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

string

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

최대 크기가 240바이트인 UTF-8로 인코딩되어야 합니다.
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)

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

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
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 및 파트너 광고 항목에만 적용되는 설정입니다.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

이 광고 항목이 유럽연합 정치 광고를 게재하는지 여부입니다.

containsEuPoliticalAds이 상위 광고주에서 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING로 설정된 경우 달리 지정하지 않는 한 이 필드에 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING이 할당됩니다. 그런 다음 UI, API 또는 구조화된 데이터 파일을 사용하여 이 필드를 업데이트할 수 있습니다.

새 광고 항목을 만들 때 이 필드를 할당해야 합니다. 그렇지 않으면 advertisers.lineItems.create 요청이 실패합니다.

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 마크업을 나타냅니다. 예를 들어 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~100000(포함) 사이여야 합니다.

예를 들어 클릭 후 전환의 50% 를 추적하려면 값 50000을 설정합니다.
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 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)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
필드
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와 관련된 설정입니다.
videoAdInventoryControl

object (VideoAdInventoryControl)

선택사항입니다. 이 광고 항목에 허용되는 인벤토리를 제어하는 설정입니다.

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_NIELSEN

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
THIRD_PARTY_VENDOR_TRANSUNION Transunion

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이 없습니다.

InteractionType

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

열거형
INTERACTION_TYPE_UNSPECIFIED 지정되지 않음 또는 알 수 없음
INTERACTION_TYPE_PAID_VIEW 유료 조회수입니다.
INTERACTION_TYPE_SKIP 시청자가 건너뛰었습니다.
INTERACTION_TYPE_IMPRESSION (조회된) 광고 노출입니다.
INTERACTION_TYPE_ENGAGED_IMPRESSION 시청자가 즉시 건너뛰지 않았지만 청구 가능한 이벤트에 도달하지도 않은 광고 노출입니다.

VideoAdInventoryControl

특정 YouTube 광고 항목 유형에 사용되는 동영상 광고 인벤토리 관리입니다.

JSON 표현 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
필드
allowInStream

boolean

선택사항입니다. 광고가 인스트림 형식으로 게재될 수 있는지 여부입니다.
allowInFeed

boolean

선택사항입니다. 광고가 인피드 형식으로 게재될 수 있는지 여부입니다.
allowShorts

boolean

선택사항입니다. 광고가 Shorts 형식으로 게재될 수 있는지 여부입니다.

메서드

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

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

bulkUpdate

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

create

 새 광고 항목을 만듭니다.

delete

 광고 항목을 삭제합니다.

duplicate

 광고 항목을 복제합니다.

generateDefault

 게재 신청서에서 상속된 설정 (타겟팅 포함)과 ENTITY_STATUS_DRAFT entity_status을 사용하여 새 광고 항목을 만듭니다.

get

 광고 항목을 가져옵니다.

list

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

patch

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