パブリッシャー ページ - アウトストリームのレベル オプション
このトピックでは、ページ コードでアウトストリーム ビデオを構成するために使用できる設定について説明します。 これらの設定は、メイン収益化に関するドキュメントで説明されている配置レベルのアウトストリーム パラメーターを補完します。
警告
Microsoft の販売者タグ (AST) を使用してページ コードを設定すると、収益化で作成されたすべての設定がオーバーライドされます。
次のアウトストリーム オプションは、[タグの定義] の設定内 rendererOptions でパブリッシャー レベルで 設定されます。 API で設定されたオプションは、収益化で作成されたすべての設定をオーバーライドします。
一般的なオプション
| オプション | 型 | 既定値 | 説明 | |
|---|---|---|---|---|
alignment |
string | センター | サイズがコンテナーよりも小さい場合のプレイヤーの配置。 受け入れられる値は次のとおりです。 -センター -左 -そうです |
|
aspectRatio |
string | 定義されておらず、fixedSizePlayer が false の場合、16:9 | プレーヤーのビデオ部分の縦横比。 ビデオをオーバーレイしないコントロール バーは考慮されません。 "auto" 設定では、ビデオ メタデータで定義されている縦横比が使用されます。 受け入れられる値は次のとおりです。 - "auto" - "16:9" - "4:3" |
|
audioOnMouseover (deprecated) |
-True -False -整数 |
true | この設定は、サウンドに関する現在のブラウザーの制限のため、サポートもテストも行われません。 ユーザーのマウスがビデオの上にあるときにオーディオを再生し、マウスがビデオの上にない場合はオーディオを一時停止/ミュート解除します。 整数を指定した場合、ビデオの上にマウスポインターを合わせるまで、オーディオは開始されません。 |
|
autoInitialSize |
ブール値 | false | true の場合、プレーヤーの幅はページ コンテナーと一致します。 false の場合、配置に設定されたプレイヤーの幅が使用されます。 | |
cbNotification |
特定の広告ユニットで呼び出されるコールバック関数。 関数フットプリントは次のとおりです。adCallback(eventType, eventName, adId, eventData)ここで、eventType は VPAID、VAST、AdUnit、eventName のいずれかであり、eventType カテゴリの 1 つです。表 1 を参照してください 。イベントの種類のカテゴリ 値は adId 、AST (ターゲット要素 ID) によって定義され、呼び出し時 renderAd() にレンダラーに渡される広告の ID になります。値は eventData 、イベントと共に渡される追加のデータになります。ウォーターフォール イベントの場合、これは次のフィールドを含むオブジェクトになります。 status (stepStart, stepFail, stepSuccess, timeout), step, totalAvailableSteps, stepLimit, maxTime, timeRemaining, failureReason (if status = stepFail) |
|||
disableCollapse |
object | 該当なし | ビデオ再生が完了したときに発生するアクションをユーザーが制御できるようにします。 詳細については、以下の「折りたたみ設定を無効にする」の表を参照してください。 | |
endCard |
object | 該当なし | ビデオ再生が完了した後もプレイヤーが開いたままのときにエンド カードが表示されるかどうかを判断するための構成。 詳細については、以下のエンド カード設定の表を参照してください。 | |
fixedSizePlayer |
ブール値 | false | true の場合、レンダリングされた最終的なプレイヤーの高さは、上または下のコントロール バーを含むプレイヤー全体の高さになります。 false の場合、レンダリングされた最終的なプレイヤーの高さはビデオ領域の高さになり、追加のコントロール バー (上のバー、下のコントロール バー) はプレーヤーの合計高さを増やします。 |
|
learnMore |
object | 該当なし | learnMore ボタンが有効になっている場合、ビデオをクリックすると広告のクリックとクリックスルーが発生します。 詳細については、以下の「詳細情報の設定」の表を参照してください。 | |
maxHeight |
ピクセル単位の true/false/height | false | 必要に応じて、次の例に示すように、プレイヤーの最大高さを有効にして設定します。 プレイヤーは縦横比を維持するように調整します。"maxHeight": { "enabled": true, "height": 480 }この設定は、垂直方向のビデオ プレゼンテーションを最適化するように設計されており、垂直方向の縦横比でのみ使用する必要があります。 推奨値など、詳細については、「 垂直ビデオ形式」を参照してください。 |
|
parentIframeGeometryCb |
関数コールバック | 該当なし | 非フレンドリな iFrame 実装ケースの場合のみ。 | |
parentIframeGeometryEvent |
string | 該当なし | 非フレンドリな iFrame 実装ケースの場合のみ。 | |
playerSkin |
object | 該当なし | アウトストリーム プレーヤーの外観を決定するための構成。 詳細については、以下のプレイヤー スキニング設定の表を参照してください。 | |
playOnMouseover |
ブール値 | false | この設定が true の場合、ユーザーのマウスがビデオの上にある間に再生されます。 マウスがビデオから離れると、マウスがビデオの上に戻ったときに一時停止して再生を再開します。 この設定が false の場合、ユーザーのマウスに関係なくビデオが再生されます。 |
|
playVideoVisibleThreshold |
integer | 50 | ビデオ コンテナーの可視性がこのしきい値を超えない限り、ビデオの再生は開始されません。 ビデオ コンテナーの可視性がこのしきい値を下回る場合、ビデオは、非ViewableBehavior で指定された動作に従います。 使用できる範囲は 1 から 100 です。 | |
sidestream |
object | 該当なし | ビデオをサイドストリーム モードで再生するかどうかを決定するための構成。 詳細については、以下のサイドストリーム設定の表を参照してください。 | |
skippable |
object | 該当なし | ビデオをスキップできるかどうかを判断するための構成とスキップ動作。 詳細については、以下のスキップ可能な設定の表を参照してください。 | |
vpaidEnvironmentVars |
JSON オブジェクト | 該当なし | vpaidEnvironmentVars を含む JSON オブジェクトを VPAID initAd() 呼び出しの "envinronmentVars" パラメーターとして VPAID クリエイティブに送信します。 | |
waterfallSteps |
integer | -1 | 広告を試して表示できるウォーターフォール試行の最大数。 詳細については、以下の「ウォーターフォール処理設定と仲介」セクションを参照してください。 | |
waterfallTimeout |
integer | 15000 | 仲介された広告ソースのウォーターフォール処理が実行可能な広告の配信を停止するまでに実行できる最大時間 (ミリ秒)。 詳細については、以下の「ウォーターフォール処理設定と仲介」セクションを参照してください。 |
イベントの種類のカテゴリ
| イベントの種類 | フィールド |
|---|---|
AdUnit |
collapseStart, collapseEnd, expandStart, expandEnd, adComplete, renderedPlayerSize, waterfall |
VAST |
creativeView, start, midpoint, firstQuartile, thirdQuartile, complete, mute, unmute, pause, rewind, resume, fullscreen, expand, collapse, close, exitFullscreen, skip, progress, acceptInvitation, acceptInvitationLinear, closeLinear, impression, error |
VPAID |
AdLoaded, AdStarted, AdStopped, AdSkipped, AdSkippableStateChange, AdSizeChange, AdLinearChange, AdDurationChange, AdExpandedChange, AdRemainingTimeChange, AdVolumeChange, AdImpression, AdVideoStart, AdVideoFirstQuartile, AdVideoMidpoint, AdVideoThirdQuartile, AdVideoComplete, onAdVClickThru, AdInteraction, AdUserAcceptInvitation, AdUserMinimize, AdUserClose, AdPaused, AdPlaying, AdLog, AdError |
折りたたみ設定を無効にする
これらの設定を使用すると、ユーザーはビデオ再生が完了したときに発生するアクションを制御できます。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
enabled |
boolean または integer | true | true の場合、アウトストリーム広告はビデオの最後に折りたたまれず、ビデオの最後に表示されていた最後の名声が表示されます。 コントロール バーがなく、クリックするとボタンまたはカウントダウン テキストが表示され、[広告インジケーター] と [スキップ] ボタンが残ります。 false の場合、再生と hideControlBar の値は問題になりません。ビデオは完了時に折りたたまれるためです。 整数が渡された場合、プレイヤーは広告を折りたたむ前に、渡された整数と等しいミリ秒単位の遅延を設定します。 |
hideControlBar |
ブール値 | false | true の場合、再生設定が false の場合、ビデオの完了後に下部のコントロール バーが非表示になります。 |
replay |
ブール値 | false | true の場合、ビデオが完了すると再生ボタンが表示され、ユーザーはビデオを再生できます。 |
終了カード設定
ノードを使用して、次の設定を endCard 構成します。 ビデオ再生が完了した後もプレイヤーが開いたままのときにエンド カードが表示されるかどうかを判断します。 終了カードを表示するには、最初に true に設定disableCollapse.enabledして、プレイ後に折りたたまないようにプレイヤーに指示します。 それ以外の場合、プレイヤーはプレイが完了すると閉じ、終了カード設定は無視されます。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
clickable |
ブール値 | true | true の場合、広告領域はクリック可能なままになりますが、終了カードが表示されます。 広告領域をクリックすると、広告がクリックされたかのように、表示したばかりの広告のクリックスルー URL が開きます。 |
color |
string | 該当なし | 終了カードが有効になっている場合は、ビデオの最後のフレームの上に色付きのレイヤーを描画します。 CSS カラー値 を使用します。 たとえば、黒の場合は「#000000」と入力します。 |
enabled |
ブール値 | false | true の場合、ビデオ プレーヤーが開いたまま、ビデオ 再生の最後にエンド カードが表示されます。 ただし、disableCollapse.enabled が false に設定されている場合、プレイヤーは終了カード設定は無視されます。 |
imageHeight |
string | 該当なし | が定義されている場合 imageUrl は、レンダリングされたイメージの高さ。 正確なピクセル幅 ("200px" など) を使用するか、パーセンテージベースの幅 ("100%" など) を指定して、広告領域のサイズが変更されたときに画像がスケーリングされるようにすることができます。が指定されていない場合 imageWidth 、イメージはネイティブ幅で描画されます。 |
imageURL |
string | 該当なし | コンパニオン広告が指定されていない場合、または使用可能な場合にカードに表示される画像の URL (https:を含む)。 イメージを指定すると、イメージ レイヤーがカラー レイヤーの上部 (色が指定されている場合) またはビデオ フレームの上に描画されます。と オプションを使用してimageWidthimageHeigh画像のサイズを指定しない限り、画像は広告領域の中央に配置され、ソース イメージのネイティブ解像度で描画されます。注: 通常、フォールバックとしてエンド カード イメージが使用され、コンパニオン広告は を使用して companionID定義されます。 有効なコンパニオン広告が利用可能な場合、画像は表示されません。 |
imageWidth |
string | 該当なし | が定義されている場合 imageUrl は、レンダリングされたイメージの幅。 正確なピクセル幅 ("320px" など) を使用したり、パーセンテージベースの幅 ("100%" など) を指定して、広告領域のサイズが変更されたときに画像がスケーリングされるようにすることができます。 imageWidth が指定されていない場合、イメージはネイティブ幅で描画されます。 |
showCompanion |
ブール値 | true | エンド カードにコンパニオン広告 (使用可能な場合) を表示するかどうかを指定します。 コンパニオンを使用しない広告の場合、によって定義imageUrlされた画像がエンド カードに表示されます。 複数のコンパニオンを含む広告の場合、エンド カードには、広告ユニット領域の縦横比とサイズに最も近いコンパニオン広告が表示されます。 |
その他の設定を確認する
警告
この learnMore 設定は HTML5 にのみ適用されます。
learnMore 設定を使用すると、ユーザーは、アウトストリーム ビデオが完了したときに learnMore ボタンが表示されるかどうか、および再生中にユーザーがビデオをクリックした場合に発生するアクションを制御できます。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
clickToPause |
ブール値 | true | true の場合、ビデオをクリックするとビデオが一時停止します。 false の場合、ビデオをクリックしても何も実行されません。 |
enabled |
ブール値 | false | true の場合、[ 詳細情報] ボタンが有効になり、ビデオ領域をクリックすると、広告のクリックとクリックスルーが発生します。 |
separator |
string | "-" | Learn More テキストと広告インジケーターの間の区切り記号のテキスト。 |
text |
string | "詳細情報" | [ 詳細情報 ] ボタンのテキスト。 |
プレイヤーのスキニング設定
ビデオ プレーヤー ユーザー インターフェイスの構成を有効にします。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
bigPlayButtonColor |
string | "#3B4249" | 一時停止時にビデオをオーバーレイする再生ボタンの色。 |
controlBarColor |
string | "#CCCCCC" | 再生ボタン、経過時間、ボリューム コントロールを含むコントロール バーの背景色。 |
controlBarControlsColor |
string | "#CCCCCC" | コントロール バーの再生ボタン、経過時間テキスト、ボリューム コントロールの色。 |
controlBarDividerColor |
string | "#555555" | iOS 上のコントロール バーとビデオの間の分割線の色。 デスクトップ ブラウザーまたは Android HTML5 プレーヤーには影響しません。 |
dividerColor |
string | "#555555" | 上部のクロムとビデオの間の分割線の色。 |
dividerHeight |
正の整数 | 1 | 上部のクロムとビデオの間の分割線の高さ。 |
topBarColor |
string | "黒" | 広告インジケーターとスキップ テキストを含む上部のクロムの背景色。 すべてのプレイヤースキンカラーの値は、、 "rgb(255,255,255)""#FFFFFF"、、など、"black"CSS 対応の任意の文字列にすることができます"rgba(255,255,255,1)"。 |
topBarTextColor |
string | "#CCCCCC" | 広告インジケーターとスキップテキストを含む上部のクロムのテキストの色。 |
サイドストリームの設定
アウトストリーム ビデオが再生されていて、ユーザーが画面をスクロールする場合、サイドストリーム モードが有効になっている場合、ビデオ プレーヤーはオプションに position 示されている画面の隅にリセットされ、ビデオの再生を続けます。 が設定されていない position 場合、ビデオ プレーヤーは画面の右下にリセットされます。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
enabled |
ブール値 | false | true の場合、サイドストリームの動作が有効になります。 |
height |
integer | 該当なし | サイドストリーム モードのプレイヤーの高さを指定します。 設定されていない場合、プレイヤーは非サイドストリーム モードと同じ高さになります。 |
maxPageOverlay |
integer | 該当なし | サイドストリームがカバーするブラウザー ウィンドウの最大割合を指定します。 プレーヤーのサイズがこの割合を超える場合、プレイヤーはサイドストリーム モードに移行せず、"nonViewablePlayer" オプションで説明されているように動作します。 |
position |
string | "右下" | サイドストリーム機能がアクティブ化されたときにプレイヤーが移動するパブリッシャー ページのコーナーを指定します。 オプションは、次のとおりです。 - "左上" -"右上" - "左下" - "右下" |
returnToPage |
ブール値 | true | サイドストリームが有効になっている場合、このオプションを true に設定すると、サイドストリームが開始された後にユーザーが下にスクロールすると、サイドストリーム プレーヤーが閉じられ、ユーザーが再びスクロールするまで広告が一時停止し、アウトストリーム プレーヤーでの再生が再開されます。 このオプションを "false" に設定すると、ビデオがサイドストリーム モードで再生され、元のアウトストリーム プレーヤーが折りたたまれます。 警告: startInSidestream と returnToPage の両方を同じ値に設定すると、広告の表示に問題が発生する可能性があり、推奨されません。 |
startInSideStream |
ブール値 | false | サイドストリームが有効になっている場合、このオプションを true に設定すると、クリエイティブがアウトストリーム プレーヤーではなくサイドストリーム モードで再生を開始することを指定します。startInSidestream=true は、仲介配置には推奨されません。警告: startInSidestream と returnToPage の両方を同じ値に設定すると、広告の表示に問題が発生する可能性があり、推奨されません。 |
width |
integer | 該当なし | サイドストリーム モードのプレーヤーの幅を指定します。 設定されていない場合、プレイヤーは非サイドストリーム モードと同じ幅になります。 |
xOffset |
integer | 0 | x 軸のページ 端からの距離をピクセル単位で指定します。サイドストリーム機能がアクティブ化されたときにプレーヤーが表示されます。 |
yOffset |
integer | 0 | y 軸のページ 端からの距離をピクセル単位で指定します。これは、サイドストリーム機能がアクティブになったときにプレーヤーに表示されます。 |
スキップ可能な設定
これらの設定は、ユーザーがビデオ プレーヤーで再生するコンテンツをスキップできるかどうかを決定し、スキップ動作がどのように機能するかを決定します。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
allowOverride |
ブール値 | false | に設定すると true、VAST 3.0 の仕様に完全に準拠して、 VAST 3.0 のスキップオフセット設定からのスキップ オフセットがパブリッシャー設定よりも優先されます。注: この場合、 を に true設定し、広告 XML で no skipoffset が定義されている場合、スキップ ボタンは表示されません。 |
enabled |
ブール値 | true | オプションの skippable オーバーライド(に設定されている false場合)、スキップオプションは表示されません。 |
skipButtonText |
string | "SKIP" | スキップ ボタンに表示されるテキスト。 ボタンをクリックすると、アウトストリーム広告ユニットが折りたたまれます。 |
skipLocation |
string | "左上" | と skipButtonTextのskipText場所。 オプションは top-left と top-rightです。左上隅に設定すると、プレーヤーの skipText左上隅に skipButtonText、 と が表示され、adText が右上隅に表示されます。を右上に設定すると、プレーヤーの skipText右上隅に skipButtonText、 と が表示され、adText が左上隅に表示されます。 |
skipText |
string | "ビデオは %%TIME%% 秒でスキップできます" | スキップ可能なタイミングをユーザーに通知するテキストが表示されます。 残りの時間を挿入するには、%%TIME%% を使用します。 |
videoOffset |
integer | 5 | ビデオがスキップ可能な時間 (秒単位) (有効でビデオの継続時間が より videoThreshold長い場合)。 |
videoThreshold |
integer | オプションを有効にするには、ビデオがこの長さ (秒単位) skippable を超える必要があります。注: ビデオの長さは最も近い秒に丸められます。 たとえば、14.97 秒と 15.23 秒のビデオ長は、15 秒のビデオとして扱われます。 |
仲介を使用したウォーターフォール処理設定
警告
次の設定は、ビデオ 仲介が構成されている場合にのみ適用されます。
メディエーションでは、動画広告のウォーターフォール処理により、タイムアウト期間内に実行可能なクリエイティブを配信する可能性が高くなります。 ウォーターフォール プロセスでは、適切な広告が見つかったときに停止して、一連の広告の読み込みを試みることができます。 タイムアウト期間と、適切な広告を見つけようとするときにチェックされるメディエーション広告ソースの最大数を設定できます。 収益化を使用して配置の仲介を有効にしたら、ウォーターフォール オプションを設定して、タイムアウト設定をさらに微調整できます。
ウォーターフォール ステップ
waterfallSteps (defineTag.rendererOptions.waterfallsteps) を設定すると、メディエーション プロセスで、実行可能な広告のレンダリング元となる広告ソースの一覧を生成できます。 このリストには、仲介入札と RTB 広告 (オークションに勝った広告) が含まれる場合があります。 パブリッシャー (またはレンダラー) は、広告の表示を試みるウォーターフォール メディエーション広告ソースの数を制御できます。
このオプションで使用できる値は、次のように解釈されます。
- -1 = ウォーターフォール リスト内のすべての広告ソースは、実行可能な広告が見つかるか、ウォーターフォールタイムアウトの有効期限が切れるまで処理されます。
- 0 = 広告の生成に使用される広告ソースは 1 つだけです。リストの最初の広告を使用します。
- 正の整数 = 実行可能な広告が見つかるまで試行する rtb 以外の広告ソースの最大数。
- 広告ソースの数がこのプロパティの値より小さい場合、すべての広告ソースが試行されます
- rtb 以外の広告ソースのいずれも実行可能な広告ソースを生成せず、ウォーターフォール タイムアウトの有効期限が切れていない場合は、rtb 広告を試行する必要があります。
- 広告のレンダリング試行回数が 6 回を超えると予想される場合は、この値を 6 より大きい数に設定することをお勧めします。 既定値は -1 です。
プレイヤーのクロム設定
| オプション | 型 | 既定値 | 説明 | |
|---|---|---|---|---|
adText |
string | Ad | アウトストリーム広告ユニットの右上隅に表示される広告インジケーターテキスト。 が右上の場合 skipLocation は、skipText、その後 skipButtonText、 は右上隅の adText の左側に表示されます (下のスキップ可能なオブジェクトを参照してください)。 |
|
allowFullscreen |
ブール値 | true | 全画面表示ボタンを表示または非表示にします。 | |
controlBarPosition |
string | over (Android を除く) | 下部コントロール バーの位置が再生領域上に浮かんでいるか、固定されているかを指定します。 ユーザーがビデオ [下に指定] を操作するときに、下のコントロール バーを再生領域の上に浮かべるには、 を指定します。下のコントロール バーは、広告の再生中に再生領域の下の固定位置に表示されます。 Android では、コントロール バーは常にこの位置に表示されます。 | |
disableCollapse |
ブール値 | false | true の場合、アウトストリーム広告はビデオの最後に折りたたまれません。 ビデオの最後に表示されていた最後のフレームが表示されます。 コントロール バーがない場合は、クリックしてボタンを再生するか、カウントダウン テキストが表示されます。 [広告インジケーター] ボタンと [スキップ] ボタンは残ります。 | |
disableTopBar |
ブール値 | false | true に設定すると、トップ プレーヤーのクロム バー (adText と skipText/skipButtonText) は表示されません。 false に設定すると、次の場合を除き、トップ プレーヤーのクロム バーが表示されます。空のテキスト フィールドが指定されている場合、クロム バーは引き続き表示されますが、空になります。 | |
showMute |
ブール値 | true | コントロール バーのミュート ボタンを表示または非表示にします。 が false に設定されている場合 audioOnMouseOver 、ユーザーはオーディオ ミュート ボタンを無効にしてサウンドをアクティブにします。 が false でオーディオ ミュート ボタンも非表示の場合 showMute 、ユーザーは音量スライダーをドラッグしてサウンドをアクティブにします。 |
|
showProgressBar |
ブール値 | false | コントロール バーの進行状況バーを表示または非表示にします。 | |
showVolume |
ブール値 | false | コントロール バーの音量スライダーを表示または非表示にします。 |
VPAID ハンドラー設定
これらの設定は、ビデオ プレーヤーが VPAID を使用するビデオ ドキュメントを処理する方法を決定します。
注:
VPAID 広告が最終フレームに到達すると、アウトストリーム プレーヤーはコントロール バーを非表示にし、再生ボタンは表示しません。 この動作により、VPAID によって提供される対話型の終了画面要素との競合の可能性が回避されます。 プレイヤーは、ページ レベルのアウトストリーム設定で指定された構成に関係なく、すべての VPAID 広告をこのように処理します。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
delayExpandUntilVPAIDInit |
ブール値 | true | true の場合は、AdLoaded イベントが返されるビデオ領域とページ上の正しい位置を拡張するまで待ってから、VPAID ケースで Outstream を展開できます。 false の場合、アウトストリームはクリエイティブを持ち、ページ上の正しい位置に配置されるとすぐに展開されます。 |
delayExpandUntilVPAIDImpression |
ブール値 | false | AdImpression または AdVideoStart イベントが受信されるまで、VPAID 広告のアウトストリーム拡張を遅延します。 広告を開始し、アウトストリームが拡大するまで可視性を遅らせているため、レポートの不一致の発生率が高くなる可能性があることに注意してください。 |
terminateUnresponsiveVPAIDCreative |
ブール値 | false | |
vpaidTimeout |
integer (ミリ秒) | 5000 | VPAID 広告ユニットが表示されている場合は、VPAID 広告ユニットの開始と実際に開始してから、タイムアウトして広告を折りたたむまでの待機時間です。 VPAID 広告ユニットが、特に低速なセカンダリ オークションの実行を試みた場合、または正しく構成されていないサーバーにヒットした場合に、この問題が発生する可能性があります。 また、完全に準拠していない VPAID 広告ユニットの場合にも、この問題が発生する可能性があります。 |
モバイル設定
この設定により、モバイル デバイスでプレイヤーが有効になります。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
enableInlineVideoForIos |
ブール値 | true | iOS デバイスのインライン ビデオを有効にします。 |
AMP 設定
アウトストリームは、amp-AD タグの既存のバナー コード (type=appnexus の場合) に自身を挿入することで AMP で機能します。 AMP 開発者向けドキュメントの AMP-IFRAME動作に関するセクションで説明されているガイドラインに従うこともお勧めします。
AMP の制限付き/制限付きオプション
AST が AMP ページで実行されていることを検出すると、次の設定をオーバーライドまたはオフにします。
次の設定は AMP ページでは使用できないか、制限付きまたは制限された値を使用できます。
| オプション | 型 | 既定値 | 説明 |
|---|---|---|---|
alignment |
string | "center" | AMP ページではサポートされていません。 |
audioOnMouseover |
ブール値 | false | モバイル デバイスには適用されません。 |
autoInitialSize |
ブール値 | false | AMP ページではサポートされていません。 プレイヤーのサイズは、発行元のオプション ページの {"size" : [300,250]} を通じてのみ変更できます。 |
controlBarPosition |
string | "over" | AMP ページでは、コントロール バーは常に "下" のように動作し、構成できません。 |
expandTime |
integer | 0 | AMP ページではサポートされていません。 AST が AMP ページで実行されていることを検出すると、渡された設定をオーバーライドし、既定値に設定します。 |
playOnMouseover |
ブール値 | false | モバイル デバイスには適用されません。 |
| モバイル | |||
enableInlineVideoForIos |
ブール値 | true | AMP ページではサポートされていません。 |
| サイド Stream ノード | |||
enabled |
ブール値 | false | AMP ページではサポートされていません。 その他のすべてのサイド ストリーム設定は、次のとおりです。 |
| 折りたたみを無効にする | |||
hideControlBar |
ブール値 | false | AMP ページではサポートされていません。 |
コード サンプル
rendererOptions: {
"adText": "Ad",
"alignment": "center",
"allowFullscreen": true,
"aspectRatio": "16:9",
"autoInitialSize": false,
"cbNotification": handlePublisherCb,
"controlBarPosition": "over",
"delayExpandUntilVPAIDInit": true,
"delayExpandUntilVPAIDImpression": false,
"delayStartUntilNotified": false,
"disableCollapse": {
"enabled": false,
"replay": false
},
"disableTopBar": false,
"enableInlineVideoForIos": true,
"endCard": {
"enabled": true,
"clickable": true,
"color": "",
"imageUrl": "",
"imageWidth": "",
"imageHeight": "",
"showCompanion": true
},
"expandTime": 1000,
"fixedSizePlayer": false,
"intervals": {
"playAndPause": 250,
"focusAndBlur": 500
},
"learnMore": {
"enabled": false,
"separator": "-",
"text": "Learn More",
"clickToPause": true
},
"maxHeight": {
"enabled": true,
"height": 480
}
"nonViewableBehavior": "mute",
"playOnMouseover": false,
"playVideoVisibleThreshold": 50,
"playerSkin": {
"topBarColor": "#5A1011",
"topBarTextColor": "yellow",
"dividerColor": "lightblue",
"dividerHeight": 1,
"controlBarColor": "blue",
"bigPlayButtonColor": "red",
"controlBarControlsColor": "yellow",
"controlBarDividerColor": "red",
"videoBackgroundColor": ""
},
"preloadInlineAudioForIos": false,
"showMute": true,
"showVolume": true,
"showPlayToggle": true,
"showBigPlayButton": true,
"showProgressBar": false,
"sideStream": {
"enabled": true,
"startInSideStream": false,
"returnToPage": true,
"position": "top-right",
"xOffset": 0,
"yOffset": 0,
"maxPageOverlay": 50,
"width": 300,
"height": 250,
},
"skippable": {
"enabled": true,
"videoThreshold": 15,
"videoOffset": 5,
"skipLocation": "top-left",
"skipText": "Video can be skipped in %%TIME%% seconds",
"skipButtonText": "SKIP",
"allowOverride": false
},
"terminateUnresponsiveVPAIDCreative": false,
"topMostViewableCheck": {
"enabled": true,
"checkVerticalOnly": true,
"rateOfBeacons": 10
},
"vpaidTimeout": 5000,
"vpaidEnvironmentVars": {},
"waterfallTimeout": 15000,
"waterfallSteps": -1
}