Esperimento A/B di mediazione

L'API AdMob può creare esperimenti A/B di mediazione per massimizzare i tuoi annunci. le prestazioni testando varie configurazioni. Un test A/B ti consente di valutare due varianti di un gruppo di mediazione per confrontare i risultati seleziona una configurazione preferita.

Ecco alcuni esempi di esperimenti che puoi configurare:

  • Aggiungere o rimuovere origini annuncio per vederne l'impatto sul gruppo di mediazione
  • Utilizzare un ordine a cascata diverso modificando il valore eCPM manuale dell'annuncio fonti
  • Attivare o disattivare l'ottimizzazione nelle 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 il 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%) da te specificata.

curl (riga di comando)

Richieste mediante curl

  1. Carica il file dei client secret e genera l'autorizzazione e le credenziali.

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

    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 in basso. sostituendo path_to_credentials_json con un percorso a File credentials.json scaricato durante la registrazione del cloud dell'app. Per la prima esecuzione, il comando ti guida nella procedura di OAuth 2.0 flusso di autorizzazione. Le esecuzioni successive aggiornano il token automaticamente.

    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 publisher ID e ZZZZZZZZZZ con il tuo ID gruppo di mediazione. L'ID gruppo di mediazione è disponibile nell'interfaccia utente di AdMob oppure utilizzando accounts.mediationGroups:list .

    Devi specificare treatmentMediationLines e treatmentTrafficPercentage, tuttavia, controlMediationLines sono ereditati dal gruppo di mediazione padre e non devono essere specificato.

    La seguente richiesta crea un esperimento A/B di mediazione in cui La variante sperimentale, nota anche come variante B, contiene una singola mediazione per la Rete AdMob utilizzando 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

    Guarda la risposta di esempio di seguito, dove SSSSSSSSSSSSSSSSSSSSSS rappresenta l'ID esperimento A/B di mediazione creato e YYYYYYYYYY rappresenta ultime 10 cifre dell'unità pubblicitaria ID, conforme 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 conoscere lo stato dell'esperimento A/B di mediazione per quel gruppo di mediazione. Consulta i gruppi di mediazione guida per saperne di più i dettagli.

    La mediationAbExperimentState è impostato su RUNNING per gli esperimenti A/B di mediazione attivi e 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 publisher ID e ZZZZZZZZZZ con il tuo ID gruppo di mediazione. L'ID gruppo di mediazione è disponibile nell'interfaccia utente di AdMob oppure utilizzando 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 la l'esperimento. La variante A contiene le righe di pubblicazione originali prima del sulla creazione dell'esperimento.
    • VARIANT_CHOICE_B: utilizza le righe di mediazione della Variante B e compila 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",
}