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はプレースホルダにすぎません。残念ながら、このレポートでは表示できません。