Initialize the .NET SDK

Last update: July 17, 2023

CREATED FOR:

  • Developer

Description

Use the Create method in order to initialize the .NET SDK and instantiate the Target Client to make calls to Adobe Target for experiments and personalized experiences.

When using .NET Dependency Injection, just add the SDK at service configuration step by calling services.AddTargetLibrary();, then inject ITargetClient targetClient in your app’s constructor.

After this, use the Initialize method of the SDK to configure the SDK, thus completing the initialization step.

Method

TargetClient is created using TargetClient.Create.

C#

TargetClient TargetClient.Create(TargetClientConfig clientConfig)

ClientConfig is created using ClientConfig.Builder.

C#

TargetClientConfig.Builder TargetClientConfig.Builder()

Parameters

TargetClientConfig.Builder has the following structure:

NameTypeRequiredDefaultDescription
ClientstringYesNoneTarget Client Id
OrganizationIdstringYesNoneExperience Cloud Organization ID
TimeoutintNo10000Timeout for all requests in milliseconds
ProxyWebProxyNonull
RetryPolicyPolicyNonullRetry Policy for all Target requests
AsyncRetryPolicyAsyncPolicyNonullAsync Retry Policy for all Target requests
LoggerILoggerNonullUsed for debug logging of Target requests and responses
ServerDomainstringNoclient.tt.omtrdc.netOverrides default hostname
SecureboolNotrueUnset to enforce HTTP scheme
DefaultPropertyTokenstringNonullSets the default property token for every getOffers call
TelemetryEnabledboolNotrueSend telemetry data for improving SDK usage experience
DecisioningMethodDecisioningMethod enumNoServerSideMust be set to OnDevice or Hybrid to enable on-device decisioning
OnDeviceDecisioningReadyActionNonullDelegate for on-device decisioning Ready event (called once when on-device decisioning is ready)
ArtifactDownloadSucceededActionNonullDelegate for on-device decisioning artifact download success (called on each successful artifact download)
ArtifactDownloadFailedActionNonullDelegate for on-device decisioning artifact download failure (called on each failed artifact download)
OnDeviceEnvironmentstringNoproductionCan be used to specify a different on-device environment such as staging
OnDeviceConfigHostnamestringNoassets.adobetarget.comCan be used to specify a different host to use to download the on-device decisioning artifact file
OnDeviceDecisioningPollingIntSecsintNo300 (5 min)Number of seconds between fetches of the on-device decisioning artifact file
OnDeviceArtifactPayloadstringNonullProvides on-device decisioning with a local artifact payload to allow immediate execution

Example

C#

var targetClientConfig = new TargetClientConfig.Builder("acmeclient", "ABCDEF012345677890ABCDEF0@AdobeOrg")
    .Build();

targetClient = TargetClient.Create(targetClientConfig);

// make calls to Adobe Target
Previous pageInstall the .Net SDK
Next pageGet Offers (.NET)

Target


Personalization & Experiementation Excellence with Recommendations and AI

Adobe Customer Success Webinars

Tuesday, Mar 4, 4:00 PM UTC

Adobe Target innovations, including GenAI, and best practices on AI-powered personalization and experimentation at scale.

Register

Connect with Experience League at Summit!

Get front-row access to top sessions, hands-on activities, and networking—wherever you are!

Learn more

Register now