IMAGE

画像データにアクセスします。

IMAGE 関数は、データソースの Image フィールドを作成します。Image フィールドには、表内の画像が表示されます。レポートに商品画像や動画のサムネイルといった画像情報を表示する際に、この関数を使います。

この記事の内容:

構文

 IMAGE(Image URL, [Alternative Text])

 

パラメータ:

  • Image URL - URL として評価されるフィールドまたは式。
  • Alternative Text -(省略可)Text として評価されるフィールドまたは式。

IMAGE 関数の機能

IMAGE 関数は、URL を入力値として受け取ります。URL パラメータは、データソースの既存の URL フィールドから取得するか、他のフィールドや関数から URL を作成する式として指定することができます。

省略可能な Alternative Text パラメータは、目の不自由なユーザーをサポートするスクリーン リーダーで画像の説明文として使用できます。

レポートに画像を表示するには、IMAGE 関数で作成した Image フィールドをレポート内の表に追加します。表示される画像のサイズは、その画像が表示される列の幅に応じて変わります。入力した URL に誤りがある場合や、サポートされていない種類の画像だった場合は、代わりに壊れた画像のアイコンが表示されます。

Image フィールドでは [タイプ] プルダウン メニューが無効になっています。

IMAGE examples

YouTube サムネイルを表示する

  1. YouTube アナリティクスのデータソースを編集します
  2. 計算フィールド(Thumbnail など)を作成します
  3. 次の式を使って Image フィールドを作成します
IMAGE(CONCAT('https://i.ytimg.com/vi/', External Video Id, '/hqdefault.jpg') , Video Title)
  1. この Thumbnail フィールドを、次のように表のディメンションとして追加します。

IMAGE 関数を使って表示された画像を含む表の例

HYPERLINK でクリック可能な画像を作成する

Image フィールドに表示される画像は静止画像ですが、Image フィールドを HYPERLINK 関数Link Label パラメータとして指定して、クリック可能な画像を生成することができます。

IMAGE 関数の制限事項

表内の画像のみ

Image フィールドは表内でのみ機能します。表をグラフなどの種類に変更すると、そのグラフ内の Image フィールドは無視されるか、その画像の URL がディメンション値として表示されます。

画像とデータ

ハイパーリンクと画像の URL では、表示するファイルの名前のほか、URL パスにクエリ パラメータを付加する形式で情報を送信することもできます。例:

http://some.domain.com/a/b/c/somefile.jpg?foo=bar&baz=bat

この URL は、JPEG 画像 somefile.jpg をリクエストしています。また、foo パラメータと bar パラメータを介してデータも送信しています。

レポートまたはデータソースにハイパーリンクや画像の URL が含まれる場合は、その URL で信頼できるドメインが指定されていることと、送信される追加データが適切なものであることを確認する必要があります。

そのため、データポータルの画像には次の制限事項が適用されます。

画像とデータ管理オプション

レポートにデータ管理オプションを含めると、次の場合に画像が表示されます。

  • データ管理オプションによって、デフォルトのデータセットが表示されている場合。
  • データ管理オプションによって別の(デフォルトではない)データセットが表示されており、かつ、Image フィールドが信頼できるドメインからの画像を配信している場合。現在、大半の Google ドメインは信頼できるドメインに該当します。

データ管理オプションによって別の(デフォルトではない)データセットが表示されており、かつ、信頼できないドメインからの画像がリクエストされた場合、画像は表示されません。表にはその画像の URL が代わりに表示され、レポートの閲覧者はその URL をクリックして画像を表示することができます。その際にはダイアログが表示され、リンク先が信頼できるドメインであることを確認するよう注意を促します。

コピーされたデータソースの画像

データソースをコピーすると、そのコピーではすべての Image フィールドが無効になります。その場合は、次の方法で画像を再度有効にできます。

  1. データソースを編集します。
  2. 有効にする各フィールドで、その他アイコンをクリックします。その他のメニュー
  3. [有効にする] を選択します。

Enable a data source field.

 

この情報は役に立ちましたか?
改善できる点がありましたらお聞かせください。