Test A/B de médiation

L'API AdMob peut créer des tests A/B de médiation pour maximiser 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 sélectionnez la configuration de votre choix.

Voici des exemples de tests que vous pouvez configurer:

  • Ajouter ou supprimer des sources d'annonces pour voir leur impact sur votre groupe de médiation
  • Utiliser un ordre de cascade d'annonces différent en modifiant manuellement la valeur d'eCPM de l'annonce sources
  • Activer ou désactiver l'optimisation des sources d'annonces participant à la cascade d'annonces
  • Modifier le nombre d'appels d'une source d'annonces

Exemples

Commencez avec un groupe de médiation existant et créez-en une variante la variante A ou B la plus performante. Le test répartit les utilisateurs de votre application entre la configuration de votre groupe de médiation existant et la variante, en fonction d'une pourcentage (1%, 10 % ou 50%) que vous fournissez.

curl (ligne de commande)

Requêtes utilisant curl

  1. Chargez le fichier de secrets client et générez une autorisation. à l'aide de ces identifiants.

    La première fois que vous effectuez cette étape, vous êtes invité à accepter un dans votre navigateur. Avant d'accepter, vérifiez que vous êtes connecté à l'aide d'un compte Google ayant accès à l'API AdMob ; Votre application est 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 avec Google OAuth 2.0. Installez oauth2l et exécutez la commande ci-dessous : en remplaçant path_to_credentials_json par un chemin d'accès credentials.json que vous téléchargez lors de l'enregistrement de votre cloud l'application. Lors de la première exécution, la commande vous guide tout au long du processus d'autorisation. Les exécutions suivantes actualisent le jeton automatiquement.

    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 éditeur. ID et ZZZZZZZZZZ par votre ID du groupe de médiation. Vous trouverez l'ID du groupe de médiation dans l'interface utilisateur d'AdMob ou à l'aide de la commande accounts.mediationGroups:list .

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

    La demande suivante crée un test A/B de médiation dans lequel La variante de traitement, également appelée variante B, contient une seule médiation pour le réseau AdMob en utilisant 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 bloc d'annonces ID, conformément au format suivant: 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.

    Appeler accounts.mediationGroups:list afin d'obtenir l'état du test A/B de ce groupe de médiation. Voir les groupes de médiation pour en savoir plus plus de détails.

    La mediationAbExperimentState est défini sur RUNNING pour les tests A/B de médiation actifs et 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 médiation et sélectionnez une variante.

    Remplacez pub-XXXXXXXXXXXXXXXX par votre éditeur. ID et ZZZZZZZZZZ par votre ID du groupe de médiation. Vous trouverez l'ID du groupe de médiation dans l'interface utilisateur d'AdMob ou à l'aide de la commande accounts.mediationGroups:list .

    Pour terminer le test, spécifiez la variante gagnante dans la demande:

    • 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 la création d'un test.
    • VARIANT_CHOICE_B: utilisez les lignes de médiation de la variante B et complétez le test. La variante B contient les nouvelles lignes de diffusion.

    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",
}