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 a segmentação de anúncios em ação, baixe o app de demonstração da API iOS em Swift ou Objective-C.

Baixar a API de demonstração

Pré-requisitos

Leia o guia para iniciantes.

GADRequestConfiguration

GADRequestConfiguration é um objeto que coleta informações de segmentação que serão 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 que todas as solicitações de anúncio apliquem as mudanças na configuração de solicitação, atualize-a antes de inicializar o SDK dos anúncios para dispositivos móveis.

Configuração voltada para crianças

De acordo com a 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 isso é indicado, tomamos medidas para desativar a IBA e os anúncios de remarketing nessa solicitação. As opções de configuração são as seguintes:

  • Defina tagForChildDirectedTreatment como true para que seu conteúdo seja tratado como direcionado a crianças e esteja em conformidade com a COPPA. Isso impede a transmissão do identificador de publicidade (IDFA).
  • Defina tagForChildDirectedTreatment como false para que seu conteúdo não seja tratado como direcionado a crianças para fins de conformidade com a 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 feito para crianças:

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

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

Você pode marcar suas solicitações de anúncio para receber o tratamento destinado 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 sua assessoria jurídica. Com as ferramentas do Google, é mais fácil obedecer às diretrizes, mas os publishers ainda precisam seguir as obrigações legais. Saiba como o GDPR afeta os publishers.

Ao usar esse recurso, um parâmetro Tag para usuários abaixo da idade de consentimento na Europa (TFUA) é incluído em todas as futuras solicitações de anúncio. Ele vai desativar a publicidade personalizada, incluindo o remarketing, para aquela solicitação específica. As solicitações a fornecedores de anúncio terceirizados também serão desativadas, como pixels de medição 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).
  • Não definir tagForUnderAgeOfConsent indica que você não quer que as solicitações sejam processadas de maneira adequada para esses usuários.

O exemplo a seguir indica que a TFUA deve ser incluída 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 a tagForUnderAgeOfConsent não podem ser definidas ao mesmo tempo como true. Se isso acontecer, a configuração voltada para 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 usando a propriedade maxAdContentRating de GADRequestConfiguration. Essa configuração se aplica a todas as solicitações de anúncios futuras durante o restante da sessão. Os valores possíveis para essa propriedade são baseados nas classificações 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 para especificar que o conteúdo do anúncio retornado deve corresponder a uma designação de classificação de conteúdo digital inferior 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 aos apps indicar se a personalização de anúncios precisa ser desativada para todas as solicitações usando a propriedade publisherPrivacyPersonalizationState de GADRequestConfiguration. Ao usar esse recurso, um parâmetro de tratamento de privacidade do publisher é incluído em todas as solicitações futuras pelo restante da sessão.

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

O objeto GAMRequest coleta as informações de segmentação que serão 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, específicos a uma única origem de anúncio.

O snippet de código a seguir define uma chave de parâmetro extra do 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 veiculado. Isso permite que a segmentação por palavras-chave corresponda o anúncio ao conteúdo.

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 = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

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

Segmentação personalizada

Depois de configurar os pares de chave-valor na interface do Ad Manager, defina uma 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 nessa solicitação. Para segmentar vários valores para uma chave, insira-os como uma string separada por vírgulas.

Swift

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

Objective-C

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 variados podem fornecer uma lista curta de URLs pela propriedade neighboringContentURLs. Os URLs do conteúdo ao redor diferem da propriedade contentURL porque são usados apenas para brand safety.

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

Swift

let request = AdManagerRequest()
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"];

Identificadores fornecidos pelo publisher

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

A definição do PPID é feita por meio de GAMRequest:

Swift

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

Objective-C

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

Veja o exemplo de PPID do Ad Manager para saber como implementar esses identificadores 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 publisher (PPS) em solicitações de anúncio. Com os PPS, você pode usar seus dados de usuário para aprimorar a monetização programática comunicando as características do seu público-alvo aos bidders em todos os tipos de transação, com as taxonomias padrão, sem precisar compartilhar identificadores de usuário. As características do público-alvo podem incluir dados comportamentais e baseados em interesses ( Taxonomia de público-alvo 1.1 do IAB) e também dados contextuais ( Taxonomia de conteúdo 2.2 do IAB).

Swift

let extras = Extras()
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 = AdManagerRequest()
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 é automaticamente atualizado?
Na atualização do anúncio, o objeto GAMRequest especificado anteriormente é usado para uma nova segmentação. Para defini-la, chame explicitamente loadRequest em GAMBannerView com um novo objeto GAMRequest.
Como faço para passar parâmetros de segmentação adicionais para redes de mediação?
Consulte Mediação para saber como enviar segmentações para redes de mediação.