Documentation Index
Fetch the complete documentation index at: https://domoinc-jkreitzman-patch-1.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
はじめに
公開組織に設定、作成、マッピングを行い、ブランドキットでインターフェース設定を選択したら、次はコンテンツを公開またはエンベッドして、ほかのユーザーが閲覧できるようにします。コンテンツは任意のウェブサイト、アプリケーション、ポータルにエンベッドすることができます。 詳細については、「コンテンツをサブスクライバーインスタンスに公開する」を参照してください。 この記事では、様々なエンベッド方法と、それぞれの方法を使用したカードやダッシュボードのエンベッドについての情報を提供します。http://developer.domo.com/docs/embed/dataset-switchingエンベッド方法 - パブリックおよびプライベート
コンテンツをエンベッドするには大きく分けてパブリックとプライベートの2つの方法があります。パブリックエンベッド
ウェブサイト、ブログ、FacebookやTwitterなどのソーシャルメディアプラットフォームにパブリックエンベッドすることができます。エンベッドURLがあれば誰でもコンテンツを閲覧できます。 このパブリックコンテンツは閲覧専用で、アラートはサポートされていません。また、どの閲覧ユーザーもログインする必要がないため、Personalized Data Permission（PDP）もサポートされていません。 パブリックエンベッドは、［Domo Everywhere］>［設定］>**［一般］で、［カードとダッシュボードをパブリックにエンベッドすることを許可］**ボックスにチェックを入れる/外すことで有効/無効にできます。プライベートエンベッド
ウェブサイト、ポータル、アプリケーションにプライベートエンベッドすることができます。プライベートエンベッドするコンテンツには3つのオプションがあります。- ユーザーベース — シングルサインオン（SSO）およびPersonalized Data Permission（PDP）をサポートしています。 ユーザーライセンスはDomo内で作成され、PDPポリシーが行レベルの資格ポリシーにもとづき既知のユーザーに適用されます。このオプションは技術的な観点では最も簡単な設定ですが、フィルターや権限が異なるユーザーが多数の場合、管理が困難になる可能性があります。そのため、小規模で一貫性のあるユーザーグループに推奨します。実装するには、ユーザーライセンスを購入してください。
- サーバーベース — この方法はプログラミングサーバー側のフィルターを使用します。Domoのエンベッドされたコンテンツをホストする環境は、Domoに対して認証が行われます。またこの環境は、どのフィルターを適用すべきかをプログラムで決定します。エンベッドされたコンテンツが表示されると、フィルターリクエストがDomoに送信されます。 これは最も柔軟性が高いオプションです。大規模なユーザーグループや一時的なユーザーグループに適していますが、デベロッパーがプログラムによるフィルターを作成して管理する必要があるため、技術的な負債が高くなります。実装するには、インプレッション（またはカードロード）を購入してください。 詳細については、デベロッパーポータルのDomo Embedに関するページを参照してください。
- プラットフォームベース — SSOとPDPをサポートし、完全に編集可能です。 このオプションでは、Domoプラットフォームを使用して完全なデータエクスペリエンスを構築し、顧客に展開することが最も簡単に行えます。実装するには、コンテンツ配信の対象となるすべての顧客に対応するDomo環境を含むプラットフォームパッケージを購入してください。
エンベッドに関する注記
パブリックエンベッドとユーザーベースのプライベートエンベッドのいずれでも、Domoから自動生成されるHTML文字列をコピーし、iFrameとして、またはJavaScript API経由で、サブスクライバーインスタンスの必要な場所に貼り付ける必要があります。 プライベートエンベッドされたすべてのコンテンツに、以下が該当します。- ソーシャル権限を持つユーザーは、コンテンツをエンベッドしたり、iFrameを作成したり、プライベートエンベッドされたコンテンツを表示したりすることはできません。 閲覧ユーザーは、コンテンツをエンベッドできませんが、プライベートエンベッドされたコンテンツを表示できます。
- Sumoピボット表を除く、すべてのカードタイプがサポートされています。
- メモカードとドキュメントカードは単体ではエンベッドできませんが、ダッシュボードの一部としてエンベッドすることができます。
注記：カード/ダッシュボードごとに1つのエンベッドタイプのみ所有できます。エンベッドIDを確認するには、［その他］>**［管理者］の順に移動します。［Domo Everywhere］メニューで、［エンベッド］を選択します。［カード］または［ダッシュボード］**タブに移動し、カードまたはダッシュボードを見つけます。次に、「エンベッドID」列でそのアセットのエントリを見つけます。
- Domo、ウェブサイト、ポータル、またはアプリケーションで、SSO（シングルサインオン）を有効にする必要があります。
-
- 「管理者設定」>**［SSO］で［招待された方のみDomoにアクセスできます］**オプションが有効になっている場合、Domo以外のユーザーは、カードにアクセスしようとしても拒否されます。
このオプションを無効にすると、Domo以外のユーザーは、デフォルトユーザーのアクセス権で自動的にプロビジョニングされます。デフォルト設定は「パワーユーザー」です。
アクセス権限についての詳細は、「Domoでのアクセスを制御する」を参照してください。
- 「管理者設定」>**［SSO］で［招待された方のみDomoにアクセスできます］**オプションが有効になっている場合、Domo以外のユーザーは、カードにアクセスしようとしても拒否されます。
- カードをパブリックエンベッドする場合は、タイトル、ドリルダウン、まとめ数字、チャートピッカーはいずれも使用できますが、フィルターはカードで使用されている列にのみ使用可能です。セキュリティ上の理由から、この機能ではカード末尾の表ビューを使用できません。
- カードをパブリックエンベッドできないようにする場合は、「管理者設定」>［カンパニー設定］>**［会社概要］の順に選択して、この機能を無効にします。［パブリックにコンテンツをエンベッド］**ボックスからチェックを外します。
Domo Embedを有効にする
Domo Embedを有効にするには、管理者のデフォルトのセキュリティ権限、またはカードをエンベッドする許可が付与されているカスタマイズされた権限を持つユーザーが、「管理者設定」>［カンパニー設定］>**［会社概要］の順に移動し、［パブリックにコンテンツをエンベッド］**ボックスにチェックを入れる必要があります。許可ドメイン
データの安全性を確保し、必要な場所にのみデータが表示されるようにするには、［許可ドメインをエンベッド］を使用してドメインを許可リストに配置することができます。許可リスト上のドメインは、JS APIを介してコンテンツをエンベッドしたりイベントを受信したりできます。許可されていないドメインにコンテンツが配置されている場合は、読み込まれません。 この詳細については、Domoデベロッパードキュメントhttps://developer.domo.com/docs/embed/filtering-optionsを参照してください。- 許可ドメインを追加するには、［Domo Everywhere］>**［設定］**に進みます。
- **［一般］タブで［許可ドメインをエンベッド］**を見つけて、ドメイン名を入力します。
- **［追加］**を選択します。
カードをエンベッドする
カードを個別にエンベッドする場合、複数のカードを1つのダッシュボードにエンベッドすることはできますが、カードごとに個別にコードを生成する必要があります。 個別にエンベッドされたカードでは、詳細ビューで、以下のような標準的に使用できるカード機能を組み込むかどうかを選択できます。- カードのタイトル
- カードをドリルダウンする機能
- エクスポートを許可
- データ表にアクセスする機能（プライベートカードのみ）
- まとめ数字
- フィルターの適用と変更を行う機能（プライベートカードのみ）
- チャートピッカーを使用してグラフタイプを変更する機能
カードをパブリックエンベッドする
カードのエンベッドオプションにアクセスするには ［カードのオプション］>**［Domo Everywhere］**を選択します。 カードをエンベッドするモーダルが表示されます。 下表では、モーダルのコンポーネントについて説明します。| コンポーネント | 説明 | |
|---|---|---|
| 表示オプション | エンベッドするカードで特定のカード機能のオンとオフを切り替えます。次の切り替えが可能です。 - ［タイトルを表示］ — カードのタイトルを表示します。 - ［ドリルを許可］ — エンベッドされたカードにドリルオプションを表示し、クリックしたHTMLリンクに移動します。 - ［エクスポートを許可］ — カードをエクスポートする機能を切り替えます。 - ［表ビューを許可］ — エンベッドされたカードを表ビューに表示できます。 - ［まとめ数字を表示］ — カードのまとめ数字を表示します。 - ［フィルターの変更を許可］ — エンベッドされたカードビューでフィルターを変更できます。 - ［チャートピッカーを許可］ — エンベッドされたカードビューでチャートピッカーを有効にします。 | |
| サイズ設定オプション | エンベッドするDomoカードのサイズを設定します。 ［正方形］（600x600ピクセル）、［ポートレート］（600x900ピクセル）、［ランドスケープ］（900x600ピクセル）の3つのデフォルトサイズを使用できます。 **［カスタム］**オプションで独自の幅と高さを設定することもできます。 | |
| エンベッドのオプション | このカードをプライベートエンベッドするか（デフォルト）、パブリックエンベッドするかを指定します。 カードをパブリックにすると、誰でもそのカードとカードに表示されるデータを閲覧できるようになります。また、パブリックカードのニュースフィードとしてこのカードを公開する権限を、Domoに付与することにもなります。 **［パブリック］オプションを選択すると、URLが生成されます（［リンクをシェア］**の下）。このURLをコピーしてホストサイトに貼り付けることができます。また、5つのソーシャルメディアプラットフォーム（Facebook、Twitter、Google+、LinkedIn、Pinterest）のいずれかを直接開いて、すぐにカードをエンベッドすることもできます。 | |
| コードをエンベッド | コピーを選択して、コードをコピーします。 |
- カードが表示されるダッシュボードまたはカードの詳細ビューに移動します。
- ［カードのオプション］>**［Domo Everywhere］**を選択します。
カードをエンベッドするモーダルが表示されます。 - 次の方法でカードサイズを設定します。
- **［デフォルトサイズ］**メニューでエンベッドされたカードのプリセットサイズを選択します。または
- **［カスタム］を選択して［幅］フィールドと［高さ］**フィールドにサイズをピクセル数で入力します。
- エンベッドするカードに含めるすべての**［表示オプション］**のボックスをオンにします。
**注記：****［表ビューを許可］と［フィルターの変更を許可］**は、現在、パブリックエンベッドするカードには使用できません。
- **［エンベッドのオプション］リストから［一般公開］**を選択します。
- **［パブリックにする］**を選択します。
- コピーを選択して、自動生成されたURLをコピーします。
- （条件付き）Facebook、Twitter、Google+、LinkedIn、Pinterestの5つのソーシャルメディアプラットフォームにカードをエンベッドする場合は、そのプラットフォームのアイコンを選択し（必要に応じてログインし）、プラットフォームの指示に従ってURLを貼り付けます。それ以外の場合は、ウェブサイトやブログを開いて、必要に応じてURLを貼り付けます。
カードをプライベートエンベッドする
カードをプライベートエンベッドするには、次の手順を実行します。- カードが表示されるダッシュボードまたはカードの詳細ビューに移動します。
- ［カードのオプション］>**［Domo Everywhere］**を選択します。
カードをエンベッドするモーダルが表示されます。 - 次の方法でカードサイズを設定します。
- **［デフォルトサイズ］**メニューでエンベッドされたカードのプリセットサイズを選択します。または
- **［カスタム］を選択して［幅］フィールドと［高さ］**フィールドにサイズをピクセル数で入力します。
- エンベッドするカードに含めるすべての**［表示オプション］**のボックスをオンにします。
- **［エンベッドのオプション］リストから［プライベート］**を選択します。
- コピーを選択して、エンベッドするHTMLをコピーします。
- カードを表示させるウェブサイト、ポータル、アプリケーションに、このHTMLを貼り付けます。貼り付け方法は、ウェブサイト、ポータル、アプリケーションのどれに貼り付けるかによって異なります。
JavaScript APIを使用してエンベッドされたカードとダッシュボードをフィルターする
エンベッドされたコンテンツのフィルターにJavaScript APIを使用するコード例については、デベロッパードキュメントの「Embedded Analytics」を参照してください。パブリックエンベッドしたカードを追跡する
Domoインスタンスでパブリックエンベッドしたすべてのカードは**「管理者設定」>［Domo Everywhere］**で追跡できます。エンベッド作成者、現在のエンベッドリンクのステータス（パブリックまたは無効）、パブリックビューの数などの情報を確認できます。このタブを表示するには、「管理者」のセキュリティ権限、またはカードをエンベッドする許可が付与されているカスタマイズされた権限が必要です。ページ全体のフィルター
個別にエンベッドされたカードは、Domoダッシュボードよりもフォーマットやレイアウトを柔軟に設定できます。ページ全体のフィルター機能を使うと、Domoダッシュボードのフィルターを許可ドメイン内のエンベッドされたカードに使用できます。使用事例に応じたフィルターを作成し、フィルターパラメーターをページ上のエンベッドされたすべてのカードに適用できます。 下の画像には、個々のエンベッドされたカードに**［国］**フィルターが適用され、グリーンランドとギリシャの確認されたCovid-19症例数、現在の感染者数、死亡者数、累積トレンドに関するデータが表示されています。ダッシュボードをエンベッドする
Domoダッシュボードでは、以下のオプションを含めるかどうかを選択できます。- ダッシュボードのタイトル
- フィルターバーを表示
- 各カードの未加工データのCSVへのエクスポート
- pフィルターパラメーターをあらゆるカスタムインタラクションリンクの最後に自動的に追加するPersistフィルター
- 新しいタブでリンクを開く
**注記：**ダッシュボードのエンベッドでは、カードのエンベッドで使用できるJavaScript APIは使用できず、iFrameのみを使用してエンベッドできます。
コンポーネント | 説明 |
|---|---|
表示オプション | エンベッドされたダッシュボードのカードで特定の機能のオンとオフを切り替えます。次のようなトグルがあります。
|
サイズ設定オプション | エンベッドされたDomoダッシュボードの幅と高さを設定します。 |
エンベッドのオプション | ダッシュボードをプライベートエンベッドするか、パブリックエンベッドするかを指定します（デフォルトのオプションは ［オフ］ です）。カードをパブリックにすると、誰でもコンテンツを閲覧できるようになります。 ［パブリック］ オプションを選択すると、URLが生成されます（ ［リンクをシェア］ の下）。このURLをコピーしてウェブサイト、ブログ、ソーシャルメディアプラットフォームに貼り付けることができます。パブリックエンベッドのオプションは認証されないため、フィルターをパーソナライズできません。 ［プライベート］ オプションを選択した場合、エンベッドされたコンテンツを見るには認証が必要になります。プライベートエンベッドのオプションは認証を使用するため、フィルターをPDPまたはプログラムによるフィルターを使用してパーソナライズできます。 |
リンクをシェア | エンベッド済みダッシュボードを直接閲覧できます。 |
コードをエンベッド | 自動生成されたHTML文字列が表示されます。これをコピーして、ウェブサイト、ポータル、アプリケーションに貼り付けます。HTMLをコピーするには、HTML文字列の右にある |
プログラムによるフィルターで、HTMLエンベッドコードで使用されます。プログラムによるフィルターの詳細については、 デベロッパーポータル | |
DataSetマッピングをエクスポートする | Domoダッシュボードのカードで使用されている元のDataSet IDをすべてリスト化し、Domoプラットフォーム以外で使用できる難読化したデータソースIDにマッピングしたCSVファイルをダウンロードすることができます。 |
ダッシュボードをパブリックエンベッドする
ダッシュボードをパブリックエンベッドするには、次の手順を実行します。- Domoでダッシュボードに移動します。
- ［シェア］
**［ダッシュボードをエンベッド］**に移動します。
- エンベッドするダッシュボードに含めるすべての**［表示オプション］**のボックスにチェックを入れます。
- **［幅］フィールドと［高さ］**フィールドにサイズをピクセル数で入力します。
- **［エンベッドのオプション］リストから［パブリック］**を選択します。
- コピーを選択して、自動生成されたURLをコピーします。
- Domoダッシュボードを表示させるウェブサイト、ポータル、アプリケーションに、エンベッドコードを貼り付けます。貼り付け方法は、ウェブサイト、ポータル、アプリケーションのどれに貼り付けるかによって異なります。
ダッシュボードをプライベートエンベッドする
- Domoでダッシュボードに移動します。
-
［シェア］
**［ダッシュボードをエンベッド］**に移動します。
- エンベッドするダッシュボードに含めるすべての**［表示オプション］**のボックスにチェックを入れます。
- **［幅］フィールドと［高さ］**フィールドにサイズをピクセル数で入力します。
- **［エンベッドのオプション］リストから［プライベート］を選択します。 6.［コピー］**を選択して、エンベッドコードをコピーします。
- ダッシュボードを表示させるウェブサイト、ポータル、アプリケーションに、エンベッドコードを貼り付けます。貼り付け方法は、ウェブサイト、ポータル、アプリケーションのどれに貼り付けるかによって異なります。
サブページをエンベッドする
ダッシュボードをエンベッドする際は、パブリックでもプライベートでも、ダッシュボードのサブページをエンベッドすることもできます。Domoインスタンスをエンベッドする
Domoアカウントのプライマリインスタンスでない限り、Domoインスタンス全体をエンベッドできます。アカウントのプライマリインスタンスとして現在設定されているインスタンスは、デフォルトではインスタンス全体をエンベッドできないように設定されています。PDPを使用してプライベートエンベッドを設定する
プライベートエンベッドは、DomoのSSOを利用してDomoプラットフォームでユーザーを認証します。エンベッドされたコンテンツはJavaScript APIまたはiFrameを介してエンドユーザーに提供されます。プライベートエンベッドをPDPと組み合わせて、外部のユーザーを含むエンドユーザーに適切なコンテンツを提供することができます。エンベッドを使用して外部エンドユーザーにコンテンツを提供する場合、次の2つの方法のいずれかが推奨されます。- ホワイトラベルのサブスクライバーインスタンスからカードをエンベッドする。この場合、エンドユーザーがDomoアプリケーションにアクセスしようとすると、ホワイトラベルのインスタンスのみが表示されます（例：Buzz機能なし）。 詳細については、「コンテンツをサブスクライバーインスタンスに公開する」を参照してください。
- プログラムエンベッドを使用する。プログラムエンベッドを使用するのは、ユーザーがDomoの認証ユーザーではなく、Domoアプリケーションにアクセスできない場合です。つまり、ポータルまたはアプリケーションコードが認証を処理し、ユーザーに対し適切なデータを確実に表示させます。 詳細については、デベロッパーポータル を参照してください。
プライベートエンベッドを実装する
PDPを使用してプライベートエンベッドを実装するには、次の手順を実行します。- シングルサインオン（SSO）を設定します。詳細については、「SAMLを使用したDomoのシングルサインオンの説明と設定」を参照してください。
- プライベートエンベッドを有効にします。
- PDPを設定します。詳細については、「Personalized Data Permission（PDP）」を参照してください。
- カードとダッシュボードをエンベッドのために設定します。
Domo環境でエンベッドのために設定されているすべてのカードとダッシュボードを表示するには、「管理者設定」>［Domo Everywhere］>**［エンベッド］**に移動します。 - ポータルまたはアプリケーションでiFrameまたはJavaScriptコードを使用してカードとダッシュボードをエンベッドします。
インプレッショントラッキング
カードをエンベッドした後、カンパニー設定内の**［利用状況］**ページから新しいカードのロード数またはインプレッション数を追跡できます。 ナビゲーションヘッダーから**［利用状況］ページにアクセスするには、［その他］>［管理者］**を選択します。**［カンパニー設定］で［利用状況］**を選択します。 **［利用状況］ページには複数のタブがあります。［インプレッション］**タブに移動すると、エンベッドされたコンテンツに関する情報を確認できます。 エンベッドされたコンテンツには、次の4種類があります。
- プライベートカードエンベッド
- プライベートダッシュボードエンベッド
- パブリックカードエンベッド
- パブリックダッシュボードエンベッド
サードパーティアナリティクス
デフォルトでは、Domoはカード、ダッシュボード、読み込み、フィルターなどの操作、使用されたドリルパス、エクスポートなどのコンテンツ操作を追跡します。サードパーティアナリティクス機能を使用すると、デジタルエクスペリエンスを監視し、FullStory、Sprig、HeapなどのDigital Experience Intelligence（DXI）ソリューションを使用して、高度な操作を追跡できます。FullStoryトラッキングを有効にする
エンベッドされたコンテンツのFullStoryトラッキングを有効にするには、次の手順を実行します。- エンベッドアナリティクス機能を有効にするには、Domoアカウントチームにお問い合わせください。
- ウェブサイトにFullStoryをインストールするために必要なコードスニペットをチームに送信します。FullStoryアカウントからコードスニペットを取得できます。
- FullStoryアカウント担当者からCanvas Captureの有効化をリクエストしてください。
よくある質問
「iFrameでDomoの全ての内容を読み込むことはブロックされます」という警告は何を意味しますか？
「iFrameでDomoの全ての内容を読み込むことはブロックされます」という警告は何を意味しますか？
- ドメインが1つも表示されていない場合は、任意のサイトにコンテンツをエンベッドすることができます。
- ドメインが1つも表示されていない場合は、エンベッドの使用事例でJS APIを使用しても機能しません。
- ドメインが表示されている場合は、ほかのドメインにエンベッドされているコンテンツは読み込まれません。
- ドメインが表示されている場合は、JS APIが機能します。
サポートについて
エンベッドされたコンテンツに関するサポートが必要な場合は、 support@domo.com
までお問い合わせください。- リクエストには次の情報を含めてください。
- 挙動が発生しているDomo環境
- 挙動の説明
- 挙動のスクリーンショット（該当する場合）
- 挙動を再現するステップ（既知の場合/該当する場合）
Domo Everywhere Embedの概要（動画）
Domo Everywhere Embedの概要（動画）
Domoカードをエンベッドする（動画）
Domoカードをエンベッドする（動画）