Grupos de mediación

La API de AdMob te permite crear, enumerar y actualizar grupos de mediación, incluidos los siguientes:

  • Especificar la segmentación del grupo de mediación incluidas las regiones, el formato, la plataforma y la segmentación del IDFA
  • Agregar nuevas líneas del grupo de mediación a un grupo de mediación existente
  • Consulta qué grupos de mediación forman parte de un experimento A/B de mediación y qué las líneas del grupo de mediación pertenecen a cada variante: A o B.

Ejemplos

Al crear credenciales de OAuth 2.0, tienes todo listo para comenzar a utilizar la API de AdMob. Para solicitar acceso con OAuth 2.0, haz lo siguiente: tu aplicación también necesitará información del alcance.

Esta es la información del alcance de OAuth 2.0:

Alcance Significado
https://www.googleapis.com/auth/admob.monetization Consulta, crea y edita tu configuración de monetización de AdMob.
https://www.googleapis.com/auth/admob.readonly Consulta todos los datos de AdMob. Esto puede incluir información la configuración de inventario y mediación, los informes y otros datos. No se incluyen datos sensibles, como detalles de pagos o campañas.

Crear

Para crear un grupo de mediación, debes especificar la segmentación del grupo de mediación. información, incluidas las unidades de anuncios relevantes. En el siguiente ejemplo, se crea un nuevo grupo de mediación para anuncios intersticiales para Android para 2 unidades de anuncios. Un grupo de mediación se agrega durante la creación para la fuente de anuncios de InMobi. No es necesario incluir la red de AdMob, ya que se agregará en el momento de la creación de forma predeterminada.

En el siguiente fragmento de código, reemplaza pub-XXXXXXXXXXXXXXXX por tu editor. correcto.

Luego, reemplace YYYYYYYYYY por los últimos 10 dígitos de su unidad de anuncios. ID, conforme al formato:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

Como hay dos unidades de anuncios en este ejemplo, YYYYY11111 hace referencia al primer anuncio y WWWWW11111 a la asignación de la primera unidad de anuncios. YYYYY22222 y WWWWW22222 hace referencia a la segunda unidad de anuncios y la asignación de unidades de anuncios.

curl (línea de comandos)

Reemplaza WWWWWWWWWW por tu ID de asignación de unidades de anuncios. El ID de asignación de unidades de anuncios pueden encontrarse mediante accounts.adUnits.adUnitMappings.list .

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

Lista

Reemplaza pub-XXXXXXXXXXXXXXXX por tu editor. ID para ver tus grupos de mediación.

curl (línea de comandos)

Solicitud de muestra:

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups \
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"

Respuesta de muestra:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

Aplicar parche

Esta es la lista de field mascarillas para actualizar un grupo de mediación. Las actualizaciones de campos repetidos, como los elementos de una reemplaza por completo los valores existentes por los nuevos. Actualizaciones individuales en un mapa se puede hacer mediante la indexación con la clave.

Se admiten las siguientes máscaras de campo para las actualizaciones de grupos de mediación:

  • targeting.adUnitIds
  • mediationGroupLines[mediationGroupLineId]
  • mediationGroupLines[mediationGroupLineId].state
  • mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

Para actualizar un grupo de mediación con una nueva línea de grupo de mediación, utilice un grupo diferente, un número negativo para mediationGroupLineId. Cómo actualizar una mediación existente líneas de grupo, hacen referencia al ID de línea del grupo de mediación en los campos update_mask y la carga útil, como se muestra a continuación.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

curl (línea de comandos)

En el siguiente ejemplo, se agregan 3 líneas de mediación nuevas a un grupo de mediación existente. La updateMask incluye las 3 líneas del grupo de mediación con un elemento negativo distinto. como el marcador de posición:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

Debes traducir los caracteres especiales porque todas las URLs deben cumplir con la sintaxis especificada por la especificación del identificador uniforme de recursos (URI) Por lo tanto, updateMask se convierte en lo siguiente:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

Para ejecutar el siguiente ejemplo, reemplaza pub-XXXXXXXXXXXXXXXX por tu ID de publicador y ZZZZZZZZZZ por el ID de tu grupo de mediación. La mediación Puedes encontrar el ID del grupo en la IU de AdMob o mediante accounts.mediationGroups:list. .

Reemplaza YYYYYYYYYY por los últimos 10 dígitos de tu unidad de anuncios. ID con el siguiente formato:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

Reemplaza WWWWWWWWWW por tu ID de asignación de unidades de anuncios. El ID de asignación de unidades de anuncios pueden encontrarse mediante accounts.adUnits.adUnitMappings.list .

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF