A/B-Test mit Vermittlungsgruppen

Mit der AdMob API können Sie A/B-Tests für die Vermittlung erstellen, um Ihre Anzeigen zu optimieren verschiedene Konfigurationen testen. Mit einem A/B-Test können Sie zwei Varianten einer Vermittlungsgruppe, um die Ergebnisse nebeneinander zu vergleichen, und wählen Sie eine bevorzugte Konfiguration aus.

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 andere Vermittlungsabfolge verwenden, indem Sie den manuellen eCPM-Wert einer Anzeige ändern Quellen
  • Optimierung von abfolgebasierten Anzeigenquellen aktivieren oder deaktivieren
  • Die Anzahl der Aufrufe einer Anzeigenquelle ändern

Beispiele

Beginnen Sie mit einer bestehenden Vermittlungsgruppe und erstellen Sie eine Variante davon, um (A oder B) besser abschneidet. Beim Test werden die Nutzer Ihrer App aufgeteilt der bestehenden Vermittlungsgruppe und der Variante zu vergleichen. (1%, 10 % oder 50%), den Sie angeben.

curl (Befehlszeile)

Anfragen mit curl

  1. Clientschlüsseldatei laden und Autorisierung generieren Anmeldedaten

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine zur Autorisierung aufgefordert. Bevor Sie zustimmen, vergewissern Sie sich, dass Sie Sie müssen mit einem Google-Konto angemeldet sein, das Zugriff auf die AdMob API hat. Ihr App autorisiert, im Namen des Kontos auf Daten zuzugreifen, aktuell angemeldet sind.

    Zur Authentifizierung und Autorisierung empfehlen wir die Verwendung von oauth2l ist ein einfaches Befehlszeilentool für mit Google OAuth 2.0. Installieren Sie oauth2l und führen Sie den folgenden Befehl aus: Ersetzen von path_to_credentials_json durch einen Pfad zu einem credentials.json-Datei, die Sie bei der Cloud-Registrierung herunterladen Bei der ersten Ausführung führt der Befehl Sie durch OAuth 2.0 Autorisierungsablauf. Bei nachfolgenden Ausführungen wird das Token automatisch aktualisiert.

    oauth2l header --json path_to_credentials_json --scope admob.monetization,admob.readonly
    
  2. Erstellen Sie einen A/B-Test mit Vermittlungsgruppen.

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihren 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 treatmentTrafficPercentage, Die Funktion controlMediationLines werden von der übergeordneten Vermittlungsgruppe übernommen. angegeben ist.

    Mit der folgenden Anfrage wird ein A/B-Test mit Vermittlungsgruppen erstellt, bei dem der Testvariante, auch als Variante B bezeichnet, eine einzelne Vermittlung für das AdMob-Werbenetzwerk LIVE-Modus.

    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

    Hier sehen Sie die Beispielantwort unten, wobei SSSSSSSSSSSSSSSSSSSSSS für die erstellte A/B-Test-ID mit Vermittlungsgruppen. YYYYYYYYYY steht für den die letzten 10 Ziffern Ihres Anzeigenblocks ID im folgenden 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. Prüfen Sie, ob der A/B-Test mit Vermittlungsgruppen ausgeführt wird.

    Anruf accounts.mediationGroups:list um den Status des A/B-Tests für diese Vermittlungsgruppe abzurufen. Weitere Informationen finden Sie unter Vermittlungsgruppen für weitere Informationen Details.

    Die mediationAbExperimentState ist für aktive A/B-Tests mit Vermittlungsgruppen auf RUNNING festgelegt und NOT_RUNNING 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 mit Vermittlungsgruppen und wählen Sie eine Variante aus.

    Ersetzen Sie pub-XXXXXXXXXXXXXXXX durch Ihren 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 zum Abschließen des Tests in der Anfrage die beste Variante an:

    • VARIANT_CHOICE_A: Verwenden Sie die Vermittlungszeilen aus Variante A und schließen Sie den zu testen. Variante A enthält die ursprünglichen Auslieferungszeilen vor dem Testerstellung.
    • VARIANT_CHOICE_B: Verwenden Sie die Vermittlungszeilen aus Variante B und füllen Sie zu testen. Variante B enthält die neu hinzugefügten Zeilen zur Auslieferung.

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