- 리소스: 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 표현
- TargetingExpansionConfig
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
<ph type="x-smartling-placeholder">
- </ph>
- JSON 표현
- 플랫폼
- 메서드
리소스: 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 |
광고 항목의 통합 세부정보입니다. |
inventorySourceIds[] |
광고 항목에 할당된 비공개 인벤토리 소스의 ID입니다. |
targetingExpansion |
광고 항목의 타겟팅 최적화 설정입니다. 이 구성은 자동 입찰을 사용하고 요건을 충족하는 잠재고객 목록을 포함 방식으로 타겟팅하는 디스플레이, 동영상 또는 오디오 광고 항목에만 적용됩니다. |
warningMessages[] |
출력 전용입니다. 광고 항목에서 생성된 경고 메시지입니다. 이러한 경고는 광고 항목 저장을 차단하지는 않지만, 일부는 광고 항목의 실행을 차단할 수 있습니다. |
mobileApp |
광고 항목으로 홍보한 모바일 앱입니다.
|
reservationType |
출력 전용입니다. 광고 항목의 예약 유형입니다. |
excludeNewExchanges |
광고 항목이 자동으로 타겟팅하지 않도록 새 거래소를 제외할지 여부입니다. 이 필드의 기본값은 false입니다. |
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 인 광고 항목에만 적용됩니다. |
LineItemFlight
광고 항목의 활성 기간을 제어하는 설정입니다.
JSON 표현 |
---|
{ "flightDateType": enum ( |
필드 | |
---|---|
flightDateType |
필수 항목입니다. 광고 항목의 게재 날짜 유형입니다. |
dateRange |
광고 항목의 광고 게재 기간 시작일과 종료일입니다. 상위 광고주의 시간대를 기준으로 해결됩니다.
|
triggerId |
광고 항목과 연결된 수동 트리거의 ID입니다.
경고: 수동 트리거를 사용하는 광고 항목은 더 이상 동영상 360 이 필드는 2023년 8월 1일에 지원 종료됩니다. 자세한 내용은 기능 지원 중단 공지를 참고하세요. |
LineItemFlightDateType
가능한 광고 항목의 게재 날짜 유형입니다.
열거형 | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
유형 값이 지정되지 않았거나 이 버전에서 알 수 없습니다. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
광고 항목의 게재 날짜는 상위 게재 신청서에서 상속됩니다. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
광고 항목은 자체적인 맞춤 게재 날짜를 사용합니다. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
광고 항목에서 트리거를 사용합니다. 경고: 수동 트리거를 사용하는 광고 항목은 더 이상 동영상 360 이 값은 2023년 8월 1일에 지원 종료됩니다. 자세한 내용은 기능 지원 중단 공지를 참고하세요. |
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 이하여야 합니다. |
TargetingExpansionConfig
광고 항목의 타겟팅 최적화 설정을 제어하는 설정입니다.
JSON 표현 |
---|
{
"targetingExpansionLevel": enum ( |
필드 | |
---|---|
targetingExpansionLevel |
필수 항목입니다. 타겟팅 최적화의 사용 설정 여부 이 필드는 다음 값을 지원합니다.
이 필드가 다른 값으로 설정되면
|
excludeFirstPartyAudience |
타겟팅 확장에 퍼스트 파티 잠재고객이 사용되지 않도록 제외할지 여부입니다. 이 필드는 타겟팅 최적화 출시와 함께 지원 중단되었습니다. 이 필드는 |
TargetingExpansionLevel
타겟팅 최적화 설정
열거형 | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
이 버전에서 타겟팅 최적화 설정이 지정되지 않았거나 알 수 없습니다. |
NO_EXPANSION |
타겟팅 최적화가 사용 중지되었습니다. |
LEAST_EXPANSION |
타겟팅 최적화가 사용 설정되었습니다. |
SOME_EXPANSION |
사용하는 경우 자동으로 |
BALANCED_EXPANSION |
사용하는 경우 자동으로 |
MORE_EXPANSION |
사용하는 경우 자동으로 |
MOST_EXPANSION |
사용하는 경우 자동으로 |
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 |
이 광고 항목의 게재 신청서에 종료일이 과거로 설정되어 있습니다. 해당 광고 항목은 실행되지 않습니다. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
이 광고 항목은 잠재고객 목록을 타겟팅하지 않으며, 이로 인해 예산이 매우 빠르게 지출될 수 있습니다. |
APP_INSTALL_NO_CONVERSION_PIXEL |
이 앱 설치 광고 항목에는 전환 픽셀이 설정되어 있지 않습니다. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
이 광고 항목은 더 이상 사용할 수 없는 사용자 목록을 하나 이상 타겟팅합니다. 이렇게 되면 앞으로 광고 항목이 게재되지 않으므로 타겟팅에서 이러한 목록을 삭제하는 것이 좋습니다. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
이 앱 설치 광고 항목에는 최적화 입찰 전략이 없습니다. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
이 광고 항목에서 타겟팅하는 거래는 사용하지 않는 광고 소재 크기를 허용합니다. 이로 인해 광고 항목의 게재 또는 실적이 제한될 수 있습니다. |
NO_CREATIVE_FOR_TARGETED_DEALS |
이 광고 항목에는 타겟팅된 거래의 광고 소재가 없습니다. |
TARGETING_DEPRECATED_GEO_TARGET |
이 광고 항목은 지원 중단된 지역 타겟을 타겟팅합니다. |
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 플랫폼입니다. |
메서드 |
|
---|---|
|
단일 광고 항목에서 타겟팅 옵션을 일괄 수정합니다. |
|
타겟팅 유형 전반에서 광고 항목에 할당된 타겟팅 옵션을 나열합니다. |
|
새 광고 항목을 만듭니다. |
|
광고 항목을 삭제합니다. |
|
게재 신청서에서 상속된 설정 (타겟팅 포함)과 ENTITY_STATUS_DRAFT entity_status 를 사용하여 새 광고 항목을 만듭니다. |
|
광고 항목을 가져옵니다. |
|
광고주의 광고 항목을 나열합니다. |
|
기존 광고 항목을 업데이트합니다. |