Test A/B de médiation

L'API AdMob peut créer des tests A/B de médiation pour maximiser les performances de vos annonces en testant différentes configurations. Un test A/B vous permet d'évaluer deux variantes d'un groupe de médiation pour comparer les résultats côte à côte et sélectionner une configuration préférée.

Voici des exemples de tests que vous pouvez configurer :

  • Ajoutez ou supprimez des sources d'annonces pour voir leur impact sur votre groupe de médiation.
  • Utilisez un ordre de cascade d'annonces différent en modifiant manuellement la valeur de l'eCPM des sources d'annonces.
  • Activer ou désactiver l'optimisation des sources d'annonces participant à la cascade d'annonces
  • Modifier le nombre de fois qu'une source d'annonce est appelée

Exemples

Commencez par un groupe de médiation existant et créez-en une variante pour voir laquelle des variantes A ou B est la plus performante. Le test répartit les utilisateurs de votre application entre votre groupe de médiation existant et la variation, en fonction d'un pourcentage (1%, 10 % ou 50%) que vous indiquez.

curl (ligne de commande)

Requêtes utilisant curl

  1. Chargez le fichier de code secret du client et générez les identifiants d'autorisation.

    La première fois que vous effectuez cette étape, vous êtes invité à accepter une invite d'autorisation dans votre navigateur. Avant d'accepter, assurez-vous d'être connecté avec un compte Google ayant accès à l'API AdMob. Votre application sera autorisée à accéder aux données au nom du compte actuellement connecté.

    Pour l'authentification et l'autorisation, nous vous recommandons d'utiliser oauth2l, un outil de ligne de commande simple pour travailler avec Google OAuth 2.0. Installez oauth2l et exécutez la commande ci-dessous, en remplaçant path_to_credentials_json par le chemin d'accès à un fichier credentials.json que vous téléchargez lorsque vous enregistrez votre application cloud. Lors de la première exécution, la commande vous guide tout au long du flux d'autorisation OAuth 2.0. Les exécutions suivantes actualisent automatiquement le jeton.

    oauth2l header --json path_to_credentials_json --scope admob.monetization,admob.readonly

  2. Créez un test A/B de médiation.

    Remplacez pub-XXXXXXXXXXXXXXXX par votre ID d'éditeur et ZZZZZZZZZZ par l'ID de votre groupe de médiation. Vous trouverez l'ID du groupe de médiation dans l'UI AdMob ou en utilisant la méthode accounts.mediationGroups:list.

    Vous devez spécifier treatmentMediationLines et treatmentTrafficPercentage. Toutefois, controlMediationLines est hérité du groupe de médiation parent et n'a pas besoin d'être spécifié.

    La requête suivante crée un test A/B de médiation dans lequel la variante de traitement, également appelée variante B, contient une seule ligne de médiation pour le réseau AdMob en mode LIVE.

    curl --http1.0 \
-X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments \
-H "Content-Type:application/json" \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
--data @- << EOF
{
  "displayName":"Mediation A/B Experiment Test Name",
  "treatmentTrafficPercentage": "50",
  "treatmentMediationLines": [{
    "mediationGroupLine": {
      "displayName": "Test mediation group line",
      "adSourceId": "5450213213286189855",
      "cpm_mode": "LIVE"
    }
  }]
}
EOF

    Consultez l'exemple de réponse ci-dessous, où SSSSSSSSSSSSSSSSSSSSSS représente l'ID du test A/B de médiation créé et YYYYYYYYYY représente les 10 derniers chiffres de votre ID de bloc d'annonces, conformément au format ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY.

    {
  "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments/SSSSSSSSSSSSSSSSSSSSSS",
  "displayName": "Mediation A/B Experiment Test Name",
  "experimentId": "SSSSSSSSSSSSSSSSSSSSSS",
  "treatmentTrafficPercentage": "50",
  "treatmentMediationLines": [
    {
      "mediationGroupLine": {
        "id": "11111111111111111",
        "displayName": "Test mediation group line",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "cpmMicros": "10000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
        },
        "state": "ENABLED"
      }
    }
  ],
  "controlMediationLines": [
    {
      "mediationGroupLine": {
        "id": "22222222222222222",
        "displayName": "AdMob Network (control)",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "cpmMicros": "10000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/
        },
        "state": "ENABLED"
      }
    }
  ],
  "state": "RUNNING"
}

  3. Vérifiez que le test A/B de médiation est en cours d'exécution.

    Appelez accounts.mediationGroups:list pour obtenir l'état du test A/B de médiation pour ce groupe de médiation. Pour en savoir plus, consultez le guide sur les groupes de médiation.

    La valeur de mediationAbExperimentState est définie sur RUNNING pour les tests A/B de médiation actifs et sur NOT_RUNNING si aucun test n'est en cours dans le groupe de médiation.

    Exemple de requête :

     curl --http1.0 \
-X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

  4. Arrêtez le test A/B de la médiation et sélectionnez une variante.

    Remplacez pub-XXXXXXXXXXXXXXXX par votre ID d'éditeur et ZZZZZZZZZZ par l'ID de votre groupe de médiation. Vous trouverez l'ID du groupe de médiation dans l'UI AdMob ou en utilisant la méthode accounts.mediationGroups:list.

    Pour terminer le test, spécifiez la variante gagnante dans la requête :

    • VARIANT_CHOICE_A : utilisez les lignes de médiation de la variante A et terminez le test. La variante A contient les lignes de diffusion d'origine avant la création du test.
    • VARIANT_CHOICE_B : utilisez les lignes de médiation de la variante B et terminez le test. La variante B contient les lignes de service nouvellement ajoutées.

    Exemple de requête :

     curl --http1.0 \
-X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ/mediationAbExperiments:stop \
-H "Content-Type:application/json" \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
--data @- << EOF
{
"variantChoice": "VARIANT_CHOICE_A"
}

    Exemple de réponse :

    {
"experimentId": "SSSSSSSSSSSSSSSSSSSSSS",
"state": "EXPIRED",
}