REST Resource: advertisers.lineItems

{
  "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)
  }
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

enum (LineItemType)

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

enum (EntityStatus)

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

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

string (Timestamp format)

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

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

object (PartnerCost)

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

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

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

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

object (FrequencyCap)

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

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

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

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

string (int64 format)

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

object (BiddingStrategy)

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

object (IntegrationDetails)

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

object (TargetingExpansionConfig)

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

이 구성은 자동 입찰을 사용하고 요건을 충족하는 잠재고객 목록을 적극적으로 타겟팅하는 디스플레이, 동영상 또는 오디오 광고 항목에만 적용됩니다.

enum (LineItemWarningMessage)

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

object (MobileApp)

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

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

enum (ReservationType)

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

boolean

광고 항목에서 새 거래소를 자동으로 타겟팅하지 않도록 할지 여부입니다. 이 필드는 기본적으로 false입니다.

object (YoutubeAndPartnersSettings)

출력 전용입니다. YouTube 및 파트너 광고 항목에 해당하는 설정입니다.

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}

enum (LineItemFlightDateType)

필수 항목입니다. 광고 항목의 게재 기간 유형입니다.

object (DateRange)

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

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

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum (LineItemBudgetAllocationType)

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

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

enum (BudgetUnit)

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

string (int64 format)

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

budgetAllocationType이 다음과 같은 경우:

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

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum (PartnerRevenueModelMarkupType)

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

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)를 나타냅니다.

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

집계할 조회 후 전환의 비율(백분율의 1/1,000)입니다. 0 이상 100,000 이하여야 합니다.

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

object (TrackingFloodlightActivityConfig)

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

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

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

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

integer

필수 항목입니다. 광고가 클릭된 후 전환이 집계될 수 있는 기간(일수)입니다. 0~90(양 끝값 포함) 사이여야 합니다.

integer

필수 항목입니다. 광고가 조회된 후 전환이 집계될 수 있는 기간(일수)입니다. 0~90(양 끝값 포함) 사이여야 합니다.

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

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

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

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

enum (Platform)

출력 전용입니다. 앱 플랫폼

string

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

string

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

{
  "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)
  }
}

object (FrequencyCap)

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

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

object (ThirdPartyMeasurementConfigs)

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

object (YoutubeAndPartnersInventorySourceConfig)

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

enum (YoutubeAndPartnersContentCategory)

YouTube 및 파트너 광고가 게재되는 콘텐츠 유형입니다.

enum (YoutubeAndPartnersContentCategory)

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

object (TargetFrequency)

선택사항입니다. 일정 기간 동안 동일한 사용자에게 이 광고 항목의 광고를 게재하려는 평균 횟수입니다.

string (int64 format)

선택사항입니다. 제품 피드의 광고 항목에 연결된 판매자의 ID입니다.

string

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

string (int64 format)

선택사항입니다. 리드를 생성할 양식의 ID입니다.

object (VideoAdSequenceSettings)

선택사항입니다. VideoAdSequence와 관련된 설정입니다.

{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}

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

object (ThirdPartyVendorConfig)

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

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

• THIRD_PARTY_VENDOR_ZERF
• THIRD_PARTY_VENDOR_DOUBLE_VERIFY
• THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE

object (ThirdPartyVendorConfig)

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

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

• THIRD_PARTY_VENDOR_NIELSEN
• THIRD_PARTY_VENDOR_COMSCORE
• THIRD_PARTY_VENDOR_KANTAR

object (ThirdPartyVendorConfig)

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

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

• THIRD_PARTY_VENDOR_DYNATA
• THIRD_PARTY_VENDOR_KANTAR

{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}

enum (ThirdPartyVendor)

서드 파티 측정 공급업체

string

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

{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}

boolean

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

boolean

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

boolean

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

{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}

string (int64 format)

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

enum (TimeUnit)

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

다음 시간 단위가 적용됩니다.

• TIME_UNIT_WEEKS

integer

타겟 게재빈도가 지속되는 timeUnit의 수입니다.

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

• TIME_UNIT_WEEKS - 1이어야 합니다.

{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}

enum (VideoAdSequenceMinimumDuration)

동일한 사용자가 이 시퀀스를 다시 보려면 기다려야 하는 최소 시간 간격입니다.

object (VideoAdSequenceStep)

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

{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}

string (int64 format)

단계의 ID입니다.

string (int64 format)

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

string (int64 format)

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

enum (InteractionType)

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