Remote Command: Contentsquare

1. In your Xcode project, select File > Add Packages… > Add Package Dependency.
2. Enter the repository URL: https://github.com/tealium/tealium-ios-contentsquare-remote-command.
3. Configure the version rules. Typically, Up to next major is recommended. If the current TealiumContentSquare version does not appear in the list, then reset your Swift package cache.
4. Select the TealiumContentSquare module to install, and select the app target you want the module to be installed in.

If your project has more than one app target and needs TealiumContentSquare module in more app targets, you have to manually add them in the Frameworks, Libraries, and Embedded Content section.

To install TealiumContentSquare in additional app targets:

1. Select your Xcode project in the Project Navigator.
2. In your Xcode project, select the app target under the TARGETS section.
3. Navigate to General > Frameworks, Libraries & Embedded Content and select the TealiumContentSquare module to add it to your app target.

To add additional modules from the Tealium Swift library, follow the Swift Package Manager instructions.

1. Remove tealium-swift and pod "CS_iOS_SDK" if they already exist your Podfile. The dependency for tealium-swift is already included in the TealiumContentsquare framework.

2. Add the following dependency to your Podfile:

   pod "TealiumContentsquare"
   

   The TealiumContentsquare pod includes the following TealiumSwift dependencies:

   'tealium-swift/Core'
   'tealium-swift/TealiumDelegate'
   'tealium-swift/TealiumRemoteCommands'
   'tealium-swift/TealiumTagManagement'
   

3. Import the modules TealiumSwift and TealiumContentsquare in your TealiumHelper file, and any other files that access the Tealium class, or the Contentsquare Remote Command.

1. Remove tealium-swift from your Cartfile. The dependency for tealium-swift is already included in the TealiumContentsquare framework.

2. Remove the following line if it exists in your Cartfile:

   github "ContentSquare/CS_iOS_SDK"
   

3. Add the following dependency to your Cartfile:

   github "tealium/tealium-ios-contentsquare-remote-command"
   

Tealium for Swift SDK (version 1.6.5+) requires the TealiumDelegate module to be included with your installation.

1. Install Tealium for Android (Kotlin) or Tealium for Android (Java) and add the Tealium Maven URL to your project’s top-level build.gradle file, if you haven’t done so already.

   allprojects {
     repositories {
       mavenCentral()
       maven {
         url "https://maven.tealiumiq.com/android/releases/"
       }
     }
   }
   

2. Import both the Contentquare SDK and Tealium-Contentsquare remote commands by adding the following dependencies in your app project’s build.gradle file:

   dependencies {
         implementation 'com.tealium.remotecommands:contentsquare:2.0.0'
   }
   

The manual installation for Contentsquare remote commands requires the Tealium for Swift library to be installed. To install the Contentsquare remote commands for your iOS project:

1. Install the Contentsquare SDK, if you haven’t already done so.

2. Clone the Tealium iOS Contentsquare remote command repo and drag the files within the Sources folder into your project.

3. Set the remoteAPIEnabled configuration flag to true.

The manual installation for Contentsquare remote commands requires Tealium for Android (Kotlin) or Tealium for Android (Java) to be installed.

To install the Contentsquare remote commands for your Android project:

1. Add flatDir to your project root build.gradle file:

   allprojects {
         repositories {
           mavenCentral()
           flatDir {
               dirs 'libs'
           }
         }
   }
   

2. Add tealium-contentsquare.aar to <PROJECT_ROOT>/<MODULE>/libs.

3. Add the Tealium library dependency to your build.gradle file:

   dependencies {
         implementation(name:'tealium-contentsquare', ext:'aar')
   }
   

Initialize remote commands with a JSON configuration file or the Remote Command tag for Tealium’s iOS (Swift) library:

var tealium : Tealium?
let config = TealiumConfig(account: "ACCOUNT",
                           profile: "PROFILE",
                           environment: "ENVIRONMENT",
                           dataSource: "DATASOURCE")
config.dispatchers = [Dispatchers.TagManagement, Dispatchers.RemoteCommands]
config.remoteAPIEnabled = true // Required to use Remote Commands

tealium = Tealium(config: config) { _ in
    guard let remoteCommands = self.tealium?.remoteCommands else {
        return
    }

    // Webview Tag
    let contentsquare = ContentSquareRemoteCommand() 

    // Local JSON
    //let contentsquare = ContentSquareRemoteCommand(type: .local(file: "contentsquare")) 

    // Remote JSON
    //let contentsquare = ContentSquareRemoteCommand(type: .remote(url: "https://some.domain.com/contentsquare.json")) 

    remoteCommands.add(contentsquare)
}

Initialize remote commands with a JSON configuration file or the Remote Command tag for Tealium’s Android (Kotlin) library:

val config = TealiumConfig(application,
        "ACCOUNT",
        "PROFILE",
        Environment.DEV,
        dispatchers = mutableSetOf(Dispatchers.RemoteCommands, Dispatchers.TagManagement));
var tealium = Tealium.create(TEALIUM_MAIN, config) {
    // Initialize with `Application` in order to take advantage of consent management and other
    // advanced features
    val contentsquare = ContentsquareRemoteCommand(this);

    // Or for simple tracking, you can initialize without `Application`
    val contentsquare = ContentsquareRemoteCommand();
    // register the command

    // Webview Tag
    remoteCommands?.add(contentsquare); 

    // Local JSON
    //remoteCommands?.add(contentsquare, filename = "contentsquare.json"); 

    // Remote JSON
    //remoteCommands?.add(contentsquare, remoteUrl = "https://some.domain.com/contentsquare.json"); 

Initialize remote commands with the Remote Command tag for Tealium’s Android (Java) library:

import com.tealium.remotecommands.contentsquare.ContentsquareRemoteCommand;

Tealium.Config config = Tealium.Config.create(application, "ACCOUNT", "PROFILE", "ENVIRONMENT");
Tealium teal = Tealium.createInstance(TEALIUM_MAIN, config);

// Initialize with `Application` in order to take advantage of consent management and other
// advanced features
ContentsquareRemoteCommand contentsquare = new ContentsquareRemoteCommand(this);

// Or for simple tracking, you can initialize without `Application`
ContentsquareRemoteCommand contentsquare = new ContentsquareRemoteCommand();

// register the command
teal.addRemoteCommand(contentsquare);