Segmentação

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

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

Fazer o download da demonstração da API

Pré-requisitos

Leia o guia Primeiros passos.

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 = GADMobileAds.sharedInstance().requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

Configuração "feito para crianças"

Para fins da Lei de Proteção da Privacidade On-line das Crianças (COPPA), há 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 feito para crianças, o Google toma medidas para desativar o IBA e os anúncios de remarketing na 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 feito para crianças de acordo com a COPPA. Isso impede a transmissão do identificador de publicidade, o IDFA.
• Defina tagForChildDirectedTreatment como false para indicar que você não quer que seu conteúdo seja tratado como feito para crianças de acordo com a COPPA.
• Não defina tagForChildDirectedTreatment se não quiser indicar como você quer que seu conteúdo seja tratado em relação à COPPA.

O exemplo a seguir indica que você quer que seu conteúdo seja tratado como feito para crianças de acordo com a COPPA:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

Usuários abaixo da idade de consentimento

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

Ao usar esse recurso, uma tag para usuários abaixo da idade de consentimento na Europa (TFUA, na sigla em inglês) será incluída em todas as solicitações de anúncios futuras. Ele desativa a publicidade personalizada, incluindo o remarketing, para essa solicitação específica. As solicitações para fornecedores de anúncios 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úncios sejam tratadas da maneira adequada para usuários abaixo da idade de consentimento. Isso também impede a transmissão do identificador de publicidade, o IDFA.
• Não definir tagForUnderAgeOfConsent indica que você não quer que as solicitações de anúncios sejam processadas de maneira adequada para usuários abaixo da idade de consentimento.

O exemplo a seguir indica que você quer que a TFUA seja incluída na solicitação de anúncio:

Swift

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

As tags que ativam a configuração para 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.

Importante: esse parâmetro tagForUnderAgeOfConsent não é encaminhado aos adaptadores de mediação da rede de publicidade. Você é responsável por garantir que cada rede de publicidade de terceiros no seu app veicule anúncios adequados para usuários abaixo da idade de consentimento de acordo com o GDPR.

Filtragem de conteúdo do anúncio

Os apps podem definir uma classificação máxima do conteúdo do anúncio para todas as solicitações usando a propriedade maxAdContentRating de GADRequestConfiguration. Essa configuração se aplica a todas as solicitações de anúncios futuras para o 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úncios para especificar que o conteúdo do anúncio retornado deve corresponder a uma designação de classificação de conteúdo digital maior que GADMaxAdContentRatingGeneral.

Importante: as configurações de filtro de classificação do conteúdo especificadas pelo SDK substituem aquelas definidas usando a Ad Manager interface.

Swift

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Tratamento de privacidade para editores (Beta)

O Tratamento de privacidade do editor A API PPT é uma ferramenta opcional que permite aos apps indicar se é necessário desativar a personalização de anúncios em todas as solicitações 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úncios futuras do restante da sessão.

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

Swift

GADMobileAds.sharedInstance().requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

Observação :para solicitações de anúncios com vários indicadores de privacidade do usuário, o mais restritivo terá precedência. Consulte a documentação da [] para conferir exemplos específicos.

GAMRequest

O objeto GAMRequest coleta informações de segmentação que serão enviadas com uma solicitação de anúncio.

URL de conteúdo

Ao solicitar um anúncio, os apps podem transmitir o URL do conteúdo que estão veiculando. Isso permite que a segmentação por palavras-chave corresponda o anúncio ao conteúdo.

Por exemplo, se o app solicita um anúncio enquanto mostra conteúdo de https://www.example.com, é possível transmitir esse URL para segmentar palavras-chave relevantes:

Swift

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

Objective-C

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

Segmentação personalizada

Depois de configurar pares de chave-valor na IU do Ad Manager, defina a segmentação personalizada com as chaves-valor em uma solicitação de anúncio. Os itens de linha que segmentam essas chaves-valor estão qualificados para veiculação para essa solicitação de anúncio. Para segmentar diversos valores para uma chave, insira os valores como uma string separada por vírgulas.

Swift

let request = GAMRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

Brand safety (Beta)

Apps que exibem conteúdo dinâmico para públicos variados podem fornecer uma pequena lista de URLs usando a propriedade neighboringContentURLs. Os URLs de conteúdo vizinhos são diferentes da propriedade contentURL porque são usados apenas para brand safety.

Suponha que seu app exiba conteúdo de quatro URLs em um feed que também contenha anúncios. Você pode solicitar anúncios com uma classificação de conteúdo semelhante a esses URLs transmitindo-os assim:

Swift

let request = GAMRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

Importante: somente os quatro primeiros URLs são usados pelo SDK. Todos os outros serão ignorados.

Identificadores fornecidos pelo editor

É possível definir um identificador fornecido pelo editor (PPID, na sigla em inglês) para uso em limite de frequência, segmentação de público-alvo, rotação de anúncios sequencial e outros controles de exibição de anúncios com base no público-alvo em vários dispositivos.

Observação :esse recurso não está disponível para todos os editores. Consulte Sobre identificadores fornecidos pelo editor para mais detalhes.

A configuração do PPID é feita pelo GAMRequest:

Swift

let request = GAMRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

Veja o exemplo de PPID do Ad Manager para uma implementação de identificadores fornecidos pelo editor (PPID) no aplicativo API Demo para iOS:

Swift Objective-C

Indicadores fornecidos pelo editor

É possível enviar dados contextuais e de público-alvo como indicadores fornecidos pelo editor (PPS) em solicitações de anúncios. Com o PPS, é possível usar os dados do usuário para melhorar a monetização programática, comunicando as características do seu público-alvo aos proponentes em todos os tipos de transação, usando taxonomias padrão, sem a necessidade de compartilhar identificadores de usuários. As características de público-alvo podem incluir dados comportamentais e baseados em interesses ( Taxonomia de público-alvo do IAB 1.1) e dados de contexto ( Taxonomia de conteúdo do IAB 2.2).

Swift

let extras = GADExtras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = GAMRequest()()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

Perguntas frequentes

Qual segmentação é usada quando um anúncio é atualizado automaticamente?

Na atualização do anúncio, o objeto GAMRequest especificado anteriormente é usado para segmentação novamente. Para definir uma nova segmentação, chame loadRequest explicitamente em GAMBannerView com um novo objeto GAMRequest.

Como faço para transmitir parâmetros de segmentação adicionais para redes de mediação?

Consulte Mediação para saber como enviar segmentação a redes de mediação.