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 aplicativo API Demo para iOS no Swift ou usando o 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 por meio de as GADMobileAds instância compartilhada. 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"

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

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seus como feito para crianças quando você faz uma solicitação de anúncio. Quando você indica quiser que o Google trate seu conteúdo como feito para crianças, tomaremos 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 da seguinte forma:

• Defina tagForChildDirectedTreatment como true para indicar que você quer que sua conteúdo tratado como feito para crianças de acordo com a COPPA. Isso evita que transmissão do Identificador de Publicidade, o IDFA.
• Defina tagForChildDirectedTreatment como false para indicar que você não quer seu conteúdo é tratado como feito para crianças de acordo com a COPPA.
• Não defina tagForChildDirectedTreatment se você não quiser indicar como. você gostaria que seu conteúdo fosse tratado em relação à COPPA.

O exemplo a seguir indica que você deseja 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 definir esta tag, você certifica que esta notificação é precisa e que você é autorizado a 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 por usuários no do Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. Esse recurso é criada para facilitar a conformidade com os Termos o Regulamento de proteção de dados (GDPR). É possível que você tenha outras informações obrigações de conformidade com o GDPR. Revisar as orientações da União Europeia e consultar seu próprio advogado. As ferramentas do Google foram criadas para facilitar a conformidade e não livram nenhum editor específico das obrigações a lei. Saiba mais sobre como o GDPR afeta editores.

Ao usar esse recurso, uma tag para usuários abaixo da idade de consentimento em Europa (TFUA) será incluído em todas as futuras solicitações de anúncios. 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 serão desativadas, como pixels de medição de anúncios e servidores de anúncios de terceiros.

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

• Defina tagForUnderAgeOfConsent como true para indicar que você quer que o anúncio solicitações devem ser tratadas de forma adequada para usuários menores de idade consentimento Isso também impede a transmissão do Código de identificador, IDFA.
• Não definir tagForUnderAgeOfConsent indica que você não quer o anúncio solicitações devem ser tratadas de forma adequada para usuários menores de idade 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 para ativar a configuração direcionada a crianças. e tagForUnderAgeOfConsent não podem ser definidos simultaneamente como true. Se forem, a configuração feito para crianças terá precedência.

Importante :esse parâmetro tagForUnderAgeOfConsent não é encaminhado para adaptadores de mediação para origens de anúncios de terceiros. É sua responsabilidade garanta que cada rede de publicidade de terceiros no app veicule anúncios apropriado para usuários abaixo da idade de consentimento de acordo com o GDPR.

Filtragem de conteúdo do anúncio

Os aplicativos podem definir uma classificação máxima do conteúdo do anúncio para todas as solicitações de anúncios usando o Propriedade maxAdContentRating de GADRequestConfiguration. Esta configuração se aplica a todas as solicitações de anúncios futuras para o restante da sessão. Os valores possíveis para esta propriedade têm como base a classificação de conteúdo digital de classificação e precisa ser uma das seguintes constantes:

• GADMaxAdContentRatingGeneral
• GADMaxAdContentRatingParentalGuidance
• GADMaxAdContentRatingTeen
• GADMaxAdContentRatingMatureAudience

O código a seguir configura todas as solicitações de anúncios para especificar o conteúdo do anúncio. retornados devem corresponder a uma designação de Classificação de conteúdo digital, no máximo, GADMaxAdContentRatingGeneral:

Importante: as configurações de filtro de classificação do conteúdo especificadas pelo SDK substituem qualquer configurações 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)

A Tratamento de privacidade do editor (PPT) API é uma ferramenta opcional que permite aos apps indicar se precisam desativar os anúncios personalização para todas as solicitações de anúncios usando o publisherPrivacyPersonalizationState propriedade de GADRequestConfiguration. Ao usar esse recurso, um editor tratamento de privacidade (PPT, na sigla em inglês) será 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 seguinte 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 têm prioridade. Consulte a API Publisher Privacy Processing (em inglês) documentação para exemplos específicos.

GAMRequest

O objeto GAMRequest coleta segmentação informações sejam 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, 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 pares de chave-valor na IU do Ad Manager, defina de anúncios com as chaves-valor em uma solicitação de anúncio. Os itens de linha que segmentam a chave valores estarã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)

Os aplicativos que exibem conteúdo dinâmico para diversos públicos podem oferecer uma lista curta de URLs pela propriedade neighboringContentURLs. Vizinhos URLs de conteúdo diferem da propriedade contentURL porque são usados apenas para segurança de marca.

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 passando-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 por 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 o editor identificadores fornecidos 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 editor fornecido identificadores (PPID) no app API Demo para iOS:

Swift Objective-C

Indicadores fornecidos pelo editor

Você pode enviar dados contextuais e de público-alvo indicadores fornecidos pelo editor (PPS) em solicitações de anúncios. Com o PPS, é possível usar os dados do usuário para melhorar da monetização programática ao comunicar as características de seu público-alvo proponentes em todos tipos de transação, usando taxonomias padrão, sem a necessidade de compartilhar identificadores de usuários. Seu público podem incluir dados comportamentais e baseados em interesses ( Taxonomia de público-alvo do IAB 1.1) 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 valor especificado anteriormente O objeto GAMRequest é usado para segmentação novamente. Para definir uma nova segmentação, chame loadRequest de forma explícita 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 para redes de mediação.