Segmentação


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

Pré-requisitos

RequestConfiguration

RequestConfiguration é um struct que coleta informações de segmentação a serem aplicada 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 quiser que o Google trate seu conteúdo como feito para crianças, tomamos medidas para desativar IBA e anúncios de remarketing nessa solicitação de anúncio.

A configuração pode ser definida pela atribuição tag_for_child_directed_treatment membro de RequestConfiguration struct para 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 direcionado a crianças para fins de COPPA.
  • Atribuir RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentFalse para indicar que você não quiser que seu conteúdo seja tratado como feito para crianças de acordo com a COPPA.
  • Atribuir RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecifiedse você não quiser para indicar como você gostaria que seu conteúdo fosse tratado em relação à COPPA em 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 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.

Você pode marcar suas solicitações de anúncios para que sejam tratadas como direcionadas a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE). Esse recurso foi criado para ajudar 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. Não se esqueça as ferramentas do Google foram criadas para facilitar a conformidade e não isentar os editores das obrigações legais. Saiba mais sobre como o GDPR afeta os editores.

Ao usar esse recurso, um parâmetro chamado "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 a publicidade personalizada, incluindo o 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:

  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentTrue para indicar que você quer que a solicitação de anúncio seja tratada como sendo direcionada a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).
  • Atribua RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::kUnderAgeOfConsentFalse para indicar que você não quer que a solicitação de anúncio seja tratada como direcionada a usuários abaixo da idade de consentimento no Espaço Econômico Europeu (EEE).
  • Atribuir RequestConfiguration::tag_for_under_age_of_consent a RequestConfiguration::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 incluir a TFUA 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 apps podem definir uma classificação máxima do conteúdo do anúncio para as solicitações de anúncio usando o RequestConfiguration::max_ad_content_rating field. anúncios da AdMob retornados quando configurado para ter uma classificação de conteúdo igual ou abaixo desse 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 o anúncio. o conteúdo retornado deve corresponder a uma classificação de conteúdo digital não 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 um anúncio solicitação.

URL de conteúdo

Ao solicitar um anúncio, os apps podem transmitir o URL do conteúdo que estiverem 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 solicita um anúncio enquanto mostra conteúdo de https://www.example.com, você pode 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();