동영상 캠페인

Google Ads 스크립트를 사용하면 YouTube 기반 동영상 캠페인을 관리하고 보고할 수 있습니다. 스크립트를 사용하여 기존 동영상 캠페인을 관리하고, 광고 그룹 및 광고를 만들고 관리하고, 캠페인의 타겟팅을 설정하고, 보고서를 실행할 수 있습니다. 하지만 스크립트를 사용하여 동영상 캠페인을 만들 수는 없습니다.

동영상 캠페인 및 광고그룹 검색

동영상 캠페인은 AdsApp 객체의 videoCampaigns 컬렉션을 통해 사용할 수 있습니다. 스크립트에서 일반적으로 캠페인을 검색하는 것처럼 검색할 수 있습니다.

const campaignName = "My first video campaign";

const campaignIterator = AdsApp.videoCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

캠페인을 검색한 후 비슷한 방식으로 광고 그룹을 가져올 수 있습니다.

const adGroupIterator = campaign.videoAdGroups()
    .withCondition(`ad_group.name = "${adGroupName}"`)
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

또는 AdsApp.videoAdGroups() 메서드를 사용할 수 있습니다.

const adGroupIterator = AdsApp.videoAdGroups()
    .withCondition(`campaign.name = "${campaignName}" AND ad_group.name = "${adGroupName}")
    .get();

for (const adGroup of adGroupIterator) {
  ...
}

동영상 광고 만들기

Google Ads 스크립트를 사용하면 VideoAdGroup의 videoAds() 메서드를 사용하여 동영상 광고를 검색할 수 있습니다. VideoAdGroup의 newVideoAd() 메서드를 사용하여 새 동영상 광고를 만들 수 있습니다.

동영상 광고 형식

지원되는 동영상 광고 형식은 동영상 캠페인 유형에 따라 다릅니다. 올바른 유형의 동영상 캠페인을 선택하려면 AdvertisingChannelSubType에서 withCondition 호출을 추가합니다.

일부 동영상 캠페인에는 해당 캠페인 내에서 지원되는 광고 유형을 제한하는 하위유형이 있습니다. 구체적으로 VIDEO_ACTION 캠페인은 VIDEO_RESPONSIVE 광고 유형만 지원하고 VIDEO_NON_SKIPPABLE 캠페인은 NON_SKIPPABLE_INSTREAM_VIDEO_AD 광고 유형만 지원합니다.

특정 유형의 캠페인을 운영하는 가장 좋은 방법은 선택기에 withCondition 절을 사용하는 것입니다. 관심 있는 캠페인 유형의 AdvertisingChannelSubType를 업데이트할 수 있습니다.

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = VIDEO_ACTION")
  .get();

하위유형이 없는 동영상 캠페인은 다음과 같은 동영상 광고 형식을 지원합니다.

  • TrueView 인스트림 광고
  • TrueView 동영상 디스커버리
  • 범퍼 광고

withCondition를 사용하여 다음 캠페인을 선택할 수 있습니다.

const campaignIterator = AdsApp.videoCampaigns()
  .withCondition("AdvertisingChannelSubType = null")
  .get();

인스트림 동영상 광고는 다른 동영상 전후 또는 중간에 재생될 수 있으며, 사용자는 지정된 시간 후 광고를 건너뛸 수 있습니다. 동영상 디스커버리 광고는 디스플레이 네트워크 및 다양한 YouTube 페이지에 게재되며 사용자가 먼저 광고 썸네일을 직접 클릭한 경우에만 재생됩니다. 범퍼 광고는 6초 이하이며 YouTube 동영상 또는 디스플레이 네트워크의 파트너 사이트 및 앱의 동영상에 게재될 수 있습니다. 이러한 각 광고 유형에 관한 자세한 내용은 동영상 광고 형식 정보를 참고하세요.

광고 그룹 빌드

동영상 캠페인의 newVideoAdGroupBuilder() 메서드를 통해 동영상 광고 그룹을 만듭니다. 광고 그룹을 만들 때 광고 그룹 유형과 광고 그룹 이름을 지정해야 합니다. 광고 그룹 유형은 다음 중 하나여야 하며 광고 그룹을 만든 후에는 변경할 수 없습니다.

  • TRUE_VIEW_IN_STREAM
  • TRUE_VIEW_IN_DISPLAY
  • BUMPER
  • VIDEO_RESPONSIVE (VIDEO_ACTION 캠페인만 해당)
  • NON_SKIPPABLE_INSTREAM_VIDEO_AD (VIDEO_NON_SKIPPABLE 캠페인만 해당)

예:

const videoAdGroup =
    videoCampaign.newVideoAdGroupBuilder()
    .withAdGroupType("TRUE_VIEW_IN_STREAM")
    .withName("Video Ad Group")
    .build()
    .getResult();

동영상 저작물 만들기

동영상 광고는 일반적으로 동영상 애셋을 참조해야 합니다. 이에 따라 광고에 재생할 동영상이 결정됩니다. 스크립트를 사용하여 동영상을 업로드할 수는 없지만 광고에 사용하기 위해 이전에 업로드한 기존 YouTube 동영상을 연결할 수는 있습니다. YouTubeVideoAssetBuilder로 Asset를 만들면 됩니다.

const assetOperation = AdsApp.adAsset().newYouTubeVideoAssetBuilder()
   .withName("name")
   // This is the ID in the URL for the YouTube video.
   .withYouTubeVideoId(youTubeVideoId)
   .build();
const videoAsset = assetOperation.getResult();

광고 빌드

새 광고를 만들려면 광고 그룹 유형과 일치하는 빌더 메서드(newVideoAd() 뒤에 체이닝됨)를 사용합니다.

예:

const videoAd = videoAdGroup.newVideoAd()
    .inStreamAdBuilder()
    .withAdName("Video Ad")
    .withFinalUrl(
        "http://www.example.com/video-ad")
    // Specify the video asset created in the last step.
    .withVideo(video)
    .build()
    .getResult();

동영상 타겟팅

동영상 캠페인에는 두 가지 유형의 관련성 타겟팅이 있습니다. VideoCampaignTargeting는 일반적으로 동영상 캠페인의 계정 수준에서 실행되는 모든 타겟팅을 나타내며 AdsApp.videoCampaignTargeting()를 사용하여 액세스합니다. 스크립트를 통해 수정할 수는 없지만 볼 수 있습니다.

다른 유형의 타겟팅을 사용하면 동영상 캠페인과 동영상 광고 그룹의 기준을 개별적으로 지정할 수 있습니다. 캠페인 또는 광고 그룹의 videoTargeting() 메서드로 액세스할 수 있으며, 해당 수준의 타겟팅에 적용되는 모든 유형의 긍정 및 부정 기준에 관한 선택기와 빌더에 대한 액세스를 제공합니다. 계정 수준에서 기준을 확인하기 위한 AdsApp.videoTargeting() 메서드도 있으며, 이 메서드에는 AdsApp.videoCampaignTargeting()와 다른 기준 집합이 포함되어 있습니다. VideoCampaignTargeting와 마찬가지로 이러한 기준은 스크립트로 관리할 수 없습니다.

다음은 캠페인에서 특정 게재위치를 제외하는 예입니다.

videoCampaign.videoTargeting().newPlacementBuilder()
    .withUrl("http://www.example.com")
    .exclude();

인구통계 기준 (연령, 성별)은 다른 기준 유형과 약간 다르게 작동합니다. 새 광고 그룹을 만들면 가능한 각 연령 및 성별 값에 대한 기준이 자동으로 생성되며 이 광고 그룹은 이 모든 값을 타겟팅합니다. 기존 타겟팅을 가져와서 exclude() 메서드를 호출하여 인구통계를 제외할 수 있으며, 기존 제외 타겟팅을 찾아 include()를 호출하여 제외된 인구통계를 다시 포함할 수 있습니다.

다음은 광고 그룹에서 특정 성별을 제외하는 예입니다.

const videoGenderIterator = videoAdGroup.videoTargeting()
    .genders()
    .withCondition('GenderType = "GENDER_MALE"')
    .get();
if (videoGenderIterator.hasNext()) {
  const videoGender = videoGenderIterator.next();
  videoGender.exclude();
}