Segmentação


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

Pré-requisitos

RequestConfiguration

RequestConfiguration é uma 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 obtenha 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 voltada 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 está correta e que tem autorização para agir em nome do proprietário do app. Você está ciente de que o abuso dessa configuração poderá 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 direcionado a crianças, tomaremos medidas para desativar a IBA e os anúncios de remarketing nessa solicitação.

A configuração pode ser feita 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 seu conteúdo deve ser tratado como direcionado a crianças para fins da 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 direcionado a crianças para fins da COPPA.
  • Atribua RequestConfiguration::tag_for_child_directed_treatment a RequestConfiguration::kChildDirectedTreatmentUnspecified se não quiser indicar como tratar seu conteúdo em relação à COPPA nas solicitações de anúncio.

O exemplo a seguir indica que seu conteúdo deve ser 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 está correta e que tem autorização para agir em nome do proprietário do app. Você está ciente de que o abuso dessa configuração poderá resultar no encerramento da sua Conta do Google.

Você pode marcar suas solicitações de anúncios para receber o tratamento destinado aos usuários no Espaço Econômico Europeu (EEE) abaixo da idade de consentimento. Esse recurso foi desenvolvido para ajudar a obedecer ao 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. Com as ferramentas do Google, é mais fácil obedecer às diretrizes, mas os publishers ainda precisam seguir as obrigações legais. Saiba mais sobre como o GDPR afeta os publishers.

Quando você usar esse recurso, um parâmetro TFUA (Tag para usuários abaixo da idade de consentimento na Europa) será incluído na solicitação de anúncio. Ele desativará a publicidade personalizada, incluindo o remarketing, para todas as solicitações. As solicitações para fornecedores de anúncio terceirizados também serã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 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 a solicitação de anúncio deve receber 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 a solicitação de anúncio não deve ser tratada 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 se não quiser especificar como tratar a solicitação de anúncio em relação à idade de consentimento no Espaço Econômico Europeu (EEE).

O exemplo a seguir indica que a TFUA deve ser incluída nas suas solicitações de anúncio:

  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 "Direcionamento a crianças" e "Usuários abaixo da idade de consentimento" não devem ser definidas como "true" simultaneamente. Se isso acontecer, a configuração voltada 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 usando o RequestConfiguration::max_ad_content_rating field. Os anúncios da AdMob retornados quando isso é 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 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 struct RequestConfiguration para especificar que o conteúdo do anúncio retornado deve corresponder a uma classificação de rótulo de conteúdo digital inferior 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 para serem 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 estiverem 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, você poderá 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();