A first-time event refers to an event that is recorded only once for a specific dimension, such as device ID. For example, registration can be recorded using a first-time event. The server will deduplicate based on the ID set by setCheckId(). Only the first event reported with the same ID will be recorded.

       Predefined events (_appInstall, _appStart, _appEnd) cannot be set as first-time events.

Function

public synchronized void trackFirstEvent(SEBaseFirstEventModel seBaseFirstEventModel);

       When using the seBaseFirstEventModel parameter, you need to pass a subclass instance of it. The specific instructions are as follows.

1. First In-App Ad Impression Event

Parameter Description

       To report the corresponding values/fields from mediation platforms, please refer to Mediation Platform-Others.

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppImpFirstEventModel seAppImpFirstEventModel = new SEAppImpFirstEventModel();
//If no checkId is sent, the current event will be seen as a normal event rather than first-time event. 
seAppImpFirstEventModel.setCheckId("11aaBB");        
seAppImpFirstEventModel.setAdNetworkPlatform("kuaishou");
seAppImpFirstEventModel.setMediationPlatform("Mintgaral");
seAppImpFirstEventModel.setAdType(1);
seAppImpFirstEventModel.setAdNetworkAppID("AppID");
seAppImpFirstEventModel.setAdNetworkADID("AdID");
seAppImpFirstEventModel.setEcpm(10.11);
seAppImpFirstEventModel.setCurrencyType("USD");
seAppImpFirstEventModel.setRenderSuccess(true);
JSONObject customProperties = new JSONObject();
try {
     //Developer custom event properties in JSON format
     customProperties.put("key1","value1");
     customProperties.put("key2","value2");
     seAppImpFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
    ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppImpFirstEventModel);

2. First In-App Ad Click Event

Parameter Description

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAdClickFirstEventModel seClickFirstEventModel = new SEAdClickFirstEventModel();
// If the CheckId (first-time event verification ID) is not passed, this call will be reported as a normal event.
seClickFirstEventModel.setCheckId("22bbCC");
seClickFirstEventModel.setAdPlatform("kuaishou");
seClickFirstEventModel.setMediationPlatform("Mintgaral");
seClickFirstEventModel.setAdType(2);
seClickFirstEventModel.setAdNetworkADID("AdID");
JSONObject customProperties = new JSONObject();
try {
     //Developer custom event properties in JSON format
     customProperties.put("key1","value1");
     customProperties.put("key2","value2");
     seClickFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
     ///
}
SolarEngineManager.getInstance().trackFirstEvent(seClickFirstEventModel);

3. First Self-Reported Attribution Event

Parameter Description

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppAttrFirstEventModel seAppAttrFirstEventModel = new SEAppAttrFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seAppAttrFirstEventModel.setCheckId("33ccDD");
seAppAttrFirstEventModel.setAdNetwork("Channel ID");
seAppAttrFirstEventModel.setSubChannel("Sub-channel");
seAppAttrFirstEventModel.setAdAccountId("Ad Account ID");
seAppAttrFirstEventModel.setAdAccountName("Ad Account Name");
seAppAttrFirstEventModel.setAdCampaignId("Ad Campaign ID");
seAppAttrFirstEventModel.setAdCampaignName("Ad Campaign Name");
seAppAttrFirstEventModel.setAdOfferId("Ad Offer ID");
seAppAttrFirstEventModel.setAdOfferName("Ad Offer Name");
seAppAttrFirstEventModel.setAdCreativeId("Ad Creative ID");
seAppAttrFirstEventModel.setAdCreativeName("Ad Creative Name");
seAppAttrFirstEventModel.setAttributionPlatform("Attribution Platform");
JSONObject customProperties = new JSONObject();
try {
     //Developer custom event properties in JSON format
     customProperties.put("key1","value1");
     customProperties.put("key2","value2");
     seAppAttrFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
     ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppAttrFirstEventModel);

4. First Login Event

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppLoginFirstEventModel seAppLoginFirstEventModel = new SEAppLoginFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seAppLoginFirstEventModel.setCheckId("44ddEE");
seAppLoginFirstEventModel.setLoginType("QQ");
seAppLoginFirstEventModel.setStatus("success");

JSONObject customProperties = new JSONObject();
try {
     //Developer custom event properties in JSON format
     customProperties.put("key1","value1");
     customProperties.put("key2","value2");
     seAppLoginFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
     ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppLoginFirstEventModel);

5. First Registration Event

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppRegisterFirstEventModel seAppRegisterFirstEventModel = new SEAppRegisterFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seAppRegisterFirstEventModel.setCheckId("55eeFF");
seAppRegisterFirstEventModel.setRegType("Wechat");
seAppRegisterFirstEventModel.setStatus("success");
JSONObject customProperties = new JSONObject();
try {
    //Developer custom event properties in JSON format
    customProperties.put("key1","value1");
    customProperties.put("key2","value2");
    seAppRegisterFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
    ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppRegisterFirstEventModel);

6. First Order Event

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppOrderFirstEventModel seAppOrderFirstEventModel = new SEAppOrderFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seAppOrderFirstEventModel.setCheckId("66ffGG");
seAppOrderFirstEventModel.setOrderId("Order ID");
seAppOrderFirstEventModel.setPayAmount(10.11);
seAppOrderFirstEventModel.setCurrencyType("USD");
seAppOrderFirstEventModel.setPayType("alipay");
seAppOrderFirstEventModel.setStatus("success");
JSONObject customProperties = new JSONObject();
try {
    //Developer custom event properties in JSON format
    customProperties.put("key1","value1");
    customProperties.put("key2","value2");
    seAppOrderFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
    ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppOrderFirstEventModel);

7. First In-App Purchase Event

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;
 
SEAppPurFirstEventModel seAppPurFirstEventModel = new SEAppPurFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seAppPurFirstEventModel.setCheckId("77ggHH");
seAppPurFirstEventModel.setOrderId("Order ID");
seAppPurFirstEventModel.setPayAmount(11.01);
seAppPurFirstEventModel.setCurrencyType("CNY");
seAppPurFirstEventModel.setPayType("alipay");
seAppPurFirstEventModel.setProductId("Product ID");
seAppPurFirstEventModel.setProductName("Nike");
seAppPurFirstEventModel.setProductNum(10);
seAppPurFirstEventModel.setPayStatus(2);
seAppPurFirstEventModel.setFailReason("failed");
JSONObject customProperties = new JSONObject();
try {
    //Developer custom event properties in JSON format
    customProperties.put("key1","value1");
    customProperties.put("key2","value2");
    seAppPurFirstEventModel.setCustomProperties(customProperties);
} catch (JSONException e) {
    ///
}
SolarEngineManager.getInstance().trackFirstEvent(seAppPurFirstEventModel);

8. Custom First Time Event

import com.reyun.solar.engine.SolarEngineManager;
import org.json.JSONObject;

SECustomFirstEventModel seCustomFirstEventModel = new SECustomFirstEventModel();
//If the CheckId is not passed, this call will be reported as a normal event.
seCustomFirstEventModel.setCheckId("88hhII");
//If reporting custom first-time event, then eventName is necessary, otherwise the reporting cannot be achieved.
seCustomFirstEventModel.setEventName("custom_event");
JSONObject customProperties = new JSONObject();
try {
    //Developer custom event properties in JSON format
    customProperties.put("key1","value1");
    customProperties.put("key2","value2");
    //Set preset properties; currently, only _pay_amount and _currency_type are supported. Other fields will be discarded by the SDK.
    preEventData.put("_pay_amount", 11.2);
    preEventData.put("_currency_type", "USD");
    seCustomFirstEventModel.setPreEventData(preEventData);
} catch (JSONException e) {
    ///
}
SolarEngineManager.getInstance().trackFirstEvent(seCustomFirstEventModel);

Note:

       The field "eventName" is required, otherwise the custom first-time event cannot be reported.