Este guia explica como fornecer informações de segmentação para uma solicitação de anúncio.
Pré-requisitos
- Conclua a etapa Começar.
RequestConfiguration
RequestConfiguration
é uma estrutura 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 acesse a configuração atual faça as atualizações desejadas e defina-o 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"
Para fins da Lei de Proteção da Privacidade On-line da Criança (COPPA, na sigla em inglês), há uma configuração chamada "etiqueta de tratamento direcionado a crianças". Ao definir , 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 quando você fizer uma solicitação de anúncio. Se você indicar que quer que o Google trate seu conteúdo como direcionado a crianças, vamos tomar medidas para desativar o 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
aRequestConfiguration::kChildDirectedTreatmentTrue
para indicar que você quer que seu conteúdo seja tratado como direcionado a crianças para fins de COPPA. - Atribua
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentFalse
para indicar que você não quer que seu conteúdo seja tratado como direcionado a crianças para fins da COPPA. - Atribua
RequestConfiguration::tag_for_child_directed_treatment
aRequestConfiguration::kChildDirectedTreatmentUnspecified
se você não quiser indicar como seu conteúdo será tratado em relação à COPPA nas solicitações de anúncios.
O exemplo a seguir indica que você quer que o 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 definir esta tag, você certifica que esta notificação é precisa e que tem autorização para agir em nome do proprietário do app. Você entende que o abuso desta configuração pode resultar no encerramento da sua conta Google.
Usuários abaixo da idade de consentimento
Você pode marcar suas solicitações de anúncios para serem tratadas por usuários na Europa do Espaço Econômico (EEE) abaixo da idade de consentimento. 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. Consulte o orientações da União Europeia e consulte sua assessoria jurídica. As ferramentas do Google foram criadas para facilitar a conformidade, mas não liberam 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) será incluído na solicitação de anúncio. Esse parâmetro desativa publicidade personalizada, incluindo remarketing, para todas as solicitações de anúncios. Além disso, ela desativa as 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 nas configurações direcionadas a crianças, há um membro na RequestConfiguration para
configure o parâmetro TFUA: tag_for_under_age_of_consent
, que pode ser
configurados com os seguintes valores enumerados:
- Atribuir
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentTrue
para indicar que você quer solicitação de anúncio para ser tratada por usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. - Atribuir
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentFalse
para indicar que você quer solicitação de anúncio para não receber tratamento para usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. - Atribuir
RequestConfiguration::tag_for_under_age_of_consent
aRequestConfiguration::kUnderAgeOfConsentUnspecified
para indicar que você não especificaram se a solicitação de anúncio deve ser tratada para os 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 para ativar a configuração "Child-directed" e "Users under the Age of Consent" não podem ser definidas como "true" simultaneamente. Em caso afirmativo, o canal tem prioridade.
Filtragem de conteúdo do anúncio
Os aplicativos podem definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncio por meio do
RequestConfiguration::max_ad_content_rating field
: Os anúncios da AdMob retornados quando
essa configuração é definida têm uma classificação de conteúdo igual ou inferior a esse nível. As possíveis
valores para ele são baseados em classificações de classificação de conteúdo digital e devem 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 deve corresponder a uma designação de rótulo de conteúdo digital
não 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 um anúncio
solicitação.
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 faça uma correspondência entre o anúncio e o conteúdo.
Por exemplo, se o app estiver solicitando um anúncio enquanto exibe conteúdo de
https://www.example.com
, você poderá transmitir este 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();