RobomaではAPIを使用した自動連携と、CSVデータを用いた手動連携にてデータの取得が可能となっております。
この記事では、手動連携で媒体データを取得する方法をご紹介します。
※自動連携の対応媒体については、Robomaにログインいただきご確認をお願いいたします。
作業手順
- アカウントを連携したいプロジェクトを開き、メニュー画面【共通設定＞広告アカウント】をクリックする
- 【新しい広告アカウントを追加する】をクリックする
- メディア選択画面で連携をしたい媒体のアイコンを選択する
- 任意でアカウント名を設定する
- メニュー画面【データシンク＞媒体データインポート】から【アップロード】ボタンをクリックし画面でテンプレート（Excel）をダウンロードする
- テンプレートのフォーマットに従って、レポートデータを作成する
※ 項目の仕様に関しては下記参照。 - CSV 形式でファイルを保存。
※ カンマ区切り、UTF-8 / Shift-JIS。 - 「アップロード」画面で、広告アカウントと CSV ファイルを選択して【取り込む】。
※ テンプレートをそのままご利用される場合、1 行目は説明行のため、データが始まる 2 行目から取り込む必要があります。ヘッダー行指定で「2」と入力してください
※【データシンク＞媒体データインポート】のアカウント追加からも同様に作成が可能です
注意点
- 媒体データインポートでは、広告のID、または名称でデータを識別します。(IDがある場合はIDで識別、名称のみの場合は名称で識別します。)
- 取り込んだ広告データの削除は出来ません。広告の名称・IDはお間違いないようご注意ください。
※クリエイティブやテキストといった入稿内容・結果の数値は上書きする事が出来ます。 - 以下の動作では、媒体データインポートは別の広告データとみなし、データが重複します。アップロード情報は予め統一してご利用ください。
- 同じ期間のデータを別の広告レベルでインポートする。
- 広告情報を名称のみ(キャンペーン名のみ、広告名のみなど)でアップロードした後に、同じ広告にID情報を付与してアップロードする。
- 詳細レポート(キーワード別、時間帯別、性別、年齢別、プレースメント別、都道府県別、デバイス別、その他)のデータをインポートした場合、反映されるのは該当の詳細レポートのみとなります。ダッシュボードやメディアマネージャへは反映されません。
アップロードした数値が Roboma に正常に反映されない場合は、こちらのヘルプをご確認ください。
媒体データインポートでアップロードした数値が上手く反映されない
対応レポートとファイルの仕様
媒体データインポートで取り込める CSV の項目は以下をご参照ください。
ファイルフォーマット
- CSV 形式 (区切り文字は
,のみ) - 文字エンコーディングは UTF-8 (BOM あり/なし), Shift-JIS
対応レポート
以下のレポートの取り込みが可能です。
- クリエイティブレポート (ダッシュボード、メディアマネージャにも反映)
- キーワード別レポート
- 時間帯別レポート
- 性別レポート
- 年齢別レポート
- プレースメント別レポート
- 都道府県別レポート
- デバイス別レポート
- その他レポート
※アセット別レポートには対応しておりません。
各レポートの必要項目について
インポートするCSVでは、特定の1行にデータ内容を判別するカラム名（列名）が必要です。
取り込みたいレポートの種類によって、必要なカラム名は異なります。
以下で取り込めるデータのカラム名を紹介します。
【注意点】
- カラム名は項目ごとにあらかじめ決まっています。(コンバージョンを除く)
例えばインプレッションの列はImpressionsというカラム名で判断しており、「Imps」など別の名称になっていた場合、インプレッションとして取り込むことが出来ません。 - 取り込みたいレポートの種類によって、必須のカラムと任意のカラムがあります。テンプレートの1行目に各カラムが必須か任意かの記載がありますので、ご確認ください。
- 広告情報に関するカラムがない場合は、アカウントレベルでのデータ取り込みになります。
クリエイティブレポートで利用可能なカラム
クリエイティブレポートでは、アカウント単位、キャンペーン単位、広告グループ単位、広告単位のいずれかのレベルで取り込む事が出来ます。
取り込みたい媒体の階層に合わせて選択してください。
階層によって必要なカラムが変わるため、以下に紹介します。
アカウント単位で取り込む場合
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ○ |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
キャンペーン単位で取り込む場合
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ○ |
Campaign ID |
キャンペーン ID | ◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
広告グループ単位で取り込む場合
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
※2：広告グループID もしくは広告グループ名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | ◯※2 |
Group Name |
広告グループ名 | ◯※2 |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
広告単位で取り込む場合
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
※2：広告グループID もしくは広告グループ名のどちらかは必須になります。
※3：広告ID もしくは広告名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | ◯※2 |
Group Name |
広告グループ名 | ◯※2 |
Ad ID |
広告 ID | ◯※3 |
Ad Name |
広告名 | ◯※3 |
Image URL |
画像 URL | |
Video URL |
動画 URL | |
Title |
テキスト1 | |
Text 1 |
テキスト2 | |
Text 2 |
テキスト3 | |
Call To Action |
CTA アクション | |
Link URL |
リンク URL | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
詳細レポートで利用可能なカラム
詳細レポートでは、レポート種類によって以下のカラムを指定する事が出来ます。
キーワードレポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キーワードID もしくはキーワードテキストのどちらかは必須になります。
※2：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
※3：広告グループID もしくは広告グループ名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Keyword ID |
キーワード ID | ◯※1 |
Keyword |
キーワード | ◯※1 |
Keyword Match Type |
キーワードのマッチタイプ | |
Campaign ID |
キャンペーン ID |
◯※2 |
Campaign Name |
キャンペーン名 | ◯※2 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | ◯※3 |
Group Name |
広告グループ名 | ◯※3 |
Impression Share |
インプレッションシェア | |
Exact Match Impression Share |
完全一致のインプレッションシェア | |
Absolute Top Impression Percentage |
インプレッションにおけるページ最上部の割合 | |
Top Impression Percentage |
インプレッションにおけるページ上部の割合 | |
Average Position |
平均掲載順位 (旧) | |
Quality Score |
品質スコア | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
時間帯別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 | 補足 |
|---|---|---|---|
Date |
日付 | ◯ | |
Hour |
時間 | ○ | 0 〜 23 の範囲で指定 |
Campaign ID |
キャンペーン ID |
◯※1 |
|
Campaign Name |
キャンペーン名 | ◯※1 | |
Campaign Objective |
キャンペーン目的 | ||
|
|
広告グループ ID | ||
Group Name |
広告グループ名 | ||
Ad ID |
広告 ID | ||
Ad Name |
広告名 | ||
Cost |
消費金額 | ||
Impressions |
インプレッション | ||
Clicks |
クリック数 |
性別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 | 補足 |
|---|---|---|---|
Date |
日付 | ◯ | |
Gender |
性別 | ○ | male, female, unknown のいずれかを指定 |
Campaign ID |
キャンペーンID |
◯※1 |
|
Campaign Name |
キャンペーン名 | ◯※1 | |
Campaign Objective |
キャンペーン目的 |
||
|
|
広告グループID | ||
Group Name |
広告グループ名 | ||
Ad ID |
広告ID | ||
Ad Name |
広告名 | ||
Cost |
消費金額 | ||
Impressions |
インプレッション | ||
Clicks |
クリック数 |
年齢別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Age |
年齢 | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | |
Group Name |
広告グループ名 | |
Ad ID |
広告 ID | |
Ad Name |
広告名 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
プレースメント別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Platform |
ネットワーク | ○ |
Delivery Side |
配信面 | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | |
Group Name |
広告グループ名 | |
Ad ID |
広告 ID | |
Ad Name |
広告名 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
都道府県別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Country |
国 | ○ |
Prefecture |
都道府県 | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | |
Group Name |
広告グループ名 | |
Ad ID |
広告 ID | |
Ad Name |
広告名 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
デバイス別レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Device Category |
デバイス種別 | ○ |
Device |
デバイス/OS | ○ |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | |
Group Name |
広告グループ名 | |
Ad ID |
広告 ID | |
Ad Name |
広告名 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
その他レポート
以下のカラム名を利用できます。必須に◯があるカラムはデータが必須の内容となります。
※1：キャンペーンID もしくはキャンペーン名のどちらかは必須になります。
| カラム名 | 内容 | 必須 |
|---|---|---|
Date |
日付 | ◯ |
Report Type |
レポート種別 | ○ |
Category 1 |
カテゴリ 1 | ○ |
Category 2 |
カテゴリ 2 | |
Campaign ID |
キャンペーン ID |
◯※1 |
Campaign Name |
キャンペーン名 | ◯※1 |
Campaign Objective |
キャンペーン目的 | |
|
|
広告グループ ID | |
Group Name |
広告グループ名 | |
Ad ID |
広告 ID | |
Ad Name |
広告名 | |
Cost |
消費金額 | |
Impressions |
インプレッション | |
Clicks |
クリック数 |
コンバージョンの指標カラム
上記のカラム名以外のカラムは、すべて「コンバージョンイベント」として取り込まれ、コンバージョン設定で選択することが出来ます。