Este guia explica como fornecer informações de segmentação para uma solicitação de anúncio.
Pré-requisitos
- Conclua Começar.
RequestConfiguration
RequestConfiguration
é um struct que coleta informações de segmentação para serem
aplicadas globalmente pela função global SetRequestConfiguration()
.
Para atualizar a configuração da solicitação, primeiro consiga a configuração atual, faça 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 "feito para crianças"
De acordo com a Lei de Proteção da Privacidade On-line das Crianças (COPPA), há uma configuração chamada "tag de 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 feito para crianças quando fizer uma solicitação de anúncio. Se você indicar que quer que o Google trate seu conteúdo como feito para crianças, tomaremos medidas para desativar a IBA e os anúncios de remarketing na 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
aRequestConfiguration::kChildDirectedTreatmentTrue
para indicar que você quer que seu conteúdo seja tratado como feito para crianças de acordo com a COPPA. - Atribua
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentFalse
para indicar que você não quer que seu conteúdo seja tratado como feito para crianças de acordo com a COPPA. - Atribua
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentUnspecified
se não quiser indicar como você quer que seu conteúdo seja tratado com relação à COPPA em solicitações de anúncios.
O exemplo a seguir indica que você quer que seu conteúdo seja tratado como feito para crianças de acordo com a 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 aplicativo. 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 desenvolvido para facilitar a conformidade com o 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. Lembre-se de que as ferramentas do Google foram criadas para facilitar a conformidade e não afastam 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 na solicitação de anúncio. Ele desativa a publicidade personalizada, incluindo o remarketing, em todas as solicitações de anúncios. 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.
Assim como as configurações direcionadas a crianças, há um membro na 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
aRequestConfiguration::kUnderAgeOfConsentTrue
para indicar que você quer que a solicitação de anúncio seja tratada para usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). - Atribua
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentFalse
para indicar que você quer que a solicitação de anúncio não seja tratada para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. - Atribua
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentUnspecified
para indicar que você não especificou se a solicitação de anúncio deve ser tratada para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento.
O exemplo a seguir indica que você quer 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 que ativam a configuração "feito para crianças" e os usuários abaixo da idade de consentimento não podem ser definidas simultaneamente como "true". 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úncio usando a
RequestConfiguration::max_ad_content_rating field
. Os anúncios da AdMob retornados quando essa opção está configurada têm uma classificação do conteúdo igual ou abaixo desse 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 um struct RequestConfiguration
para especificar que o conteúdo
do anúncio retornado precisa corresponder a uma designação de classificação de conteúdo digital
maior que 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 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
, é possível transmitir 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();