Segmentação

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

Pré-requisitos

RequestConfiguration

RequestConfiguration é uma estrutura que coleta informações de segmentação a serem aplicadas globalmente por meio da função global SetRequestConfiguration().

Para atualizar a configuração da solicitação, consiga a configuração atual primeiro, realize as atualizações desejadas e defina-a da seguinte maneira:

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

Configuração para direcionamento a crianças

De acordo com a Lei de proteção à privacidade on-line infantil (COPPA, na sigla em inglês), há uma configuração chamada "tag para tratamento para direcionamento a crianças". Ao configurar essa tag, você certifica que essa 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.

Como desenvolvedor de apps, você pode indicar se quer que o Google trate seu conteúdo como direcionado a crianças ao fazer uma solicitação de anúncio. Se você indicar que quer que o Google trate seu conteúdo como direcionado a crianças, tomaremos medidas para desativar a IBA e os anúncios de remarketing nessa solicitação de anúncio.

A configuração pode ser definida atribuindo o membro tag_for_child_directed_treatment da estrutura RequestConfiguration a um dos seguintes valores enumerados:

  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentTrue para indicar que você quer que seu conteúdo seja tratado como voltado para crianças de acordo com a COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que você não quer que seu conteúdo seja tratado como voltado para crianças de acordo com a COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se não quiser indicar como você quer que seu conteúdo seja tratado em relação à COPPA em solicitações de anúncios.

O exemplo a seguir indica que você quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

Ao configurar essa tag, você certifica que essa 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.

Marque suas solicitações de anúncios para que sejam tratadas como direcionadas aos usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. Esse recurso foi criado para facilitar a conformidade com 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 seu advogado. Lembre-se de que as ferramentas do Google foram criadas para facilitar a conformidade e não remetem a nenhum editor específico de suas obrigações perante a lei. 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 na solicitação de anúncio. Esse parâmetro desativa a publicidade personalizada, incluindo o remarketing, para todas as solicitações de anúncios. Ela também desativa solicitações para fornecedores de anúncios terceirizados, como pixels de medição de anúncios e servidores de anúncios de terceiros.

Assim como as configurações direcionadas a crianças, há um membro em RequestConfiguration para configurar o parâmetro TFUA: tag_for_under_age_of_consent, que pode ser configurado com os seguintes valores enumerados:

  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentTrue para indicar que você quer que a solicitação de anúncio receba tratamento para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.
  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse para indicar que você quer que a solicitação de anúncio não receba tratamento para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.
  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentUnspecified para indicar que você não especificou se a solicitação de anúncio receberá tratamento para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.

O exemplo a seguir indica que você deseja que a TFUA seja incluída nas suas solicitações de anúncios:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

As tags para ativar a configuração "feito para crianças" e os usuários abaixo da idade de consentimento não podem ser definidas simultaneamente como verdadeiras. Se forem, a configuração feito 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 as solicitações de anúncios com RequestConfiguration::max_ad_content_rating field. Os anúncios da AdMob retornados quando isso está configurado têm uma classificação de conteúdo igual ou inferior a esse nível. Os valores possíveis para isso são baseados em classificações de classificação de conteúdo digital e precisam ser um dos seguintes valores enumerados:

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

O código a seguir configura uma estrutura RequestConfiguration para especificar que o conteúdo do anúncio retornado precisa corresponder a uma classificação de classificação de conteúdo digital que não seja superior a G:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

O objeto AdRequest 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 aplicativos podem passar 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 estiver solicitando um anúncio enquanto mostra conteúdo de https://www.example.com, transmita esse URL para segmentar palavras-chave relevantes:

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();