このページは Cloud Translation API によって翻訳されました。

動画キャンペーン

Google 広告スクリプトを使用すると、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 広告スクリプトでは、 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();

インストリーム動画広告は、他の動画の前後または途中に再生できるため、指定した時間後にスキップするオプションをユーザーに提供します。TrueView ディスカバリー広告は、さまざまな 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 動画をリンクする。そのためには、 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() の後にチェーン）:

inStreamAdBuilder()
videoDiscoveryAdBuilder()
bumperAdBuilder()
responsiveVideoAdBuilder() （VIDEO_ACTION 個のキャンペーンのみ）
nonSkippableAdBuilder() （VIDEO_NON_SKIPPABLE 個のキャンペーンのみ）

例:

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();

動画ターゲティング

動画キャンペーンに関連するターゲティングは 2 種類あります。「 VideoCampaignTargeting 動画キャンペーンのアカウント単位で行われたターゲティングを表します AdsApp.videoCampaignTargeting() を使用してアクセスします。このスクリプトでは変更できませんが、表示することはできます。

もう一方のターゲティングでは、動画キャンペーンの条件を指定できます。動画広告グループを個別に作成しますこの API にはキャンペーンまたは広告グループの 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();
}