Implementar a segmentação de chave-valor

Selecione a plataforma: Android iOS Unity Android (legada)

Com a segmentação de chave-valor, você pode definir uma segmentação personalizada para segmentar usuários por uma solicitação de anúncio. Para mais detalhes sobre a segmentação de chave-valor, como adicionar um par de chave-valor na interface da AdMob, consulte Adicionar segmentação de chave-valor a um grupo de mediação.

Esta página mostra como implementar a segmentação por chave-valor ao configurar uma solicitação de anúncio usando o SDK do Android do Google Mobile Ads.

Antes de começar

Para configurar a segmentação de chave-valor no seu app, primeiro adicione a segmentação de chave-valor a um grupo de mediação.

Anexar pares de chave-valor a uma solicitação de anúncio

Depois de configurar os pares de chave-valor personalizados na interface da AdMob, anexe-os a uma solicitação de anúncio no seu aplicativo.

Para anexar os pares de chave-valor a uma solicitação de anúncio, chame putCustomTargeting() com a chave e o valor.

O exemplo a seguir segmenta os usuários por duração em um app:

Kotlin

val daysInApp = 1
val request = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("USER_DURATION", if (daysInApp < 3) "NEW" else "MATURE")
  .build()

Java

int daysInApp = 1;
AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
    .putCustomTargeting("USER_DURATION", (daysInApp < 3) ? "NEW" : "MATURE")
    .build();

Testar a configuração da segmentação de chave-valor

Para testar sua implementação em pares de chave-valor personalizados, envie uma solicitação de anúncio e verifique o objeto response info. Verifique se o valor do campo mediation_group_name corresponde ao nome esperado do grupo de mediação.

O exemplo a seguir verifica o nome de um grupo de mediação na resposta do anúncio:

{
  "Response ID": "r6_DZtitA8Gi2OMPyKeksAI",
  ...
  "Response Extras": {
    "mediation_group_name": "Mediation group for new users"
  }
}