影片廣告活動

Google Ads 指令碼可讓您管理 YouTube 影片廣告並製作相關報表 廣告活動。您可以使用指令碼 管理現有影片廣告活動、建立及管理廣告群組和廣告、設定 指定廣告活動，以及執行報表不過，您無法使用指令碼 建立影片廣告活動。

擷取影片廣告活動和廣告群組

影片廣告活動可在 videoCampaigns敬上 當中 AdsApp 物件。個人中心 來擷取這些廣告活動，就像在指令碼中擷取廣告活動一樣：

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 指令碼可讓您使用 videoAds()敬上 方法是 VideoAdGroup。 您可以使用 newVideoAd()敬上 VideoAdGroup 方法。

影片廣告格式

支援的影片廣告格式因影片廣告活動類型而異。為了確保 如果您選取的影片廣告活動類型正確無誤，請新增withCondition通話 在 AdvertisingChannelSubType。

部分影片廣告活動內含子類型，限制可放送的廣告類型 個別支援的廣告活動具體來說，只有 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 影片或 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 影片，以便在廣告中使用。 只要建立 Asset，其中包含 YouTubeVideoAssetBuilder。

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() 存取這個 但無法透過指令碼修改，但可以查看。

其他類型的指定目標可讓您為影片廣告活動指定條件 和影片廣告群組使用 GCP 控制台 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();
}