graft 機能（メディアのアクション）

graft 機能をタグの記述に使用すると、キャンペーンや広告ごとの指標（表示回数・クリック数など）とアクションごとの数値を一緒にしたレポートの作成が可能です。
下記のようなレポートを graft 機能で出力する方法について説明します。

キャンペーン名 表示回数 クリック数 お問合せ 資料請求
キャンペーン_A 86253 525 3 10
キャンペーン_B 59431 806 1 2

スケジュールの設定

glu の［スケジュール］には 2 種類の［レポート種別］が必要です。基となるレポート（表示回数やクリック数を含む）の種別と、それに対応するアクション別レポートの種別を設定します。
レポートへ出力する前に［スケジュール］の設定を行い、glu へレポートデータを取得しておきます。

以下に例として、いくつかのレポート種別での例を記載します。

基となるレポートの種別 対応するアクション別レポートの種別
アカウント別 アカウントアクション別
キャンペーン別 キャンペーンアクション別
広告グループ別 広告グループアクション別
広告別 広告アクション別
キーワード別 キーワードアクション別
オーディエンス別 オーディエンスアクション別
性年齢別 性年齢アクション別

設定する際は、対応レポート からメディアごとに設定可能なレポート種別を確認してください。

↑

タグの記述

graft 機能では、INCLUDE_FORMULA と DYNAMIC_ATTR というディレクティブを使用します。また、ITEMS にもアイテム番号を追加して出力します。

 ・ INCLUDE_FORMULA
 ・ DYNAMIC_ATTR
 ・ ITEMS・ATTR_ORDERS
 ・【資料】メディアごとのカラム名

INCLUDE_FORMULA

基となるレポートへ異なるレポートデータを接続するときに使用するディレクティブです。アクション別レポートを接続するには、以下のように記述します。

INCLUDE_FORMULA=graft:action_reports
↑

DYNAMIC_ATTR

動的にデータを出力するためのディレクティブです。
レポートの内容に合わせて以下の【1】～【4】の項目を変更します。

DYNAMIC_ATTR[【1】]=decimal,0,"SUM(RX.【1】)","","SUM(RX.【2】* (MX.【3】 ='【4】'))"

例）Google 広告のアクション別レポートから「お問合せ」と「資料請求」の数値を出力する

DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='お問合せ'))"
DYNAMIC_ATTR[cv02]=decimal,0,"SUM(RX.cv02)","","SUM(RX.met_conv_t * (MX.data ='資料請求'))"

【1】ヘッダー名
【2】カラム名（アクションの数値）
【3】カラム名（アクション名）
【4】アクション名

2 箇所あります。
レポート出力時にヘッダー名としたい文字列を 2 箇所ともに同じ内容で入力します。
［使用可能な文字列］
英数字と「_」（アンダーバー）のみ

※ 先頭文字に数字は使用不可
※ 日本語などの 2 バイト文字は使用不可
※ MySQL の予約語は使用不可（例：LIKE、TABLE、AND など）
※ 記号や日本語など現在使える文字もありますが非推奨のため使用をお控えください。

例）ヘッダー名を「cv01」とする
【1】に「cv01」を入力
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.【2】* (MX.【3】 ='【4】'))"

【2】カラム名（アクションの数値）

アクションの数値が入っているカラムのカラム名を入力します。
カラム名は、【資料】メディアごとのカラム名 を参照してください。

例）Google 広告の「コンバージョン」を出力する
【2】にカラム名「met_conv_t」を入力
DYNAMIC_ATTR[【1】]=decimal,0,"SUM(RX.【1】)","","SUM(RX.met_conv_t * (MX.【3】 ='【4】'))"

【3】カラム名（アクション名）

アクション名が入っているカラムのカラム名を入力します。
data または name をご利用可能です。

例）【3】にカラム名「data」を入力
DYNAMIC_ATTR[【1】]=decimal,0,"SUM(RX.【1】)","","SUM(RX.【2】 * (MX.data ='【4】'))"

【ご注意】data と name でアクション名が異なるケース

以下の指標では data と name を使い分ける必要があります。

・Meta広告（Facebook広告、Instagram広告）のカタログセグメントのコンバージョン
glu 3.7.2 / 4.7.2 以降
カタログセグメントのコンバージョンのみを使用する際は、name を使用します。

カラム名 アクション名（例）シェアされたアイテムの購入
data omni_purchase
name catalog_segment.omni_purchase
例）
・「シェアされたアイテムの購入」の値と通常の「購入」の値との両方を出力可能
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='omni_purchase'))"

・「シェアされたアイテムの購入」の値を出力可能
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.name ='catalog_segment.omni_purchase'))"

・「購入」の値を出力可能
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.name ='omni_purchase'))"

・Meta広告（Facebook広告、Instagram広告）のカスタムコンバージョン
Meta広告マネージャ上の名称は data を使用します。

カラム名 アクション名（例）
data お申し込み
name offsite_conversion.custom.1234567891234567
※ 数字の箇所は各カスタムコンバージョンの ID です。
例）
data で指定する
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='お申し込み'))"
name で指定する
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.name ='offsite_conversion.custom.1234567891234567'))"

【4】アクション名

出力したいアクションのアクション名を入力します。
glu では、アカウントの［標準レポート］タブでアクション別を表示すると、視点または［アクション名］の列に表示されます。実績が出ていないアクションは、glu 上で確認できません。

例）アクション名は予約完了
【4】に 予約完了 を入力
DYNAMIC_ATTR[【1】]=decimal,0,"SUM(RX.【1】)","","SUM(RX.【2】 * (MX.【3】 ='予約完了'))"
↑

ITEMS・ATTR_ORDERS

ITEMS（Excel のレポートタグの場合）

ITEMS に DYNAMIC_ATTR の使用により動的に増えたカラムのアイテム番号を入力します。
例えば、レポートタグの出力項目の最後尾の番号が 200 だった場合、
1 行目の DYNAMIC_ATTR の数値を出力するためには 201 を ITEMS へ入力します。
2 行目の DYNAMIC_ATTR の数値を出力するためには 202 を ITEMS へ入力します。
このアイテム番号は、SORTS にも入力可能です。

なお、レポートタグの出力項目の最後尾の番号は、ご利用のダイスのカラム数やレポート条件によって異なります。タグを作成する際に、都度、glu 管理画面上の［レポート］タブ > ［エクスポート］ > ［レポートタグエディタ］より確認いただくことをお勧めします。

ATTR_ORDERS（Excel 以外のレポートタグの場合）

ATTR_ORDERS に DYNAMIC_ATTR の使用により動的に増えたカラムのヘッダー名を入力します。
例えば、DYNAMIC_ATTR の記述が
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='お問合せ'))"
の場合、ATTR_ORDERS での指定は cv01:0 となります。

↑

【資料】メディアごとのカラム名

DYNAMIC_ATTR の「【2】カラム名（アクションの数値）」に入力する値は以下です。メディアごとの値を入力してください。

Meta広告（Facebook広告、Instagram広告）

コンバージョン値およびアトリビューションウィンドウごとの数値は、最初に設定が必要です。アタラ サポートチームまでお知らせください。

【ご注意】
・「met_conv_t」「met_revenue_t」は、広告セットのアトリビューション設定に準じたコンバージョン数を取得します。
・エンゲージメント関連の項目は、「met_conv_t」のみ取得可能です。（各アトリビューションウィンドウごとの数値は取得しません）
・標準イベント・カスタムコンバージョンは、「複数アトリビューション設定」（キャンペーン配下の広告セットごとにアトリビューションウィンドウの設定が異なる）の場合、キャンペーンアクション別レポートではコンバージョン数を取得できません。（Meta広告管理画面のキャンペーン別レポートでもコンバージョン数は反映されておらず、glu でも同様の状態になります）
キャンペーン別レポートや日別（週別・月別）レポートなどは、以下のように出力してください。
1.［スケジュール］タブへ広告グループアクション別または広告アクション別レポートを設定する
2.レポートタグの「FROM_LEVEL」を「FROM_LEVEL=adgroups」または「FROM_LEVEL=ads」とする
・レポートタグで複数のアトリビューションウィンドウを合計する場合の記述は、こちら を参照ください。

アトリビューションウィンドウ コンバージョンのカラム名 コンバージョン値のカラム名
広告セットのアトリビューション設定に準じた 合計 met_conv_t met_revenue_t
ビュー 1日間 合計 met_conv_x001 met_revenue_x001
ビュー 7日間 合計 met_conv_x002 met_revenue_x002
ビュー 28日間 合計 met_conv_x003 met_revenue_x003
クリック 1日間 合計 met_conv_x004 met_revenue_x004
クリック 7日間 合計 met_conv_x005 met_revenue_x005
クリック 28日間 合計 met_conv_x006 met_revenue_x006
広告セットのアトリビューション設定に準じた ユニーク met_conv_u –
ビュー 1日間 ユニーク met_user_x001 –
ビュー 7日間 ユニーク met_user_x002 –
ビュー 28日間 ユニーク met_user_x003 –
クリック 1日間 ユニーク met_user_x004 –
クリック 7日間 ユニーク met_user_x005 –
クリック 28日間 ユニーク met_user_x006 –

Google 広告

コンバージョンの種類 カラム名
すべてのコンバージョン met_conv_a
コンバージョン met_conv_t
コンバージョン met_conv_u
ビュースルーコンバージョン met_vt_conv
すべてのコンバージョン値 met_revenue_a
コンバージョン値 met_revenue_t

Google ディスプレイ & ビデオ 360

コンバージョンの種類 カラム名
Post-Click Conversions met_conv_t
Post-Click Conversions met_conv_u

LINE広告

コンバージョンの種類 カラム名
コンバージョン met_conv_t
コンバージョン met_conv_u

TikTok 広告

ページイベントデータの「合計」を出します。対応済みのページイベントデータは こちら で確認してください。

種類 カラム名
合計 met_conv_t
合計 met_conv_u

X広告（旧 Twitter広告）

最初に設定が必要です。アタラ サポートチームまでお知らせください。

コンバージョンの種類 カラム名
購入 met_conv_purchase
購入 – ポストビュー met_conv_purchase_x1
購入 – ポストエンゲージメント met_conv_purchase_x2
購入 – 売上金額 met_conv_purchase_v
リード ※ 旧：新規登録 met_conv_entry
リード – ポストビュー ※ 旧：登録 – ポストビュー met_conv_entry_x1
リード – ポストエンゲージメント ※ 旧：登録 – ポストエンゲージメント met_conv_entry_x2
リード – 売上金額 ※ 旧：登録 – 売上金額 met_conv_entry_v
ページビュー ※ 旧：サイト訪問 met_conv_visit
ページビュー – ポストビュー ※ 旧：サイト訪問 – ポストビュー met_conv_visit_x1
ページビュー – ポストエンゲージメント ※ 旧：サイト訪問 – ポストエンゲージメント met_conv_visit_x2
ページビュー – 売上金額 ※ 旧：サイト訪問 – 売上金額 met_conv_visit_v
ダウンロード met_conv_install
ダウンロード – ポストビュー met_conv_install_x1
ダウンロード – ポストエンゲージメント met_conv_install_x2
ダウンロード – 売上金額 met_conv_install_v
カスタムイベント met_conv_other
カスタムイベント – 表示 met_conv_other_x1
カスタムイベント – エンゲージメント met_conv_other_x2
カスタム – 売上金額 met_conv_other_v

Yahoo!広告 検索広告

コンバージョンの種類 カラム名
すべてのコンバージョン数 met_conv_a
コンバージョン数 met_conv_t
コンバージョン数 met_conv_u

Yahoo!広告 ディスプレイ広告（YDN）

コンバージョンの種類 カラム名
コンバージョン数（全て） met_conv_a
コンバージョン数 met_conv_t
コンバージョン数 met_conv_u
ビュースルーコンバージョン数 met_vt_conv
↑

タグのサンプル

タグの記述
ヘッダー名の指定
アクション名の指定
メディアごとの記述
複数のアクションを異なる列に出力
複数のメディア（異なるカラム名）のアクションを同じ列に出力
複数のアクションを合計して同じ列に出力
セル参照
データの無い行に 0 を出力

タグの記述

INCLUDE_FORMULA と DYNAMIC_ATTR の位置に厳格な決まりはありません。サンプルでは、タグの下部に設置しています。

例）キャンペーン別レポートにアクション別レポートを出力
GROUP=report_group_default
START_AT=from,month,0,1
END_AT=from,month,0,-1
ASPECT=report_aspect_campaigns
SERIES=report_series_none
SEGMENT=report_segment_none
SELECTOR=
DAILY_LEVEL=
FROM_LEVEL=
ANTE_FILTER=report_ante_filter_media_g_aw
MEDI_FILTER=report_medi_filter_none
POST_FILTER=report_post_filter_none
ROUND_UP=report_round_up_none
SHOW_SEGMENT=report_show_segment_none_by_aspect
SHOW_ALL_ASPECT_ROWS=false
SHOW_SUM=report_show_sum_none
TRANSPOSE=false
TYPE=table
DATA=report
EDIT=paste
SHIFT=down
HEADER=true
CELL=
SORTS=
ITEMS=2,5,6,201,202
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='お問合せ'))"
DYNAMIC_ATTR[cv02]=decimal,0,"SUM(RX.cv02)","","SUM(RX.met_conv_t * (MX.data ='資料請求'))"

ヘッダー名の指定

例）ヘッダー名：cv01
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='CV（予約完了）'))"

例）ヘッダー名：Reservation
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Reservation]=decimal,0,"SUM(RX.Reservation)","","SUM(RX.met_conv_t * (MX.data ='CV（予約完了）'))"

例）ヘッダー名：post_reaction
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[post_reaction]=decimal,0,"SUM(RX.post_reaction)","","SUM(RX.met_conv_t * (MX.data = 'post_reaction'))"

アクション名の指定

アクション名の指定には「=」だけでなく、「LIKE」も使用可能です。

例）アクション名が「予約」（ = を使用）
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data = '予約'))"

例）アクション名に「予約」を含む（ LIKE を使用）
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data LIKE '%予約%'))"

メディアごとの記述

例）メディア：Google 広告
ヘッダー名：Reservation
指標：コンバージョン
アクション名：CV（予約完了）
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Reservation]=decimal,0,"SUM(RX.Reservation)","","SUM(RX.met_conv_t * (MX.data ='CV（予約完了）'))"

例）メディア：Google ディスプレイ & ビデオ 360
ヘッダー名：Reservation
指標：Post-Click Conversions
アクション名：Reservation
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Reservation]=decimal,0,"SUM(RX.Reservation)","","SUM(RX.met_conv_t * (MX.data = '予約完了'))"

例）メディア：Meta広告（Facebook広告、Instagram広告）
ヘッダー名：Reaction
アクション名：post_reaction
アトリビューションウィンドウ：広告セットのアトリビューション設定
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Reaction]=decimal,0,"SUM(RX.Reaction)","","SUM(RX.met_conv_t * (MX.data = 'post_reaction'))"

例）メディア：Meta広告（Facebook広告、Instagram広告）
ヘッダー名：Reaction
アクション名：post_reaction
アトリビューションウィンドウ：ビュー 1日間
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Reaction]=decimal,0,"SUM(RX.Reaction)","","SUM(RX.met_conv_x001 * (MX.data = 'post_reaction'))"

例）メディア：X広告（旧 Twitter広告）
ヘッダー名：Purchase
コンバージョンの種類：購入 – ポストエンゲージメント
アクション名：購入
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[Purchase]=decimal,0,"SUM(RX.Purchase)","","SUM(RX.met_conv_purchase_x2 * (MX.data ='購入'))"

複数のアクションを異なる列に出力

アクションの種類ごとに DYNAMIC_ATTR の行を作成して複数にします。ヘッダー名はアクションごとに異なる文字列を指定します。（ヘッダー名が重複するとエラーになります。）

例）3 種類のアクション
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data ='CV（資料請求）'))"
DYNAMIC_ATTR[cv02]=decimal,0,"SUM(RX.cv02)","","SUM(RX.met_conv_t * (MX.data ='CV（問合せ）'))"
DYNAMIC_ATTR[cv03]=decimal,0,"SUM(RX.cv03)","","SUM(RX.met_conv_t * (MX.data ='CV（予約完了）'))"

複数のメディア（異なるカラム名）のアクションを同じ列に出力

メディアによってカラム名が異なる場合でも、同じ列に出力します。

例）カラム名：X広告（旧 Twitter広告）は「購入 – ポストエンゲージメント」（met_conv_purchase_x2）
その他のメディアは「コンバージョン」（met_conv_t）

アクション名：購入

INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(CASE WHEN AC.media_type = 'TW' THEN RX.met_conv_purchase_x2 ELSE RX.met_conv_t END * (MX.data = '購入'))"

例）カラム名：Google 広告は「すべてのコンバージョン」（met_conv_a）
X広告（旧 Twitter広告）は「購入 – ポストエンゲージメント」（met_conv_purchase_x2）
Meta広告（Facebook広告、Instagram広告）は「クリック 7日間 合計」（met_conv_x005）
その他のメディアは「コンバージョン」（met_conv_t）

アクション名：glu 管理画面上のアカウントの「CV1」に入力

INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(CASE WHEN MX.data = AC.cv_name_01 THEN CASE WHEN AC.media_type = 'AW' THEN RX.met_conv_a WHEN AC.media_type = 'TW' THEN RX.met_conv_purchase_x2 WHEN AC.media_type = 'FB' THEN RX.met_conv_x005 ELSE RX.met_conv_t END END)"

複数のアクションを合計して同じ列に出力

複数のアクションの値を合計して同じ列に出力します。

例）2 種類のアクションを合計
メディア：Meta広告（Facebook広告、Instagram広告）
アトリビューションウィンドウ：ビュー 1日間 + クリック 7日間
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","IFNULL( SUM(RX.met_conv_x001 * (MX.data = 'post_reaction') ), 0) + IFNULL( SUM(RX.met_conv_x005 * (MX.data = 'post_reaction') ), 0)"

例）3 種類のアクションを合計
アクション名：glu 管理画面上のアカウントの「CV1」「CV2」「CV3」に入力
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(IFNULL(RX.cv01,0))","","IFNULL(SUM(RX.met_conv_t * (MX.data =AC.cv_name_01)), 0) + IFNULL(SUM(RX.met_conv_t * (MX.data =AC.cv_name_02)), 0) + IFNULL(SUM(RX.met_conv_t * (MX.data =AC.cv_name_03)), 0)"

セル参照

例）アクション名をセル参照（同一シート上のセル番地を指定）
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data = '${CELL_VALUE=B3}'))"

例）アクション名をセル参照（シート名とセル番地を指定）
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(RX.cv01)","","SUM(RX.met_conv_t * (MX.data = '${CELL_VALUE='シート名'!A5}'))"

データの無い行に 0 を出力

アクションの数値が全く発生していない場合に空白でなく 0 と出力させる記述です。

例）データの無い行に 0 を出力
“SUM(RX.cv01)” を “SUM(IFNULL(RX.cv01,0))” へ変更
INCLUDE_FORMULA=graft:action_reports
DYNAMIC_ATTR[cv01]=decimal,0,"SUM(IFNULL(RX.cv01,0))","","SUM(RX.met_conv_t * (MX.data = '予約'))"
↑

関連リンク