Singular Events Connector Setup Guide | Server-Side Connectors

Connector Actions

Action Name	AudienceStream	EventStream
Install Event	✗	✓
Post Install Events	✗	✓

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

API Key: API Key is required. Clients can retrieve their API key from within their account from the Singular’s portal.

Click Next or go to the Actions tab. This is where you configure connector actions.

This section describes how to set up parameters and options for each action.

Parameter	Description
Device ID	At least one device identifier is required, for example: Advertiser Identifier (`idfa`) Identifier for Vendor (`idfv`) for iOS apps Android advertising ID ( `aifa`), Android ID ( `andi`) for Android. Reference the following API documentation for more information.
Platform	`Android` or `iOS`.
Application Name	Package Name (Android) or Bundle ID (iOS) of your application. For example: `com.mycompany.app`
IP Address	IP address of the device session (with decimal points or colons). Both IPv4 and IPv6 are supported.
Device Make	Make of the device hardware, which is typically the consumer-facing name. For example: `Samsung`, `LG`, or `Apple`.
Device Model	Model of the device hardware. Examples: `iPhone 8` or `Galaxy S10`
Device Build	The build of the device, URL-encoded. For example: `Build%2F13D15`.
OS Version	Version of the OS on the device. Example: `9.2`.
Language & Country Code	The IETF local tag for the device, using two-letter language and country code separated by an underscore. For example: `en_US`.
Optional Parameters	Add all other optional parameters here. For more information on supported parameters, reference the Singular API documentation.

Parameter	Description
Event Name	Name of the event to report in Singular. Example: `ViewItem`
Application Name	Package Name (Android) or Bundle ID (iOS) of the mobile application. Example: `com.yourcompany.app`
Device ID	At least one device identifier is required, for example: Advertiser Identifier (`idfa`) Identifier for Vendor (`idfv`) for iOS apps Android advertising ID ( `aifa`), Android ID ( `andi`) for Android. Reference the following API documentation for more information.
Platform	Android or iOS.
IP Address	Raw IP address of the device (with decimal points or colons). Both IPv4 and IPv6 are supported.
Device Make	Make of the device hardware, typically the consumer-facing name. For example: `Samsung`, `LG`, or `Apple`
Device Model	Model of the device hardware. Examples: `iPhone XS` or `Galaxy S10`
Device Build	Build of the device, URL encoded. Example: `Build%2F13D15`
OS Version	Version of the OS on the device. Example: `9.2`
Language & Country Code	The IETF local tag for the device, using two-letter language and country code separated by an underscore. For example: `en_US`
Optional Parameters	Add all other optional parameters here. For more information, see the Singular Server-to-Server documentation.