A/B-Test mit Vermittlungsgruppen

Mit der AdMob API können Sie A/B-Tests für die Vermittlung erstellen, um die Anzeigenleistung durch Tests verschiedener Konfigurationen zu maximieren. Mit einem A/B-Test können Sie zwei Varianten einer Vermittlungsgruppe auswerten, um die Ergebnisse nebeneinander zu vergleichen und eine bevorzugte Konfiguration auszuwählen.

Hier sind einige Beispiele für Tests, die Sie einrichten können:

  • Anzeigenquellen hinzufügen oder entfernen, um zu sehen, wie sie sich auf Ihre Vermittlungsgruppe auswirken
  • Eine unterschiedliche Vermittlungsabfolge verwenden, indem Sie den manuellen eCPM-Wert von Anzeigenquellen ändern
  • Das Optimieren von abfolgebasierten Anzeigenquellen aktivieren oder deaktivieren
  • Die Anzahl der Aufrufe einer Anzeigenquelle ändern

Beispiele

Dazu erstellen Sie eine Variante einer bereits bestehenden Vermittlungsgruppe, um zu ermitteln, womit Sie die besseren Ergebnisse erzielen. Beim Test werden die Nutzer Ihrer App anhand eines von Ihnen angegebenen Prozentsatzes (1%, 10 % oder 50%) zwischen den ursprünglichen Einstellungen für Ihre Vermittlungsgruppen und der Variante aufgeteilt.

curl (Befehlszeile)

Anfragen mit curl

  1. Clientschlüsseldatei laden und Autorisierungsanmeldedaten generieren:

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie die Einladung annehmen, müssen Sie sich mit einem Google-Konto anmelden, das Zugriff auf die AdMob API hat. Ihre App erhält die Berechtigung, im Namen des jeweils angemeldeten Kontos auf Daten zuzugreifen.

    Für die Authentifizierung und Autorisierung empfehlen wir die Verwendung von oauth2l, einem einfachen Befehlszeilentool für die Arbeit mit Google OAuth 2.0. Installieren Sie oauth2l und führen Sie den folgenden Befehl aus. Ersetzen Sie path_to_credentials_json durch einen Pfad zu einer credentials.json-Datei, die Sie beim Registrieren Ihrer Cloud-App herunterladen. Beim ersten Ausführen des Befehls werden Sie durch den OAuth 2.0-Autorisierungsvorgang geführt. Bei nachfolgenden Ausführungen wird das Token automatisch aktualisiert.

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

  2. A/B-Test für die Vermittlung erstellen

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID und ZZZZZZZZZZ durch Ihre Vermittlungsgruppen-ID. Die Vermittlungsgruppen-ID finden Sie in der AdMob-Benutzeroberfläche oder mit der Methode accounts.mediationGroups:list.

    Sie müssen die treatmentMediationLines und die treatmentTrafficPercentage angeben. Die controlMediationLines werden jedoch von der übergeordneten Vermittlungsgruppe übernommen und müssen nicht angegeben werden.

    Mit der folgenden Anfrage wird ein A/B-Test für die Vermittlung erstellt, bei dem die Behandlungsvariante (auch als Variante B bezeichnet) eine einzelne Vermittlungszeile für das AdMob-Werbenetzwerk im Modus LIVE enthält.

    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

    Im folgenden Beispielantwort sehen Sie, dass SSSSSSSSSSSSSSSSSSSSSS die ID des erstellten A/B-Tests für die Vermittlung und YYYYYYYYYY die letzten 10 Ziffern Ihrer Anzeigenblock-ID im Format ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY darstellt.

    {
  "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. Prüfen Sie, ob der A/B-Test mit Vermittlungsgruppen ausgeführt wird.

    Rufen Sie accounts.mediationGroups:list auf, um den Status des A/B-Tests für die Vermittlung für diese Vermittlungsgruppe abzurufen. Weitere Informationen

    Der Wert für mediationAbExperimentState ist für aktive A/B-Tests mit Vermittlungsgruppen auf RUNNING und auf NOT_RUNNING gesetzt, wenn in der Vermittlungsgruppe kein Test ausgeführt wird.

    Beispielanfrage:

     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. Beenden Sie den A/B-Test für die Vermittlung und wählen Sie eine Variante aus.

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihre Publisher-ID und ZZZZZZZZZZ durch Ihre Vermittlungsgruppen-ID. Die Vermittlungsgruppen-ID finden Sie in der AdMob-Benutzeroberfläche oder mit der Methode accounts.mediationGroups:list.

    Geben Sie die Variante mit den besten Ergebnissen in der Anfrage an, um den Test abzuschließen:

    • VARIANT_CHOICE_A: Verwenden Sie die Vermittlungsgruppen aus Variante A und schließen Sie den Test ab. Variante A enthält die ursprünglichen Serving-Zeilen vor der Erstellung des Tests.
    • VARIANT_CHOICE_B: Verwenden Sie die Vermittlungslinien aus Variante B und schließen Sie den Test ab. Variante B enthält die neu hinzugefügten Serving-Zeilen.

    Beispielanfrage:

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

    Beispielantwort:

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