ドキュメント Campaign Campaign Classic v7 ドキュメント

[v8 にも適用されます]{class="badge positive" title="Campaign v8 にも適用されます"}

テーブルの作成 creating-a-table

Last update: Thu Sep 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：

レポートにテーブルを追加して、データを表示できます。追加できるテーブルには、キューブの測定に基づいて作成されたピボットテーブル、グループ化されたリスト、値の分類を含むテーブルがあります。

グループを使用したリストの作成 creating-a-list-with-group

グループ化されたリスト タイプのテーブルでは、テーブルのデータをグループ化し、それに関する統計を生成できます。例えば、データの合計と小計を作成できます。グループごとに、専用のヘッダー行、詳細行、フッター行があります。

CAUTION

テーブルを含む ページ アクティビティの前に、レポートで分析するデータを収集するための クエリ または スクリプト アクティビティが必要です。これらのアクティビティについて詳しくは、分析するデータの収集およびスクリプトアクティビティを参照してください。

動作原理 operating-principle

複数のデータカテゴリを一度に分析しなければならないことがあります。グループ化されたリストでは、データを組み合わせて、同じテーブル内のデータの様々なグループに関する統計を作成できます。それには、テーブルにグループを作成します。

次の例では、グループは、データベース内のすべてのキャンペーン、配信、および配信ごと／キャンペーンごとに送信されたメッセージ数を表示します。

キャンペーン（ラベル (キャンペーン)）、キャンペーンにリンクされた配信（ラベル）のリスト、配信ごとに送信されたメッセージの数（処理済み）、それらをキャンペーンごとに合計した総数（Sum(@processed)）を一覧表示できます。

実装手順 implementation-steps

完全な実装例は、使用例：グループリストを含むレポートの作成で説明しています。

「グループ化されたリスト」タイプのテーブルを作成するには、次の手順に従ってください。

レポートのチャートに移動し、クエリ アクティビティを追加します。分析するデータの収集を参照してください。
ソーステーブルを入力し、そのテーブルのフィールドのうち、統計に関係するものを選択します。
フローチャートに ページ アクティビティを追加します。詳しくは、静的要素を参照してください。
ページに グループ化されたリスト タイプのテーブルを挿入します。
データパス、またはクエリでデータソースとして選択されたテーブルを指定します。

後でソーステーブルのフィールドを復元し、それらをテーブルのセルに挿入する場合、この手順は必須です。
テーブルとその内容を作成します。
最終決定したレポートを「プレビュー」タブに表示します。その後は、レポートをパブリッシュしたり、必要に応じてレポートを別のフォーマットにエクスポートしたりできます。詳しくは、レポートのエクスポートを参照してください。

行や列の追加 adding-lines-and-columns

デフォルトでは、グループ化されたリスト タイプのテーブルには、ヘッダー行、詳細行、フッター行が含まれています。

グループ自体に、ヘッダー行、詳細行、フッター行が含まれています。

ヘッダー行：この行にはテーブルの列のタイトルを入力できます。
詳細行：この行には統計値が含まれます。
フッター行：この行には合計値を表示できます。

必要に応じて、行や列を追加できます。

グループは、テーブルの任意の行に配置でき、独自のヘッダー行、詳細行、フッター行を含みます。

行や列：行や列を追加または削除するには、既存の行や列に移動し、右クリックメニューを使用します。

追加する行の特性は、カーソルの位置によって決まります。例えば、ヘッダー行を追加するには、ヘッダーにカーソルを置き、追加／上に 1 行（または下に 1 行） を選択します。

列の幅は 列のフォーマット 項目で変更できます。

グループ：グループを追加するには、対象となる行に移動し、ドロップダウンメニューから該当する項目を選択します。

セルの内容の定義 defining-cell-content

テーブルのセルを編集してセルの内容とフォーマットを定義するには、対象となるセルに移動し、右クリックメニューを使用します。

式メニューエントリを使用すると、表示する値を選択できます。

分析する値をテーブルに直接挿入する場合は、使用可能なフィールドの中から該当するものを選択します。

使用可能なフィールドのリストは、レポート作成チャートでテーブル作成の前に定義するクエリの内容に一致します。
セル（例えばヘッダーセル）のラベルを入力します。

それには、データベースにフィールドを挿入する場合と同様の手順に従いますが、式は選択しません。「ラベル」フィールドにラベルを入力します。それがそのまま表示されます。
集計（平均や合計など）を計算し、それをセルに表示します。

それには、集計メニューエントリを使用し、目的とするキャンペーンを選択します。

セルのフォーマットの定義 defining-cell-format

セルのフォーマットを定義する場合は、セルのフォーマット… メニューを使用して、選択したセルに使用できるすべての書式設定オプションにアクセスできます。

これらのオプションを使用すると、レポートの最終的なレンダリングをパーソナライズし、情報を読み取りやすくすることができます。

データを Excel にエクスポートする場合は、「CR」フィールドを使用します。「はい」の値を選択すると、強制的に復帰改行されます。この値はエクスポート時に保持されます。詳しくは、レポートのエクスポートを参照してください。

セルのフォーマット ウィンドウでは、次のタブにアクセスできます。

「値」タブ
「境界線」タブ
「クリック」タブ
「追加」タブ

「値」タブでは、フォントおよび様々な値属性を変更したり、値の性質に基づいてフォーマットを定義したりできます。

フォーマットによってデータの表示が変わります。例えば、「数」、「通貨」、「割合」の各フォーマットを使用すると、数字を右詰めにして小数点を表示できます。

通貨フォーマットの設定方法の例：値の表示に使用される通貨を指定し、3 桁区切り記号を使用するかどうかを選択し、負の値を赤で表示できます。通貨記号の位置は、オペレーターのプロファイルに定義されている言語に依存します。

日付の設定例：時刻を表示するかどうかを選択できます。

「境界線」タブでは、テーブルの行や列に境界線を追加できます。セルに境界線を追加すると、サイズの大きいレポートを Excel にエクスポートする際に、パフォーマンス上の問題が発生する可能性があります。

必要に応じて、テーブルテンプレート（管理／設定／フォームのレンダリング）で境界線を定義できます。

その場合、使用する構文は次のようになります。

「Web」タブで使用する構文

 .tabular td {
 border: solid 1px #000000;
 }

「Excel」タブで使用する構文

 <style name="odd" fillColor="#fdfdfd">
  <border>
   <borderTop value="solid 0.05pt #000000" />
   <borderBottom value="solid 0.05pt #000000" />
   <borderLeft value="solid 0.05pt #000000" />
   <borderRight value="solid 0.05pt #000000" />
  </border>
 </style>

 <style name="even" fillColor="#f7f8fa">
  <border>
   <borderTop value="solid 0.05pt #000000" />
   <borderBottom value="solid 0.05pt #000000" />
   <borderLeft value="solid 0.05pt #000000" />
   <borderRight value="solid 0.05pt #000000" />
  </border>
 </style>

「クリック」タブでは、ユーザーがセルやテーブルの内容をクリックしたときに実行されるアクションを定義できます。

次の例では、セルの値をクリックするとレポートの 2 番目のページが表示されるようになります。配信時の情報がセルに格納されます。

「追加」タブでは、色付きマークや棒グラフなどのビジュアルをデータにリンクできます。色付きのマークは、テーブルが凡例としてグラフに表示される場合に使用されます。詳しくは、手順 5 - 2 番目のページの作成の実装例を参照してください。

ユースケース：グループリストを含んだレポートの作成 use-case--create-a-report-with-a-group-list

この例では、2 ページから成るレポートを作成します。最初のページには、キャンペーンのリストとキャンペーンごとの合計配信数のほか、送信されたメッセージの数が表示されます。配信名はクリック可能なリンクになっており、それをクリックすると、レポートの 2 番目のページに移動し、テーブルやグラフで選択した配信のメールドメインごとの配信の分類が表示されます。2 番目のページでは、テーブルはグラフの凡例になります。

手順 1 - レポートの作成 step-1---create-a-report

キャンペーンスキーマに関する新しいレポート、「キャンペーン (nms)」を作成します。

「保存」ボタンをクリックして、レポートを作成します。

チャートに移動し、レポートのコンテンツを設計するための最初のコンポーネント、つまり、最初のクエリと最初のページを追加します。

手順 2 - 最初のクエリの作成 step-2---create-the-first-query

最初のクエリでは、各キャンペーンにリンクされている配信を収集します。目標は、Adobe Campaign データベースの様々な配信のうち、各キャンペーンにリンクされている配信に関するレポートを表示することです。

最初のクエリをダブルクリックして編集してから、次の手順に従ってクエリを設定します。

最初に、クエリのソースのスキーマを変更します。「配信 (nms)」スキーマを選択します。
「クエリを編集」リンクをクリックして、詳細フィールドを表示します。
次のフィールドを選択します。
- 配信ラベル
- 配信のプライマリキー
- キャンペーンラベル
- 処理された配信の指標
- 「キャンペーン」リンクの外部キー
- エラー率指標
各フィールドにエイリアスをリンクします。これにより、レポートの最初のページに追加されるテーブルからデータを選択しやすくなるので、お勧めします。

この例の場合は、次のエイリアスを使用します。
- ラベル：@label
- プライマリキー：@deliveryId
- ラベル（キャンペーン）：@label1
- 処理済み：@processed
- 「キャンペーン」リンク ('id' フィールド) の外部キー：@operationId
- エラー率：@errorRatio
「次へ」ボタンを 2 回クリックして、データのフィルター 手順に移動します。

キャンペーンにリンクされた配信のみを収集するためのフィルター条件を追加します。

このフィルターの構文は「"キャンペーン" リンクの外部キーが 0 より大きい」です。
「完了」をクリックしてこれらの条件を保存した後、「OK」をクリックしてクエリエディターを閉じます。

手順 3：最初のページの作成 step-3--create-the-first-page

この手順では、レポートの最初のページを設定します。設定するには、次の手順に従います。

ページ アクティビティを開き、そのタイトルを、例えばこの場合は "Deliveries" と入力します。
ツールバーからグループ化されたリストを挿入し、そのラベルを入力します。例：キャンペーンごとの配信のリスト。
「テーブルデータ Xpath…」リンクをクリックし、[query/delivery] のような配信リンクを選択します。
「データ」タブをクリックし、テーブルのレイアウトを変更します。右側に 3 列を追加します。
グループを追加します。

このグループによって、キャンペーンとそのキャンペーンにリンクされている配信をグループ化できるようになります。
グループウィンドウで 「キャンペーン」リンク (「id」フィールド) の外部キー を参照し、ウィンドウを閉じます。
グループヘッダーの最初のセルを編集し、式としてキャンペーンの ラベル フィールドを挿入します。
詳細行の 2 番目のセルを編集し、配信の ラベル を選択します。
このセルのフォーマットを編集し、「クリック」タブを開きます。ユーザーが配信の名前をクリックしたときにその配信が同じウィンドウに開くように、適切なオプションを設定します。

それには、次のページ タイプのアクションを選択し、「同じウィンドウで」をウィンドウオプションとして選択します。
ウィンドウ下部の「追加」をクリックし、先に作成したクエリで定義したとおり、/vars/selectedDelivery パスおよび配信のプライマリキーのエイリアスに一致する @deliveryId の式を指定します。この式を使用すると、選択した配信にアクセスできます。
グループのフッター行の 2 番目のセルを編集し、ラベルとして "Total per Campaign" を入力します。
グループのヘッダー行の 3 番目のセルを編集し、ラベルとして "Number of messages sent" を入力します。

この情報は列タイトルと一致します。
詳細行の 3 番目のセルを編集し、処理されたメッセージの指標を式として選択します。
グループのフッター行の 3 番目のセルを編集して、処理された配信達成度を選択し、それに対して合計の集計を適用します。
詳細行の 4 番目のセルを編集し、式として「配信のエラー率 (@errorRatio)」を選択します。
このセルを選択して、配信のエラー率を表す棒グラフを表示するように設定します。

それには、セルのフォーマットにアクセスし、「追加」タブを開きます。ドロップダウンリストの 棒グラフ を選択し、「セル値を非表示」オプションを選択します。

これでレポートのレンダリングを表示できます。「プレビュー」タブをクリックし、「グローバル」オプションを選択します。これで、キャンペーンにリンクされている Adobe Campaign データベースのすべての配信のリストが表示されます。

「プレビュー」タブを使用して、テーブル内のデータが正しく選択および設定されていることを確認することをお勧めします。それが済めば、テーブルの書式設定に進むことができます。
キャンペーンごとの合計配信数と処理されたメッセージの総数を表示するセルに太字スタイルを適用します。

グループのヘッダー行の最初のセル（キャンペーン名を表示するセル）をクリックし、編集／右に結合 を選択します。

グループのヘッダー行の最初の 2 つのセルを結合すると、キャンペーンのタイトルと、キャンペーンにリンクされている配信のリストが整列し直されます。

note caution
CAUTION
セルを結合するのはレポートが作成されてからにすることをお勧めします。結合は元に戻せないからです。

手順 4 - 2 番目のクエリの作成 step-4---create-the-second-query

レポートのユーザーが配信をクリックしたきにその配信の詳細が表示されるように、2 番目のクエリと 2 番目のページを追加します。クエリを追加する前に、作成したページを編集し、クエリにリンクできるように出力トランジションを有効にします。

ページ アクティビティの後に新しいクエリを追加し、そのクエリのスキーマを編集して 受信者配信ログ スキーマを選択します。
クエリを編集し、出力列を定義します。メールドメインごとの配信数を表示するには、次の作業が必要です。
- プライマリキーの合計を計算して、配信ログの数をカウントします。
- 受信者のメールドメインを収集し、このフィールドに関する情報をグループ化します。それには、出力列で「グループ」オプションを選択します。
フィールドに次のエイリアスをリンクします。
- カウント（プライマリキー）：@count
- メールドメイン（受信者）：@domain
「次へ」ボタンを 2 回クリックします。これで、データのフィルター の手順に移動します。

選択した配信にリンクされている情報のみを収集するフィルター条件を追加します。

構文は「"配信" リンクの外部キーが設定の値と等しい」です。 $([vars/selectedDelivery])
クエリ設定ウィンドウを閉じ、チャートに（2 番目のクエリの直後に）ページアクティビティを追加します。

手順 5 - 2 番目のページの作成 step-5---create-the-second-page

ページを編集し、そのラベルを「メールドメイン」と入力します。
「アウトバウンドトランジションを有効にする」オプションのチェックをオフにします。これがレポートの最後のページであり、この後に別のアクティビティが続くことはありません。
右クリックメニューを使用して、グループ化されたリストを新しく追加し、名前を "Email domain per recipient" とします。
「テーブルデータ Xpath」をクリックし、「受信者配信ログ」リンクを選択します。
「データ」タブで、テーブルを次のように調整します。
- 右側に 2 列を追加します。
- 詳細行の最初のセルに、行数をカウントする式 rowNum()-1 を追加します。その次に、セルのフォーマットを変更します。「追加」タブで、「「カラー」タブ」を選択し、「OK」をクリックします。
  
  この設定によって、テーブルをグラフのキャプションとして使用できるようになります。
- 詳細行の 2 番目のセルに、式 Email domain(Recipient) を追加します。
- 詳細行の 3 番目のセルに、式 count(primary key) を追加します。
右クリックメニューを使用してページに円グラフを追加し、そのラベルを "Email domains" にします。詳しくは、グラフのタイプとバリエーションを参照してください。
「バリエーション」リンクをクリックし、「ラベルを表示」オプションと「キャプションを表示」オプションの選択を解除します。
値の並べ替えが設定されていないことを確認します。詳しくは、この節を参照してください。
「データ」タブで、データソースを変更します。それには、ドロップダウンリストから「コンテキストデータ」を選択します。
次に、「詳細設定パラメーター」をクリックし、受信者配信ログへのリンクを選択します。
「グラフタイプ」セクションで、メールドメイン 変数を選択します。
次に、実行する計算を追加します。合計を演算子として選択します。
「詳細」ボタンをクリックして、カウントに関係するフィールドを選択した後、設定ウィンドウを閉じます。
レポートを保存します。

これで、ページが設定されました。