Segmentação

Selecione a plataforma: Android iOS Unity Flutter

Este guia explica como fornecer informações de segmentação para uma solicitação de anúncio.

Para conferir o direcionamento de anúncios em ação, faça o download do app de demonstração da API iOS em Swift ou Objective-C.

Fazer o download da demonstração da API

Pré-requisitos

Conclua o guia Começar.

GADRequestConfiguration

GADRequestConfiguration é um objeto que coleta informações de segmentação para serem aplicadas globalmente pela instância compartilhada GADMobileAds. Ele pode ser acessado com o seguinte código:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Para garantir que todas as solicitações de anúncio apliquem as mudanças na configuração, defina a configuração de solicitação antes de inicializar o SDK de anúncios para dispositivos móveis.

Configuração "feito para crianças"

Para fins da Lei de Proteção da Privacidade On-line das Crianças (COPPA), existe uma configuração chamada tagForChildDirectedTreatment.

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seu conteúdo como feito para crianças quando fizer uma solicitação de anúncio. Quando você indica que quer que o Google trate seu conteúdo como direcionado a crianças, o Google toma medidas para desativar a IBA e os anúncios de remarketing nessa solicitação de anúncio. As opções de configuração são as seguintes:

  • Defina tagForChildDirectedTreatment como true para indicar que você quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA. Isso impede a transmissão do identificador de publicidade, IDFA.
  • Defina tagForChildDirectedTreatment como false para indicar que você não quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA.
  • Não defina tagForChildDirectedTreatment se não quiser indicar como o conteúdo deve ser tratado em relação à COPPA.

O exemplo a seguir indica que você quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ao definir essa tag, você certifica que esta notificação está correta e que tem autorização para agir em nome do proprietário do app. Você entende que o abuso dessa configuração pode resultar no encerramento da sua Conta do Google.

Você pode marcar suas solicitações de anúncios para que sejam tratadas como direcionadas a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Esse recurso foi desenvolvido para obedecer ao Regulamento geral de proteção de dados (GDPR). É possível que você tenha outras obrigações legais de acordo com o GDPR. Leia as orientações da União Europeia e consulte seu advogado. As ferramentas do Google foram criadas para facilitar a conformidade e não livram os publishers das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, um parâmetro de tag para usuários abaixo da idade de consentimento na Europa (TFUA) será incluído em todas as solicitações de anúncio futuras. Ele desativa a publicidade personalizada, incluindo o remarketing, para essa solicitação de anúncio específica. As solicitações para fornecedores de anúncio terceirizados também serão desativadas, como pixels de medição de anúncios e servidores de anúncios de terceiros.

A configuração pode ser usada com todas as versões do SDK dos anúncios para dispositivos móveis do Google definindo a propriedade tagForUnderAgeOfConsent no objeto GADMobileAds.requestConfiguration e transmitindo true.

  • Defina tagForUnderAgeOfConsent como true para indicar que você quer que as solicitações de anúncio sejam processadas de maneira adequada para usuários abaixo da idade de consentimento. Isso também impede a transmissão do identificador de publicidade (IDFA, na sigla em inglês).
  • Não definir tagForUnderAgeOfConsent indica que você não quer que as solicitações de anúncio sejam processadas de maneira adequada para usuários abaixo da idade de consentimento.

O exemplo a seguir indica que você quer incluir o TFUA na sua solicitação de anúncio:

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

As tags para ativar a configuração de direcionamento a crianças e tagForUnderAgeOfConsent não podem ser definidas simultaneamente como true. Se forem, a configuração "feito para crianças" terá precedência.

Filtragem de conteúdo de anúncios

Os apps podem definir uma classificação máxima do conteúdo do anúncio para todas as solicitações de anúncio usando a propriedade maxAdContentRating de GADRequestConfiguration. Essa configuração se aplica a todos os pedidos de anúncio futuros pelo restante da sessão. Os valores possíveis para essa propriedade são baseados nas classificações de classificação de conteúdo digital e precisam ser uma das seguintes constantes:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

O código a seguir configura todas as solicitações de anúncio para especificar que o conteúdo retornado deve corresponder a uma designação de classificação de conteúdo digital não superior a GADMaxAdContentRatingGeneral.

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Tratamento de privacidade do publisher (Beta)

A API Publisher Privacy Treatment (PPT) é uma ferramenta opcional que permite que os apps indiquem se a personalização de anúncios precisa ser desativada para todas as solicitações de anúncio usando a propriedade publisherPrivacyPersonalizationState de GADRequestConfiguration. Ao usar esse recurso, um parâmetro de tratamento de privacidade do editor (PPT) é incluído em todas as solicitações de anúncio futuras durante o restante da sessão.

Por padrão, as solicitações de anúncios ao Google veiculam anúncios personalizados. O código a seguir desativa a personalização de anúncios para todas as solicitações de anúncios:

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GADRequest

O objeto GADRequest coleta informações de segmentação para serem enviadas com uma solicitação de anúncio.

Adicionar extras de rede

Os extras de rede são detalhes adicionais enviados com uma solicitação de anúncio que são específicos de uma única origem de anúncio.

O snippet de código a seguir define uma chave de parâmetro extra de collapsible com um valor de bottom para o Google:

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

URL de conteúdo

Ao solicitar um anúncio, os apps podem transmitir o URL do conteúdo que estiverem veiculando. Dessa forma, a segmentação por palavras-chave pode fazer uma correspondência ao anúncio que tiver outros conteúdos em exibição.

Por exemplo, se o app estiver solicitando um anúncio enquanto mostra conteúdo de https://www.example.com, você poderá transmitir esse URL para segmentar palavras-chave relevantes:

Swift

let request = Request()
request.contentURL = "https://www.example.com"

Objective-C

GADRequest *request = [GADRequest request];
request.contentURL = @"https://www.example.com";

Perguntas frequentes

Qual segmentação é usada quando um anúncio é atualizado automaticamente?
Na atualização do anúncio, o objeto GADRequest especificado anteriormente é usado novamente para segmentação. Para definir uma nova segmentação, chame explicitamente loadRequest em GADBannerView com um novo objeto GADRequest.
Como faço para transmitir parâmetros de segmentação extras para redes de mediação?
Consulte Mediação para saber como enviar segmentação para redes de mediação.