- 리소스: LineItem
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LineItemType
- LineItemFlight
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LineItemFlightDateType
- LineItemBudget
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LineItemBudgetAllocationType
- PartnerRevenueModel
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- TrackingFloodlightActivityConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- LineItemWarningMessage
- MobileApp
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 플랫폼
- YoutubeAndPartnersSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- YoutubeAndPartnersThirdPartyMeasurementSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ThirdPartyVendorConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- ThirdPartyVendor
- YoutubeAndPartnersInventorySourceConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- YoutubeAndPartnersContentCategory
- TargetFrequency
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoAdSequenceSettings
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- VideoAdSequenceMinimumDuration
- VideoAdSequenceStep
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- InteractionType
- 메서드
리소스: LineItem
단일 광고 항목
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
필드 | |
---|---|
name |
출력 전용입니다. 광고 항목의 리소스 이름입니다. |
advertiserId |
출력 전용입니다. 광고 항목이 속한 광고주의 고유 ID입니다. |
campaignId |
출력 전용입니다. 광고 항목이 속한 캠페인의 고유 ID입니다. |
insertionOrderId |
필수 항목입니다. 변경할 수 없습니다. 광고 항목이 속한 게재 신청서의 고유 ID입니다. |
lineItemId |
출력 전용입니다. 광고 항목의 고유 ID입니다. 시스템에서 할당합니다. |
displayName |
필수 항목입니다. 광고 항목의 표시 이름입니다. 최대 240바이트의 UTF-8로 인코딩되어야 합니다. |
lineItemType |
필수 항목입니다. 변경할 수 없습니다. 광고 항목의 유형입니다. |
entityStatus |
필수 항목입니다. 광고 항목이 인벤토리에 예산을 지출하고 입찰할 수 있는지 여부를 제어합니다.
|
updateTime |
출력 전용입니다. 광고 항목이 마지막으로 업데이트된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
partnerCosts[] |
광고 항목과 연결된 파트너 비용입니다.
|
flight |
필수 항목입니다. 광고 항목 광고 게재 기간의 시작 및 종료 시간입니다. |
budget |
필수 항목입니다. 광고 항목의 예산 할당 설정입니다. |
pacing |
필수 항목입니다. 광고 항목의 예산 지출 속도 설정입니다. |
frequencyCap |
필수 항목입니다. 광고 항목의 노출 최대 게재빈도 설정입니다. 제한된 한도를 할당하는 경우 이 설정 객체의 |
partnerRevenueModel |
필수 항목입니다. 광고 항목의 파트너 수익 모델 설정입니다. |
conversionCounting |
광고 항목의 전환 추적 설정입니다. |
creativeIds[] |
광고 항목과 연결된 광고 소재의 ID입니다. |
bidStrategy |
필수 항목입니다. 광고 항목의 입찰 전략입니다. |
integrationDetails |
광고 항목의 통합 세부정보입니다. |
targetingExpansion |
광고 항목의 타겟팅 최적화 설정입니다. 이 구성은 자동 입찰을 사용하고 요건을 충족하는 잠재고객 목록을 포함 방식으로 타겟팅하는 디스플레이, 동영상 또는 오디오 광고 항목에만 적용됩니다. |
warningMessages[] |
출력 전용입니다. 광고 항목에서 생성된 경고 메시지입니다. 이러한 경고는 광고 항목 저장을 차단하지는 않지만, 일부는 광고 항목의 실행을 차단할 수 있습니다. |
mobileApp |
광고 항목으로 홍보한 모바일 앱입니다.
|
reservationType |
출력 전용입니다. 광고 항목의 예약 유형입니다. |
excludeNewExchanges |
광고 항목이 자동으로 타겟팅하지 않도록 새 거래소를 제외할지 여부입니다. 이 필드의 기본값은 false입니다. |
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 ( |
필드 | |
---|---|
flightDateType |
필수 항목입니다. 광고 항목의 게재 날짜 유형입니다. |
dateRange |
광고 항목의 광고 게재 기간 시작일과 종료일입니다. 상위 광고주의 시간대를 기준으로 해결됩니다.
|
LineItemFlightDateType
가능한 광고 항목의 게재 날짜 유형입니다.
열거형 | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
광고 항목의 게재 날짜는 상위 게재 신청서에서 상속됩니다. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
광고 항목은 자체적인 맞춤 게재 날짜를 사용합니다. |
LineItemBudget
예산 할당 방법을 제어하는 설정입니다.
JSON 표현 |
---|
{ "budgetAllocationType": enum ( |
필드 | |
---|---|
budgetAllocationType |
필수 항목입니다. 예산 할당 유형입니다.
|
budgetUnit |
출력 전용입니다. 예산 단위는 예산이 통화 기반인지 또는 노출수 기반인지 지정합니다. 이 값은 상위 게재 신청서에서 상속됩니다. |
maxAmount |
광고 항목이 지출할 최대 예산 금액입니다. 0보다 커야 합니다.
|
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 ( |
필드 | |
---|---|
markupType |
필수 항목입니다. 파트너 수익 모델의 마크업 유형입니다. |
markupAmount |
필수 항목입니다. 파트너 수익 모델의 인상된 금액입니다. 0보다 크거나 같아야 합니다.
|
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 ( |
필드 | |
---|---|
postViewCountPercentageMillis |
계산할 조회 후 전환수의 비율(단위: 밀리초)입니다(백분율의 1/1000). 0 이상 100,000 이하여야 합니다. 예를 들어 클릭 후 전환의 50% 를 추적하려면 값을 50000으로 설정합니다. |
floodlightActivityConfigs[] |
전환을 추적하는 데 사용되는 플러드라이트 활동 구성입니다. 계산된 전환수는 이 필드에 지정된 모든 플러드라이트 활동 ID로 계산된 모든 전환수를 합한 값입니다. |
TrackingFloodlightActivityConfig
단일 플러드라이트 활동 구성의 동작을 제어하는 설정입니다.
JSON 표현 |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
필드 | |
---|---|
floodlightActivityId |
필수 항목입니다. 플러드라이트 활동의 ID입니다. |
postClickLookbackWindowDays |
필수 항목입니다. 광고가 클릭된 후 전환으로 집계될 수 있는 경과 일수입니다. 0 이상 90 이하여야 합니다. |
postViewLookbackWindowDays |
필수 항목입니다. 광고가 조회된 후 전환으로 집계될 수 있는 경과 일수입니다. 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 |
이 광고 항목의 게재 신청서에 종료일이 과거로 설정되어 있습니다. 해당 광고 항목은 실행되지 않습니다. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
이 광고 항목에서 사용 중인
|
MobileApp
모바일 앱 설치 광고 항목으로 홍보되는 모바일 앱입니다.
JSON 표현 |
---|
{
"appId": string,
"platform": enum ( |
필드 | |
---|---|
appId |
필수 항목입니다. 플랫폼 스토어에서 제공하는 앱의 ID입니다. Android 앱은 Android의 Play 스토어에서 사용하는 번들 ID(예: iOS 앱은 Apple의 App Store에서 사용되는 9자리의 앱 ID(예: |
platform |
출력 전용입니다. 앱 플랫폼 |
displayName |
출력 전용입니다. 앱 이름입니다. |
publisher |
출력 전용입니다. 앱 게시자 |
플랫폼
가능한 모바일 앱 플랫폼
열거형 | |
---|---|
PLATFORM_UNSPECIFIED |
플랫폼이 지정되지 않았습니다. |
IOS |
있습니다. |
ANDROID |
Android 플랫폼입니다. |
YoutubeAndPartnersSettings
YouTube 및 파트너 광고 항목의 설정입니다.
JSON 표현 |
---|
{ "biddingStrategy": { object ( |
필드 | |
---|---|
biddingStrategy |
필수 항목입니다. YouTube 및 파트너 광고 항목의 입찰 전략입니다. |
viewFrequencyCap |
광고 항목의 조회 최대 게재빈도 설정입니다. 제한된 한도를 할당하는 경우 이 설정 객체의 |
thirdPartyMeasurementSettings |
선택사항입니다. 광고 항목의 서드 파티 측정 설정입니다. |
inventorySourceSettings |
광고 항목이 타겟팅할 YouTube 및 파트너 인벤토리를 제어하는 설정입니다. |
contentCategory |
YouTube 및 파트너 광고가 게재될 콘텐츠의 종류입니다. |
effectiveContentCategory |
출력 전용입니다. 광고 항목을 게재할 때 적용되는 콘텐츠 카테고리입니다. 콘텐츠 카테고리가 광고 항목과 광고주 모두에 설정된 경우 광고 항목을 게재할 때 더 엄격한 카테고리가 적용됩니다. |
targetFrequency |
일정 기간 동안 동일한 사용자에게 이 광고 항목의 광고를 게재하려는 평균 횟수입니다. |
linkedMerchantId |
제품 피드의 광고 항목에 연결된 판매자의 ID입니다. |
relatedVideoIds[] |
휴대기기의 YouTube 앱에서 광고가 재생될 때 동영상 ID가 기본 동영상 광고 아래에 표시됩니다. |
leadFormId |
리드를 생성할 양식의 ID입니다. |
videoAdSequenceSettings |
VideoAdSequence와 관련된 설정입니다. |
YoutubeAndPartnersThirdPartyMeasurementSettings
특정 광고 항목 측정항목을 측정하는 서드 파티 공급업체를 제어하는 설정입니다.
JSON 표현 |
---|
{ "viewabilityVendorConfigs": [ { object ( |
필드 | |
---|---|
viewabilityVendorConfigs[] |
조회가능성을 측정하는 서드 파티 공급업체입니다. 다음과 같은 서드 파티 공급업체가 적용됩니다.
|
brandSafetyVendorConfigs[] |
브랜드 안전성을 측정하는 서드 파티 공급업체 다음과 같은 서드 파티 공급업체가 적용됩니다.
|
reachVendorConfigs[] |
도달범위를 측정하는 서드 파티 공급업체입니다. 다음과 같은 서드 파티 공급업체가 적용됩니다.
|
brandLiftVendorConfigs[] |
브랜드 광고효과를 측정하는 서드 파티 공급업체 다음과 같은 서드 파티 공급업체가 적용됩니다.
|
ThirdPartyVendorConfig
서드 파티 측정 공급업체의 구성 방식을 제어하는 설정입니다.
JSON 표현 |
---|
{
"vendor": enum ( |
필드 | |
---|---|
vendor |
서드 파티 측정 공급업체 |
placementId |
서드 파티 공급업체의 플랫폼에서 광고 항목을 식별하기 위해 사용하는 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 |
Dynata입니다. |
YoutubeAndPartnersInventorySourceConfig
YouTube 및 파트너 광고 항목이 타겟팅할 YouTube 관련 인벤토리를 제어하는 설정입니다.
JSON 표현 |
---|
{ "includeYoutubeSearch": boolean, "includeYoutubeVideos": boolean, "includeGoogleTv": boolean, "includeYoutubeVideoPartners": boolean } |
필드 | |
---|---|
includeYoutubeSearch |
YouTube 검색 결과 페이지의 인벤토리를 타겟팅할지 여부입니다. |
includeYoutubeVideos |
YouTube의 채널 및 동영상 인벤토리와 다른 사이트에 삽입된 YouTube 동영상의 인벤토리를 타겟팅할지 여부입니다. |
includeGoogleTv |
선택사항입니다. Google TV에서 사용할 수 있는 동영상 앱의 인벤토리를 타겟팅할지 여부입니다. |
includeYoutubeVideoPartners |
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 ( |
VideoAdSequenceSettings
VideoAdSequence와 관련된 설정입니다.
JSON 표현 |
---|
{ "minimumDuration": enum ( |
필드 | |
---|---|
minimumDuration |
동일한 사용자가 이 시퀀스를 다시 볼 수 있는 최소 시간 간격입니다. |
steps[] |
시퀀스가 구성되는 단계입니다. |
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 ( |
필드 | |
---|---|
stepId |
단계의 ID입니다. |
adGroupId |
단계의 해당 광고 그룹의 ID입니다. |
previousStepId |
이전 단계의 ID입니다. 첫 번째 단계에 이전 단계가 없습니다. |
interactionType |
시청자를 이 단계로 유도하는 이전 단계의 상호작용 첫 번째 단계에 상호작용 유형이 없습니다. |
InteractionType
단계의 상호작용 유형입니다.
열거형 | |
---|---|
INTERACTION_TYPE_UNSPECIFIED |
지정되지 않았거나 알 수 없음 |
INTERACTION_TYPE_PAID_VIEW |
유료 보기 |
INTERACTION_TYPE_SKIP |
시청자가 건너뛰었습니다. |
INTERACTION_TYPE_IMPRESSION |
(조회된) 광고 노출 |
INTERACTION_TYPE_ENGAGED_IMPRESSION |
시청자가 즉시 건너뛰지 않았지만 청구 가능 이벤트에 도달하지 않은 광고 노출입니다. |
메서드 |
|
---|---|
|
여러 광고 항목의 타겟팅 옵션을 일괄 수정합니다. |
|
타겟팅 유형 전반에 걸쳐 여러 광고 항목에 할당된 타겟팅 옵션을 나열합니다. |
|
여러 광고 항목을 업데이트합니다. |
|
새 광고 항목을 만듭니다. |
|
광고 항목을 삭제합니다. |
|
광고 항목을 복사합니다. |
|
게재 신청서에서 상속된 설정 (타겟팅 포함)과 ENTITY_STATUS_DRAFT entity_status 를 사용하여 새 광고 항목을 만듭니다. |
|
광고 항목을 가져옵니다. |
|
광고주의 광고 항목을 나열합니다. |
|
기존 광고 항목을 업데이트합니다. |