동영상 캠페인을 사용하면 YouTube와 Google 동영상 파트너에서 운영하는 웹사이트 및 앱에 동영상 광고를 게재할 수 있습니다.
API 제한사항
Google Ads API는 주로 기존 동영상 캠페인, 광고 그룹, 광고, 기준을 가져오고 보고하는 기능을 지원합니다. 다음 버전별 예외 및 동작을 제외하고 Google Ads API를 사용하여 동영상 캠페인을 만들거나 변경할 수 없습니다.
VideoResponsiveAdInfo변경 가능 여부:v24부터VideoResponsiveAdInfo객체는 변경 가능합니다 (이전 버전에서는 변경 불가능).VideoResponsiveAdInfo을 만들거나 변경할 때videos,business_name,logo_images필드가 필수입니다.- 브랜드 안전성 적합성:
v24부터 캠페인 수준campaign.video_brand_safety_suitability이(가) 삭제됩니다.customer.video_brand_safety_suitability를 사용하여 계정 수준에서 브랜드 안전성 적합성을 쿼리합니다. - 동영상 캠페인 실험:
v24부터experiment.video_experiment을 사용하여 동영상 캠페인으로 구성된YOUTUBE_CUSTOM실험을 구성할 수 있습니다.
캠페인 관리 대안
프로그래매틱 방식으로 동영상 캠페인을 만들거나 관리해야 하는 경우 다음 옵션을 고려하세요.
- Google Ads 스크립트: Google Ads 스크립트를 사용하여 동영상 캠페인을 관리할 수 있습니다. 이를 통해 Google Ads 인터페이스 내에서 자동 관리가 가능합니다.
- 디맨드젠 캠페인: YouTube를 비롯한 Google 서비스 전반에 동영상 광고를 게재하는 것이 목표인 경우, 디맨드젠 캠페인은 생성 및 관리를 위해 Google Ads API에서 완전히 지원됩니다.
실적 데이터 가져오기
campaign.advertising_channel_type = 'VIDEO'를 필터링하여 GoogleAdsService.SearchStream를 사용해 동영상 캠페인, 광고 그룹, 기준의 실적 데이터를 가져올 수 있습니다.
광고그룹 실적
다음 쿼리는 ad_group 리소스에서 TrueView 동영상 조회수와 사분위수 완료율을 비롯한 동영상 캠페인 및 광고 그룹 측정항목을 가져옵니다.
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
ad_group.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.video_trueview_views,
metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'
동영상 게재위치 및 기준 보고
ad_group_criterion는 측정항목이나 세그먼트를 직접 지원하지 않으므로 managed_placement_view와 같은 기준 보기 리소스를 사용하여 타겟팅된 YouTube 동영상, YouTube 채널 또는 기타 관리 게재위치의 실적 측정항목을 검색합니다.
SELECT
campaign.id,
ad_group.id,
ad_group_criterion.criterion_id,
ad_group_criterion.type,
ad_group_criterion.youtube_video.video_id,
ad_group_criterion.youtube_channel.channel_id,
metrics.impressions,
metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
AND segments.date DURING LAST_30_DAYS