Troubleshooting

D/Permutive: Error fetching configuration - please check that your workspace id & API key is correct, or contact customer support (Http error: 404)

// ❌ Wrong: Using deprecated projectId
val permutive = Permutive.Builder()
    .projectId(UUID.fromString("..."))  // DEPRECATED
    .build()

// ✅ Correct: Use workspaceId
val permutive = Permutive(
    context = this,
    workspaceId = UUID.fromString("YOUR_WORKSPACE_ID"),
    apiKey = UUID.fromString("YOUR_API_KEY")
)

// Example: "550e8400-e29b-41d4-a716-446655440000"

// ❌ Wrong: Not a UUID
workspaceId = UUID.fromString("12345")  // Throws exception

// ✅ Correct: Valid UUID
workspaceId = UUID.fromString("550e8400-e29b-41d4-a716-446655440000")

D/Permutive: Error publishing event with name "Pageview":
D/Permutive: Code: 1007
D/Permutive: Status: BadRequest
D/Permutive: Cause: Schema validation failed with reason(s): [#: extraneous key [publishDate] is not permitted;#/article/categories: expected type: JSONArray, found: String]

// ❌ Wrong: Typo in property name
EventProperties.from("publishDate" to date)  // Schema expects "published_at"

// ✅ Correct: Exact match with schema
EventProperties.from("published_at" to date)

// ❌ Wrong: String instead of Array
EventProperties.from("categories" to "sports")  // Schema expects List<String>

// ✅ Correct: Array type
EventProperties.from("categories" to listOf("sports", "football"))

IllegalArgumentException: Invalid event name "My Event": must contain only the characters [a-zA-Z0-9_]

// ❌ Wrong: Contains spaces and special characters
tracker.track("My Event!", properties)
tracker.track("page-view", properties)

// ✅ Correct: Only valid characters
tracker.track("MyEvent", properties)
tracker.track("page_view", properties)
tracker.track("PageView123", properties)

import java.security.MessageDigest

fun hashEmail(email: String): String {
    val normalized = email.trim().lowercase()
    val bytes = MessageDigest.getInstance("SHA-256")
        .digest(normalized.toByteArray())
    return bytes.joinToString("") { "%02x".format(it) }
}

// ❌ Wrong: Plain text email
permutive.setIdentity(
    listOf(Alias.create("email", "user@example.com", 0))  // DON'T!
)

// ✅ Correct: Hashed email
val emailHash = hashEmail("user@example.com")
permutive.setIdentity(
    listOf(Alias.create("email_sha256", emailHash, 0))
)

// ❌ Wrong: Manual ad request without Permutive
val adRequest = AdManagerAdRequest.Builder().build()

// ✅ Correct: Use Permutive helper
val adRequest = AdManagerAdRequest.Builder()
    .addPermutiveTargeting(permutive)
    .build()

D/Permutive: Permutive segments appended to Google Ad request: 123, 456, 789

val activations = permutive.currentActivations
val gamCohorts = activations["dfp"]

if (gamCohorts.isNullOrEmpty()) {
    Log.w("Debug", "No GAM activations available")
    // Either cohorts not ready or not activated for GAM
}

class MyActivity : AppCompatActivity() {
    private lateinit var pageTracker: PageTracker

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        pageTracker = permutive.trackPage(...)
    }

    override fun onDestroy() {
        super.onDestroy()
        pageTracker.close()  // IMPORTANT!
    }
}

class MyActivity : AppCompatActivity() {
    private val triggers = mutableListOf<TriggerAction>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        triggers.add(triggersProvider.triggerAction("cohort") { /*...*/ })
    }

    override fun onDestroy() {
        super.onDestroy()
        triggers.forEach { it.close() }  // IMPORTANT!
        triggers.clear()
    }
}

Duplicate class com.permutive.android.X found in modules...

./gradlew app:dependencies

configurations.all {
    resolutionStrategy {
        force("com.permutive.android:core:1.12.1")
        force("com.permutive.android:google-ads:2.2.0")
    }
}