Esperimento A/B di mediazione

L'API AdMob può creare esperimenti A/B di mediazione per massimizzare il rendimento degli annunci testando varie configurazioni. Un test A/B ti consente di valutare due varianti di un gruppo di mediazione per confrontare i risultati fianco a fianco e selezionare una configurazione preferita.

Ecco alcuni esempi di esperimenti che puoi configurare:

  • Aggiungere o rimuovere origini annuncio per constatarne l'impatto sul gruppo di mediazione.
  • Utilizzare un ordine con struttura a cascata diverso modificando il valore eCPM manuale delle origini annuncio.
  • Attivare o disattivare l'ottimizzazione per le origini annuncio con struttura a cascata.
  • Modificare il numero di volte in cui un'origine annuncio viene chiamata.

Esempi

Inizia con un gruppo di mediazione esistente e creane una variante per vedere quale variante, A o B, ha un rendimento migliore. Il test suddivide gli utenti della tua app tra la configurazione esistente del gruppo di mediazione e la variante, in base a una percentuale (1%, 10% o 50%) che fornisci.

curl (riga di comando)

Richieste che utilizzano curl

  1. Carica il file client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questo passaggio, ti viene chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che abbia accesso all'API AdMob. La tua app sarà autorizzata ad accedere ai dati per conto dell'account attualmente connesso.

    Per l'autenticazione e l'autorizzazione, ti consigliamo di utilizzare oauth2l, un semplice strumento a riga di comando per lavorare con Google OAuth 2.0. Installa oauth2l ed esegui il comando riportato di seguito, sostituendo path_to_credentials_json con un percorso a un file credentials.json che scarichi quando registri la tua app cloud. Per la prima esecuzione, il comando ti guida nel flusso di autorizzazione OAuth 2.0. Le esecuzioni successive aggiornano automaticamente il token.

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

  2. Crea un esperimento A/B di mediazione.

    Sostituisci pub-XXXXXXXXXXXXXXXX con il tuo ID publisher e ZZZZZZZZZZ con il tuo ID gruppo di mediazione. L'ID gruppo di mediazione si trova nell'interfaccia utente di AdMob o utilizzando il metodo accounts.mediationGroups:list.

    Devi specificare treatmentMediationLines e treatmentTrafficPercentage, tuttavia, controlMediationLines vengono ereditati dal gruppo di mediazione principale e non devono essere specificati.

    La seguente richiesta crea un esperimento A/B di mediazione in cui la variante di trattamento, nota anche come variante B, contiene una singola riga di mediazione per la rete AdMob che utilizza la modalità 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

    Vedi la risposta di esempio riportata di seguito, dove SSSSSSSSSSSSSSSSSSSSSS rappresenta l'ID esperimento A/B di mediazione creato e YYYYYYYYYY rappresenta le ultime 10 cifre dell'ID unità pubblicitaria, in conformità al formato: 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. Verifica che l'esperimento A/B di mediazione sia in esecuzione.

    Chiama accounts.mediationGroups:list per ottenere lo stato dell'esperimento A/B di mediazione per quel gruppo di mediazione. Per ulteriori dettagli, consulta la guida ai gruppi di mediazione.

    mediationAbExperimentState è impostato su RUNNING per gli esperimenti A/B di mediazione attivi e su NOT_RUNNING se non è in esecuzione alcun esperimento nel gruppo di mediazione.

    Richiesta di esempio:

     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. Interrompi l'esperimento A/B di mediazione e seleziona una variante.

    Sostituisci pub-XXXXXXXXXXXXXXXX con il tuo ID publisher e ZZZZZZZZZZ con il tuo ID gruppo di mediazione. L'ID gruppo di mediazione si trova nell'interfaccia utente di AdMob o utilizzando il metodo accounts.mediationGroups:list.

    Per completare l'esperimento, specifica la variante vincente nella richiesta:

    • VARIANT_CHOICE_A: utilizza le righe di mediazione della variante A e completa l'esperimento. La variante A contiene le righe di pubblicazione originali prima della creazione dell'esperimento.
    • VARIANT_CHOICE_B: utilizza le righe di mediazione del modulo Variante B e completa l'esperimento. La variante B contiene le righe di pubblicazione appena aggiunte.

    Richiesta di esempio:

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

    Esempio di risposta:

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