Remergeイベント計測APIは、クライアントやパートナーに提供される、幅広いタイプのデータをRemerge に転送するツールです。当該クライアント/パートナーは、各自のアプリ内イベント、アトリビューション、BI、または SKAdNetworkデータをRemergeに提供します。次のドキュメントは、 Remergeイベント計測APIへのアプリ内イベントデータの転送に関するインサイトを提供します。ご不明な点がありましたら、担当のRemergeアカウントマネージャーまでお問い合わせください。
プロセス
リクエスト
GET
応答
HTTP 204 (デフォルト設定)。Remergeアカウントマネージャーに連絡して、リクエストが成功するように確認してください。
エンドポイント
プロトコル
HTTPS
頻度
一般
- すべてのアプリ内イベントをリアルタイムで転送します。
App Open
- App Openイベントを 10 分ごとに転送します。
パラメーター
- 適切な計測を行うために、すべての必須 (M)パラメーターを指定します。
- （オプション）パラメーターを追加して、リターゲティングとレポートを改善します。
-
ウェブセーフではない文字を含むパラメーターを適切にエンコードします。
| パラメータ名 | 内容 | 例 |
|---|---|---|
| app_id (M) | Google Play ストア/iTunes (IDの番号のみ) | 553834731, com.king.candycrush |
| event (M) |
アプリ内イベント名は、その性質/CTA（例：アプリ内オープン、アプリ内購入）を反映したものにする必要があります。また、 最初のアプリオープン（first_app_open）イベント（新規ユーザーに代わり）を インストール（install）イベントと名付けるようにしてください。 |
purchase、add_to_basket、level_2_reached |
| データ | イベントに関する追加データ。JSON形式と二重引用符を必ず実装してください。単一の文字列も許容されます。 | {"store":1341, "keywords":["yellow","red"]} |
| ts | イベントタイムスタンプはUnix Epoch。タイムゾーンは UTCで10桁。 | 1427976389 |
| partner (M) | パートナーパートナー名 | supergame |
| key (M) | パートナーのキー（Remerge提供） | x34dlx |
| idfa (M) |
Apple IDFA（すべての文字が大文字であることを確認してください） |
AEBE52E7-03EE-455A-B3C4-E57283966239 |
| aaid（M） |
Android広告ID（すべての文字が小文字であることを確認してください） |
38400000-8cf0-11bd-b23e-10b96e40000d |
| country | ISO alpha 2 国コード | de |
| device_name | デバイス名 | 例：iPhone11、iPhone7、iPhone XR、Galaxya51、Galaxya50 |
|
os_name |
OS名 | android, ios |
| os_version | OSバージョン | 8.0.1 |
| app_version | アプリバージョン | 1.2 |
| user | カスタマーユーザーID | 4838131 |
| 収益 | マイクロ通貨単位での収益（サブペニー単位を有効にし、浮動小数の問題を防ぎます） | revenue=170000 (=0.17), 5750000 (=5.75$) |
| (revenue_float) | 価格に小数点以下の数値や小数点以下の区切り文字が含まれていない場合 | revenue_float=0.17 または 5.75 |
| currency | ISO 4217 通貨コード | USD |
| non_app_event | イベントがアプリによって作成されていない場合 (クリックポストバック) - true または false | false |
|
idfv (M) |
iOS のみに適用される、ユーザーの IDFV (ベンダー ID) |
E29738C9-0556-4F49-AB98-1A33197F0FFD |
|
operator |
携帯電話会社 / デバイス回線業者 |
MTS%20RUS、TELCEL、Telenor AT%26T、Iliad、Viettel、LGU%2B |
|
zipcode |
地域の郵便番号 |
15414, 500064, 517504, 115088 |
|
city |
都市名。標準化のためにUN/LOCODEを使用。 |
Yokohama、Yocsina、Bogota |
|
country_subdivision |
州名 |
CA、PB、Sindh、Istanbul |
|
partner_device_id |
ユーザー用のID |
|
|
ip |
IP アドレス (ip4、ip6?) |
178.151.153.17 |
|
language |
ユーザー言語（簡略/拡張） |
簡略：en、ja、bg 拡張：pl-SE、ru_RU |
|
sdk |
クライアントによって実装されたSDKバージョン |
2.2 |
データパラメータ
データパラメータは、JSON形式で独自のキーと値のペアを保持でき、イベント自体の一部としてユーザーのアクションに関する追加のメタデータを提供するために使用されます。たとえば、電子商取引では、このパラメーターを使用して製品関連情報（製品ID、価格、数量など）を転送し、プロダクトフィードからカスタマイズされたバナーで追加の関連製品を表示および識別します。
構造
- JSONデータ構造は次のようになります。
data= {"product_id":"sdf235235dfw3131","cv_type":0}
フォーマット
- URLエンコードされたJSONオブジェクトを Remerge に転送：
data=%7B%22product_id%22%3A%22sdf235235dfw3131%22%2C%22cv_type%22%3A0%7D%20
- 文字列が二重引用符付き （JSON仕様では、https://www.json.org/json-en.html）であることを確認する。
- マルチプロダクトIDを当社に提供するためには、次のようにしてください。
data={"products":["23ef23","234fe2d","23dw334"]}とエンコードされた：
data= %7B%22products%22%3A%5B% 2223ef23%22%2C%22234fe2d%22%2C%2223dw334%22%5D%7D%C2%A0
例
-
プレースホルダーの例 ({PLACEHOLDER}には内部用のプレースホルダー名を含める必要があります):
https://remerge.events/event?app_id={AppId}&event={EventName}&partner=yourname&key=yourkey&idfa={IDFA}&aaid={AAID}&country={Country}&device_name={DeviceName}&os_name={OS}&os_version={OSVersion}&ts={Timestamp}&revenue={RevenueAmount}¤cy={Currency}&non_app_event=false