mParticle.Sdk.Core 1.0.0

There is a newer version of this package available.
See the version list below for details.
Install-Package mParticle.Sdk.Core -Version 1.0.0
dotnet add package mParticle.Sdk.Core --version 1.0.0
<PackageReference Include="mParticle.Sdk.Core" Version="1.0.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add mParticle.Sdk.Core --version 1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: mParticle.Sdk.Core, 1.0.0"
#r directive can be used in F# Interactive, C# scripting and .NET Interactive. Copy this into the interactive tool or source code of the script to reference the package.
// Install mParticle.Sdk.Core as a Cake Addin
#addin nuget:?package=mParticle.Sdk.Core&version=1.0.0

// Install mParticle.Sdk.Core as a Cake Tool
#tool nuget:?package=mParticle.Sdk.Core&version=1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

<img src="http://static.mparticle.com/sdk/logo.svg" width="280">

mParticle Universal Windows Platform SDK

NuGet version (mParticle.Sdk.UWP)

This is the public repo of the mParticle UWP SDK. The SDK is designed for use in Xbox and other UWP devices. This repo contains two core projects, respective test projects, and a sample UWP app:

  • mParticle.Sdk.UWP: Universal Windows class library for UWP apps
  • mParticle.Sdk.Core: Underlying .NET Standard class library implementing the mParticle HTTP API
  • mParticle.Sdk.UWP.ExampleApp: Example UWP app implementing the SDK

Download

mParticle.Sdk.UWP is available via NuGet.

Initialize

Initialize the SDK within the OnLaunched Application lifecycle method:

sealed partial class App : Application
{
    protected override void OnLaunched(LaunchActivatedEventArgs launchArgs)
    {
         // Create an Identity Request:
        // The SDK will automatically make an Identify() request during initialization,
        // if you know identities of the current-user, you should provide them.
        // Otherwise, the SDK will use the Identities of the most recent user.
        var identifyRequest = IdentityApiRequest.EmptyUser()
            .CustomerId("foo")
            .Email("bar")
            .Build();

        // Create an MParticleOptions object:
        // You must at least provide an mParticle workspace key and secret
        MParticleOptions options =
            MParticleOptions.Builder(apiKey: "REPLACE ME", apiSecret: "REPLACE ME")
            .IdentifyRequest(identifyRequest)
            .LaunchArgs(launchArgs)
            .Logger(new ExampleConsoleLogger())
            .Build();

        // Initialize the mParticle SDK:
        // You must do this prior to calling MParticle.Instance
        var task = MParticle.StartAsync(options);
        HandleIdentityTaskAsync(task);
    }
}

See the MParticleOptions class definition and the example app for all SDK customization options.

Basic Usage

A reference to the SDK and its API is available statically via MParticle.Instance. You must initialize the SDK prior to accessing this reference.

Log Custom Events

var customEvent = CustomEvent.Builder("Example event name")
    .CustomAttributes(dictionary)
    .Type(CustomEventType.Navigation)
    .Build();
MParticle.Instance.LogEvent(customEvent);

Log Screen-views

MParticle.Instance.LogScreen("Example screen name");

Example App

See the app below for an example implementation:

License

Apache License 2.0

NuGet packages (1)

Showing the top 1 NuGet packages that depend on mParticle.Sdk.Core:

Package Downloads
mParticle.Sdk.UWP

mParticle SDK for UWP apps

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.0 477 1/24/2020
1.0.3 476 5/17/2019
1.0.2 312 5/7/2019
1.0.1 666 12/13/2017
1.0.0 644 12/11/2017

Initial release.