タグのディレクティブ一覧です。
それぞれに指定できる値の例を下部に記載しています。

Excel レポートに影響しないディレクティブ

他に、ダイスからエクスポートされたレポートタグに記載があるものの、実際のレポート出力には使用しないディレクティブが存在します。これらは、glu 管理画面上の表の形式にのみ使用されます。そのため、タグから削除してもレポート出力へ影響ありません。

ディレクティブに指定できる値

TYPE

EDIT

※　insert_before、insert_after 使用時の注意点
1.図形の書式設定
コンパイル時に Excel の仕様から意図せずタグがコピーされてしまい、レポートの出力結果に問題が出ることがございます。これを防ぐために、Excel の図形であるタグを下記のように設定することをお勧めいたします。

• 対象のタグを選択。
• 右クリックを行い、メニューから［図形の書式設定］を選択。
• ［サイズとプロパティ］を選択。
• ［プロパティ］を展開。
• ［セルに合わせて移動やサイズ変更をしない］を選択。

2.タグの実行順序
1 つのシート内で複数のタグをコンパイルする場合、タグの配置が背面のものからコンパイルされます。正しく行の挿入を行うために、下の行のタグから背面になるよう配置してください。

※ Excel の機能の一つ「オブジェクトの選択と表示」を使用すると操作しやすくなります。タグの表示/非表示 をご確認ください。

■ EDIT の使い分け
paste、insert_before
paste は、タグの下の行に入力されている文字や数値が上書きされます。
insert_before は、データ件数に応じて行が挿入される動きをします。下の行に、他のタグや入力された値がある場合に使用します。

insert_after
下の行へデータ件数に応じて行を挿入します。出力した値の合計値を SUM 関数で下に出すなど、セル番地を下方向に拡張したい場合に適しています。

copy_straight と copy_tuple
シートコピーを行うための EDIT です。
PAGES、TYPE=book と一緒に使用することで、シートをアイテムの数に合わせてコピーできます。

CELL

例）

DATA

例）

• ダイス名を取得
  TYPE=table
EDIT=paste
DATA=attribute
ITEMS=1
• 基準日を取得
  TYPE=table
EDIT=paste
DATA=parameter
ITEMS=target_date
• レポート作成の実行日（コンパイル）日を取得
  TYPE=table
EDIT=paste
DATA=parameter
ITEMS=local_timestamp

サンプルテンプレート

Excel ファイルのレポートテンプレートです。
sample_datatype.xlsx（Excel ファイル）

HEADER

例）

START_AT / END_AT

※　from を指定する場合、基準日からの相対日となります。

基準日とは、コンパイルを行う際に基準となる日です。
手動で作成する場合、レポートタブで指定する「期間」の左側の日付となります。
自動生成の場合は自動作成の条件毎に基準日をいつにするか決めることが出来ます。

例）

値	説明
START_AT=from,day,0,0 END_AT=from,day,0,0	対象日のデータを取得。
START_AT=from,day,29,0 END_AT=from,day,0,0	対象日より 30 日前までのデータを取得。
START_AT=from,week,0,1 END_AT=from,week,0,0	当週月曜から、当週日曜日までのデータを取得。
START_AT=from,month,0,1 END_AT=from,month,0,-1	対象月の 1 日から対象月の末日まで
START_AT=from,month_last,0,34 END_AT=from,month,0,-1	対象月の末日の 34 日前から対象月の末日まで
START_AT=from,year,0,1 END_AT=from,year,0,-1	対象年の 1 月から対象年の 12 月まで
START_AT=at,20xx-01-16 END_AT=at,20xx-02-15	日付で期間を選択。
START_AT=at,${CELL_VALUE=’シート名’!A5} END_AT=at,${CELL_VALUE=’シート名’!A6}	セルの値を参照。※1 左の入力例は、別シートのセルを参照する場合。 同じシート内のセルは、下記のようにセル番地のみを入力して参照可能。 例：${CELL_VALUE=A6}

※1 基準日を取得するタグで出力したセルの値を参照する場合には、基準日を取得するタグが一番最初に実行されるようにします。タグ概要 ＞ 5. タグの表示/非表示 を参考にタグが実行される順番を調整してください。

GROUP

ASPECT

DAILY_LEVEL

FROM_LEVEL

ANTE_FILTER

SEGMENT

レポートデータの分割方法を指定します。

※1 デバイスの大分類は以下となります。

値
c: PC
t: タブレット
m: スマートフォン
o: その他フィーチャーフォン、ゲーム機など

※2 レポートは、c、t、m、o の順番に並ぶわけではありません。SORTS でデバイスを指定する必要があります。また、値がないデバイスは、レポートに出力されません。

例）キャンペーンごとのデバイスの値を必ず同じ順序で並べる場合には、SORTS にキャンペーンとデバイスのアイテム番号を指定します。
ただ、以下の記述を行っても、値がないデバイスの列は出力できません。
ASPECT=report_aspect_campaigns
SEGMENT=report_segment_devices:c_t_m_o
SORTS=2,4
# 1:アカウント別
# 2:キャンペーン別
# 3:媒体種別
# 4:デバイス
# 5:表示回数

※3 「_」で区切ることにより、任意のデバイスタイプで分割または合計することが可能です。
組み合わせは自由なので、ご希望の出力方法に合わせて、ご利用ください。

例）

SHOW_SEGMENT

視点を分割項目で分割した際、分割項目の表示方法を指定します。
※ SEGMENTとセットで使用することが可能です。

分割項目を出力する場合には、ダイスの項目として追加することをお勧めします。ご希望の場合は、アタラ サポートチームまでお知らせください。

glu 管理画面から分割項目の値を表示するためのタグをエクスポートする場合の手順を記載します。

1. レポート用のダイスを選択。
2. ［レポート］ タブを開く。
3. ［データ条件］を開く。
4. ［視点］で（例として） キャンペーン別 を選択。
5. ［分割］で（例として）［デバイス別］を選択。
6. ［表示形式］を開く。
7. ［分割列］で（例として） ［視点別で分割し最初］を選択。
8. ［エクスポート］を選択。
9. ［レポート］タグを選択。

MEDI_FILTER

レポートの絞り込み条件を指定します。

集計対象の絞込みをより柔軟に指定できます。
定義されている条件指定としてデバイス別に絞り込む方法があります。他には、カスタムで条件を指定可能な方法があり、媒体の構造（キャンペーンや広告グループ、キーワードなど）などに合わせて絞り込むことができます。

■　定義されている条件指定
デバイスを絞り込む場合の条件指定です。
※　SEGMENT も一緒に使用する必要があります。

デバイスで絞り込む値とカスタムした条件で絞り込む値を同時に指定する場合は & でつなぎます。
MEDI_FILTER=report_medi_filter_segment_device:ctm&report_medi_filter_custom:"CP.name='キャンペーン1'"

■　カスタムで絞り込む場合の条件指定

アカウント ID、キャンペーン名など様々な条件を、完全一致（＝）や部分一致（LIKE）で絞り込むことができます。

注意点

1. “（クォーテーション）’（シングルクォーテーション）は半角で入力します。
2. LIKE を使用する際、次の 2 文字をワイルドカードとして使用できます。
   

   %	任意の 0 文字以上の文字列
   _	任意の 1 文字

3. エスケープ文字の追加が必要な場合があります。
   絞り込み対象の name にクォーテーションやワイルドカードと同じ記号が含まれている場合は、文字列として認識させるために、エスケープ文字を追加してください。
   

   name に含まれる記号	エスケープ文字
   “	\
   ‘	‘
   %	\\
   _	\\

   例）「ATARA’s」というキャンペーン名で絞り込みたい場合
   キャンペーン名に含まれている「’」の前に「’」を追加
   MEDI_FILTER=report_medi_filter_custom:"CP.name = 'ATARA''s'"

   例）「絹100%」で終わるキャンペーン名で絞り込みたい場合
   キャンペーン名に含まれている「%」の前に「\\」を追加
   MEDI_FILTER=report_medi_filter_custom:"CP.name LIKE '%絹100\\%'"

カスタム条件指定の例
例として下記のような条件を指定することが可能です。

• メディア（Yahoo!広告の検索広告とディスプレイ広告）で絞り込む
  ※ その他のメディアの識別子は こちら
  MEDI_FILTER=report_medi_filter_custom:"AC.media_type IN ('SS','IM')"
• キャンペーン名（1つ）で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.name = 'キャンペーン1'"
• キャンペーン名（1つ）以外のもので絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.name != 'キャンペーン1'"
• 「リマーケ」で始まるキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.name LIKE 'リマーケ%'"
• 「/RM」で終わるキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.name LIKE '%/RM'"
• 「CT」を含むキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.name LIKE '%CT%'"
• 複数のキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"(CP.name = '関東' OR CP.name = '東北')"
• 複数の「CT」または「RM」を含むキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"(CP.name LIKE '%CT%' OR CP.name LIKE '%RM%')"
• 複数の「CT」と「RM」を含まないキャンペーン名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"(CP.name NOT LIKE '%CT%' AND CP.name NOT LIKE '%RM%')"
• 東京 を先頭に含む広告グループ名で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AG.name LIKE '東京%'"
• 東京を含むキーワードで絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CR.name LIKE '%東京%'"
• 広告タイプが「Responsive」で始まる広告で絞り込む場合
  MEDI_FILTER=report_medi_filter_custom:"AD.ad_type LIKE 'Responsive%'"
• 広告タイプに「TEXT」を含まない広告で絞り込む場合
  MEDI_FILTER=report_medi_filter_custom:"AD.ad_type NOT LIKE '%TEXT%'"
• 画像サイズに 300 を含むもので絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AD.image_size LIKE '%300%'"
• 画像サイズが 300×250 のもので絞り込む ※ x は半角で入力してください。
  MEDI_FILTER=report_medi_filter_custom:"AD.image_size = '300x250'"
• キーワードのマッチタイプで絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CR.match_type = 'EXACT'"
  

  キーワードのマッチタイプ	説明
  EXACT	完全一致
  BROAD	部分一致、絞り込み部分一致
  PHRASE	フレーズ一致

• Google 広告 のキャンペーンタイプで絞り込む
  – P-MAX キャンペーンで絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.campaign_type IN ('PERFORMANCE_MAX')"
  – 動画キャンペーンで絞り込む
  MEDI_FILTER=report_medi_filter_custom:"CP.campaign_type IN ('VIDEO')"
  – ショッピングキャンペーン かつキャンペーン名が「春SALE」で始まるキャンペーンで絞り込み
  MEDI_FILTER=report_medi_filter_custom:"CP.campaign_type IN ('SHOPPING') AND CP.name LIKE '春SALE%'"
  – アプリ キャンペーン（キャンペーンのサブタイプ）で絞り込み ※ CP.sub_type を使用します。
  AdWords API
  MEDI_FILTER=report_medi_filter_custom:"CP.sub_type IN ('UNIVERSAL APP CAMPAIGN')"
  Google Ads API
  MEDI_FILTER=report_medi_filter_custom:"CP.sub_type IN ('APP_CAMPAIGN')"
  

  Google 広告のキャンペーン（サブ）タイプ	説明
  SEARCH	検索キャンペーン
  DISPLAY	ディスプレイ キャンペーン
  SHOPPING	ショッピング キャンペーン
  VIDEO	動画キャンペーン
  UNIVERSAL APP CAMPAIGN ※ AdWords API APP_CAMPAIGN ※ Google Ads API	アプリ キャンペーン ※ キャンペーンのサブタイプです。 ※ API により名称が異なります。
  PERFORMANCE_MAX	P-MAX キャンペーン

 

• X広告（旧 Twitter広告）のオーディエンス別レポートをフォロワーのデータだけに絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AU.audience_type = 'SIMILAR_TO_FOLLOWERS_OF_USER'"
• Yahoo!広告 ディスプレイ広告のオーディエンス別レポートを「オーディエンスリスト」のデータだけに絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AU.audience_type = '@AUDIENCE_LIST'"
• Yahoo!広告 ディスプレイ広告のオーディエンス別レポートを「オーディエンスカテゴリー」のデータだけに絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AU.audience_type = '@AUDIENCE_CATEGORY'"
• Yahoo!広告 ディスプレイ広告の広告タイプが「RESPONSIVE」で始まり、メディア形式が「IMAGE」の広告で絞り込む
  MEDI_FILTER=report_medi_filter_custom:"AD.ad_type LIKE 'RESPONSIVE%' AND AD.sub_type = 'IMAGE'"

■　カスタムの条件指定に使える値の例

・属性
※　下記にない属性はアタラサポートチームへお問い合わせください。

・メディア/ツールの識別子

POST_FILTER

レポートの絞り込み条件を指定します。

条件を指定することにより、集計結果に対し絞り込みを行います。

■　定義されている条件指定

■　カスタムで絞り込む場合の条件指定
例として下記のような条件を指定することが可能です。
※　”（クォーテーション）’（シングルクォーテーション）は半角で入力してください。

• 表示回数が 1,000 以上で絞り込む
  POST_FILTER=report_post_filter_custom:"SUM(report_imps)>1000"
• 「表示回数」が 0 以上」または「ご利用金額が 0 以上」または「クリック数が 0 以上」で絞り込む
  POST_FILTER=report_post_filter_custom:"(SUM(report_imps)>0 OR SUM(report_cost)>0 OR SUM(report_clicks)>0)"

■　カスタムの条件指定に使える値

例）

※ 上記の値は、お客様の環境によって異なるため、ご利用の際は、アタラ サポートチーム までお問い合わせください。

SERIES

ASPECT で指定した視点を系列（日別、月別）で分割します。

※1 週別の値には、0 : 日, 1 : 月, 2 : 火, 3 : 水, 4 : 木, 5 : 金, 6 : 土 を指定することができます。省略時は 0 : 日 が適用されます。

例）キャンペーン別、日別

FLAT

SERIES で分割した表の展開方法を指定します。

例）FLAT=true を指定した場合

ITEMS

レポートに出力したい項目のアイテム番号を指定します。

複数の項目を指定

アイテム番号をカンマ区切りで指定します。
例）ITEMS=1,2,3,7,8,9

スキップ

0 を指定した列にはデータを書き込みません。Excel のセルに関数を入力している場合などはこの方法でスキップさせます。
例）ITEMS=1,2,3,7,0,8,9

改行

番号の代わりに「b」を指定するとその列でいったん改行されます。
例）ITEMS=1,2,3,7,b,8,9

特殊な指定方法：広告別レポートでの画像出力

広告の画像を出す場合は、=IMG(番号) と指定します。
番号には、画像出力のアイテム番号が入ります。
例）
ITEMS=　=IMG(17),1,2,3
ITEMS=1,2,3,=IMG(15)

特殊な指定方法：SERIES と併用時

・SERIES 使用時に、=top() を使用すると、繰り返し分を順次参照して、最初に登場した値を採用します。
書式：=top( 1 回目のアイテム番号 * 同じ項目の 2 回目のアイテム番号 – 1 回目のアイテム番号)
ご利用のタグでアイテム番号をお確かめの上、ご利用ください。
例）ITEMS=1,2,3,=top(8*100),9

使用場面：アカウント/日別レポートにアカウント ID を出力したい場合
SERIES で FLAT=1 を使わずに日別レポートを出力した場合、アカウント B やアカウント C のように 2 月 1 日には表示回数などの数値が発生していないアカウントが混在してきます。レポートの同じ列にアカウント ID を出力させたい場合、ITEMS に指定するアイテム番号が特定しづらくなります。
1 日目のアカウント ID を指定しただけではアカウント A の ID しか出力されません。
すべてのアカウントで値が発生している日が無いという場合もあり得ます。
=top() を使用するとこうした問題を解決できます。アカウントごとに最初に値が発生した日のアカウント ID を自動的に採用します。

SORTS

ソート（データの並べ替え）を行います。
ソートしたい項目のアイテム番号を指定します。

昇順と降順

マイナスをつけると降順になります。

複数の項目でソート

カンマで区切りながら複数の項目を指定します。最初の項目が同じ値だった場合に、次に指定した項目でソートをかけて表示することができます。
例）コンバージョン、クリック数、表示回数の順番に降順でソート。

指定する番号の確認方法

ソートしたいデータを［レポート］タブの［エクスポート］から「CSVファイル」または「レポートタグ」で出力します。

• CSV ファイル
  列番号で指定します。
  
• レポートタグ
  アイテム番号で指定します。
  

SHIFT

表示方向を指定します。

例）
SHIFT がない場合

SHIFT=right を指定した場合

SUM

COUNT

レポートデータの最大行数を指定します。

例)全データ数が 15 件の場合で COUNT 指定なし(全件表示)

全データ数が 15 件の場合で COUNT=5 ( 5 件表示)

ROUND_UP

その他としてまとめる

SELECTOR

直下のダイスを特定する

・ダイスの型,属性名==’値’
※「=」は比較式を指定可能。「!=」(以外)、「>」、「<」、「>=」、「<=」
・複数指定の場合
OR→　||
AND→　&&

例）
SELECTOR=client,name==’YSS_PC’

SHOW_ALL_ASPECT_ROWS

PAGES

OPTIONS