Inscreva-se hoje mesmo na Performance Max e no workshop da API Google Ads, que vai acontecer no dia 17 de julho.

Esta página foi traduzida pela API Cloud Translation.

Critérios

O CampaignCriterionService, o AdGroupCriterionService e o CustomerNegativeCriterionService são compatíveis com a segmentação ou a exclusão de vários tipos de critérios.

Critérios da campanha

Com o CampaignCriterionService, é possível especificar a segmentação no nível da campanha para os tipos a seguir. Você também pode especificar modificadores de lance nesse nível usando um multiplicador, mas não é possível definir lances absolutos.

AdScheduleInfo

Por padrão, uma nova campanha não contém programações de anúncios, o que significa que os anúncios serão exibidos durante todos os períodos. É possível configurar uma programação de anúncios de até um quarto de hora para determinar com mais precisão quando exibir os anúncios.

Só é possível segmentar programações de anúncios. Não é possível excluir.

AgeRangeInfo

Por padrão, uma nova campanha não contém critérios de faixa etária, o que significa que todas as idades são incluídas.

BrandInfo

Por padrão, uma nova campanha não terá critérios de marca, ou seja, nenhuma marca será explicitamente segmentada ou excluída.

CarrierInfo

Por padrão, uma nova campanha não terá critérios de operadora de conteúdo, o que significa que todas as operadoras estão incluídas. Somente critérios positivos são compatíveis no nível da campanha.

CombinedAudienceInfo

Qualquer número de critérios de público-alvo pode ser combinado em um público-alvo combinado. Por padrão, as novas campanhas não têm públicos-alvo combinados. Para mais detalhes, consulte o artigo da Central de Ajuda sobre públicos-alvo combinados.

ContentLabelInfo

Por padrão, uma nova campanha não terá critérios de classificação de conteúdo, o que significa que todas as categorias serão incluídas. Somente critérios negativos são compatíveis no nível da campanha.

CustomAffinityInfo

Por padrão, uma nova campanha não terá critérios de afinidade personalizados. Os critérios de afinidade personalizada são definidos por recursos CustomInterest que precisam ser criados pelo usuário. Apenas critérios positivos são aceitos. Este artigo contém mais detalhes sobre como os critérios de afinidade personalizada funcionam e como usá-los.

DeviceInfo

Defina os critérios de DeviceInfo usando um dos tipos enumerados Device predefinidos. O principal caso de uso da segmentação por dispositivo é ajustar lances para um dispositivo específico usando o valor bid_modifier do CampaignCriterion.

Só é possível segmentar dispositivos. Não é possível excluir.

GenderInfo

Por padrão, uma nova campanha não conterá critérios de gênero, o que significa que todos os sexos serão incluídos. Apenas critérios negativos são compatíveis no nível da campanha.

IncomeRangeInfo

Por padrão, uma nova campanha não contém critérios de faixa de renda, ou seja, todas as rendas são incluídas. Somente critérios negativos são compatíveis no nível da campanha.

IpBlockInfo

Por padrão, uma nova campanha não contém critérios de bloqueio de IP, o que significa que tudo é incluído.

KeywordInfo

As palavras-chave são criadas usando texto de formato livre e um dos valores de tipo enumerado de correspondência.

Como você só pode excluir palavras-chave no nível da campanha, é necessário especificar negative = true no CampaignCriterion de uma palavra-chave.

LanguageInfo

Por padrão, uma nova campanha não contém critérios de idioma, o que significa que todos os idiomas são incluídos. Apenas critérios positivos são aceitos.

LifeEventInfo

Por padrão, as novas campanhas não contêm critérios de eventos importantes, ou seja, nenhum evento importante será segmentado ou excluído explicitamente. Eventos importantes precisam ser identificados de acordo com o valor do campo id no recurso LifeEvent. Recupere a lista de LifeEvents disponíveis usando GoogleAdsService.SearchStream.

ListingScopeInfo

Por padrão, uma nova campanha não contém critérios de escopo da listagem. Apenas critérios positivos são aceitos.

LocationInfo

A segmentação por local nomeada é implementada como LocationInfo e criada usando um conjunto fixo de IDs de critérios. Os IDs disponíveis estão listados na documentação e podem ser pesquisados individualmente usando o GeoTargetConstantService. Esses critérios podem ser configurados como positivos ou negativos, com destinos negativos substituindo os positivos. Por padrão, uma nova campanha não contém critérios de local, ou seja, todos os locais são segmentados.

Saiba mais sobre a segmentação por local nomeado.

LocationGroupInfo

Com um LocationGroup, as campanhas podem segmentar várias regiões geográficas. Essas regiões são definidas por um conjunto de locais e um raio de distância ao redor de cada um deles em metros ou milhas. A segmentação desses locais pode ser filtrada usando uma lista de IDs de critérios de segmentação geográfica.

Saiba mais sobre como segmentar várias regiões geográficas.

MobileAppCategoryInfo

Por padrão, uma nova campanha não contém critérios de categoria de app para dispositivos móveis. Isso significa que todas as categorias são incluídas. Apenas critérios negativos no nível da campanha são compatíveis.

MobileApplicationInfo

Por padrão, os novos grupos de anúncios não contêm critérios de apps para dispositivos móveis. Cada app para dispositivos móveis precisa ser identificado de acordo com o valor do campo app_id.

MobileDeviceInfo

Por padrão, uma nova campanha não contém critérios de dispositivos móveis, o que significa que todos os dispositivos são incluídos.

Para especificar um dispositivo móvel individual, use o nome do recurso de um MobileDeviceConstant para definir o campo device nos critérios da campanha.

Só é possível segmentar dispositivos móveis. Não é possível excluir.

OperatingSystemVersionInfo

Por padrão, uma nova campanha não contém critérios de versão do sistema operacional, ou seja, todos os sistemas operacionais são segmentados. Somente critérios positivos são compatíveis no nível da campanha.

ParentalStatusInfo

Por padrão, uma nova campanha não contém critérios de status parental, o que significa que todas as categorias de status parental estão incluídas. Somente critérios negativos são compatíveis no nível da campanha.

PlacementInfo

Eles são criados usando um URL do cliente. Existem limites para o tamanho (250 caracteres) e a profundidade (dois níveis) dos URLs. Elas só podem ser configuradas como negativas e, por padrão, uma nova campanha não conterá critérios de posicionamento. Não são permitidos canais negativos com um URL exatamente igual a adsenseformobileapps.com.

ProximityInfo

As segmentações por raio são implementadas como critérios ProximityInfo. Elas podem ser criadas usando um endereço ou latitude-longitude e com a especificação de um raio. Elas só podem ser configuradas como positivas e, por padrão, uma nova campanha não conterá critérios de proximidade.

Saiba mais sobre a segmentação por raio.

TopicInfo

Por padrão, as novas campanhas não contêm critérios de tópicos. Apenas critérios negativos são compatíveis no nível da campanha.

UserInterestInfo

Por padrão, uma nova campanha não terá critérios de interesse do usuário. Apenas critérios negativos são compatíveis no nível da campanha.

Ao recuperar UserInterest para definir em UserInterestInfo, verifique se os availabilities[] são compatíveis com o tipo de campanha. Algumas opções de UserInterest estão disponíveis apenas para tipos de campanha específicos.

UserListInfo

Por padrão, uma nova campanha não contém critérios de listas de usuários. Use o ID da lista de usuários para identificá-la no critério. Critérios positivos e negativos são compatíveis no nível da campanha.

WebpageInfo

Por padrão, uma nova campanha não contém critérios de página da Web, o que significa que todas as páginas da Web são incluídas. Apenas critérios negativos no nível da campanha são compatíveis.

YouTubeChannelInfo

Por padrão, as novas campanhas não contêm os critérios do canal do YouTube. Apenas critérios negativos são compatíveis no nível da campanha.

YouTubeVideoInfo

Por padrão, as novas campanhas não contêm critérios de vídeo do YouTube. Apenas critérios negativos são compatíveis no nível da campanha.

Critérios do grupo de anúncios

O AdGroupCriterionService permite especificar a segmentação no nível do grupo de anúncios para os tipos a seguir.

AgeRangeInfo: Por padrão, um novo grupo de anúncios não contém critérios de faixa etária, o que significa que todas as idades são incluídas. No nível do grupo de anúncios, é possível excluir ou dar lances em faixas etárias.
AppPaymentModelInfo: No nível do grupo de anúncios, só é possível segmentar critérios do modelo de pagamento do aplicativo.
CombinedAudienceInfo: Qualquer número de critérios de público-alvo pode ser combinado em um público-alvo combinado. Por padrão, os novos grupos de anúncios não têm públicos-alvo combinados. Para mais detalhes, consulte o artigo da Central de Ajuda sobre públicos-alvo combinados.
CustomAffinityInfo: Por padrão, um novo grupo de anúncios não terá critérios de afinidade personalizada. Os critérios de afinidade personalizada são definidos por recursos CustomInterest que precisam ser criados pelo usuário. Somente critérios positivos são aceitos.Neste artigo, você encontra mais detalhes sobre como os critérios de afinidade personalizada funcionam e como usá-los.
CustomIntentInfo: Por padrão, um novo grupo de anúncios não contém critérios de intenção personalizada. Os critérios de intenção personalizada são definidos por recursos CustomInterest que precisam ser criados pelo usuário. Apenas critérios positivos são aceitos. Este artigo contém mais informações sobre como os critérios de intenção personalizada funcionam e como usá-los.
GenderInfo: Por padrão, um novo grupo de anúncios não terá critérios de gênero, ou seja, todos os gêneros serão incluídos. No nível do grupo de anúncios, é possível excluir ou dar lances em gêneros.
IncomeRangeInfo: Por padrão, um novo grupo de anúncios não contém critérios de faixa de renda, ou seja, todas as rendas são incluídas. No nível do grupo de anúncios, é possível dar lances ou excluir faixas de renda.
KeywordInfo: No nível do grupo de anúncios, é possível segmentar ou excluir palavras-chave.
LifeEventInfo: Por padrão, um novo grupo de anúncios não terá critérios de eventos importantes, ou seja, nenhum evento importante será explicitamente segmentado ou excluído. Eventos importantes precisam ser identificados de acordo com o valor do campo id no recurso LifeEvent. Recupere a lista de LifeEvents disponíveis usando GoogleAdsService.SearchStream.
ListingGroupInfo: Os grupos de produtos anunciados definem uma estrutura de critérios baseada em árvore para anúncios de hotel e campanhas do Shopping.
MobileAppCategoryInfo: No nível do grupo de anúncios, é possível segmentar ou excluir critérios de categoria de apps para dispositivos móveis.
MobileApplicationInfo: Por padrão, um novo grupo de anúncios não terá critérios de apps para dispositivos móveis. Cada app para dispositivos móveis precisa ser identificado de acordo com o valor do campo app_id.
ParentalStatusInfo: Por padrão, um novo grupo de anúncios não contém os critérios de status parental, o que significa que todas as categorias de status parental estão incluídas. No nível do grupo de anúncios, é possível dar lances ou excluir categorias de status parental.
PlacementInfo: Elas são criadas usando um URL do cliente. Existem limites para o tamanho (250 caracteres) e a profundidade (dois níveis) dos URLs. Elas só podem ser configuradas como negativas e, por padrão, um novo grupo de anúncios não conterá critérios de posicionamento. Não são permitidos canais negativos com um URL exatamente igual a adsenseformobileapps.com.
TopicInfo: Por padrão, um novo grupo de anúncios não contém os critérios de tópicos. No nível do grupo de anúncios, é possível dar lances ou excluir faixas de renda.
UserInterestInfo: Por padrão, um novo grupo de anúncios não terá critérios de interesse dos usuários. No nível do grupo de anúncios, você pode dar lances ou excluir interesses dos usuários.; Ao recuperar UserInterest para definir em UserInterestInfo, verifique se os availabilities[] são compatíveis com o tipo de campanha. Algumas opções de UserInterest estão disponíveis apenas para tipos de campanha específicos.
UserListInfo: Por padrão, um novo grupo de anúncios não terá critérios de listas de usuários. Use o ID da lista de usuários para identificá-la no critério. No nível do grupo de anúncios, você pode dar lances ou excluir listas de usuários.
WebpageInfo: No nível do grupo de anúncios, é possível segmentar ou excluir critérios de páginas da Web.
YouTubeChannelInfo: No nível do grupo de anúncios, você pode segmentar ou excluir os critérios do canal do YouTube.
YouTubeVideoInfo: No nível do grupo de anúncios, é possível segmentar ou excluir critérios de vídeos do YouTube.

Critérios do cliente

Com o CustomerNegativeCriterionService, é possível especificar a segmentação negativa no nível da conta para os tipos a seguir.

LifeEventInfo: Exclui um evento importante pelo id dele. Recupere a lista de LifeEvents disponíveis usando GoogleAdsService.SearchStream.
MobileAppCategoryInfo: Exclua uma categoria de app para dispositivos móveis na lista MobileAppCategoryConstant.
MobileApplicationInfo: Exclua apps para dispositivos móveis individuais de acordo com o valor do campo app_id.
NegativeKeywordList: Exclua uma SharedSet de palavras-chave. Somente um critério da lista de palavras-chave negativas pode ser anexado por conta.
PlacementInfo: Elas são criadas usando um URL do cliente. Existem limites para o tamanho (250 caracteres) e a profundidade (dois níveis) dos URLs. Canais negativos com um URL exatamente igual a adsenseformobileapps.com não são permitidos.
YouTubeChannelInfo: Excluir um canal do YouTube pelo ID ou código do canal.
YouTubeVideoInfo: Exclua um vídeo específico do YouTube pelo ID dele, conforme exibido na página de exibição do YouTube.

Visão geral

Modificadores de lances