翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# クライアント側の広告追跡のプレイヤーコントロールと機能
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls"></a>

MediaTailor クライアント側の追跡メタデータは、さまざまなプレイヤーコントロールと機能をサポートしています。次のリストでは、一般的なプレイヤーコントロールについて説明します。

**Topics**
+ [スクラブ](#ad-reporting-client-side-ad-tracking-schema-player-controls-scrubbing)
+ [広告カウントダウンタイマー](#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-countdown-timer)
+ [スキップ可能な広告](#ad-reporting-client-side-ad-tracking-schema-player-controls-skippable-ads)
+ [広告クリックスルー](#ad-reporting-client-side-ad-tracking-schema-player-controls-ad-clickthrough)
+ [コンパニオン広告](#ad-reporting-client-side-ad-tracking-schema-player-controls-companion-ads)
+ [インタラクティブ広告 (SIMID)](#ad-reporting-client-side-ad-tracking-schema-player-controls-simid-ads)
+ [インタラクティブ広告 (VPAID)](#ad-reporting-client-side-ad-tracking-schema-player-controls-vpaid-ads)
+ [Google Why This Ad (WTA) のアイコン](#ad-reporting-client-side-ad-tracking-schema-player-controls-google-wta)

## スクラブ
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-scrubbing"></a>

再生エクスペリエンスを向上させるために、プレイヤーは再生タイムラインに広告位置を表示できます。MediaTailor は、これらの広告位置をクライアント側の追跡レスポンス`startTimeInSeconds`の値の形式で利用できるようにします。

**注記**  
一部のストリーミングプロバイダーは、広告位置を超えたスクラブを防止します。

![広告が再生されるビデオタイムライン内の MediaTailor マーク位置を示すスクリーンショット。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/scrubbing.png)


次のクライアント側の追跡ペイロード JSON レスポンスは、avails 配列のルート JSON オブジェクト内の avail (ad break) 開始時刻を示しています。プレイヤーはこのデータを使用して、プレイヤータイムラインの広告時間枠の場所を 28 秒で表示します。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [...],
      "availId": "7",
      "availProgramDateTime": null,
      "duration": "PT30S",
      "durationInSeconds": 30,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT28S",
      "startTimeInSeconds": 28
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMk0zNC44NjhTXzIwMjMtMDctMjFUMjA6MjM6MDcuNzc1NzE2MzAyWl8x",
  "nonLinearAvails": []
}
```

## 広告カウントダウンタイマー
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-ad-countdown-timer"></a>

MediaTailor を使用すると、広告カウントダウンタイマーを使用して、広告ブレークの表示中にオーディエンスのエンゲージメントを維持できます。対象者はタイマーを使用して、広告時間枠が終了し、プログラムが再開されるタイミングを把握できます。

![MediaTailor が広告カウントダウンタイマーを表示しているスクリーンショット。このプログラムが再開されるまでの残り時間を視聴者に指示します。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad-countdown-timer.png)


広告カウントダウンタイマーで役割を果たすクライアント側の追跡メタデータの要素は`startTime`、、`startTimeInSeconds`、`duration`、および です`durationInSeconds`。プレイヤーは、このメタデータを個別に追跡するセッションの経過時間とともに使用して、タイマーを表示するタイミングとカウントダウンする値を決定します。

次のクライアント側の追跡ペイロード JSON レスポンスは、広告カウントダウンタイマーを表示するために必要な情報を示しています。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [...],
      "availId": "7",
      "availProgramDateTime": null,
      "duration": "PT30S",
      "durationInSeconds": 30,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT28S",
      "startTimeInSeconds": 28
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMk0zNC44NjhTXzIwMjMtMDctMjFUMjA6MjM6MDcuNzc1NzE2MzAyWl8x",
  "nonLinearAvails": []
}
```

セッションの経過時間が avail の開始時間に達すると、プレイヤーは avail の期間に一致する値を含むカウントダウンタイマーを表示します。カウントダウンタイマーの値は、経過時間が表示の開始時間を超えると減少します。

**Example 式: HLS (ライブと VOD) と DASH (VOD) のカウントダウンタイマー**  
+ `session_start_time` = すべての`EXT-INF`継続時間値の合計 - 3 つの最新の`EXT-INF`メディアシーケンスの継続時間値
+ タイマー値 = `duration` - (`session_elapsed_time` - `startTime`)

![HLS (ライブおよび VOD) マニフェストと DASH (VOD) マニフェストについて、セッションの開始時刻と表示の開始時刻に基づく広告カウントダウンタイマーの計算を示す図。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad-countdown-timer-hls-dash-vod.png)


**Example 計算式: DASH のカウントダウンタイマー (ライブ)**  
+ `session_start_time` = (最新のセグメントの `startTime` \+ `duration`) / `timescale` - `MPD@suggestedPresentationDelay`
+ タイマー値 = `duration` - (`session_elapsed_time` - `startTime`)

![ライブ DASH マニフェストのセッションの開始時刻と表示の開始時刻に基づく広告カウントダウンタイマーの計算を示す図。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad-countdown-timer-dash-live.png)


## スキップ可能な広告
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-skippable-ads"></a>

*スキップ可能な広告*は、ビューワーが一部の広告をスキップしてプログラムの表示を再開できるようにする広告スポットです。VAST では、 `Linear@skipOffset` 属性はスキップ可能な広告を識別します。

次の VAST レスポンスは、スキップ可能な広告の使用方法を示しています。

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear skipoffset="00:00:05">
            <Duration>00:00:15</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="640" height="360" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[{{https://ads.com/file.mp4}}]]></MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

次のクライアント側の追跡ペイロード JSON レスポンスは、`ads`配列内の広告メタデータを示しています。配列には、MediaTailor が VAST レスポンスから取得した`skipOffset`値が含まれています。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:11:40.693Z",
          "adSystem": "2.0",
          "adTitle": "AD-skiing-15",
          "adVerifications": [],
          "companionAds": [...],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT15.015S",
          "durationInSeconds": 15.015,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": "00:00:05",
          "startTime": "PT9.943S",
          "startTimeInSeconds": 9.943,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://adserverbeaconing.com/v1/impression"
              ],
              "duration": "PT15.015S",
              "durationInSeconds": 15.015,
              "eventId": "2697726",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT9.943S",
              "startTimeInSeconds": 9.943
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2697726",
      "availProgramDateTime": "2023-07-31T16:11:40.693Z",
      "duration": "PT15.015S",
      "durationInSeconds": 15.015,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT9.943S",
      "startTimeInSeconds": 9.943
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "",
  "nonLinearAvails": []
}
```

## 広告クリックスルー
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-ad-clickthrough"></a>

クリックスルー URIs を使用すると、広告が視聴者の注意を引くのにどの程度成功したかを広告主が測定できます。ビューワーが進行中の広告のアクティブな動画フレームをクリックすると、ウェブブラウザは広告主のホームページまたはキャンペーンランディングページの URI を開きます。プレイヤー開発者は、広告ビデオにボタンやラベルを重ねるなどのクリック動作を決定し、クリックして詳細を確認するメッセージを表示します。プレイヤーデベロッパーは、視聴者がアクティブな動画フレームをクリックした後、広告の動画を一時停止することがよくあります。

![ビデオプレーヤーでの広告クリックスルーのスクリーンショット。視聴者は動画フレームをクリックします。プレイヤーは動画を一時停止し、ウェブブラウザを開いて、閲覧者を広告主のホームページまたはキャンペーンランディングページに移動します。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/ad-clickthrough.png)


MediaTailor は、VAST レスポンスで返されたリニアビデオのクリックスルーイベント URLs を解析して使用できます。次の VAST レスポンスは、広告クリックスルーの例を示しています。

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="1280" height="720" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[{{https://ads.com/file.mp4}}]]></MediaFile>
            </MediaFiles>
            <VideoClicks>
              <ClickThrough id="EMT"><![CDATA[{{https://aws.amazon.com}}]]></ClickThrough>
              <ClickTracking id="EMT"><![CDATA[{{https://myads.com/beaconing/event=clicktracking}}]]></ClickTracking>
            </VideoClicks>
          </Linear>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

次のクライアント側の追跡ペイロード JSON レスポンスは、MediaTailor が`trackingEvents`配列内にクリックスルー URL とクリック追跡 URLs を表示する方法を示しています。`clickThrough` イベントタイプはクリックスルー広告を表し、`clickTracking`イベントタイプはクリック追跡 URL を表します。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "1",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=clicktracking"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}
```

## コンパニオン広告
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-companion-ads"></a>

*コンパニオン広告*は、線形クリエイティブと一緒に表示されます。コンパニオン広告を使用して、製品、ロゴ、ブランド情報を表示することで、広告スポットの有効性を高めます。ディスプレイ広告には、クイックレスポンス (QR) コードとクリック可能なエリアが用意されており、オーディエンスのエンゲージメントを高めることができます。

MediaTailor は VAST レスポンスでコンパニオン広告をサポートしています。、`StaticResource`、`iFrameResource`および `HTMLResource`ノードからそれぞれメタデータを渡すことができます。

次の VAST レスポンスは、線形広告とコンパニオン広告の場所と形式の例を示しています。

```
<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad>
    <InLine>
      ...
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:10</Duration>
            <MediaFiles>
              <MediaFile id="EMT" delivery="progressive" width="640" height="360" type="video/mp4" bitrate="143" scalable="true" maintainAspectRatio="true"><![CDATA[{{https://ads.com/file.mp4}}]]></MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
        <Creative id="2" sequence="1">
          <CompanionAds>
            <Companion id="2" width="300" height="250">
              <StaticResource creativeType="image/png"><![CDATA[{{https://emt.com/companion/9973499273}}]]></StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView"><![CDATA[{{https://beacon.com/1}}]]></Tracking>
              </TrackingEvents>
              <CompanionClickThrough><![CDATA[{{https://beacon.com/2}}]]></CompanionClickThrough>
            </Companion>
            <Companion id="3" width="728" height="90">
              <StaticResource creativeType="image/png"><![CDATA[{{https://emt.com/companion/1238901823}}]]></StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView"><![CDATA[{{https://beacon.com/3}}]]></Tracking>
              </TrackingEvents>
              <CompanionClickThrough><![CDATA[{{https://beacon.com/4}}]]></CompanionClickThrough>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
      ...
    </InLine>
  </Ad>
</VAST>
```

データは、`/avail/x/ads/y/companionAds`リストのクライアント側の追跡レスポンスに表示されます。各リニアクリエイティブには、最大 6 つのコンパニオン広告を含めることができます。以下の例に示すように、コンパニオン広告はリストに表示されます。

**注記**  
ベストプラクティスとして、アプリケーション開発者は、クリエイティブの最後にコンパニオン広告を明示的に削除またはアンロードするロジックを実装する必要があります。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "0",
          "adParameters": "",
          "adProgramDateTime": null,
          "adSystem": "EMT",
          "adTitle": "sample",
          "adVerifications": [],
          "companionAds": [
            {
              "adParameters": null,
              "altText": null,
              "attributes": {
                "adSlotId": null,
                "apiFramework": null,
                "assetHeight": null,
                "assetWidth": null,
                "expandedHeight": null,
                "expandedWidth": null,
                "height": "250",
                "id": "2",
                "pxratio": null,
                "renderingMode": null,
                "width": "300"
              },
              "companionClickThrough": "https://beacon.com/2",  
              "companionClickTracking": null,
              "htmlResource": null,
              "iFrameResource": null,
              "sequence": "1",
              "staticResource": "https://emt.com/companion/9973499273",
              "trackingEvents": [
                {
                  "beaconUrls": [
                    "https://beacon.com/1"
                  ],
                  "eventType": "creativeView"
                }
              ]
            },
            {
              "adParameters": null,
              "altText": null,
              "attributes": {
                "adSlotId": null,
                "apiFramework": null,
                "assetHeight": null,
                "assetWidth": null,
                "expandedHeight": null,
                "expandedWidth": null,
                "height": "90",
                "id": "3",
                "pxratio": null,
                "renderingMode": null,
                "width": "728"
              },
              "companionClickThrough": "https://beacon.com/4",
              "companionClickTracking": null,
              "htmlResource": null,
              "iFrameResource": null,
              "sequence": "1",
              "staticResource": "https://emt.com/companion/1238901823",
              "trackingEvents": [
                {
                  "beaconUrls": [
                    "https://beacon.com/3"
                  ],
                  "eventType": "creativeView"
                }
              ]
            }
          ],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT10S",
          "durationInSeconds": 10,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT0S",
          "startTimeInSeconds": 0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://beacon.com/impression/1"
              ],
              "duration": "PT10S",
              "durationInSeconds": 10,
              "eventId": "0",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT0S",
              "startTimeInSeconds": 0
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "0",
      "availProgramDateTime": null,
      "duration": "PT10S",
      "durationInSeconds": 10,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT0S",
      "startTimeInSeconds": 0
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMFNfMjAyMy0wNy0wNlQyMToxMDowOC42NzQ4NDA1NjJaXzE%3D",
  "nonLinearAvails": []
}
```

## インタラクティブ広告 (SIMID)
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-simid-ads"></a>

*SecureInteractive Media Interface Definition* (SIMID) は、インタラクティブ広告局 (IAB) の VAST 4.x 標準で導入されたインタラクティブ広告の標準です。SIMID は、インタラクティブ要素のロードをプレイヤーのプライマリリニアクリエイティブから切り離し、VAST レスポンスで両方を参照します。MediaTailor は、再生エクスペリエンスを維持するためにプライマリクリエイティブをステッチし、インタラクティブコンポーネントのメタデータをクライアント側の追跡レスポンスに配置します。

次の VAST 4 レスポンスの例では、SIMID ペイロードは`InteractiveCreativeFile`ノード内にあります。

```
<?xml version="1.0"?>
<VAST xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>SampleAdSystem</AdSystem>
      <AdTitle>Linear SIMID Example</AdTitle>
      <Description>SIMID example</Description>
      <Error>{{https://www.beacons.com/error}}</Error>
      <Impression>{{https://www.beacons.com/impression}}</Impression>
      <Creatives>
        <Creative sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
                ...
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="123">{{https://aws.amazon.com}}</ClickThrough>
              <ClickTracking id="123">{{https://www.beacons.com/click}}</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4">
                                {{https://interactive-ads.com/interactive-media-ad-sample/media/file.mp4}}
                            </MediaFile>
              <InteractiveCreativeFile type="text/html" apiFramework="SIMID" variableDuration="true">
                                {{https://interactive-ads.com/interactive-media-ad-sample/sample_simid.html}}
                            </InteractiveCreativeFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>
```

次の VAST 3 レスポンスでは、SIMID ペイロードは`Extensions`ノード内にあります。

```
<?xml version="1.0"?>
<VAST xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>SampleAdSystem</AdSystem>
      <AdTitle>Linear SIMID Example</AdTitle>
      <Description>SIMID example</Description>
      <Impression>{{https://www.beacons.com/impression}}</Impression>
      <Creatives>
        <Creative id="1" sequence="1">
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
                ...
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="123">{{https://aws.amazon.com}}</ClickThrough>
              <ClickTracking id="123">{{https://myads.com/beaconing/event=clicktracking}}</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4">
                                {{https://interactive-ads.com/interactive-media-ad-sample/media/file.mp4}}
                            </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
      <Extensions>
        <Extension type="InteractiveCreativeFile">
          <InteractiveCreativeFile type="text/html" apiFramework="SIMID" variableDuration="true">
            {{https://interactive-ads.com/interactive-media-ad-sample/sample_simid.html}}
          </InteractiveCreativeFile>
        </Extension>
      </Extensions>
    </InLine>
  </Ad>
</VAST>
```

次のクライアント側の追跡レスポンスでは、SIMID データが`/avails/x/ads/y/extensions`リストに表示されます。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "Linear SIMID Example",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "1",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [
            {
              "content": "<InteractiveCreativeFile type=\"text/html\" apiFramework=\"SIMID\" variableDuration=\"true\">\n{{https://interactive-ads.com/interactive-media-ad-sample/sample_simid.html}}</InteractiveCreativeFile>",
              "type": "InteractiveCreativeFile"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "{{https://myads.com/beaconing/event=impression}}"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "{{https://myads.com/beaconing/event=clicktracking}}"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}
```

## インタラクティブ広告 (VPAID)
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-vpaid-ads"></a>

*Video Player 広告インターフェイス定義* (VPAID) は、広告インタラクティブやその他の機能を有効にする広告とビデオプレーヤーの間のプロトコルを指定します。ライブストリームの場合、MediaTailor は、表示期間中にスレートセグメントを にステッチし、ビデオプレイヤーが消費するクライアント側の追跡レスポンスに VPAID クリエイティブのメタデータを配置することで、VPAID 形式をサポートします。プレイヤーは VPAID ファイルをダウンロードして線形クリエイティブを再生し、クライアントのスクリプトを実行します。プレイヤーはスレートセグメントを再生*しないでください*。

**注記**  
VPAID は VAST 4.1 以降廃止されました。

![VPAID 広告再生の図。MediaTailor は、コンテンツタイムラインの空き時間に対してスレートセグメントをステッチします。プレイヤーは、有効期間中に VPAID アセットに切り替えます。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/interactive-ads-vpaid.png)


次の例は、VAST レスポンスの VPAID コンテンツを示しています。

```
<?xml version="1.0"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
  <Ad id="1234567">
    <InLine>
      <AdSystem>GDFP</AdSystem>
      <AdTitle>VPAID</AdTitle>
      <Description>Vpaid Linear Video Ad</Description>
      <Error>{{http://www.example.com/error}}</Error>
      <Impression>{{http://www.example.com/impression}}</Impression>
      <Creatives>
        <Creative sequence="1">
          <Linear>
            <Duration>00:00:00</Duration>
            <TrackingEvents>
              <Tracking event="start">{{http://www.example.com/start}}</Tracking>
              <Tracking event="firstQuartile">{{http://www.example.com/firstQuartile}}</Tracking>
              <Tracking event="midpoint">{{http://www.example.com/midpoint}}</Tracking>
              <Tracking event="thirdQuartile">{{http://www.example.com/thirdQuartile}}</Tracking>
              <Tracking event="complete">{{http://www.example.com/complete}}</Tracking>
              <Tracking event="mute">{{http://www.example.com/mute}}</Tracking>
              <Tracking event="unmute">{{http://www.example.com/unmute}}</Tracking>
              <Tracking event="rewind">{{http://www.example.com/rewind}}</Tracking>
              <Tracking event="pause">{{http://www.example.com/pause}}</Tracking>
              <Tracking event="resume">{{http://www.example.com/resume}}</Tracking>
              <Tracking event="fullscreen">{{http://www.example.com/fullscreen}}</Tracking>
              <Tracking event="creativeView">{{http://www.example.com/creativeView}}</Tracking>
              <Tracking event="acceptInvitation">{{http://www.example.com/acceptInvitation}}</Tracking>
            </TrackingEvents>
            <AdParameters><![CDATA[ {"videos":[ {"url":"{{https://my-ads.com/interactive-media-ads/media/media_linear_VPAID.mp4}}","mimetype":"video/mp4"}]} ]]></AdParameters>
            <VideoClicks>
              <ClickThrough id="123">http{{://google.com}}</ClickThrough>
              <ClickTracking id="123">{{http://www.example.com/click}}</ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" apiFramework="VPAID" type="application/javascript" width="640" height="480"> {{https://googleads.github.io/googleads-ima-html5/vpaid/linear/VpaidVideoAd.js}} </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>
```

次の例は、追跡情報を示しています。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "1",
          "adParameters": "",
          "adProgramDateTime": "2023-07-31T16:53:40.577Z",
          "adSystem": "2.0",
          "adTitle": "1",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "00006",
          "creativeSequence": "1",
          "duration": "PT14.982S",
          "durationInSeconds": 14.982,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": null,
          "startTime": "PT39.339S",
          "startTimeInSeconds": 39.339,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=impression"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://aws.amazon.com"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698188",
              "eventProgramDateTime": null,
              "eventType": "clickThrough",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            },
            {
              "beaconUrls": [
                "https://myads.com/beaconing/event=clicktracking"
              ],
              "duration": "PT14.982S",
              "durationInSeconds": 14.982,
              "eventId": "2698795",
              "eventProgramDateTime": null,
              "eventType": "clickTracking",
              "startTime": "PT39.339S",
              "startTimeInSeconds": 39.339
            }
          ],
          "vastAdId": ""
        }
      ],
      "availId": "2698188",
      "availProgramDateTime": "2023-07-31T16:53:40.577Z",
      "duration": "PT14.982S",
      "durationInSeconds": 14.982,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT39.339S",
      "startTimeInSeconds": 39.339
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQzOS4zMzlTXzIwMjMtMDctMzFUMTY6NTQ6MDQuODA1Mzk2NTI5Wl8x",
  "nonLinearAvails": []
}{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "2922274",
          "adParameters": "",
          "adProgramDateTime": "2023-08-14T19:49:53.998Z",
          "adSystem": "Innovid Ads",
          "adTitle": "VPAID",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "",
          "creativeSequence": "",
          "duration": "PT16.016S",
          "durationInSeconds": 16.016,
          "extensions": [],
          "mediaFiles": {
            "mediaFilesList": [
              {
                "apiFramework": "VPAID",
                "bitrate": 0,
                "codec": null,
                "delivery": "progressive",
                "height": 9,
                "id": "",
                "maintainAspectRatio": false,
                "maxBitrate": 0,
                "mediaFileUri": "http://my-ads.com/mobileapps/js/vpaid/1h41kg?cb=178344c0-8e67-281a-58ca-962e4987cd60&deviceid=&ivc=",
                "mediaType": "application/javascript",
                "minBitrate": 0,
                "scalable": false,
                "width": 16
              }
            ],
            "mezzanine": "http://my-ads.com/mobileapps/js/vpaid/1h41kg?cb=178344c0-8e67-281a-58ca-962e4987cd60&deviceid=&ivc="
          },
          "skipOffset": null,
          "startTime": "PT8M42.289S",
          "startTimeInSeconds": 522.289,
          "trackingEvents": [
            {
              "beaconUrls": [
                "about:blank"
              ],
              "duration": "PT16.016S",
              "durationInSeconds": 16.016,
              "eventId": "2922274",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT8M42.289S",
              "startTimeInSeconds": 522.289
            }
          ],
          "vastAdId": "1h41kg"
        }
      ],
      "availId": "2922274",
      "availProgramDateTime": "2023-08-14T19:49:53.998Z",
      "duration": "PT16.016S",
      "durationInSeconds": 16.016,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT8M42.289S",
      "startTimeInSeconds": 522.289
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQ4TTQyLjI4OVNfMjAyMy0wOC0xNFQxOTo1MDo0MS4zOTc5MjAzODVaXzE%3D",
  "nonLinearAvails": []
}
```

## Google Why This Ad (WTA) のアイコン
<a name="ad-reporting-client-side-ad-tracking-schema-player-controls-google-wta"></a>

*AdChoices* は、広告がどのようにターゲットにされたかなど、表示される広告に関する情報を視聴者に提供する業界標準です。

![Google Why This Ad (WTA) ロゴ。WTA は、それらの広告がどのようにターゲットにされたかなど、表示される広告についてビューワーに通知します。](http://docs.aws.amazon.com/ja_jp/mediatailor/latest/ug/images/google-wta.png)


MediaTailor クライアント側の追跡 API は、VAST レスポンスの VAST 拡張機能ノードで伝送されるアイコンメタデータをサポートします。VAST レスポンスの WTA の詳細については、[この VAST XML レスポンスのサンプル](https://storage.googleapis.com/interactive-media-ads/ad-tags/ima_wta_sample_vast_3.xml)を参照してください。

**注記**  
MediaTailor は現在、VAST バージョン 3 のみをサポートしています。

```
<VAST>
    <Ad>  
    <InLine>  
       ...
      <Extensions>
        <Extension type="IconClickFallbackImages">
          <IconClickFallbackImages program="GoogleWhyThisAd">
            <IconClickFallbackImage width="400" height="150">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png}}]]></StaticResource>
            </IconClickFallbackImage>
          </IconClickFallbackImages>
          <IconClickFallbackImages program="AdChoices">
            <IconClickFallbackImage width="400" height="150">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=1x}}]]></StaticResource>
            </IconClickFallbackImage>
            <IconClickFallbackImage width="800" height="300">
              <AltText>Alt icon fallback</AltText>
              <StaticResource creativeType="image/png"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=2x}}]]></StaticResource>
            </IconClickFallbackImage>
          </IconClickFallbackImages>
        </Extension>
      </Extensions>
    </InLine>
  </Ad>
</VAST>
```

次の例は、`/avails/x/ads/y/extensions`リスト内のクライアント側の追跡レスポンスを示しています。

```
{
  "avails": [
    {
      "adBreakTrackingEvents": [],
      "adMarkerDuration": null,
      "ads": [
        {
          "adId": "0",
          "adParameters": "",
          "adProgramDateTime": null,
          "adSystem": "GDFP",
          "adTitle": "Google Why This Ad VAST 3 Sample",
          "adVerifications": [],
          "companionAds": [],
          "creativeId": "7891011",
          "creativeSequence": "1",
          "duration": "PT10S",
          "durationInSeconds": 10,
          "extensions": [
            {
              "content": "<IconClickFallbackImages program=\"GoogleWhyThisAd\">      
                          <IconClickFallbackImage height=\"150\" width=\"400\">      
                          <AltText>Alt icon fallback</AltText>      
                          <StaticResource creativeType=\"image/png\"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png}}]]>
                          </StaticResource>     
                          </IconClickFallbackImage>    
                          </IconClickFallbackImages>     
                          <IconClickFallbackImages program=\"AdChoices\">     
                          <IconClickFallbackImage height=\"150\" width=\"400\">     
                          <AltText>Alt icon fallback</AltText>       
                          <StaticResource creativeType=\"image/png\"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=1x}}]]>
                          </StaticResource>      
                          </IconClickFallbackImage>      
                          <IconClickFallbackImage height=\"300\" width=\"800\">       
                          <AltText>Alt icon fallback</AltText>       
                          <StaticResource creativeType=\"image/png\"><![CDATA[{{https://storage.googleapis.com/interactive-media-ads/images/wta_dialog.png?size=2x}}]]>
                          </StaticResource>      
                          </IconClickFallbackImage>     
                          </IconClickFallbackImages>",
              "type": "IconClickFallbackImages"
            }
          ],
          "mediaFiles": {
            "mediaFilesList": [],
            "mezzanine": ""
          },
          "skipOffset": "00:00:03",
          "startTime": "PT0S",
          "startTimeInSeconds": 0,
          "trackingEvents": [
            {
              "beaconUrls": [
                "https://example.com/view"
              ],
              "duration": "PT10S",
              "durationInSeconds": 10,
              "eventId": "0",
              "eventProgramDateTime": null,
              "eventType": "impression",
              "startTime": "PT0S",
              "startTimeInSeconds": 0
            }
          ],
          "vastAdId": "123456"
        }
      ],
      "availId": "0",
      "availProgramDateTime": null,
      "duration": "PT10S",
      "durationInSeconds": 10,
      "meta": null,
      "nonLinearAdsList": [],
      "startTime": "PT0S",
      "startTimeInSeconds": 0
    }
  ],
  "dashAvailabilityStartTime": null,
  "hlsAnchorMediaSequenceNumber": null,
  "nextToken": "UFQxMFNfMjAyMy0wNy0wNlQyMDo0MToxNy45NDE4MDM0NDhaXzE%3D",
  "nonLinearAvails": []
}
```