Implementar 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 orienta você na implementação da segmentação de chave-valor ao configurar uma solicitação de anúncio usando o SDK dos Anúncios para Dispositivos Móveis do Google para iOS.

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 pares a uma solicitação de anúncio no aplicativo.

  1. Crie um objeto de par de chave-valor que represente seus dados de segmentação personalizados.

  2. Defina a customTargeting propriedade da solicitação de anúncio para esse objeto.

O exemplo a seguir aborda as etapas anteriores para segmentar usuários por duração em um app:

Swift 

let daysInApp = 1

// Step 1: Create the key-value pair dictionary with custom targeting data.
let customTargeting: [String: String] = [
  "USER_DURATION": daysInApp < 3 ? "NEW" : "MATURE"
]

// Step 2: Create an ad request with custom targeting.
let request = GADRequest()
request.customTargeting = customTargeting

Objective-C 

int days_in_app = 1;

// Step 1: Create the key-value pair object with custom targeting data.
NSDictionary *customTargeting = @{
  @"USER_DURATION" : days_in_app < 3 ? @"NEW" : @"MATURE"
};

// Step 2: Create an ad request with custom targeting.
GADRequest *request = [GADRequest request];
request.customTargeting = customTargeting;

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

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

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

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