Étape 3 : Intégration

Comment utiliser notre SDK ?

1. Obtenez votre AppKey

La première étape est de créer votre source / notice et de récupérer YOUR_APP_KEY généré depuis https://app.appconsent.io

2. Créez l'instance de Appconsent & l'utiliser

La second étape consiste à initialiser le SDK et d'attendre que celui-ci soit démarré avant de pouvoir l'utiliser.

ASTUCE

Nous recommandons d'implémenter cette logique dans la class application, splashscreen, ou votre activity "android.intent.category.LAUNCHER".

L'idée est d'être capable d'afficher la CMP aussi-tôt que possible, ce qui vous permettra de charger votre fournisseur publicitaire.

NOTE

Même si votre fournisseur de publicité s'inscrit aux événements de mise à jour du consentement de l'utilisateur et que cela est transparent pour vous, certains fournisseurs peuvent ne pas fonctionner correctement avec cette solution. C'est pourquoi nous vous recommandons d'initialiser le SDK de votre fournisseur uniquement lorsque le consentement a été donné, afin de vous assurer que vos publicités soient conformes au consentement de l'utilisateur.

Pensez également à le mettre à jour à chaque fois que l'utilisateur met à jour son consentement, grâce aux callbacks

INFO

Dans l'exemple ci-dessous, le code se concentre sur l'utilisation du SDK exclusivement. Les imports et éléments visuels potentiels dans ces exemples n'y sont donc pas présents, car ils sont fortement liés à la structure et au projet Android qui sont indépendants du SDK.

class MyActivity : Activity() {
    override fun onCreate() {
        super.onCreate()
        SFBX.initialize(
            context = this@MyActivity,
            configuration = Configuration(appkey = "YOUR-APP-KEY"),
            onCmpReady = { appconsent ->
                appconsent.presentNotice(
                    context = this@MyActivity,
                    onCmpDisplayed = {
                        // La CMP est affichée à vos utilisateurs.
                    },
                    onCmpNotDisplayed = {
                        // La CMP ne s'est pas affichée.
                    },
                    onCmpClosed = {
                        // La CMP a été fermée.
                    },
                )
            },
            onCmpOnError = {
                // L'initialisation a échouée.
            },
        )
    }
}

public class MyActivity extends Activity {
    @Override
    void onCreate() {
        super.onCreate();
        final Configuration config = new Configuration("YOUR-APP-KEY");
        SFBX.initialize(
            this,
            config,
            (appconsentInstance) -> {
                appconsentInstance.presentNotice(
                    this,
                    () -> {
                        // La CMP est affichée à vos utilisateurs.
                        return Unit.INSTANCE;
                    },
                    () -> {
                        // La CMP ne s'est pas affichée.
                        return Unit.INSTANCE;
                    },
                    () -> {
                        // La CMP a été fermée.
                        return Unit.INSTANCE;
                    }
                );
                return Unit.INSTANCE;
            }, () -> {
                // L'initialisation a échouée.
                return Unit.INSTANCE;
            }
        );
    }
}

3. Proposer à vos utilisateurs de consulter leur consentement

Il est également conseillé de fournir à vos utilisateurs une entrée leur permettant de voir et de modifier leur consentement, comme un écran de configuration.

INFO

class SecondActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_second)

        findViewById<View>(R.id.button_display_privacy_policy).setOnClickListener {
            try {
                SFBX.getInstance()
            } catch (e: Exception) {
                null
            }?.displayLayer2(
                this@SecondActivity,
                onCmpDisplayed = {
                    // La CMP est affichée à vos utilisateurs.
                },
                onCmpNotDisplayed = {
                    // La CMP ne s'est pas affichée.
                },
                onCmpClosed = {
                    // La CMP a été fermée.
                },
            )
        }
    }
}

public class SecondActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        findViewById(R.id.button_display_privacy_policy).setOnClickListener(v -> {
            SFBX.getInstance().displayLayer2(
                this,
                () -> {
                    // La CMP est affichée à vos utilisateurs.
                    return Unit.INSTANCE;
                },
                () -> {
                    // La CMP ne s'est pas affichée.
                    return Unit.INSTANCE;
                },
                () -> {
                    // La CMP a été fermée.
                    return Unit.INSTANCE;
                }
            );
        });
    }
}

PrécédentÉtape 2 : Dépendance SuivantComment utiliser le SDK ?

Mis à jour il y a 3 mois

hashtagComment utiliser notre SDK ?

hashtag1. Obtenez votre AppKey

hashtag2. Créez l'instance de Appconsent & l'utiliser

hashtag3. Proposer à vos utilisateurs de consulter leur consentement

Comment utiliser notre SDK ?

1. Obtenez votre AppKey

2. Créez l'instance de Appconsent & l'utiliser

3. Proposer à vos utilisateurs de consulter leur consentement