- 리소스: 광고 소재
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation입니다.
- 애셋
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- 트랜스코드
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- 메서드
리소스: Creative
단일 광고 소재입니다.
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
필드 | |
---|---|
name |
출력 전용. 광고 소재의 리소스 이름입니다. |
advertiserId |
출력 전용. 광고 소재가 속한 광고주의 고유 ID입니다. |
creativeId |
출력 전용. 광고 소재의 고유 ID입니다. 시스템에서 할당합니다. |
cmPlacementId |
출력 전용. 광고 소재와 연결된 Campaign Manager 360 게재위치의 고유 ID입니다. 이 입력란은 Campaign Manager에서 동기화된 광고 소재에만 적용됩니다. |
displayName |
필수 항목입니다. 광고 소재의 표시 이름입니다. 최대 240바이트의 UTF-8 인코딩이어야 합니다. |
entityStatus |
필수 항목입니다. 광고 소재의 게재 가능 여부를 제어합니다. 허용되는 값은 다음과 같습니다.
|
updateTime |
출력 전용. 사용자 또는 시스템에 의해 광고 소재가 마지막으로 업데이트된 타임스탬프입니다 (예: 광고 소재 검토). 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
createTime |
출력 전용. 광고 소재가 생성된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
creativeType |
필수 항목입니다. 변경할 수 없습니다. 광고 소재의 유형입니다. |
hostingSource |
필수 항목입니다. 광고 소재가 호스팅되는 위치를 나타냅니다. |
dynamic |
출력 전용. 광고 소재가 동적인지 여부를 나타냅니다. |
dimensions |
필수 항목입니다. 광고 소재의 기본 크기입니다. 모든 광고 소재 유형에 적용할 수 있습니다.
|
additionalDimensions[] |
추가 측정기준
이 필드가 지정되면 |
mediaDuration |
출력 전용. 광고 소재의 미디어 길이입니다.
초 단위 기간으로, 소수점 아래 9자리까지 지정 가능하며 ' |
creativeAttributes[] |
출력 전용. 시스템에서 생성된 광고 소재의 속성 목록입니다. |
reviewStatus |
출력 전용. 광고 소재 검토 과정의 현재 상태입니다. |
assets[] |
필수 항목입니다. 이 광고 소재에 연결된 애셋입니다. 애셋은 다음 역할 중 하나로 광고 소재에 연결될 수 있습니다.
|
exitEvents[] |
필수 항목입니다. 이 광고 소재의 이탈 이벤트입니다. 이탈 (클릭 태그라고도 함)은 광고 소재에서 사용자가 클릭하거나 탭하여 광고주의 방문 페이지를 열 수 있는 모든 영역을 의미합니다. 모든 광고 소재에는 이탈이 하나 이상 포함되어 있어야 합니다. 다음과 같은 방법으로 광고 소재에 이탈을 추가할 수 있습니다.
|
timerEvents[] |
리치 미디어 광고 소재의 타이머 맞춤 이벤트입니다. 타이머는 사용자가 리치 미디어 소재의 지정된 부분을 보고 상호작용하는 시간을 추적합니다. 광고 소재 하나에 여러 개의 타이머 이벤트가 있을 수 있으며 각 타이머 이벤트의 시간은 독립적으로 기록됩니다. 이미지 확장 소재만 포함하는 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
counterEvents[] |
리치 미디어 광고 소재의 카운터 이벤트입니다. 카운터는 사용자가 지정된 방식 (마우스오버, 마우스아웃, 클릭, 탭, 데이터 로드, 키보드 입력 등)으로 리치 미디어 광고 소재의 일부와 상호작용한 횟수를 추적합니다. 광고 소재에서 캡처할 수 있는 모든 이벤트는 카운터로 기록될 수 있습니다. 이미지 확장 소재만 포함하는 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
appendedTag |
광고 소재 태그에 추가될 제3자 HTML 추적 태그입니다. |
integrationCode |
이 광고 소재를 외부 시스템에 연결하는 데 사용되는 ID 정보입니다. 10,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다. |
notes |
이 광고 소재에 대한 사용자 메모입니다. 20,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다. |
iasCampaignMonitoring |
Integral Ad Science (IAS) 캠페인 모니터링이 사용 설정되었는지 여부를 나타냅니다. 광고 소재에 이 기능을 사용 설정하려면 |
companionCreativeIds[] |
동영상 광고 소재의 컴패니언 광고 소재 ID입니다. 기존 디스플레이 광고 소재 (이미지 또는 HTML5 애셋 포함)를 할당하여 게시자의 동영상 플레이어 주변에 게재할 수 있습니다. 컴패니언은 동영상이 재생되는 동안 동영상 플레이어 주위에 표시되며 동영상이 끝난 후에도 남아 있습니다.
이 필드는 다음
|
skippable |
사용자가 동영상 광고 소재 건너뛰기를 선택할 수 있는지 여부입니다. 이 필드는 다음
|
skipOffset |
동영상이 재생되기 전까지 건너뛰기 버튼이 표시될 때까지 걸리는 시간입니다.
이 필드는 다음
|
progressOffset |
조회수를 집계하기 전에 동영상을 재생한 시간입니다.
이 필드는 다음
|
universalAdId |
선택사항입니다. 레지스트리에서 제공하는 광고 소재 식별자(선택사항)로, 모든 플랫폼에서 고유합니다. 범용 광고 ID는 VAST 4.0 표준의 일부입니다. 광고 소재를 만든 후에 수정할 수 있습니다. 이 필드는 다음
|
thirdPartyUrls[] |
동영상 광고 소재와의 상호작용을 추적하기 위한 타사의 추적 URL 이 필드는 다음
|
transcodes[] |
출력 전용. 오디오/동영상 트랜스코드 Display & Video 360은 특정 동영상 플레이어 또는 대역폭에 맞게 설계된 다양한 파일 형식을 사용하거나 속성 (해상도, 오디오 비트 전송률, 동영상 비트 전송률)이 다른 여러 대체 버전으로 기본 애셋을 트랜스코딩합니다. 이러한 트랜스코드를 사용하면 게시자의 시스템에서 동영상의 각 노출에 대해 더 많은 옵션을 선택할 수 있으며 뷰어의 연결 및 화면 크기에 따라 적절한 파일이 게재됩니다. 이 필드는 다음
|
trackerUrls[] |
분석 제공업체 또는 서드 파티 광고 기술 공급업체용 추적 URL URL은 https로 시작해야 합니다 (SSL 준수를 요구하지 않는 인벤토리 제외). URL에 매크로를 사용하는 경우 Display & Video 360에서 지원하는 매크로만 사용하세요. 표준 URL만 사용하고 IMG 또는 script 태그는 사용하지 마세요. 이 필드는 다음
|
jsTrackerUrl |
지원되는 서드 파티 인증 제공업체 (ComScore, DoubleVerify, IAS, Moat)의 자바스크립트 측정 URL입니다. HTML 스크립트 태그는 지원되지 않습니다. 이 필드는 다음
|
cmTrackingAd |
광고 소재와 연결된 Campaign Manager 360 추적 광고입니다. Campaign Manager 360과 서드 파티 광고 게재를 모두 사용하는 광고주가 만든 경우 다음
다른 사례의 경우에만 출력됩니다. |
obaIcon |
동영상 광고 소재의 OBA 아이콘을 지정합니다. 이 필드는 다음
|
thirdPartyTag |
선택사항입니다. 광고 소재에 사용된 원래의 서드 파티 태그입니다. 필수이며 서드 파티 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requireMraid |
선택사항입니다. 광고 소재에 MRAID (모바일 리치 미디어 광고 인터페이스 정의 시스템)가 필요함을 나타냅니다. 광고 소재가 상호작용을 위해 모바일 동작(예: 스와이프 또는 탭)을 사용하는 경우 이 속성을 설정합니다. 선택사항이며 서드 파티 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requireHtml5 |
선택사항입니다. 광고 소재가 제대로 렌더링되기 위해 HTML5를 사용함을 나타냅니다. 선택사항이며 서드 파티 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requirePingForAttribution |
선택사항입니다. 광고 소재가 기여를 위해 반환 핑을 기다릴 것임을 나타냅니다. Campaign Manager 360 추적 광고를 서드 파티 광고 서버 매개변수 및 ${DC_DBM_TOKEN} 매크로와 함께 사용하는 경우에만 유효합니다. 선택사항이며 서드 파티 태그 광고 소재 또는 서드 파티 VAST 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
타사 VAST 태그 광고 소재는 다음
다음
|
expandingDirection |
선택사항입니다. 광고 소재의 확장 방향을 지정합니다. 서드 파티 확장형 광고 소재에만 사용할 수 있는 필수사항입니다. 서드 파티 확장형 광고 소재는 다음과 같은 호스팅 소스를 포함하는 광고 소재입니다.
다음
|
expandOnHover |
선택사항입니다. 광고 소재가 마우스 오버 시 자동으로 확장됨을 나타냅니다. 선택사항이며 서드 파티 확장형 광고 소재에만 유효합니다. 서드 파티 확장형 광고 소재는 다음과 같은 호스팅 소스를 포함하는 광고 소재입니다.
다음
|
vastTagUrl |
선택사항입니다. 서드 파티 VAST 태그 광고 소재의 VAST 태그 URL입니다. 필수이며 서드 파티 VAST 태그 광고 소재에만 유효합니다. 타사 VAST 태그 광고 소재는 다음
다음
|
vpaid |
출력 전용. 타사 VAST 태그 광고 소재에 VPAID (Digital Video Player-Ad Interface)가 필요함을 나타냅니다. 출력 전용이며 서드 파티 VAST 태그 광고 소재에만 유효합니다. 타사 VAST 태그 광고 소재는 다음
다음
|
html5Video |
출력 전용. 타사 VAST 태그 광고 소재에 HTML5 동영상 지원이 필요함을 나타냅니다. 출력 전용이며 서드 파티 VAST 태그 광고 소재에만 유효합니다. 타사 VAST 태그 광고 소재는 다음
다음
|
lineItemIds[] |
출력 전용. 이 광고 소재가 연결된 광고 항목의 ID입니다. 광고 소재를 광고 항목에 연결하려면 |
mp3Audio |
출력 전용. 서드 파티 오디오 광고 소재가 MP3를 지원함을 나타냅니다. 출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다. 서드 파티 오디오 광고 소재는 다음과 같은
다음
|
oggAudio |
출력 전용. 서드 파티 오디오 광고 소재가 OGG를 지원함을 나타냅니다. 출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다. 서드 파티 오디오 광고 소재는 다음과 같은
다음
|
HostingSource
광고 소재의 가능한 호스팅 소스입니다. 광고 소재가 생성되고 호스팅되는 위치를 나타냅니다.
열거형 | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
이 버전에서 호스팅 소스가 지정되지 않았거나 알 수 없습니다. |
HOSTING_SOURCE_CM |
Campaign Manager 360에서 동기화된 광고 소재 이 호스팅 유형에는 생성 및 업데이트 메서드가 지원되지 않습니다. |
HOSTING_SOURCE_THIRD_PARTY |
3PAS (제3자 광고 서버)에서 호스팅하는 광고 소재입니다.
|
HOSTING_SOURCE_HOSTED |
DV360에서 생성되고 Campaign Manager 360에서 호스팅하는 광고 소재입니다.
|
HOSTING_SOURCE_RICH_MEDIA |
Studio에서 제작되고 Campaign Manager 360에서 호스팅하는 리치 미디어 광고 소재입니다. 이 호스팅 유형에는 생성 및 업데이트 메서드가 지원되지 않습니다. |
CreativeAttribute
광고 소재에 가능한 속성입니다.
열거형 | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
이 버전에서 광고 소재 속성이 지정되지 않았거나 알 수 없습니다. |
CREATIVE_ATTRIBUTE_VAST |
광고 소재가 VAST 광고 소재입니다. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
광고 소재는 선형 VPAID 광고 소재입니다. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
광고 소재가 비선형 VPAID 광고 소재입니다. |
ReviewStatusInfo
광고 소재의 상태를 검토합니다.
JSON 표현 |
---|
{ "approvalStatus": enum ( |
필드 | |
---|---|
approvalStatus |
광고 소재를 게재하는 데 필요한 기본 승인을 나타냅니다. |
creativeAndLandingPageReviewStatus |
광고 소재의 광고 소재 및 방문 페이지 검토 상태입니다. |
contentAndPolicyReviewStatus |
광고 소재의 콘텐츠 및 정책 검토 상태입니다. |
exchangeReviewStatuses[] |
광고 소재의 Exchange 검토 상태입니다. |
publisherReviewStatuses[] |
광고 소재의 게시자 검토 상태입니다. |
ApprovalStatus
승인 상태의 유형입니다. creativeAndLandingPageReviewStatus
및 contentAndPolicyReviewStatus
의 요약입니다.
열거형 | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
광고 소재가 아직 검토 중이며 게재할 수 없습니다. |
APPROVAL_STATUS_PENDING_SERVABLE |
광고 소재가 광고 소재 및 방문 페이지 검토를 통과했으며 게재할 수는 있지만, 추가 콘텐츠 및 정책 검토를 기다리는 중입니다. |
APPROVAL_STATUS_APPROVED_SERVABLE |
광고 소재 및 방문 페이지 검토와 콘텐츠 및 정책 검토가 모두 승인되었습니다. 광고 소재를 게재할 수 있습니다. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
광고 소재에 문제가 있습니다. 이 문제를 해결해야 광고를 게재할 수 있습니다. |
ReviewStatus
가능한 검토 상태 유형입니다.
열거형 | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다. |
REVIEW_STATUS_APPROVED |
광고 소재가 승인되었습니다. |
REVIEW_STATUS_REJECTED |
광고 소재가 거부되었습니다. |
REVIEW_STATUS_PENDING |
광고 소재가 검토 대기 중입니다. |
ExchangeReviewStatus
광고 소재의 Exchange 검토 상태입니다.
JSON 표현 |
---|
{ "exchange": enum ( |
필드 | |
---|---|
exchange |
광고 소재를 검토 중인 광고 거래소입니다. |
status |
거래소 검토 상태입니다. |
PublisherReviewStatus
광고 소재의 게시자 검토 상태입니다.
JSON 표현 |
---|
{
"publisherName": string,
"status": enum ( |
필드 | |
---|---|
publisherName |
광고 소재를 검토하는 게시자입니다. |
status |
게시자 검토 상태입니다. |
AssetAssociation
광고 소재의 애셋 연결입니다.
JSON 표현 |
---|
{ "asset": { object ( |
필드 | |
---|---|
asset |
연결된 저작물입니다. |
role |
광고 소재에서 이 애셋의 역할입니다. |
저작물
단일 저작물입니다.
JSON 표현 |
---|
{ "mediaId": string, "content": string } |
필드 | |
---|---|
mediaId |
업로드된 애셋의 미디어 ID입니다. 저작물의 고유 식별자입니다. 이 ID를 다른 API 호출(예: |
content |
저작물 콘텐츠입니다. 업로드된 애셋의 경우 콘텐츠가 게재 경로가 됩니다. |
AssetRole
광고 소재에서 이 애셋의 역할입니다.
열거형 | |
---|---|
ASSET_ROLE_UNSPECIFIED |
이 버전에서 애셋 역할이 지정되지 않았거나 알 수 없습니다. |
ASSET_ROLE_MAIN |
애셋은 광고 소재의 기본 애셋입니다. |
ASSET_ROLE_BACKUP |
애셋은 광고 소재의 백업 애셋입니다. |
ASSET_ROLE_POLITE_LOAD |
애셋은 광고 소재의 폴라이트 로드 애셋입니다. |
ASSET_ROLE_HEADLINE |
네이티브 광고 소재의 제목입니다.
이 역할은 다음
|
ASSET_ROLE_LONG_HEADLINE |
네이티브 광고 소재의 긴 광고 제목입니다.
이 역할은 다음
|
ASSET_ROLE_BODY |
네이티브 광고 소재의 본문 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_LONG_BODY |
네이티브 광고 소재의 긴 본문 텍스트
이 역할은 다음
|
ASSET_ROLE_CAPTION_URL |
광고 소재에 표시할 방문 페이지 URL의 짧고 사용하기 쉬운 버전입니다. 사용자는 이 URL을 통해 광고 소재를 클릭하면 어디로 연결될지 짐작할 수 있습니다.
예를 들어 방문 페이지 URL이 'http://www.example.com/page'이면 자막 URL은 'example.com'일 수 있습니다. 프로토콜 (http://)은 선택사항이지만 URL에 공백이나 특수문자를 포함할 수 없습니다. 이 역할은 다음
|
ASSET_ROLE_CALL_TO_ACTION |
네이티브 광고 소재의 클릭 유도 문구 버튼에 사용할 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_ADVERTISER_NAME |
광고주 또는 브랜드 이름을 식별하는 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_PRICE |
Google Play 스토어 또는 iOS 앱 스토어에서의 앱 구매 가격 (예: 5.99달러)입니다. 이 값은 스토어에 나열된 실제 값과 자동으로 동기화되지 않습니다. 광고 소재를 저장할 때 항상 제공된 값이 됩니다.
이 역할은 다음
|
ASSET_ROLE_ANDROID_APP_ID |
Google Play 스토어의 Android 앱 ID입니다. 이 ID는 앱의 Google Play 스토어 URL의 'id' 뒤에 표시됩니다. 예를 들어 https://play.google.com/store/apps/details?id=com.company.appname에서 식별자는 com.company.appname입니다. 이 역할은 다음
|
ASSET_ROLE_IOS_APP_ID |
Apple App Store의 iOS 앱 ID입니다. 이 ID 번호는 Apple App Store URL에서 'id' 바로 뒤에 있는 숫자열에서 찾을 수 있습니다. 예를 들어 https://apps.apple.com/us/app/gmail-email-by-google/id422689480에서 ID는 422689480입니다. 이 역할은 다음
|
ASSET_ROLE_RATING |
Google Play 스토어 또는 iOS 앱 스토어에 있는 앱의 평점입니다. 이 값은 스토어의 실제 평점과 자동으로 동기화되지 않습니다. 광고 소재를 저장할 때 항상 제공된 값이 됩니다. 이 역할은 다음
|
ASSET_ROLE_ICON |
광고 소재의 아이콘입니다. 이 역할은 다음
|
ASSET_ROLE_COVER_IMAGE |
네이티브 동영상 광고 소재의 표지 이미지입니다. 이 역할은 다음
|
ExitEvent
광고 소재의 이탈 이벤트입니다.
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type |
필수 항목입니다. 이탈 이벤트의 유형입니다. |
url |
필수 항목입니다. 이탈 이벤트의 클릭연결 URL입니다.
|
name |
이탈 이벤트의 클릭 태그 이름입니다. 이름은 하나의 광고 소재 내에서 고유해야 합니다. 이미지 확장 소재만 포함하는 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
reportingName |
보고서에서 이 이벤트를 식별하는 데 사용되는 이름입니다. 이미지 확장 소재만 포함하는 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
ExitEventType
이탈 이벤트의 유형입니다.
열거형 | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
이 버전에서 이탈 이벤트 유형이 지정되지 않았거나 알 수 없습니다. |
EXIT_EVENT_TYPE_DEFAULT |
이탈 이벤트가 기본 이벤트입니다. |
EXIT_EVENT_TYPE_BACKUP |
이탈 이벤트는 백업 이탈 이벤트입니다. 하나의 광고 소재에 여러 개의 백업 이탈 이벤트가 있을 수 있습니다. |
TimerEvent
광고 소재의 타이머 이벤트입니다.
JSON 표현 |
---|
{ "name": string, "reportingName": string } |
필드 | |
---|---|
name |
필수 항목입니다. 타이머 이벤트의 이름입니다. |
reportingName |
필수 항목입니다. 보고서에서 이 타이머 이벤트를 식별하는 데 사용되는 이름입니다. |
CounterEvent
광고 소재의 카운터 이벤트입니다.
JSON 표현 |
---|
{ "name": string, "reportingName": string } |
필드 | |
---|---|
name |
필수 항목입니다. 카운터 이벤트의 이름입니다. |
reportingName |
필수 항목입니다. 보고서에서 이 카운터 이벤트를 식별하는 데 사용되는 이름입니다. |
AudioVideoOffset
오디오 또는 동영상이 재생된 길이입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 offset . 오프셋의 값입니다. offset 은 다음 중 하나여야 합니다. |
|
percentage |
오디오 또는 동영상 길이의 백분율로 표시되는 오프셋입니다. |
seconds |
오디오 또는 동영상의 시작 부분으로부터의 오프셋(초)입니다. |
UniversalAdId
레지스트리에서 제공하는 광고 소재 식별자로, 모든 플랫폼에서 고유합니다. 이는 VAST 4.0 표준의 일부입니다.
JSON 표현 |
---|
{
"id": string,
"registry": enum ( |
필드 | |
---|---|
id |
고유한 광고 소재 식별자입니다. |
registry |
등록처에서 고유한 광고 소재 식별자를 제공합니다. |
UniversalAdRegistry
등록처는 범용 광고 ID에 고유한 광고 소재 식별자를 제공합니다.
열거형 | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
이 버전에서 범용 광고 레지스트리가 지정되지 않았거나 알 수 없습니다. |
UNIVERSAL_AD_REGISTRY_OTHER |
맞춤 제공업체를 통해 범용 광고 ID를 제공합니다. |
UNIVERSAL_AD_REGISTRY_AD_ID |
광고 ID를 사용하여 범용 광고 ID를 입력합니다. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
clearcast.co.uk를 사용하여 범용 광고 ID를 입력합니다. |
UNIVERSAL_AD_REGISTRY_DV360 |
Display & Video 360을 사용하여 범용 광고 ID를 입력합니다. |
UNIVERSAL_AD_REGISTRY_CM |
Campaign Manager 360을 사용하여 범용 광고 ID를 제공합니다. |
ThirdPartyUrl
오디오 또는 동영상 광고 소재와의 상호작용을 추적하기 위한 서드 파티의 추적 URL
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type |
상호작용 유형은 추적 URL로 추적해야 함 |
url |
상호작용을 추적하는 데 사용되는 추적 URL입니다.
|
ThirdPartyUrlType
상호작용 유형은 서드 파티 추적 URL로 추적해야 합니다.
열거형 | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
이 버전에서 서드 파티 URL 유형이 지정되지 않았거나 알 수 없습니다. |
THIRD_PARTY_URL_TYPE_IMPRESSION |
오디오 또는 동영상 버퍼링이 완료된 후에 광고 소재의 노출수를 계산하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
오디오 또는 동영상에 대한 사용자의 클릭을 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
사용자가 오디오 또는 동영상을 시작한 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
오디오 또는 동영상이 전체 길이의 25% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
오디오 또는 동영상이 전체 길이의 50% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
오디오 또는 동영상이 전체 길이의 75% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
오디오 또는 동영상이 끝까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
사용자가 오디오 또는 동영상을 음소거하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
사용자가 오디오 또는 동영상을 일시중지하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
사용자가 오디오 또는 동영상을 다시 재생하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
사용자가 플레이어를 전체 화면 크기로 확장하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
사용자가 오디오 또는 동영상을 중지하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
사용자가 맞춤 클릭(예: 동영상 핫스팟 클릭)을 수행한 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
오디오 또는 동영상을 건너뛴 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
progressOffset 에 의해 결정된 오프셋까지 오디오 또는 동영상이 재생되는 횟수를 추적하는 데 사용됩니다. |
트랜스코딩
트랜스코딩된 오디오 또는 동영상 파일에 대한 정보를 나타냅니다.
JSON 표현 |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
필드 | |
---|---|
name |
트랜스코딩된 파일의 이름입니다. |
mimeType |
트랜스코딩된 파일의 MIME 유형입니다. |
transcoded |
트랜스코딩이 성공했는지 여부를 나타냅니다. |
dimensions |
트랜스코딩된 동영상의 크기입니다. |
bitRateKbps |
트랜스코딩된 동영상의 트랜스코딩 비트 전송률(kbit/초)입니다. |
frameRate |
트랜스코딩된 동영상의 프레임 속도(초당 프레임 수)입니다. |
audioBitRateKbps |
트랜스코딩된 동영상의 오디오 스트림에 대한 비트 전송률 또는 트랜스코딩된 오디오의 비트 전송률(kbit/초)입니다. |
audioSampleRateHz |
트랜스코딩된 동영상의 오디오 스트림에 대한 샘플링 레이트 또는 트랜스코딩된 오디오의 샘플링 레이트(Hz)입니다. |
fileSizeBytes |
트랜스코딩된 파일의 크기(바이트)입니다. |
CmTrackingAd
Campaign Manager 360 추적 광고
JSON 표현 |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
필드 | |
---|---|
cmPlacementId |
캠페인 관리자 360 추적 광고의 게재위치 ID입니다. |
cmCreativeId |
캠페인 관리자 360 추적 광고의 광고 소재 ID입니다. |
cmAdId |
캠페인 관리자 360 추적 광고의 광고 ID입니다. |
ObaIcon
광고 소재 OBA 아이콘
JSON 표현 |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
필드 | |
---|---|
resourceUrl |
OBA 아이콘 리소스의 URL입니다. |
resourceMimeType |
OBA 아이콘 리소스의 MIME 유형입니다. |
position |
광고 소재에서 OBA 아이콘의 위치입니다. |
dimensions |
OBA 아이콘의 크기입니다. |
program |
OBA 아이콘의 프로그램입니다. (예: 'AdChoices') |
landingPageUrl |
필수 항목입니다. OBA 아이콘의 방문 페이지 URL입니다. 다음 도메인의 URL만 허용됩니다. |
clickTrackingUrl |
필수 항목입니다. OBA 아이콘의 클릭 추적 URL입니다. 다음 도메인의 URL만 허용됩니다. |
viewTrackingUrl |
필수 항목입니다. OBA 아이콘의 보기 추적 URL입니다. 다음 도메인의 URL만 허용됩니다. |
ObaIconPosition
광고 소재에서 OBA 아이콘의 위치입니다.
열거형 | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
OBA 아이콘 위치가 지정되지 않았습니다. |
OBA_ICON_POSITION_UPPER_RIGHT |
광고 소재의 오른쪽 상단 |
OBA_ICON_POSITION_UPPER_LEFT |
광고 소재의 왼쪽 상단 |
OBA_ICON_POSITION_LOWER_RIGHT |
광고 소재의 오른쪽 하단 |
OBA_ICON_POSITION_LOWER_LEFT |
광고 소재의 왼쪽 하단에 위치 |
ExpandingDirection
서드 파티 확장형 광고 소재의 확장 방향입니다.
열거형 | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
확장 방향이 지정되지 않았습니다. |
EXPANDING_DIRECTION_NONE |
어떤 방향으로도 확장되지 않습니다. |
EXPANDING_DIRECTION_UP |
위로 확장됩니다. |
EXPANDING_DIRECTION_DOWN |
아래로 확장됩니다. |
EXPANDING_DIRECTION_LEFT |
왼쪽으로 확장합니다. |
EXPANDING_DIRECTION_RIGHT |
오른쪽으로 확장됩니다. |
EXPANDING_DIRECTION_UP_AND_LEFT |
위로 및 왼쪽으로 확장됩니다. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
오른쪽 위로 확장됩니다. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
아래쪽으로 펼쳐집니다. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
오른쪽 아래로 확장됩니다. |
EXPANDING_DIRECTION_UP_OR_DOWN |
위 또는 아래로 확장됩니다. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
왼쪽 또는 오른쪽으로 확장됩니다. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
대각선 방향으로 확장할 수 있습니다. |
방법 |
|
---|---|
|
새 광고 소재를 만듭니다. |
|
광고 소재를 삭제합니다. |
|
광고 소재를 가져옵니다. |
|
광고주의 광고 소재를 나열합니다. |
|
기존 광고 소재를 업데이트합니다. |