출시 노트

이 페이지에서는 디스플레이 및 Video 360 API

최신 API 버전: v3

2024년 7월 15일

새로운 기능

광고 항목 및 광고그룹 구조화된 데이터 파일 다운로드 지원 추가 v3의 QA 형식

v3

  • 다음 필드가 추가되었습니다.

    리소스필드
    IdFilter

    adGroupQaIds

    lineItemQaIds

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    FileType

    FILE_TYPE_AD_GROUP_QA

    FILE_TYPE_LINE_ITEM_QA

2024년 6월 17일

새로운 기능

광고주 수준에서 할당된 키워드 타겟팅을 관리하기 위한 지원이 추가되었습니다.

게재 신청서에 새로운 optimizationObjective 필드 추가됨 리소스도 제공합니다 optimizationObjective 서비스는 허용 목록에 포함된 고객만 사용할 수 있습니다.

v3

v2

2024년 5월 30일

새로운 기능

구조화된 데이터 파일 (SDF) 버전 7.1 지원이 추가되었습니다.

v3

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    SdfVersion

    SDF_VERSION_7_1

v2

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    SdfVersion

    SDF_VERSION_7_1

2024년 4월 23일

새로운 기능

새로운 KPI 유형, 거래소, 앱 플랫폼에 대한 지원이 추가되었습니다.

v3

  • 다음 필드가 추가되었습니다.

    리소스필드
    KPI

    kpiAlgorithmId

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    AppPlatform

    APP_PLATFORM_LG_TV

    APP_PLATFORM_VIZIO_TV
    광고 거래소

    EXCHANGE_DRAX
    KpiType

    KPI_TYPE_CPCL

    KPI_TYPE_CPCV

    KPI_TYPE_CPV

    KPI_TYPE_CUSTOM_IMPRESSION_VALUE_OVER_COST

    KPI_TYPE_MAXIMIZE_PACING

    KPI_TYPE_TOS10
    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPM

v2

2024년 2월 28일

새로운 기능

고객 일치 타겟팅 잠재고객에서 구성원을 명시적으로 삭제할 수 있는 기능이 추가되었습니다.

새로운 거래소를 타겟팅하는 지원이 추가되었습니다.

v3

v2

2024년 1월 29일

새로운 기능

새로운 floodlightGroups.floodlightActivities 서비스에만 적용됩니다.

YouTube 및 파트너 광고 항목 타겟팅에 Google TV 인벤토리가 포함됩니다.

마지막 로그인 시간을 디스플레이 및 동영상 360 사용자가 누구인지 알아보세요.

v3

v2

2023년 11월 14일

새로운 기능

고객 일치 타겟팅을 업로드할 때 최종 사용자 동의를 전달하는 기능이 추가되었습니다. 시청자 회원을 확인할 수 있습니다.

v3

v2

2023년 10월 31일

새로운 기능

v3가 공개 베타에서 정식 버전으로 이동되었습니다.

v3에서 AdGroupFormat enum 값의 이름이 더 정확하게 변경됨 관련 형식을 반영합니다.

구조화된 데이터 파일 v7에 대한 지원이 v2 및 v3의 SDF_VERSION_7 enum 값

v3

  • 다음 enum 값이 삭제되었습니다.

    열거형값
    AdGroupFormat

    AD_GROUP_FORMAT_ACTION

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    AdGroupFormat

    AD_GROUP_FORMAT_RESPONSIVE
    SdfVersion

    SDF_VERSION_7

v2

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    SdfVersion

    SDF_VERSION_7

2023년 10월 2일

새로운 기능

다음 변경사항이 포함된 공개 베타 버전으로 v3가 출시되었습니다.

이전 가이드의 단계에 따라 v2에서 v3

새로운 LineItemType 값 3개에 대한 지원이 추가되었습니다. YoutubeAndPartnersBiddingStrategyType 외 새 이메일 1개 PartnerCostType(v2 및 v3)

v3

v2

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    LineItemType

    LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

    LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

    LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW
    PartnerCostType

    PARTNER_COST_TYPE_SCIBIDS_FEE
    YoutubeAndPartnersBiddingStrategyType

    YOUTUBE_AND_PARTNERS_BIDDING_STRATEGY_TYPE_TARGET_CPV

2023년 8월 25일

새로운 기능

2개의 광고 거래 및 2개의 새로운 YouTube 및 파트너 입찰 전략 유형을 참조하세요.

YouTube 및effectiveContentCategory 파트너 광고 항목을 사용하여 다음과 같은 경우 광고 항목에서 YoutubeAndPartnersContentCategory를 사용합니다. 광고주 및 광고 항목 수준에서 할당된 값을 고려합니다.

v2

2023년 6월 5일

새로운 기능

구조화된 데이터 파일의 새 SdfVersion 값을 추가했습니다. (SDF) v6 v1 및 v2

v2

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    SdfVersion

    SDF_VERSION_6

v1

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    SdfVersion

    SDF_VERSION_6

2023년 3월 9일

새로운 기능

새로운 LineItemWarningMessage 값이 추가되었습니다. 광고 항목의 warningMessages 입력란에 할당됨( 지원 중단된 excludeFirstPartyAudience 필드가 true입니다. excludeFirstPartyAudience 필드가 지원 종료됩니다. 2023년 3월 25일 후에는 false로 설정합니다.

v2

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

v1

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    LineItemWarningMessage

    DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION

2023년 2월 8일

새로운 기능

YouTubeAdGroup 및 YouTubeAdGroupAd 리소스 및 YouTube 광고그룹 리소스 타겟팅을 참조하세요. 또한 YouTube 광고그룹에서 사용되는 검색 가능한 타겟팅 유형 있습니다. YouTube 및 파트너 리소스를 참조하세요.

v1 및 v2에 4개의 추가 거래소에 대한 지원이 추가되었습니다.

v2

v1

  • 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    광고 거래소

    EXCHANGE_APPLOVIN

    EXCHANGE_CONNATIX

    EXCHANGE_JCD

    EXCHANGE_PLACE_EXCHANGE

2022년 12월 6일

새로운 기능

v2가 공개 베타에서 정식 버전으로 이동되었습니다.

새로운 assignedTargetingOptionIdAlias 필드를 AssignedTargetingOption 리소스 대신 사용할 수 있습니다. 타겟팅을 검색 및 삭제할 때 assignedTargetingOptionId를 사용합니다. 이 필드는 enum을 통해 할당됩니다 별칭 값은 문자열 형식의 관련 enum 값입니다.

새로운 billingConfig 필드를 Advertiser 리소스

YouTube 및 파트너 오버더톱 광고 항목 세 개의 새로운 LineItemType 값으로 식별됩니다.

v1 및 v2의 수많은 list 메서드에서 최대 페이지 크기를 200으로 늘렸습니다. 이 기본 페이지 크기가 변경되지 않습니다.

v2

v1

알려진 문제

이 업데이트는 v2의 다음과 같은 알려진 문제를 해결합니다.

2022년 10월 27일

상위 요소 내에서 기존 광고 항목을 복제하는 기능이 추가됨 InsertionOrder

하위 집합에 대한 쓰기 지원을 타겟팅하는 부분 게재 신청서 도입 create 및 delete 메서드를 advertisers.insertionOrders.targetingTypes.assignedTargetingOptions 있습니다.

새로운 기능

v2

v1

v1에는 새로운 기능이 추가되지 않았습니다.

2022년 9월 20일

다음 변경사항이 포함된 공개 베타 버전으로 v2가 출시되었습니다.

이전 가이드의 단계에 따라 v1에서 버전 2

v1에 세 가지 새로운 거래소에 대한 지원이 추가되었습니다.

새로운 기능

v2

다음은 v1과 v2의 변경사항 목록입니다.

v1

  • v1에 다음과 같은 enum 값이 추가되었습니다.

    열거형값
    광고 거래소

    EXCHANGE_DAX

    EXCHANGE_FYBER

    EXCHANGE_VISTAR

2022년 5월 26일

InventorySource 리소스 및 새로운GuaranteedOrder inventorySources 서비스 쓰기 메서드 및 새로운 guaranteedOrders 서비스.

modelReadiness 필드를 CustomBiddingAlgorithm 리소스 이 필드에는 알고리즘의 모델에 따라 작동합니다.

다음에 대한 새로운 filter 쿼리 매개변수 기능이 사용 설정되었습니다. 사용자가advertisers.creatives.list updateTime가 있는 광고 소재만 검색하려면 지정된 타임스탬프 앞 또는 뒤에 표시됩니다.

다음을 통해 최신 SDF 버전 v5.5에 대한 지원이 추가되었습니다. SdfVersion enum 값이 추가되었습니다.

새로운 기능

2022년 3월 31일

다음에서 타겟팅 검색 및 설정에 대한 지원을 추가했습니다. 콘텐츠 길이, 스트림 유형 및 genre를 선택합니다.

InsertionOrder에 billableOutcome 필드를 추가했습니다. 객체를 지정합니다.

raiseBidForDeals 필드를 MaximizeSpendBidStrategy 객체: 이를 통해 사용자는 입찰 타겟팅된 거래에 광고주 가격 하한선을 적용하는 전략입니다.

새로운 기능

2022년 2월 2일

만들기, 업데이트, 특정 고객 일치 타겟팅 구성원 수정 리소스 FirstAndThirdPartyAudience개. 이 고객 일치 타겟팅 잠재고객 업로드 페이지를 잠재고객 사용 가이드에서는 이러한 새 기능을 사용하는 방법을 자세히 설명합니다.

새로운 reservationType 필드를 도입했습니다. InsertionOrder 및 LineItem 리소스가 태그 보장 리소스, 프로그래매틱 리소스, 보장 또는 보장되지 않습니다.

광고 항목이 자동으로 타겟팅할지 여부를 가져오고 설정하는 기능이 추가됨 새 excludeNewExchanges를 통한 새 교환 필드를 확인합니다.

새로운 기능 외에도 기본 할당량 한도가 두 배 증가했습니다.

새로운 기능

2021년 12월 8일

타겟팅 유형 아래에 오디오 콘텐츠 유형 타겟팅에 대한 지원이 추가되었습니다. TARGETING_TYPE_AUDIO_CONTENT_TYPE

새로운 기능

2021년 11월 8일

맞춤 입찰 알고리즘 및 스크립트 관리에 대한 완벽한 지원이 추가되었습니다. 여기에는 다음이 포함됩니다.

새로운 맞춤 입찰 구현 페이지가 광고 항목 관리 가이드에서 맞춤 입찰 알고리즘을 생성하고 스크립트를 업로드하며 광고 항목의 입찰 전략으로 맞춤 입찰 알고리즘을 할당하는 경우

다음을 통해 최신 SDF 버전 v5.4에 대한 지원이 추가되었습니다. SdfVersion enum 값이 추가되었습니다.

새로운 기능

2021년 9월 14일

타겟팅 유형 아래에 인접 타겟팅 지원 추가 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI.

사용 가능한 TARGETING_TYPE_BUSINESS_CHAIN 및 TARGETING_TYPE_POI 타겟팅 옵션을 targetingTypes.targetingOptions.search: targetingTypes.targetingOptions.get를 통해 가져옴 또는 targetingTypes.targetingOptions.list 메서드로 전달하세요.

새 sharedAdvertiserIds 및 customBiddingAlgorithmState 필드를 맞춤 입찰에 추가합니다. 알고리즘 리소스 및 GOAL_BUILDER_BASED 맞춤 입찰 알고리즘 유형입니다.

Exchange enum에 새로운 값 두 개를 추가했습니다.

새로운 기능

2021년 8월 4일

Open Measurement 사용 설정됨에 대한 지원이 추가되었습니다. 인벤토리 타겟팅을 TARGETING_TYPE_OMID

반환될 수 있는 할당된 타겟팅 옵션의 최대 개수 증가 다양한 광고주, 캠페인, 게재 신청서 및 광고 항목의 할당된 타겟팅 pageSize 메서드 매개변수를 사용하는 옵션 목록 메서드

새로운 기능

2021년 5월 26일

advertisers.invoices 서비스가 출시되었습니다. 이 서비스를 통해 사용자:

  • 특정 월에 광고주에게 발행된 인보이스를 검색할 수 있습니다.
  • 특정 월에 광고주가 사용한 통화 코드를 조회할 수 있습니다.

캠페인에 campaignBudgets 필드를 추가했습니다. 리소스도 제공합니다 게재 신청서 예산 세그먼트를 연결할 수 있습니다. 캠페인 예산: 연결된 세그먼트가 총 캠페인 예산 금액과 합산됩니다.

다음에 대한 지원 추가: 네이티브 콘텐츠 게재위치 타겟팅을 타겟팅 유형 TARGETING_TYPE_NATIVE_CONTENT_POSITION

광고주에게 새로운 prismaEnabled 필드가 도입되었습니다. 리소스를 제공하여 사용자가 Mediaocean의 Prisma 도구와의 통합을 사용 설정할 수 있도록 합니다.

ENTITY_STATUS_PAUSED enum 값 지원을 사용 설정했습니다. 광고주의 entityStatus 필드

새로운 기능

2021년 4월 29일

채널 및 행 수를 반환하는 제외 키워드 목록 리소스 항목을 정의합니다. 새 filter 사용 설정됨 사용자가 다음 작업을 할 수 있게 해주는 광고 항목 목록 메서드의 속성 특정 채널 또는 제외 키워드를 사용하는 광고 항목만 검색 할 수 있습니다.

새로운 기능

2021년 3월 30일

다음을 생성하는 새로운 메서드가 광고 항목 서비스에 추가되었습니다. 광고 항목을 생성할 수 있습니다. 이러한 기본값은 광고 항목 유형뿐 아니라 설정 및 할당된 인벤토리도 상위 게재 신청서 타겟팅입니다.

Ad Exchange를 통해 캠페인 타겟팅을 새 캠페인 타겟팅 서비스 추가 일괄 목록 메서드를 사용할 수 있습니다.

앱 타겟팅을 허용하도록 앱 타겟팅 확장 더 많은 플랫폼에서 사용할 수 있습니다

advertisers.channels.sites에 여러 변경사항이 적용되었습니다. partners.channels.sites 및 다음 목적지까지 서비스 advertisers.negativeKeywordLists.negativeKeywords개 채널 및 제외 키워드 목록 콘텐츠를 보다 쉽게 관리할 수 있습니다. 이러한 변경사항은 다음과 같습니다.

새로운 기능

지원 중단

2021년 2월 24일

새로운 게재 신청서 타겟팅 서비스를 도입했습니다. 추가 일괄 목록 메서드를 사용하면 타겟팅이 게재 신청서에 할당되어 있습니다. 광고 소재 리소스를 확장하여 출력 전용 광고 소재 라벨은 사용할 수 있습니다. 새로운 실적 목표 유형이 추가되었습니다. 게재 신청서 및 캠페인에서 사용 리소스를 배포합니다

새로운 기능

2021년 1월 27일

TV 게재 신청서 및 오버더톱 라인의 검색 및 관리 지원 아이템에 새로운 InsertOrderType 필드 및 새 LineItemType enum 값입니다. 모바일 앱에 대한 지원이 추가되었습니다. mobileApp 광고 항목 필드를 통해 광고 항목을 게재할 수 있습니다. 확장된 거래소, Google 잠재고객, 추가 enum 값을 통한 SDF 지원 advertisers.list 필터링 및 정렬 기능 마지막 업데이트 시간별로 값을 비교할 수 있습니다.

새로운 기능

2020년 12월 4일

다음 항목을 검색하는 기능이 추가되었습니다. 지역 타겟팅 옵션 및 여러 리소스 필터링 최종 업데이트 시간을 기준으로 메서드 결과를 나열합니다. 새로운 새로운 LineItemWarningMessage를 사용하여 사용자에게 알림이 광고 항목이 지원 중단된 지역 타겟팅을 사용하고 있습니다.

새로운 기능

2020년 11월 5일

생성, 할당, 활성화 기능이 추가됨 수동 트리거를 사용하는 경우 도움이 될 수 있습니다 타겟팅 확장 옵션을 도입했습니다. 이 매개변수를 설정하면 광고 항목의 타겟팅을 확장하여 얻을 수 있습니다. 맞춤 세그먼트 ID 필드를 다음에 추가함 DoubleVerify 및 Integral Ad Science 대상 객체: 서드 파티 인증 타겟팅

새로운 기능

2020년 10월 12일

광고 항목에 가져오기 가능한 경고 메시지를 도입했습니다. 리소스 및 클릭률 (CTR) 실적 목표 유형을 선택할 수 있습니다. 추가됨 warningMessages 필드가 광고 항목을 나열할 때 필터링 가능한 필드로 추가되었습니다.

새로운 기능 외에 새 할당량 한도가 이제 적용됩니다. 일괄 요청 활용에 대한 새로운 문서를 참조하세요.

새로운 기능

2020년 8월 28일

광고주 감사 메서드의 응답에 새 필드를 추가했으며 필터링 가능한 새 필드를 다양한 목록 메서드로 변환할 수 있습니다.

새로운 기능

2020년 8월 4일

새로운 사용자 관리, 파트너, 파트너 타겟팅 서비스가 출시되었습니다. 사용자가 계정 항목 한도에 도달하는 것을 사전에 방지할 수 있는 도구를 도입했습니다. 오디오 광고 항목에 대한 지원과 광고 항목 및 게재 신청서 입찰 전략에 맞춤 입찰 알고리즘을 사용하는 기능이 추가되었습니다.

새로운 기능

2020년 6월 24일

파트너 및 광고주 채널에 대한 생성 메서드, 새로운 FirstAndThirdPartyAudience 필드 및 추가 거래소 enum 값이 추가된 소규모 업데이트가 출시되었습니다.

새로운 기능

2020년 6월 2일

타겟팅 가능한 항목의 하위 집합을 생성, 패치, 채우는 기능이 도입되었으며 채널, 디지털 콘텐츠 라벨 제외, 민감한 카테고리 제외의 세 가지 타겟팅 유형에 대한 광고주 수준 타겟팅을 수정할 수 있는 기능이 추가되었습니다.

새로운 기능

2020년 4월 27일

대규모 기능 세트를 출시하여 API 범위를 SDF 이상으로 확장했습니다. 추가됨 핵심 리소스 관리를 통해 광고주, 캠페인, 게재 신청서, 광고 항목 및 있습니다. 또한 새로운 기능을 통해 광고 항목 수준에서 타겟팅을 수정할 수 있습니다.

새로운 기능

다음 서비스가 추가되었습니다.

서비스방법
<ph type="x-smartling-placeholder"></ph> 광고주

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> advertisers.assets

<ph type="x-smartling-placeholder"></ph> 업로드
<ph type="x-smartling-placeholder"></ph> advertisers.campaigns

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> advertisers.channels

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> advertisers.creatives

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> advertisers.insertionOrders

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems

<ph type="x-smartling-placeholder"></ph> bulkEditLineItemAssignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> bulkListLineItemAssignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> advertisers.lineItems.targetingTypes.assignedTargetingOptions

<ph type="x-smartling-placeholder"></ph> 만들기

<ph type="x-smartling-placeholder"></ph> 삭제

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> advertisers.locationLists

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> advertisers.negativeKeywordLists

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> combinedAudiences

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> customLists

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> firstAndThirdPartyAudiences

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> floodlightGroups

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 패치
<ph type="x-smartling-placeholder"></ph> googleAudiences

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> inventorySourceGroups

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> inventorySources

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> partners.channels

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록
<ph type="x-smartling-placeholder"></ph> partners.channels

<ph type="x-smartling-placeholder"></ph> 다운로드

<ph type="x-smartling-placeholder"></ph> 목록

2020년 3월 9일

Display & Video 360 API v1 API의 초기 버전입니다.

알려진 문제

없음