SolarEngine SDK provides an interface to obtain attribution result information, which developers can use for event tracking and other processing.
The meaning of the code in the attribution callback is as follows:
Parameter Name | Parameter Meaning |
---|---|
code | Callback Status Codes: -Code 0: Indicates successful retrieval of attribution results. -Code non-0: Indicates failure to retrieve attribution results. Details for non-0 codes: -117: _appKey is invalid. -137: _packageType is invalid. -1001: Network error, SDK failed to connect to the server. -1002: The current startup request has exceeded 10 attempts without obtaining attribution results. -1003: The time since the last polling request for attribution results is less than 5 minutes; please try again after 5 minutes. -1004: The user has not obtained attribution results for more than 15 days; attribution results will no longer be requested during this installation. |
If the user participated in re-targeting attribution, the related information will be displayed under "re_data".
{
//New User Attribution Result
"account_id": "",
"ad_type": "",
"adcreative_id": "",
"adcreative_name": "",
"adcreative_type": "",
"adgroup_id": "",
"adgroup_name": "",
"adplan_id": "",
"adplan_name": "",
"attribution_time": "2023-08-31 11:16:35",
"attribution_touch_type": "",
"attribution_type": "",
"callback_id": "",
"channel_id": "-1",
"channel_name": "organic",
"click_id": "",
"conversion_id": "",
"custom_params_1": "",
"custom_params_10": "",
"custom_params_2": "",
"custom_params_3": "",
"custom_params_4": "",
"custom_params_5": "",
"custom_params_6": "",
"custom_params_7": "",
"custom_params_8": "",
"custom_params_9": "",
"impression_id": "",
"install_time": "2023-08-31 11:16:32",
"placement_id": "",
"report_time": "2023-08-31 11:16:34",
"request_id": "",
"ry_touchpoint_ts": "",
"site_id": "",
"site_name": "",
"turl_campaign_id": "",
"turl_campaign_name": "",
"turl_id": "",
"re_data": {
//Re-targeting Attribution Result
"account_id": "",
"ad_type": "",
"adcreative_id": "",
"adcreative_name": "",
"adcreative_type": "",
"adgroup_id": "",
"adgroup_name": "",
"adplan_id": "",
"adplan_name": "",
"attribution_time": "2023-08-31 11:16:35",
"attribution_touch_type": "",
"promotion_objectives": "",
"callback_id": "",
"channel_id": "-1",
"channel_name": "organic",
"click_id": "",
"conversion_id": "",
"custom_params_1": "",
"custom_params_10": "",
"custom_params_2": "",
"custom_params_3": "",
"custom_params_4": "",
"custom_params_5": "",
"custom_params_6": "",
"custom_params_7": "",
"custom_params_8": "",
"custom_params_9": "",
"impression_id": "",
"install_time": "2023-08-31 11:16:32",
"placement_id": "",
"report_time": "2023-08-31 11:16:34",
"request_id": "",
"ry_touchpoint_ts": "",
"site_id": "",
"site_name": "",
"turl_campaign_id": "",
"turl_campaign_name": "",
"turl_id": ""
}
}
Parameters Explanation
Parameter | Example | Description |
---|---|---|
attribution_touch_type | click,impression | Attribution touchpoint type |
ry_touchpoint_ts | Attribution display or click time (YYYY-MM-DD HH:MM:SS) | Attribution touchpoint time |
install_time | Device activation time (YYYY-MM-DD HH:MM:SS) | Activation time |
attribution_time | 2022/5/11 15:00:03 | Attribution time |
turl_campaign_id | 3e0a9bad8455d685eaaf91bad71bdeb2 | Tracking link ID |
turl_campaign_name | Mintegral_tracking | Tracking link name |
turl_id | UfeE7za | Short link ID |
channel_id | 1234 | Channel ID |
channel_name | mintegral | Attribution channel name |
attribution_type | ua | UA (indicates new user acquisition) |
account_id | , | Channel promotion account ID |
adgroup_id | , | Channel promotion ad group ID |
adgroup_name | , | Channel promotion ad group name |
adplan_id | , | Channel promotion plan ID |
adplan_name | , | Channel promotion plan name |
adcreative_id | , | Channel promotion creative ID |
adcreative_name | , | Channel promotion creative name |
adcreative_type | , | Channel promotion creative type |
site_id | , | Sub-channel ID |
site_name | , | Sub-channel name |
ad_type | , | Channel promotion ad type |
placement_id | , | Channel promotion ad placement ID |
conversion_id | , | Ad placement ID |
click_id | , | Channel promotion unique click ID |
impression_id | , | Channel promotion unique impression ID |
request_id | , | Ad request ID |
callback_id | EJiw267wvfQCGKf2g74ZIPD89-vIATAMOAFCIjIwMTkxM TI3MTQxMTEzMDEwMDI2MDc3MjE1MTUwNTczNTBIAQ==, | Callback ID |
custom_params_1 | Channel promotion custom parameter 1-10 | |
custom_params_2 | Channel promotion custom parameter 1-10 | |
custom_params_3 | Channel promotion custom parameter 1-10 | |
custom_params_4 | Channel promotion custom parameter 1-10 | |
custom_params_5 | Channel promotion custom parameter 1-10 | |
custom_params_6 | Channel promotion custom parameter 1-10 | |
custom_params_7 | Channel promotion custom parameter 1-10 | |
custom_params_8 | Channel promotion custom parameter 1-10 | |
custom_params_9 | Channel promotion custom parameter 1-10 | |
custom_params_10 | Channel promotion custom parameter 1-10 |