First-Time Event

      A first-time event refers to an event that is recorded only once for a specific dimension. 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

export function trackFirstEvent(firstCheckId:string,eventAttribute:
                                                  SEIAPEventAttribute|
                                                  SEAppAttrEventAttribute|
                                                  SEOrderEventAttribute|
                                                  SERegisterEventAttribute|
                                                  SELoginEventAttribute|
                                                  SEAdImpressionEventAttribute|
                                                  SEAdClickEventAttribute|
                                                  SECustomEventAttribute);

      When using the attributes 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:

       (For the corresponding fields from each mediation platform, please refer to Impression-level-revenue-integration )

SEAdImpressionEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SEAdImpressionEventAttribute = {
  adNetworkPlatform:"AdMob",
  adType:AdType.Interstitial,
  adNetworkAppID:"AdMob appid",
  adNetworkPlacementID:"AdMob placementid",
  mediationPlatform:"MAX",
  currency:"USD",
  ecpm:1.234,
  rendered:true,
  customProperties:{"key1":"value1","key2":"value2"}
// You can choose not to set customProperties. 
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

2. First in-app ad click event

SEAdClickEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SEAdClickEventAttribute = {

  adNetworkPlatform: "AdNetwork platform",
  adType:AdType.Interstitial,
  adNetworkPlacementID:"AdNetwork placementid",
  mediationPlatform:"mediation name",
  customProperties:{"key":"adclick customProperties value"}
// You can choose not to set customProperties. 
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

3. First self-reported attribution event

SEAppAttrEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SEAppAttrEventAttribute = {
  adNetwork:"toutiao",
  subChannel:"103300", //If no value, please send ""
  adAccountID:"1655958321988611",//If no value, please send ""
  adAccountName:"xxx科技全量18",//If no value, please send ""
  adCampaignID:"1680711982033293",//If no value, please send ""
  adCampaignName:"冲冲冲计划157-1024",//If no value, please send ""
  adOfferID:"1685219082855528",//If no value, please send ""
  adOfferName:"冲冲冲单元406-1024",//If no value, please send ""
  adCreativeID:"1680128668901378",//If no value, please send ""
  adCreativeName:"自动创建20210901178921",//If no value, please send ""
  attributionPlatform:"广告监测平台xxx",
  customProperties:{"customProperties":"app attr customProperties value"} 
// You can choose not to set customProperties.  // Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

4. First login event

SELoginEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SELoginEventAttribute = {
    loginType:"WeChat",
    loginStatus:"failed",
    customProperties:{"key":"login customProperties value"}
// You can choose not to set customProperties.  // Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

5. First registration event

SERegisterEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SERegisterEventAttribute = {
  registerType:"WeChat",
  registerStatus:"success",
  customProperties:{"key":"register customProperties value"}
// You can choose not to set customProperties.  
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

6. First order event

SEOrderEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SEOrderEventAttribute = {
  orderID:"order id",
  payAmount:3.1415926,
  currency:"USD",
  payType:Paypal,
  status:"success",
  customProperties:{"key":"order customProperties value"}
// You can choose not to set customProperties.  
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

7. First in-app purchase event

SEIAPEventAttribute parameters:

Sample Code

let firstCheckId = "my first check id";
let attribute:SEIAPEventAttribute = {
  productID:"product id",
  productName:"product name",
  productCount:3,
  orderId:"order id",
  payAmount:3.14,
  currency:"USD",
  // const Alipay    = "alipay";
  // const Weixin    = "weixin";
  // const ApplePay  = "applepay";
  // const Paypal    = "paypal";
  payType:Paypal,
  payStatus:SEIAPStatus.Success,
  failReason:"",
  customProperties:{"key":"iap customProperties value"}

// You can choose not to set customProperties.  
// Please do not report custom properties starting with "_", otherwise SDK will abandon its value by default.
}
SolarEngine.trackFirstEvent(firstCheckId,attribute);

Note:

       The fail_reason parameter for payment failure will only be passed when the paystatus is SEConstant_IAP_PayStatus_fail. For other statuses, an empty string "" can be passed.

8. Custom first-time event

CustomAttributes parameters

Sample Code

let firstCheckId = "my first check id";

SolarEngine.trackFirstEvent(firstCheckId,attribute);

Note:

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