メインコンテンツまでスキップ

SolarEngine統合プラン

最終更新 2026/10/03
ヒント

サードパーティデータ統合によって生成されたデータは、クラスターの消費データ量に含まれますのでご注意ください

概要​

インターフェースの概要​

インターフェース名タイプ粒度アトリビューションコスト収益表示クリックコンバージョン
リアルタイムAPIコールバックユーザーレベル✅✅

SolarEngineのデータの統合を始める前に、AEシステムのユーザー識別ルールを読み、AEが#distinct_idと#account_idによってユーザーを識別する仕組みを理解しておいてください

SolarEngineはリアルタイムAPIエクスポート機能を提供しており、アクティベーションなどのイベントデータをリアルタイムでコールバックできます。詳しくはSolarEngine公式サイトのドキュメントを参照してください

統合の流れ​

  1. SolarEngine SDKとAE SDKを導入し、SolarEngine SDKの共通イベントプロパティ設定インターフェースを使ってAE SDKのゲストIDを渡します
  2. AE管理画面にログインし、サードパーティ統合モジュールでSolarEngine統合を追加して、関連する設定を完了し、コールバックURLをコピーします
  3. SolarEngineの管理画面にログインし、データのコールバック設定を完了します
  4. AEシステムがデータを正常に受信しているかを確認し、レポートを作成します

1. クライアントSDKの設定​

1.1 SolarEngine SDKとAE SDKの導入​

まず、アプリにSolarEngine SDKとAE SDKを導入し、初期化の設定を完了する必要があります。SolarEngine SDKとAE SDKの統合ドキュメントは以下のとおりです:

1.2 SDKの設定​

SDKを導入したら、次にAE SDKのゲストIDとアカウントIDをSolarEngine SDKに設定します。SolarEngineの共通イベントプロパティの設定インターフェースを使う方法をお勧めします

順序に注意してください:

  1. AE SDKの初期化を完了する
  2. AE SDKのゲストIDを取得する
  3. SolarEngineの共通プロパティ設定インターフェースを呼び出し、AE SDKのゲストIDをSolarEngine SDKの共通プロパティとして設定する
  4. SolarEngine SDKを初期化する
  5. AE SDKのアカウントIDを取得できるようになったら(アカウントへのログイン時やキャラクターのログイン時)、AE SDKのloginインターフェースを呼び出し、再度SolarEngineの共通プロパティ設定インターフェースを呼び出して、アカウントIDをSolarEngine SDKの共通プロパティとして設定する

以下はAndroidのコード例です:

// AE SDK の初期化を完了する
TDAnalytics.init(context, APPID, SERVER_URL);

// AE SDK のゲスト ID を取得する
String te_distinct_id = TDAnalytics.getDistinctId();

// 共通イベントプロパティ設定インターフェースを使い、AE のゲスト ID を SolarEngine SDK の共通プロパティとして設定する
SolarEngineManager.getInstance().setSuperProperties(context, "te_distinct_id", te_distinct_id);

// SolarEngine SDK を初期化する
SolarEngineConfig config = new SolarEngineConfig.Builder().build();
SolarEngineManager.getInstance().initialize(context, "開発者が申請したappkey","開発者が申請したuserId",config);

// .....

// ユーザーのログイン後
// アカウント ID を取得する
String te_account_id = "login_id";

// TE SDK で login を呼び出す
TDAnalytics.login(te_account_id);

// 共通イベントプロパティ設定インターフェースを使い、AE のアカウント ID を SolarEngine SDK の共通プロパティとして設定する
SolarEngineManager.getInstance().setSuperProperties(context,"te_account_id", te_account_id);

2. プランの設定​

SDKの設定が完了したら、次にAEシステムの管理画面にログインし、「サードパーティ統合」モジュールでSolarEngineの設定を完了します。下図はSolarEngineの設定画面です:

2.1 ユーザー識別フィールド​

SolarEngineがコールバックするのはユーザーレベルのデータであるため、ユーザー識別ルールを設定する必要があります。AEシステムはこの設定に基づき、コールバックデータを変換する際に、これらのフィールドをデータのユーザー識別フィールドとして設定します。

本ドキュメントの前のステップに従ってクライアントSDKを設定した場合は、次の設定を使用してください:

  • アカウントIDの関連フィールド:event_custom_params.te_account_id
  • ゲストIDの関連フィールド:event_custom_params.te_distinct_id

2.2 イベントデータの格納設定​

「イベントデータの格納設定」スイッチをオンにすると、コールバックされたデータ(アクティベーションイベントとアプリ内イベントを含む)はすべてイベントテーブルに書き込まれます

イベントデータの格納を有効にすることをお勧めします。ただし、デフォルトではSolarEngineからコールバックされるすべてのデータを受信する点に注意してください。コールバックするイベントの種類が多すぎると、AEプロジェクトのイベント量が過度に膨らみます。そのため、SolarEngineプラットフォームでコールバックを設定する際は、必要なイベントだけを選んでコールバックすることをお勧めします。

2.3 ユーザープロパティの格納設定​

デフォルトでは、AEシステムはSolarEngineのコールバックデータに含まれるアトリビューションフィールドを、標準化処理後のユーザープロパティに自動的に書き込みます。ユーザープロパティに書き込まれるフィールドとその意味は以下のとおりです:

SolarEngineのフィールド標準化フィールド説明
channel_namete_ads_object.media_sourceメディアチャンネル
adplan_namete_ads_object.campaign_name広告キャンペーン名
adgroup_namete_ads_object.ad_group_name広告グループ名
adcreative_namete_ads_object.ad_name広告名

変更が必要な場合は、「設定ルール」をクリックして、下図のような格納ルールの設定ページに移動します

ここでは、ユーザープロパティの取得元イベントを変更できます。ユーザープロパティが頻繁に書き込まれないようにしたい場合は、「すべてのイベントを含む」をオフにして、ソースイベント名をinstallに変更します。このように設定すると、AEシステムはSolarEngineからコールバックされたinstallイベントからのみ、ユーザープロパティに書き込むフィールドを抽出して書き込みます。格納の方法はデフォルトでuser_setOnceで、最初に送信された情報のみが保持されます。

ユーザープロパティの格納を無効にしたい場合は、すべてのルールを停止します:

2.4 統合構成​

最後に、統合構成モジュールでデータ取得の詳細な設定を制御できます。格納後のイベント名などが含まれます。

統合構成の内容はJSONです。次の内容に従ってカスタム設定できます:

モジュール名前意味
sink_eventevent_mapping格納後のイベント名。カスタマイズできます。KeyはSolarEngineのイベント名、Valueは格納後のイベント名です。デフォルトはアクティベーションイベント:installです

2.5 ターミナルアドレス​

ターミナルアドレスには、AEシステムがSolarEngineのコールバックデータを受信するアドレスが表示されます。

ターミナルアドレスにはAPPのコールバック用パラメータが含まれています。ミニアプリ/ミニゲームのデータをコールバックする場合は、ミニアプリ/ミニゲームのコールバックパラメータの節を参照してください

このアドレスをそのままコピーし、この後のコールバック設定で入力してください:

ここにアドレスが表示されない場合は、右上のメニュー「プロジェクト管理 → プロジェクト設定 → プロジェクト構成」でパブリックネットワークURLを設定してください。このアドレスは、AE SDKで設定するデータ受信URLです。設定後、SolarEngineの設定ページの「ターミナルアドレス」に戻ってターミナルアドレスをコピーしてください。

3. SolarEngineでのコールバック設定​

3.1 SolarEngine管理画面のリアルタイムAPIデータエクスポートページでコールバックリンクを設定する​

AE管理画面でプランを作成したら、SolarEngineの管理画面にログインし、データをコールバックするプロジェクトを選択して、「アトリビューション」モジュールから「アプリ設定」-「エクスポート」-「リアルタイムAPIエクスポート」を選択すると、SolarEngineのリアルタイムコールバックを設定できます

以下のルールに従って入力してください:

  • コールバックタイプは「アクティベーション」を選択します
  • コールバックURLには、AE管理画面で取得したコールバックURLを入力します
  • コールバックURLの解析は、3.2章の内容に従って入力することをお勧めします
  • コールバック方式はPOSTを選択します
  • タイムアウト時間とリトライ回数は必要に応じて変更できます。特に要件がなければデフォルト値を使用できます

設定が完了したら、送信をクリックします

3.2 SolarEngineのコールバックパラメータ​

以下は、SolarEngineのコールバックで設定できるパラメータです。設定時は、入力するパラメータ名を選択した値と一致させることをお勧めします。推奨するすべてのコールバックフィールドは下表で確認できます。event_name、event_time、event_custom_paramsフィールドは必ずコールバックしてください。そうしないとデータの変換に失敗する可能性があります

3.2.1 Appのコールバックパラメータ​

パラメータ名デフォルトで使用値(例)説明
event_typeはい列挙値:
preset、custom
プリセットイベントかどうか
event_nameはいイベント名:install、startup、etc...イベント名
attribution_timeはい2023/7/1 22:47アトリビューション時刻
attribution_touch_typeはいclickアトリビューションのタッチポイントタイプ
attribution_methodはい列挙値:
deviceid
fingerprint
アトリビューション方法
attribution_lbw86400アトリビューションのタイムウィンドウ
attribution_ttit68アトリビューションの時間差
channel_nameはいMintegralアトリビューションされたチャネル名
app_nameはいCat EscapeInfinityAPP名
appkeyはいappkey
app_platformはいiosappのプラットフォーム
landing_page_urlhttps://apps.apple.com/us/app/cat-escape-infinity/id6445884698appのランディングページURL
turl_idEv2Evyaトラッキングリンクの短縮リンクID
turl_stringトラッキングリンクの短縮リンク
turl_campaign_idはい7b35b6bd982780f729fcf4ff925b9c4eトラッキングリンクの一意なID
turl_campaign_nameはいかくれんぼエンドレス版-IOSトラッキングリンク名
channel_idはい8221トラッキングリンクに対応するチャネルID
ry_touchpoint_tsはい1688222783854インプレッション・クリック時刻
attribution_typeはいuaアトリビューションタイプ(UA新規獲得で固定)
account_idはい配信アカウントID
adgroup_idはい配信プラットフォームの広告グループID
adgroup_nameはいCatEscapeInfinity_CN_FO_0404_WX_iOS_MTG_1配信プラットフォームの広告グループ名
adplan_idはいss_Duomm_CN_FO_0404_WX_iOS_MTG_1配信プラットフォームの広告キャンペーンID
adplan_nameはい配信プラットフォームの広告キャンペーン名
adcreative_idはい1804913040配信プラットフォームの広告素材ID
adcreative_nameはいwadmm_21186_0_V_1203_mtg_nndb_cn_1024x768_cy.mp4配信プラットフォームの広告素材名
adcreative_typeはい配信プラットフォームの広告素材タイプ
site_idはいmtg1183741824配信プラットフォームのサブチャネルID
site_nameはい配信プラットフォームのサブチャネル名
ad_typeはい配信プラットフォームの広告タイプ
placement_idはい配信プラットフォームの広告枠ID
conversion_id配信プラットフォームがコンバージョンを受信する一意なID
click_idmtg64a03bfe52979a0001a8cb4y配信プラットフォームのクリックの一意なID
impression_id配信プラットフォームの表示の一意なID
request_id7434D04B787321D534C7268DD8D4D52E配信プラットフォームのリクエストの一意なID
callback_id配信プラットフォームのコールバックの一意なID
callback_url配信プラットフォームのコールバックURL
custom_params_1配信プラットフォームのカスタムパラメータデータ1-10
custom_params_2配信プラットフォームのカスタムパラメータデータ1-10
custom_params_3配信プラットフォームのカスタムパラメータデータ1-10
custom_params_4配信プラットフォームのカスタムパラメータデータ1-10
custom_params_5配信プラットフォームのカスタムパラメータデータ1-10
custom_params_6配信プラットフォームのカスタムパラメータデータ1-10
custom_params_7配信プラットフォームのカスタムパラメータデータ1-10
custom_params_8配信プラットフォームのカスタムパラメータデータ1-10
custom_params_9配信プラットフォームのカスタムパラメータデータ1-10
custom_params_10配信プラットフォームのカスタムパラメータデータ1-10
device_idはいB9BBB98D-FFEE-448D-A9BE-52883FF230FDアトリビューションされたデバイスの一意なID
device_id_typeはいdistinct_iddistinct_id
device_id_md5_typedistinct_id_md5distinct_id_md5
device_id_md555a6187afabbe2ed4c6e9bc0fdca423dアトリビューションされたデバイスの一意なIDのmd5
gaidgaid
gaid_md5gaid_md5
imei1imei1
imei1_md5imei1_md5
imei2imei2
imei2_md5imei2_md5
oaidoaid
oaid_md5oaid_md5
macmac
mac_md5mac_md5
android_idandroid_id
android_id_md5android_id_md5
idfa49BB9C2F-E0DB-46B8-9C68-21C4C7FB30CCidfa
idfa_md51225a829ea48f2fc62a2d3faee263829idfa_md5
idfvB9BBB98D-FFEE-448D-A9BE-52883FF230FDidfv
idfv_md555a6187afabbe2ed4c6e9bc0fdca423didfv_md5
ipv4110.154.208.22ipv4
ipv6ipv6
uaはいMozilla/5.0 (iPad; CPU OS 14_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148ua
manufacturerはいappleブランド
modelはいiPad11,6機種
osはい列挙値
1:Android
2:ios
システム
os_versionはい14.2バージョン
ua_device_typeiPaduaから解析したデバイスタイプ
ua_osIOSuaから解析したシステム
ua_osv14.2uaから解析したos version
languageはいzh-Hans-CN言語
countryはいCN国
cityはい都市
att_status列挙値:
denied、restricted、authorized、unknown、空
lat_status列挙値:
enable、disable、unknown、空
network_typeはい列挙値:
0:ネットワークなし
1:unknown
2:2G
3:3G
4:4G
5:5G
6:6Gまたは次世代ネットワーク
9:WIFI
データアップロード時のネットワーク状態
carrierはい通信キャリア
install_time1688222848242アクティベーション時刻
event_timeはい1689781058000サーバーがイベントを受信した時刻
channel_package_namedefaultチャネルパッケージ名
app_versionはい1.0.2アプリバージョン
bundleidはいjp.os.catescapeapp bundle id
event_dataはい
collector_version1.1.8.0sdkバージョン
integration_type列挙値:
sdk
api
s2s
連携方式
event_custom_paramsはい顧客のカスタムイベントプロパティの内容
caidイベントのcaid値
caid_md5イベントのcaidのmd5値
event_account_idイベントのaccount_id

3.2.2 ミニアプリ/ミニゲームのコールバックパラメータ​

統合するのがミニアプリまたはミニゲームの場合は、以下のコールバックURLを使用してください。{receiver-host}はデータ受信URLに、以下の{app-id}はプロジェクトのAPP IDに置き換えてください:

https://{receiver-host}/attribution/callback/solarengine/{app-id}?appkey=appkey&app_name=app_name&app_platform=app_platform&app_type=app_type&event_name=event_name&country=country&current_event_time=current_event_time&channel_name=channel_name&os=os&os_version=os_version&brand=brand&model=model&ua=ua&user_id=user_id&account_id=account_id&adgroup_id=adgroup_id&adgroup_name=adgroup_name&adplan_id=adplan_id&adplan_name=adplan_name&adcreative_id=adcreative_id&adcreative_name=adcreative_name&adcreative_type=adcreative_type&scene_id=scene_id&custom_params=custom_params&ad_platform=ad_platform&ad_type=ad_type&ad_appid=ad_appid&ad_id=ad_id&mediation_platform=mediation_platform&ad_ecpm=ad_ecpm&order_id=order_id&order_amount=order_amount&currency_type=currency_type&purchase_type=purchase_type&product_id=product_id&product_name=product_name&product_num=product_num&register_type=register_type&login_type=login_type

ミニアプリ/ミニゲーム共通イベントのフィールド説明:

フィールド名推奨値(例)説明
appkeyはい9b716df699b77694SE管理画面で作成したアプリの一意な識別子
app_nameはいアプリ名アプリ名
app_platformはいminiprogramOS:miniprogramまたはminigame
app_typeはいwechatプラットフォームタイプ:wechat、douyin
event_nameはいstartupイベント名。install(アクティベーション)、startup(起動)、register(登録)、login(ログイン)、order(注文)、purchase(課金)、adimpression(広告表示)...のいずれかに固定
countryはいCHN国
install_time1637823377000インストール時刻
current_event_timeはい1637823377000現在のイベントの発生時刻
report_time1637823377000サーバーが受信した時刻
integration_typesdk統合方式。sdkに固定
collector_version1.8.0コレクターのバージョン
attribution_methodpathアトリビューション方式:パスアトリビューション(path)、クリックアトリビューション(click)
channel_id8221チャネルID
channel_nameはいtiktokチャンネル名
turl_campaign_id871bbfa4560283c5a0ca00483c529c63トラッキングリンクID
turl_campaign_nameトラッキングリンク名_Mintegralトラッキングリンク名
openidoUFfk5coGBwScTmIsr008qL93ANk現在のミニアプリ内でのユーザーの一意なID
anonymous_openidDouyin専用。現在のミニプログラム内での匿名ユーザーの一意なID
unionidf7510d9ab***********同一開発者配下の異なるミニアプリ間で共通のユーザーの一意なID
device_idoUFfk5UyO--kSbPVEuC5zWtqYvbsデバイスID
device_id_typeopenidデバイスIDのタイプ
container_nametoutiaoホストAPP名(Douyin専用)
osはいandroidホストAppのOSプラットフォーム
os_versionはい10ホストAppのOSバージョン
brandはいHUAWEIホストAppのデバイスメーカー
modelはいMate 40ホストAppのデバイスモデル
languagezh-hanホストAppのデバイス言語
ipv41.1.1.1ユーザーのパブリックIP(v4)
uaはいMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/95.0.4638.54 Safari/537.36UA
user_idはいアカウントID(ユーザーID)
account_idはい広告アカウントID
adgroup_idはい広告グループID
adgroup_nameはい広告グループ名
adplan_idはい広告キャンペーンID
adplan_nameはい広告キャンペーン名
adcreative_idはい広告クリエイティブID
adcreative_nameはい広告クリエイティブ名
adcreative_typeはいクリエイティブタイプ(大画像、小画像、動画など)
material_1素材ID_1
material_2素材ID_2
material_3素材ID_3
material_4素材ID_4
material_5素材ID_5
material_6素材ID_6
click_id広告クリックID
impression_id広告表示ID
request_id広告リクエストID
callback_idチャネルのコールバックID
callback_urlチャネルのコールバックURL
site_idトラフィックメディアID(Ocean EngineのToutiao、Pangle、Douyinなど)。
site_nameトラフィックメディア名(Ocean EngineのToutiao、Pangle、Douyinなど)。
scene_idはい1シーン値
pathindex/xxxミニアプリの起動ページのパス
query_info{ "channel_id": "234234",
"turl_id": "234234", ...}
ミニアプリプラットフォームから取得したquery情報。SEが付加するパラメータ+チャネルが追加するパラメータ
custom_paramsはい{ "add_cart": "234234", //カスタムパラメータ。 "sku": "234234", "level_up": "234234" ... }/イベントのカスタムパラメータのネスト。含まれるパラメータは最大10個です。

ミニアプリ/ミニゲームの一部のイベント専用のフィールド説明:

イベントフィールド名推奨説明
adimpressionad_platformはい収益化プラットフォーム
ad_typeはい表示した広告のタイプ
ad_appidはい収益化プラットフォームのアプリID
ad_idはい収益化プラットフォームの収益化広告枠ID
mediation_platformはいメディエーションプラットフォームの識別子。メディエーションプラットフォームの識別子がない場合は "custom" に設定してください
ad_ecpmはい広告のECPM(広告1,000回表示あたりの収益。0または負の値は未送信を表します)。単位:元
is_rendered広告のレンダリングに成功したかどうか。列挙値は以下のとおりです:
YES:成功
NO:失敗
この指標を集計する必要がない場合は、YESを渡してください
adclickad_platformはい収益化プラットフォーム
ad_typeはい表示した広告のタイプ
ad_idはい収益化プラットフォームの収益化広告枠ID
mediation_platformはいメディエーションプラットフォームの識別子。メディエーションプラットフォームの識別子がない場合は "custom" に設定してください
purchaseorder_idはい注文ID
order_amountはい今回の購入で支払った金額
currency_typeはい支払いの通貨の種類。『ISO 4217国際規格』に準拠します(例:CNY、USD)
purchase_typeはい支払い方法:alipay、weixin、applepay、paypalなど
product_idはい購入した商品のID
product_nameはい商品名
product_numはい購入した商品の数量
orderorder_idはい注文ID
order_amountはい注文金額。単位:元
currency_typeはい表示収益の通貨の種類。『ISO 4217国際規格』に準拠します(例:CNY、USD)
purchase_typeはい支払い方法:alipay、weixin、applepay、paypalなど
registerregister_typeはい登録タイプ。"WeChat"、"QQ"などのカスタム値
loginlogin_typeはいログインタイプ。"WeChat"、"QQ"などのカスタム値

4. データの格納​

4.1 データの格納ルール​

デフォルトでは、以下のルールに従って、取得したデータをイベントとしてAEプロジェクトに書き込みます:

  • データ内のevent_timeフィールドを、イベントのデータ時間#event_timeとして使用します
  • データ内のevent_nameをデータのイベント名として使用します
  • その他のフィールドはすべて格納されます

4.2 標準化フィールド​

元フィールド標準化フィールド意味
account_idte_ads_object.ad_account_id広告アカウントID
adplan_namete_ads_object.campaign_name広告キャンペーン名
adplan_idte_ads_object.campaign_id広告キャンペーンID
adgroup_namete_ads_object.ad_group_name広告グループ名、マネタイズ広告のUnit名
adgroup_idte_ads_object.ad_group_id広告グループID、マネタイズ広告のUnit ID
adcreative_namete_ads_object.ad_name広告名
adcreative_idte_ads_object.ad_id広告ID
placement_idte_ads_object.placement広告の配置
channel_namete_ads_object.media_sourceメディアチャンネルまたはマネタイズチャンネル
bundleidte_ads_object.app_idアプリID
app_namete_ads_object.app_nameアプリ名
app_platformte_ads_object.platformプラットフォーム(Android、iOSなど)
countryte_ads_object.country国・地域コード
このページは役に立ちましたか?