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 na prática, faça o download do app de demonstração da API para iOS no Swift ou Objective-C.
Fazer o download da demonstração da API
Pré-requisitos
Concluir o guia Primeiros passos.
GADRequestConfiguration
GADRequestConfiguration
é um objeto que coleta informações de segmentação para serem aplicadas globalmente com
a instância compartilhada
GADMobileAds
. Ela pode ser acessada com o seguinte código:
Swift
let requestConfiguration = GADMobileAds.sharedInstance().requestConfiguration
Objective-C
GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;
Configuração direcionada a 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 direcionado ao público infantil quando for fazer uma solicitação de anúncio. Quando você indica que quer que o Google trate seu conteúdo como direcionado ao público infantil, o Google toma medidas para desativar o 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
comotrue
para indicar que você quer que seu conteúdo seja tratado como direcionado a crianças para os fins da COPPA. Isso impede a transmissão do identificador de publicidade, o IDFA. - Defina
tagForChildDirectedTreatment
comofalse
para indicar que você não quer que seu conteúdo seja tratado como direcionado a crianças de acordo 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 direcionado a 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 a 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 no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. Esse recurso foi projetado para ajudar a cumprir o 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 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 a fornecedores de anúncios terceirizados também serão desativadas, como pixels de medição de anúncio 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
comotrue
para indicar que você quer que as solicitações de anúncios sejam processadas 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 da maneira adequada para usuários abaixo da idade de consentimento.
O exemplo a seguir indica que você quer incluir o TFUA na solicitação de anúncio:
Swift
GADMobileAds.sharedInstance().requestConfiguration.tagForUnderAgeOfConsent = true
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;
As tags para ativar a configuração para direcionamento a crianças
e tagForUnderAgeOfConsent
não devem ser definidas simultaneamente como true
.
Se forem, a configuração para crianças terá precedência.
Filtragem de conteúdo do anúncio
Os apps podem definir uma classificação máxima para todas as solicitações de anúncios usando a propriedade maxAdContentRating
de GADRequestConfiguration
. Essa configuração se aplica
a todas as solicitações de anúncios futuras pelo restante da sessão. Os valores possíveis
para essa propriedade são baseados em 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 precisa corresponder a uma designação de classificação de conteúdo digital não superior a GADMaxAdContentRatingGeneral
.
Swift
GADMobileAds.sharedInstance().requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral
Objective-C
GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
GADMaxAdContentRatingGeneral;
Tratamento de privacidade do editor (Beta)
A API
Tratamento de privacidade do editor
(PPT) é uma ferramenta opcional que permite aos apps indicar se a personalização de anúncios
é desativada para todas as solicitações 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 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;
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 solicitar um anúncio enquanto mostra conteúdo de
https://www.example.com
, você pode transmitir este 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 os 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 destinado a públicos variados 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 exiba conteúdo de quatro URLs em um feed que também contém anúncios. É possível solicitar anúncios com classificação de conteúdo semelhante a esses URLs transmitindo-os da seguinte maneira:
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"];
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 sequencial de anúncios e 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 meio de GAMRequest
:
Swift
let request = GAMRequest()
request.publisherProvidedID = "AB123456789"
Objective-C
GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";
Confira o exemplo de PPID do Ad Manager para uma implementação de identificadores fornecidos pelo editor (PPID) no app API Demo para iOS:
Indicadores fornecidos pelo editor
Você pode enviar dados contextuais e de público-alvo como indicadores fornecidos pelo editor (PPS, na sigla em inglês) 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 público-alvo aos proponentes em todos os tipos de transação usando taxonomias padrão, sem precisar compartilhar identificadores de usuários. As características do público-alvo podem incluir dados comportamentais e com base em interesses ( taxonomia 1.1 de público-alvo do IAB) e dados contextuais ( taxonomia de conteúdo 2.2 do IAB).
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, chameloadRequest
de forma explícita emGAMBannerView
com um novo objetoGAMRequest
. - Como passar parâmetros de segmentação adicionais para redes de mediação?
- Consulte a Mediação para saber como enviar segmentação para redes de mediação.