Intégrer Chartboost à la médiation

Ce guide vous explique comment utiliser le SDK Google Mobile Ads pour charger et afficher des annonces de Chartboost à l'aide de la médiation et de laintégration de cascade. Il explique comment ajouter Chartboost à la configuration de la médiation d'un bloc d'annonces, et comment intégrer le SDK et l'adaptateur Chartboost dans une application Android .

Intégrations et formats d'annonces compatibles

L'adaptateur de médiation pour Chartboost présente les fonctionnalités suivantes :

Conditions requises

• Niveau d'API Android 21 ou supérieur

• Dernière version du SDK Google Mobile Ads

• Suivez le guide de démarrage de la médiation.

Étape 1 : Configurer les configurations dans l'interface utilisateur de Chartboost

Créez un compte Chartboost, puis connectez-vous une fois votre compte validé. Accédez ensuite à l'onglet Gestion des applications.

Cliquez sur le bouton Add new app (Ajouter une application) pour créer votre application.

Remplissez le reste du formulaire, puis cliquez sur le bouton Ajouter une application pour finaliser votre application.

Une fois votre application créée, vous êtes redirigé vers son tableau de bord. Notez l'ID et la signature de l'application de votre application.

AdMob nécessite l'ID utilisateur et la signature utilisateur Chartboost pour configurer votre ID de bloc d'annonces AdMob. Pour accéder à ces paramètres, cliquez sur Chartboost médiation (Médiation Chartboost) dans l'interface utilisateur Chartboost.

Accédez à l'onglet Resources > API Explorer (Ressources > API Explorer) et notez votre ID utilisateur et votre Signature utilisateur situés dans la section Authentication (Authentification).

Activer le mode test

Pour activer le mode test sur votre application, accédez à l'onglet Apps management (Gestion des applications) de l'interface utilisateur de Chartboost, sélectionnez votre application dans la liste et cliquez sur Edit app settings (Modifier les paramètres de l'application).

Dans les paramètres de votre application, vous pouvez activer le mode test.

Une fois le mode test activé, vous pouvez demander des annonces à l'aide de l'ID de bloc d'annonces créé précédemment et recevoir une annonce test Chartboost.

Une fois que vous pourrez recevoir des annonces de test Chartboost, votre application sera placée dans l'examen de l'application de l'éditeur de Chartboost. Pour que la monétisation sur Chartboost fonctionne, l'examen de l'application de l'éditeur doit être approuvé par Chartboost.

Étape 2 : Configurez la demande Chartboost dans l'interface utilisateur de Ad Manager

Ajouter Chartboost à la liste des partenaires publicitaires concernant le RGPD et les réglementations des États américains

Suivez la procédure décrite dans les sections Paramètres liés au RGPD et Paramètres liés aux réglementations dans les États américains pour ajouter Chartboost à la liste des partenaires publicitaires conformes au RGPD et aux réglementations dans les États américains dans l'UI d'AdMob.

Étape 3 : Importer le SDK et l'adaptateur Chartboost

Intégration d'Android Studio (recommandée)

Dans le fichier settings.gradle.kts au niveau du projet, ajoutez les dépôts suivants :

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://cboost.jfrog.io/artifactory/chartboost-ads/")
    }
  }
}

Ensuite, dans le fichier build.gradle.kts au niveau de l'application, ajoutez les dépendances et configurations d'implémentation suivantes. Utilisez les dernières versions du SDK et de l'adaptateur Chartboost:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:chartboost:9.7.0.0")
}

Intégration manuelle

1. Téléchargez le fichier .aar de la dernière version du SDK Chartboost depuis Maven Central, puis ajoutez-le à votre projet.

2. Accédez aux artefacts de l'adaptateur Chartboost dans le dépôt Maven de Google. Sélectionnez la dernière version, téléchargez le fichier .aar de l'adaptateur Chartboost et ajoutez-le à votre projet.

Étape 4 : Implémenter les paramètres de confidentialité sur le SDK Chartboost

Consentement des utilisateurs de l'UE et RGPD

Conformément aux Règles de Google relatives au consentement de l'utilisateur dans l'UE, vous devez vous assurer que certaines informations sont communiquées aux utilisateurs de l'Espace économique européen (EEE) et que leur consentement est obtenu concernant l'utilisation des identifiants d'appareil et des données à caractère personnel. Ces règles reflètent les exigences de la directive vie privée et communications électroniques de l'UE, et celles du Règlement général sur la protection des données (RGPD). Lorsque vous demandez le consentement, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de collecter, de recevoir ou d'utiliser des données à caractère personnel, et fournir des informations sur l'utilisation de chaque réseau. Google n'est actuellement pas en mesure de transmettre automatiquement le choix de l'utilisateur concernant ces réseaux.

Dans la version 8.1.0 du SDK, Chartboost a ajouté la méthode addDataUseConsent(). L'exemple de code suivant définit le consentement à l'utilisation des données sur NON_BEHAVIORAL. Si vous choisissez d'appeler cette méthode, nous vous recommandons de le faire avant de demander des annonces via le SDK Google Mobile Ads.

DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)

Pour en savoir plus et connaître les valeurs pouvant être fournies dans chaque méthode, consultez l'article sur le RGPD de Chartboost et ses méthodes de confidentialité Android .

Lois sur la confidentialité dans les États américains

Lois sur la confidentialité dans les États américains exigent d'offrir aux utilisateurs le droit de s'opposer à la "vente" de leurs "informations personnelles" (selon la définition de ces termes par la loi). Cette possibilité doit être proposée via un lien bien visible indiquant "Do Not Sell My Personal Information" (Ne pas vendre mes informations personnelles) et figurant sur la page d'accueil de l'entreprise (le "vendeur"). Le guide de conformité aux lois sur la confidentialité dans les États américains permet d'activer le traitement restreint des données pour la diffusion d'annonces Google, mais Google ne peut pas appliquer ce paramètre à chaque réseau publicitaire de votre chaîne de médiation. Par conséquent, vous devez identifier chaque réseau publicitaire de votre chaîne de médiation susceptible de participer à la vente d'informations personnelles et suivre les consignes de chacun de ces réseaux pour garantir la conformité.

Dans la version 8.1.0 du SDK, Chartboost a ajouté la méthode addDataUseConsent(). L'exemple de code suivant définit le consentement à l'utilisation des données sur OPT_IN_SALE. Si vous choisissez d'appeler cette méthode, nous vous recommandons de le faire avant de demander des annonces via le SDK Google Mobile Ads.

DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);

val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)

Pour en savoir plus et connaître les valeurs pouvant être fournies dans chaque méthode, consultez l'article de Chartboost sur la loi CPPA et les méthodes de confidentialité Android .

Étape 5 : Ajoutez le code requis

Modifier AndroidManifest

Autres éléments

Ajoutez l'attribut suivant à chaque activité du fichier AndroidManifest.xml qui affichera des annonces Chartboost et sera compatible avec différentes orientations:

android:configChanges="keyboardHidden|orientation|screenSize"

Événements liés au cycle de vie

Conformément aux recommandations de Chartboost, ajoutez le code suivant à tous les événements de cycle de vie de votre activité qui diffuseront des annonces Chartboost.

import com.chartboost.sdk.Chartboost;
// ...

@Override
public void onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed()) {
        return;
    } else {
        super.onBackPressed();
    }
}

import com.chartboost.sdk.Chartboost
// ...

@Override
fun onBackPressed() {
    // If an interstitial is on screen, close it.
    if (Chartboost.onBackPressed())
        return
    else
        super.onBackPressed()
}

Étape 6: Testez votre implémentation

Étapes facultatives

Autorisations

Pour des performances optimales, Chartboost recommande d'ajouter les autorisations facultatives suivantes au fichier AndroidManifest.xml de votre application :

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

Codes d'erreur

Si l'adaptateur ne parvient pas à recevoir une annonce de Chartboost, vous pouvez vérifier l'erreur sous-jacente de la réponse de l'annonce à l'aide de,, ResponseInfo.getAdapterResponses() etdans les classes suivantes :

com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter

Voici les codes et les messages associés générés par l'adaptateur Chartboost en cas d'échec du chargement d'une annonce:

Journal des modifications de l'adaptateur de médiation Android Chartboost

Version 9.7.0.0

• Vérification de la compatibilité avec la version 9.7.0 du SDK Chartboost.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 23.0.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 23.0.0
• Version du SDK Chartboost 9.7.0.

Version 9.6.1.0

• Compatibilité vérifiée avec la version 9.6.1 du SDK Chartboost.

Compilé et testé avec :

• SDK Google Mobile Ads 22.6.0
• Version du SDK Chartboost 9.6.1

Version 9.6.0.0

• Compatibilité vérifiée avec la version 9.6.0 du SDK Chartboost.

Compilé et testé avec :

• SDK Google Mobile Ads version 22.5.0
• Version du SDK Chartboost 9.6.0.

Version 9.5.0.0

• Compatibilité vérifiée avec le SDK Chartboost version 9.5.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 22.3.0
• Version du SDK Chartboost 9.5.0.

Version 9.4.1.0

• Compatibilité vérifiée avec le SDK Chartboost version 9.4.1.

Compilé et testé avec :

• SDK Google Mobile Ads 22.2.0
• SDK Chartboost 9.4.1.

Version 9.4.0.0

• Compatibilité vérifiée avec le SDK Chartboost version 9.4.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 22.1.0.
• Version du SDK Chartboost 9.4.0.

Version 9.3.1.0

• Vérification de la compatibilité avec la version 9.3.1 du SDK Chartboost.

Compilé et testé avec :

• SDK Google Mobile Ads version 22.1.0
• Version du SDK Chartboost 9.3.1.

Version 9.3.0.0

• Compatibilité vérifiée avec le SDK Chartboost version 9.3.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 22.0.0
• SDK Chartboost 9.3.0.

Version 9.2.1.1

• Adaptateur mis à jour pour utiliser la nouvelle classe VersionInfo.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 22.0.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 22.0.0
• SDK Chartboost 9.2.1.

Version 9.2.1.0

• Vérification de la compatibilité avec le SDK Chartboost 9.2.1.

Conçu et testé avec:

• SDK Google Mobile Ads version 21.5.0
• Version du SDK Chartboost 9.2.1.

Version 9.2.0.0

• Compatibilité vérifiée avec le SDK Chartboost 9.2.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 21.5.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 21.5.0
• Version du SDK Chartboost 9.2.0.

Version 9.1.1.0

• Ajout de la méthode ChartboostMediationAdapter.setAppParams(String, String) comme moyen facultatif de coder en dur l'ID et la signature d'application à utiliser pour initialiser le SDK Chartboost.
• Compatibilité vérifiée avec le SDK Chartboost 9.1.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 21.3.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 21.3.0
• SDK Chartboost 9.1.1.

Version 8.4.3.1

• La version minimale requise du SDK Google Mobile Ads est désormais la version 21.0.0.
• Mise à jour du niveau d'API Android minimal requis vers la version 19.

Compilé et testé avec :

• SDK Google Mobile Ads version 21.0.0
• SDK Chartboost 8.4.3.

Version 8.4.3.0

• Compatibilité vérifiée avec le SDK Chartboost 8.4.3.

Compilé et testé avec :

• SDK Google Mobile Ads 20.6.0
• Version du SDK Chartboost 8.4.3

Version 8.4.2.0

• Compatibilité vérifiée avec le SDK Chartboost 8.4.2.
• Mise à jour de compileSdkVersion et targetSdkVersion vers l'API 31.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.6.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 20.6.0
• Version du SDK Chartboost 8.4.2

Version 8.4.1.0

• Compatibilité vérifiée avec le SDK Chartboost 8.4.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.6.0.

Compilé et testé avec :

• SDK Google Mobile Ads 20.6.0
• Version du SDK Chartboost 8.4.1

Version 8.3.1.0

• Compatibilité vérifiée avec le SDK Chartboost 8.3.1.
• Mise à jour de l'adaptateur pour qu'il utilise la nouvelle API AdError.

Compilé et testé avec :

• Version 20.5.0 du SDK Google Mobile Ads
• SDK Chartboost 8.3.1.

Version 8.3.0.0

• Compatibilité vérifiée avec le SDK Chartboost 8.3.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 20.5.0.

Compilé et testé avec :

• Version 20.5.0 du SDK Google Mobile Ads
• Version du SDK Chartboost 8.3.0.

Version 8.2.1.0

• Vérification de la compatibilité avec le SDK Chartboost 8.2.1.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.1.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 20.1.0
• Version du SDK Chartboost 8.2.1

Version 8.2.0.1

• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 20.0.0.

Compilé et testé avec :

• Version 20.0.0 du SDK Google Mobile Ads
• Version du SDK Chartboost 8.2.0.

Version 8.2.0.0

• Compatibilité vérifiée avec le SDK Chartboost 8.2.0.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads : 19.5.0.

Compilé et testé avec :

• SDK Google Mobile Ads version 19.5.0.
• Version du SDK Chartboost 8.2.0.

Version 8.1.0.0

• Compatibilité vérifiée avec le SDK Chartboost 8.1.0.

Conçu et testé avec:

• SDK Google Mobile Ads 19.2.0
• Version du SDK Chartboost 8.1.0.

Version 8.0.3.2

• Ajout de codes d'erreur descriptifs et de motifs pour les échecs de chargement et d'affichage de l'adaptateur.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.2.0.

Compilé et testé avec :

• SDK Google Mobile Ads 19.2.0
• Version du SDK Chartboost 8.0.3.

Version 8.0.3.1

• Ajout de la prise en charge des bannières publicitaires Chartboost.

Conçu et testé avec:

• SDK Google Mobile Ads 19.1.0
• SDK Chartboost 8.0.3.

Version 8.0.3.0

• Compatibilité vérifiée avec le SDK Chartboost 8.0.3.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.1.0.

Compilé et testé avec :

• SDK Google Mobile Ads 19.1.0
• Version du SDK Chartboost 8.0.3.

Version 8.0.2.0

• Compatibilité vérifiée avec le SDK Chartboost 8.0.2.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 19.0.1.

Compilé et testé avec :

• SDK Google Mobile Ads 19.0.1
• SDK Chartboost 8.0.2.

Version 8.0.1.0

• Compatibilité vérifiée avec le SDK Chartboost 8.0.1.
• Nécessite le SDK Chartboost 8.0.1 ou version ultérieure.
• Le contexte de l'activité n'est plus nécessaire pour charger les annonces.

Compilé et testé avec :

• SDK Google Mobile Ads version 18.3.0
• SDK Chartboost 8.0.1.

Version 7.5.0.1

• Correction d'un bug qui empêchait l'adaptateur Chartboost d'invoquer des événements d'annonce.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.3.0.

Conçu et testé avec:

• SDK Google Mobile Ads version 18.3.0
• Version du SDK Chartboost 7.5.0.

Version 7.5.0.0

• Compatibilité vérifiée avec le SDK Chartboost 7.5.0.
• Migration de l'adaptateur pour utiliser les dépendances AndroidX.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 18.1.1.

Version 7.3.1.1

• Mise à jour de l'adaptateur pour prendre en charge la nouvelle API Rewarded en version bêta ouverte.
• Mise à jour de la version minimale requise du SDK Google Mobile Ads vers la version 17.2.0.

Version 7.3.1.0

• Compatibilité vérifiée avec le SDK Chartboost 7.3.1.

Version 7.3.0.0

• Compatibilité vérifiée avec le SDK Chartboost 7.3.0.

Version 7.2.1.0

• Compatibilité vérifiée avec le SDK Chartboost 7.2.1.

Version 7.2.0.1

• L'adaptateur a été mis à jour pour appeler l'événement d'annonce onRewardedVideoComplete().

Version 7.2.0.0

• Compatibilité vérifiée avec le SDK Chartboost 7.2.0.

Version 7.1.0.0

• Compatibilité vérifiée avec le SDK Chartboost 7.1.0.

Version 7.0.1.0

• Vérification de la compatibilité avec le SDK Chartboost 7.0.1.
• Ajout de la compatibilité avec les nouveaux codes d'erreur Chartboost.
• Mise à jour du projet d'adaptateur pour Android Studio 3.0

Version 7.0.0.0

• Mise à jour de l'adaptateur pour le rendre compatible avec le SDK Chartboost 7.0.0.

Version 6.6.3.0

• Vérification de la compatibilité avec le SDK Chartboost 6.6.3.

Version 6.6.2.0

• Compatibilité vérifiée avec le SDK Chartboost 6.6.2.

Version 6.6.1.0

• Compatibilité vérifiée avec le SDK Chartboost 6.6.1.

Version 6.6.0.0

• Modification du système de dénomination des versions pour le remplacer par [version du SDK Chartboost].[version du correctif de l'adaptateur].
• Vous pouvez désormais ajouter les adaptateurs en tant que dépendance de compilation en insérant ce qui suit dans la balise de dépendances du fichier build.gradle : compile 'com.google.ads.mediation:chartboost:6.6.0.0'
• Déplacé vers la distribution de l'adaptateur sous forme de fichier AAR au lieu de fichier JAR (consultez le fichier README pour obtenir des instructions supplémentaires).

Version 1.1.0

• Suppression de la zone géographique de l'annonce Chartboost des extras Chartboost. L'emplacement de l'annonce est désormais spécifié dans la console AdMob lorsque vous configurez Chartboost pour la médiation.

Version 1.0.0

• Version initiale. Compatible avec les annonces vidéo avec récompense et les annonces interstitielles.