Remergeはアプリのリターゲティングプラットフォームです。ダッシュボードと分析機能に加えて、RemergeレポーティングAPIからアクティブなキャンペーンのJSONベースのレポートを日次で社内BIツールに引き出すことが可能です。
ご注意ください：
-
Remerge Reporting API にアクセスできるのは、以下に示すように、Terminal（またはAPIクライアント）のみです。
- Terminalを経由するにはデータ転送ツールCurlを使用し、サインインリクエスト（認証情報は担当のRemergeアカウントマネージャーからお送り致します）および以下の投稿リクエスト例のようにする必要があります。
- また、クライアントは独自の内部APIおよびデータ転送ツールを採用することもできます。
- Reporting APIはWebブラウザからはアクセスできません 。
クライアントのパフォーマンスは、5つのディメンションに分類されます。 タイムスタンプ、国、アプリ、キャンペーン および 関連広告です。そのため、結果を簡単にインポートしたり、細かく分割したり、提供されたディメンションに沿ってクライアントが選択したBIプラットフォームと連携する事ができます。特定のパラメータやフィールドの詳細については、以下の注釈のセクションをご参照ください。
エンドポイント
APIは以下のエンドポイントからアクセスできます：
https://api.remerge.io/reportリクエストパラメータ
RemergeレポーティングAPIはデータクエリのシンプルなインターフェイスを提供します。必要なパラメータは、開始日と終了日だけです。
| パラメータ名 | 内容 | 例 | 必須 |
|---|---|---|---|
| *start_date | レポート開始日（YYYY-MM-DD） | 2017-01-09 | x |
| *end_date | レポート終了日（YYYY-MM-DD） | 2017-01-10 | x |
| dimensions |
コンマで区切られたディメンションのリストで、デフォルトでは集計をオーディエンス、国、キャンペーン、および広告に分割します（指定がない場合）。可能なディメンション：オーディエンス、国、キャンペーン、広告、広告ラベル、およびプラットフォーム。 |
国、プラットフォーム |
有効なリクエストは次でご確認ください。https://api.remerge.io/report?start_date=2017-01-10&end_date=2017-01-11&dimensions=campaign,ad
注意：
- クエリ内のすべてのシンボルが正しく端末に転送されるように、テキスト編集プログラム（SublimeやAtomなど）を使用することをお勧めします。
- リクエストURLでディメンションを制限しない限り、レスポンスは可能性のあるすべてのディメンションを生成します。
認証
例
サインインリクエスト
curl -H 'Content-Type: application/json' -H 'Accept: application/json' -X POST
-d '{"user" : { "email" : "your@email.com","password": "password"}}' https://api.remerge.io/users/sign_in
必要なトークンをJSONで返す
{"email":"your@email.com","token":"J-QeJxyza7JH19QUDb4","user_id":1234,"user_name":"Peter Example","user_token":"J-QeJ49Yasdf219QUDb4"}
有効なレポーティングリクエストのための必須リクエストヘッダー
| パラメータ名 | 内容 | 例 | 必須 |
|---|---|---|---|
| Request Header | コンテンツタイプ | 'Content-Type: application/json' | x |
| Request Header | 許諾 | 'Accept: application/json' | x |
| Request Header | 認証トークン | 'Authorization: Token user_token="HJn4OYViZv", email="example@mydomain.com"' | x |
| Request Type | POST | POST | x |
リクエスト例
以下は、データ転送ツールcurl を使用した、RemergeレポーティングAPIへのPOSTリクエストの例です：
curl -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'Authorization: Token user_token="HJn4OYViZv", email="example@mydomain.com"'-X POST "https://api.remerge.io/report?start_date=2017-01-10&end_date=2017-01-11" -v
レスポンスフィールド
レスポンスは、結果の配列と要素数を含むJSONオブジェクトを返します。各配列要素は、次のフィールドで構成されます：
| パラメータ名 | 内容 | 例 | |
|---|---|---|---|
| timestamp | UTC（協定世界時）タイムスタンプ | 2017-01-11T00:00:00.000Z | |
| event.platform | プラットフォーム（iOS /Android） | ios | |
| event.country | RTB（リアルタイムビディング）地域別情報 | de | |
| event.campaign | 内部向けRemergeキャンペーンID | 42 | |
| event.campaign_name | 外部向けRemergeキャンペーン | Test Campaign | |
| **event.cost_currency | 内部向けRemergeキャンペーン通貨 | EUR | |
| ***event.audience | App Storeリファレンス | 12345678 | |
| event.ad_id | クリエイティブID | 1406561 | |
| event.ad_name | 画像/動画アセットのファイル名を指定します。 | banner_300_50.png | |
| event.ad_label_id | クリエイティブラベル ID | 18304 | |
| event.ad_label_name | クリエイティブラベル名 | non_purchasers_it | |
| ****event.ad_creative_url | クリエイティブURL | https://assets.remerge.io/ad_assets/files/000/006/696/original/banner_300_50.png?1478088208 | |
| event.impressions | アプリ.国.キャンペーンレベルのデイリーインプレッション数 | 2 | |
| event.clicks | アプリ.国.キャンペーンレベルのデイリークリックカウント | 1 | |
| event.app_open_rate | クリック数に対するアプリ起動率（%） | 83.57 | |
| event.cost | アプリ.国.キャンペーンレベルのお客様の通貨でのコスト | 0.12 | |
| event.conversions | アプリ.国.キャンペーンレベルのデイリーターゲットコンバージョンイベント数 | 1 | |
| event.ap_conversions | アプリ.国.キャンペーンレベルのデイリー属性別ターゲットコンバージョンイベント数 | 5 | |
| event.unique_user | アプリ.国.キャンペーンレベルのデイリーユニークユーザー数 | 2 |
JSONレスポンスの例（同じクエリにおける2つの表示オプション）
オプション1：
{results: [{"timestamp":"2017-01-11T00:00:00.000Z","event":{"impressions":2,"audience":"12345678","app_open_rate":1.0,"clicks":1,"ad":"test.jpg","user_id":2,"conversions":1,"campaign":"42","country":"de","cost":0.12,"campaign_name":"TestCampaign"}}],count:1}
オプション2：
指定された間隔にデータが存在しない場合、リクエストは空の結果配列とカウント：0を返します。
可能性のあるエラーリスト
| ステータス | メッセージ | 説明 |
|---|---|---|
| 200 | OK | JSONで返されたクエリ結果 |
| 401 | Unauthorized | 提供された認証トークンが無効 |
| 422 | start_date: Format YYYY-MM-DD required | 開始日の形式が不正 |
| 422 | end_date: Format YYYY-MM-DD required | 終了日の形式が不正 |
| 422 | start_date: must be a valid date | 実在しない日付、例：2015-33-09 |
| 422 | end_date: must be a valid date | 実在しない日付、例：2015-33-09 |
| 422 | end_date: end date must be greater or equal to the start date | 終了日が開始日よりも前 |
| 422 | queryID: queryId already exists | 送信したリクエストがAPIで処理中（1ユーザーあたりのクエリレート数制限は1です） |
| 504 | Gateway Timeout | リクエストのウェブサーバーの処理に時間がかかりすぎています。これは通常、クエリ間隔が広すぎることが原因です。この場合、最大14日間の間隔で再試行してください。 |
注釈
* APIタイムスタンプ ー start_date、end_dateともに、デフォルトではその日の午前0時00分に設定されています。つまり、例えば、ある日を正確にクエリしたい場合、その日をstart_date、次の日をend_dateとして使用することになります。必ず一度に1日分のデータだけをリクエストするようにしてください。（例えば、昨日のデータを毎日リクエストして、内部データベースに保存してください）
** キャンペーンごとに異なる通貨を使用している場合は、キャンペーンごとにレポートを分割してください。
*** Remergeでは、アプリケーション全体への参照としてAudience（オーディエンス）という用語を使用します。（文章によっては、Audienceがセグメントを示すこともあります）レポートを取得すると、RemergeレポーティングAPI は、Audienceと呼ばれるフィールドを返すことができます。これは単純に、そのレポートにアプリ全体の静的データが含まれていることを意味します。
**** ダイナミック広告の場合、実際のクリエイティブURLはフィードから動的に取得されるため、表示されるクリエイティブURLはプレースホルダにすぎません。残念ながら、このレポートでは表示できません。