Segmentação

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

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

Download da demonstração da API

Pré-requisitos

Conclua 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:

let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

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

Configuração direcionada a crianças

Para fins da Lei de Proteção da Privacidade On-line das Crianças (COPPA, na sigla em inglês), há uma configuração chamada tagForChildDirectedTreatment.

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seu conteúdo como direcionado a crianças quando você 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 publicidade com base em interesses 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 de conformidade com a 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 de conformidade com a COPPA.
• Não defina tagForChildDirectedTreatment se não quiser indicar como 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 dirigido a crianças para fins da COPPA:

GADMobileAds.sharedInstance().requestConfiguration.tagForChildDirectedTreatment = true

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

Ao definir essa tag, você confirma que esta notificação é precisa 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.

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 abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Esse recurso foi desenvolvido 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 seu advogado. As ferramentas do Google foram criadas para facilitar a conformidade, mas não isentam os editores das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, um parâmetro "Tag para usuários abaixo da idade de consentimento" na Europa (TFUA, na sigla em inglês) será incluído em todas as solicitações de anúncios futuras. Esse parâmetro desativa a publicidade personalizada, incluindo o remarketing, para essa solicitação de anúncio específica. As solicitações para fornecedores de anúncios terceirizados também sã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. Para isso, defina a propriedade tagForUnderAgeOfConsent no objeto GADMobileAds.requestConfiguration e transmita true.

• Defina tagForUnderAgeOfConsent como true para indicar que você quer que as solicitações de anúncios 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.
• 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 incluir a TFUA na sua solicitação de anúncio:

GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

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

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 de anúncio 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 rótulo 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 do anúncio retornado deve corresponder a uma designação de rótulo de conteúdo digital não superior a GADMaxAdContentRatingGeneral.

GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Tratamento de privacidade do editor (Beta)

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

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

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

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

O objeto GAMRequest coleta informações de segmentação para serem 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 estiverem veiculando. Isso permite que a segmentação por palavras-chave faça uma correspondência entre o anúncio e o conteúdo.

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

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

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

Segmentação personalizada

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

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

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

Brand safety (Beta)

Os apps que mostram conteúdo dinâmico destinado a públicos-alvo diferentes podem fornecer uma lista curta de URLs usando a propriedade neighboringContentURLs. Os URLs de conteúdo vizinhos diferem da propriedade contentURL porque são usados apenas para brand safety.

Suponha que seu app mostre conteúdo de quatro URLs em um feed que também contém anúncios. É possível solicitar anúncios com uma classificação de conteúdo semelhante a esses URLs transmitindo-os da seguinte maneira:

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

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

Identificadores fornecidos pelo editor

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

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

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

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

Consulte o exemplo de PPID do Ad Manager para conferir uma implementação de identificadores fornecidos pelo editor (PPID, na sigla em inglês) no app de demonstração da API iOS:

Swift Objective-C

Indicadores fornecidos pelo publisher

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

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)

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 explicitamente loadRequest em GAMBannerView com um novo objeto GAMRequest.

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

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