DCR Italy Static Android SDK - Revision history

WilsonQuispe: /* Nielsen SDK Metadata */

2023-07-06T13:56:23Z

Nielsen SDK Metadata

← Older revision		Revision as of 13:56, 6 July 2023
Line 202:		Line 202:
	\| type \|\| asset type \|\| fixed \|\| <code>'static'</code> \|\| Yes		\| type \|\| asset type \|\| fixed \|\| <code>'static'</code> \|\| Yes
	\|-		\|-
	\| assetid \|\| Unique ID for each article \|\| dynamic \|\| custom (no [[Special Characters\|Special Characters]]) \|\| Yes		\| assetid \|\| Unique ID for each article. For the Italian Market only the home page/ landing page must be tagged \|\| dynamic \|\| custom (no [[Special Characters\|Special Characters]]) \|\| Yes
	\|-		\|-
	\| section \|\| section of the App to be measured </br> EntityName = brand name or sub-brand name\|\| dynamic \|\| <code>Home_EntityName_Android</code> for Android App \|\| Yes		\| section \|\| section of the App to be measured </br> EntityName = brand name or sub-brand name\|\| dynamic \|\| <code>Home_EntityName_Android</code> for Android App \|\| Yes

WilsonQuispe: /* Java */

2023-07-06T13:25:31Z

Java

← Older revision		Revision as of 13:25, 6 July 2023
Line 183:		Line 183:
	.put("type", "static")		.put("type", "static")
	.put("section", "Home_EntityName_Android")		.put("section", "Home_EntityName_Android")
	.put("assetid", "~~vid345-67483~~")		.put("assetid", "HomePage")
	}		}

WilsonQuispe: /* Required Privacy Links */

2022-07-13T13:14:41Z

Required Privacy Links

← Older revision		Revision as of 13:14, 13 July 2022
Line 377:		Line 377:
	In addition, the following text must be included in your app store description.		In addition, the following text must be included in your app store description.

	"Si prega di notare che questa app include il software di misurazione proprietario di Nielsen che contribuisce alla ricerca di mercato. Per ulteriori informazioni, si prega di consultare il seguente link [https://~~www~~.nielsen.com~~/it/it~~/legal/privacy-~~statement~~/digital-measurement/ https://~~www~~.nielsen.com~~/it/it~~/legal/privacy-~~statement~~/digital-measurement/]"		"Si prega di notare che questa app include il software di misurazione proprietario di Nielsen che contribuisce alla ricerca di mercato. Per ulteriori informazioni, si prega di consultare il seguente link [https://global.nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=it https://global.nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=it]"

	== Going Live ==		== Going Live ==

WilsonQuispe: /* Overview */

2022-05-11T12:37:02Z

Overview

@@ Line 7: / Line 7: @@
 *Application launch events and how long app was running
 *Time of viewing a page / sub section in the application.
 __TOC__

WilsonQuispe: /* Prerequisites */

2022-05-11T12:36:50Z

Prerequisites

← Older revision		Revision as of 12:36, 11 May 2022
Line 9:		Line 9:

	__TOC__		__TOC__

	~~== Prerequisites ==~~
	~~Before you start the integration, you will need:~~
	~~{\| class="wikitable"~~
	\|-
	~~! style="width: 15%;" \| Item~~
	~~! Description~~
	~~! Source~~
	\|-
	~~\|\| '''App ID (appid)''' \|\| Unique ID assigned to the player/site and configured by product. \|\| Provided by Nielsen~~
	\|-
	~~\|\| '''Nielsen SDK''' \|\| Includes SDK frameworks and '''sample implementation'''; ''See [[Android SDK Release Notes]]'' \|\| [[Special:Downloads\|Download]]~~
	\|-
	~~\|\| '''sfcode''' \|\| Unique identifier for the environment that the SDK should point to \|\| Provided by Nielsen~~
	\|}

	~~If need App ID(s) or our SDKs, feel free to reach out to us and we will be happy to help you get started.~~
	~~Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and appid.~~

	~~=== Notes for WebView Contents ===~~
	~~<code>Please note that if within your APP user can surf '''static contents''' recalled from your website the [[DCR_Italy_Static_Browser_SDK\|browser static SDK]] have to inhibit from this pages.</code>~~

	== Implementation ==		== Implementation ==

WilsonQuispe: /* Prerequisites */

2022-05-11T12:36:24Z

Prerequisites

← Older revision		Revision as of 12:36, 11 May 2022
Line 27:		Line 27:
	If need App ID(s) or our SDKs, feel free to reach out to us and we will be happy to help you get started.		If need App ID(s) or our SDKs, feel free to reach out to us and we will be happy to help you get started.
	Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and appid.		Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and appid.

			=== Notes for WebView Contents ===
			<code>Please note that if within your APP user can surf '''static contents''' recalled from your website the [[DCR_Italy_Static_Browser_SDK\|browser static SDK]] have to inhibit from this pages.</code>

	== Implementation ==		== Implementation ==

WilsonQuispe: /* Implementation */

2022-05-11T12:36:08Z

Implementation

← Older revision		Revision as of 12:36, 11 May 2022
Line 30:		Line 30:
	== Implementation ==		== Implementation ==
	This guide covers implementation steps for Android Studio utilizing the Standard Nielsen SDK for DCR.		This guide covers implementation steps for Android Studio utilizing the Standard Nielsen SDK for DCR.

	~~<code>Please note that if within your APP user can surf static contents recalled from your website the [[DCR_Italy_Static_Browser_SDK\|browser static SDK]] have to inhibit from this pages.</code>~~

	=== How to obtain the NielsenAppApi ===		=== How to obtain the NielsenAppApi ===

WilsonQuispe: /* Implementation */

2022-05-11T10:29:25Z

Implementation

← Older revision		Revision as of 10:29, 11 May 2022
Line 30:		Line 30:
	== Implementation ==		== Implementation ==
	This guide covers implementation steps for Android Studio utilizing the Standard Nielsen SDK for DCR.		This guide covers implementation steps for Android Studio utilizing the Standard Nielsen SDK for DCR.

			<code>Please note that if within your APP user can surf static contents recalled from your website the [[DCR_Italy_Static_Browser_SDK\|browser static SDK]] have to inhibit from this pages.</code>

	=== How to obtain the NielsenAppApi ===		=== How to obtain the NielsenAppApi ===

WilsonQuispe: /* Configuring Android Development Environment */

2022-03-31T16:28:53Z

Configuring Android Development Environment

← Older revision		Revision as of 16:28, 31 March 2022
Line 38:		Line 38:
	== Setting up your Development Environment ==		== Setting up your Development Environment ==
	=== Configuring Android Development Environment ===		=== Configuring Android Development Environment ===
	*The Nielsen App SDK (located in the Downloads section of the website) class is the primary application interface to the Nielsen App SDK on Android.		*The Nielsen App SDK (located in the [https://engineeringportal.nielsen.com/docs/Special:Downloads Downloads section] of the website) class is the primary application interface to the Nielsen App SDK on Android.
	*The Nielsen App SDK class is defined as the only public class belonging to the com.nielsen.app.sdk package.		*The Nielsen App SDK class is defined as the only public class belonging to the com.nielsen.app.sdk package.
			*The Nielsen App SDK can also be added via [https://engineeringportal.nielsen.com/docs/Digital_Measurement_Android_Artifactory_Guide Artifact Repository].

	'''Nielsen App SDK is compatible with Android OS versions 2.3+. Clients can control / configure the protocol to be used – HTTPS or HTTP to suit their needs.'''		'''Nielsen App SDK is compatible with Android OS versions 2.3+. Clients can control / configure the protocol to be used – HTTPS or HTTP to suit their needs.'''

	The requirement for the Java AppSdk.jar library and the libAppSdk.so native library will depend on the type of host application that will make use of them.		The requirement for the Java ''AppSdk.jar'' library and the ''libAppSdk.so'' native library will depend on the type of host application that will make use of them.
			* '''For Video player applications'''
			** The Android OS hosting the App SDK should use a media player supporting HLS streaming (Android 3.0 and later will support it natively).
			** If the player application uses a 3rd party media player implementing its own HLS, then the minimum Android version will be limited to version 2.3, since the SDK depends on Google Play support to work properly.

	*'''~~For Video player applications~~'''		Once SDK is downloaded ensure to unzip the Nielsen SDK and copy the AppSdk.jar in your app (Android Studio) libs folder, then right click the AppSdk.jar and select '''Add As Library'''.
	**The Android OS hosting the App ~~SDK should use a media player supporting HLS streaming (Android 3.0 and later will support it natively~~).		Ensure the AppSdk.jar file is added in 'build.grade (App Level) file.
	**If the player application uses a 3rd party media player implementing its own HLS, ~~then the minimum Android version will be limited to version 2.3~~, ~~since the SDK depends on Google Play support to work properly~~.		* App SDK 1.2 provides support for x86, mips, and armeabi-7a architecture.

	~~Once SDK is downloaded ensure to unzip~~ the ~~Nielsen SDK and copy~~ the ~~AppSdk.jar in your app (~~Android Studio) ~~libs folder, then right click the AppSdk~~.~~jar and~~ select ~~'''Add As Library'''~~. Ensure ~~the AppSdk.jar file~~ is added in 'build.~~grade~~ (App ~~Level~~) file.		==== Google Play Services ====
			Add the Google Play Services in the project,
			Steps: Android Studio -> File -> Project Structure ->(In module selection) select App -> Dependencies (tab) -> Click "+" button and search for <code>"play-services"</code>. Then select the most recent version of the play-services Artifact.
			Ensure it is added in build.gradle (App level) file

	*App SDK ~~1.2 provides support for x86, mips, and armeabi-7a architecture~~.		==== Google AD ID Permissions ====
			The following is required if target API level is set to 31 (Android 12) with the Ad Version of the Nielsen SDK.

	=~~=== Google Play Services ====~~		<syntaxhighlight lang="java">
	~~Add the Google Play Services in the project, Steps: Android Studio -> File -> Project Structure ->(In module selection) select App -> Dependencies (tab) -> Click~~ "+" ~~button and select~~ <~~code>~~"com.google.android.gms~~:play-services~~"</~~code~~>~~. Ensure it is added in build.gradle (App level) file~~		<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
			</syntaxhighlight>
			</br>

	==== Manifest File ====		==== Manifest File ====
	*Add the following permissions on the project’s AndroidManifest.xml file.		* Add the following permissions on the project’s ''AndroidManifest.xml'' file.
	<syntaxhighlight lang="java"><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>		<syntaxhighlight lang="java">
			<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
	<uses-permission android:name="android.permission.INTERNET"/></syntaxhighlight>		<uses-permission android:name="android.permission.INTERNET"/></syntaxhighlight>
	For more details to handle runtime permissions in Android versions, please visit [~~https://developer.android.com/training/permissions/requesting.html~~ https://developer.android.com/training/permissions/requesting.html].		For more details to handle runtime permissions in Android versions, please visit [https://developer.android.com/training/permissions/requesting.html].

	*In <code>AndroidManifest.xml</code> under <application> ~~node~~ add the following metadata		* In <code>AndroidManifest.xml </code>under <code><application></code> add the following metadata
	<syntaxhighlight lang="java"> <meta-data
			<syntaxhighlight lang="java"><meta-data
	android:name="com.google.android.gms.version"		android:name="com.google.android.gms.version"
	android:value="@integer/google_play_services_version"/></syntaxhighlight>		android:value="@integer/google_play_services_version"/></syntaxhighlight>
	*App SDK checks to see if there is a Google service available and updated.
	*If not available or updated, App SDK will not use this service when executing its functions and will make reference to missing imports and the app will not be compiled.		* App SDK checks to see if there is a Google service available and updated.
			* If not available or updated, App SDK will not use this service when executing its functions and will make reference to missing imports and the app will not be compiled.

	==== Library ====		==== Library ====
	Nielsen App SDK uses the following packages/classes from the Google Play service.		Nielsen App SDK uses the following packages/classes from the Google Play service.
	*google-play-services_lib		* google-play-services_lib

	==== Classes/package ====		==== Classes/package ====
	*com.google.android.gms.ads.identifier.AdvertisingIdClient;		* com.google.android.gms.ads.identifier.AdvertisingIdClient;
	*com.google.android.gms.ads.identifier.AdvertisingIdClient.Info;		* com.google.android.gms.ads.identifier.AdvertisingIdClient.Info;
	*com.google.android.gms.common.ConnectionResult;		* com.google.android.gms.common.ConnectionResult;
	*com.google.android.gms.common.GooglePlayServicesUtil;		* com.google.android.gms.common.GooglePlayServicesUtil;
	*com.google.android.gms.common.GooglePlayServicesRepairableException;		* com.google.android.gms.common.GooglePlayServicesRepairableException;
	*com.google.android.gms.common.GooglePlayServicesNotAvailableException;		* com.google.android.gms.common.GooglePlayServicesNotAvailableException;

	== SDK Initialization ==		== SDK Initialization ==

WilsonQuispe: /* APP SDK Error & Event Codes */

2020-10-19T19:34:21Z

APP SDK Error & Event Codes

← Older revision		Revision as of 19:34, 19 October 2020
Line 148:		Line 148:

	== APP SDK Error & Event Codes ==		== APP SDK Error & Event Codes ==
	To view the Error and Event codes for ~~iOS~~, please review the [[APP SDK Event Codes\|App SDK Event Code]] Reference page.		To view the Error and Event codes for Android, please review the [[APP SDK Event Codes\|App SDK Event Code]] Reference page.

	== Configure Metadata ==		== Configure Metadata ==