Direcionamento avançado

O direcionamento avançado abrange:

É possível usar combinações das opções avançadas de direcionamento nos seus públicos personalizados e semelhantes. Por padrão, o Facebook usa ORs para fazer combinações. Saiba mais sobre direcionamento básico ou principal.

Caso você use flexible_spec, também será preciso fornecer um dos seguintes dados em targeting:

  • geo_locations (campo de direcionamento geográfico por país, região, cidade, código postal)
  • custom_audiences
  • product_audience_specs
  • dynamic_audience_ids

Limitações

  • Haverá conjuntos distintos de restrições para os anunciantes que veicularem anúncios de moradia, emprego e crédito que estiverem baseados nos Estados Unidos ou que veicularem anúncios direcionados a esse país. Consulte Categorias de anúncio especial.
  • O uso de radius ao direcionar para diversas localizações poderá causar um erro com o código 100 e o subcódigo 1815946. Recomendamos criar um anúncio para cada localização ou não usar radius na chamada.
  • Consulte nosso guia sobre restrições de direcionamento para ver mais limitações.

Celular

Esta seção é útil para anúncios de instalação de app para celular.

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "user_device": ["Galaxy S6","One m9"], 
    "user_os": ["android"] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Você pode combinar categorias, como iPod OU iPad OU iPhone.

Uma categoria não exclui a outra. Ao selecionar iOS, você direcionará para todos os dispositivos que usam esse sistema operacional, incluindo iPhone e iPod, mesmo se não especificar user_device.

Para anúncios com o objetivo de reconhecimento da marca, não será possível direcionar com base no tipo de dispositivo móvel, como celulares comuns ou aparelhos Samsung, nem com base no número de versão do iOS. Só é possível escolher Android, iOS ou todos os celulares.

Campos disponíveis

Campo Descrição

user_os

Tipo: matriz

Obrigatório.

Um ou mais valores da tabela de opções de sistema operacional abaixo. Os valores possíveis estão na API de Pesquisa de Direcionamento com type=adTargetingCategory e class=user_os. Você não pode direcionar anúncios para a versão mínima de uma plataforma na outra plataforma. Contudo, você pode direcionar anúncios às duas plataformas sem especificar as versões mínimas delas.


Valores válidos:
- ['iOS', 'Android']
- ['iOS']
- ['Android_ver_4.2_and_above']
- ['iOS_ver_8.0_to_9.0']
Valores inválidos:
- ['Android', 'iOS_ver_8.0_and_above']
- ['iOS', 'Android_ver_4.0_and_above']

user_device

Tipo: matriz

Opcional.

Os dispositivos devem corresponder ao valor em user_os. Veja os valores possíveis na API de Pesquisa de Direcionamento com type=adTargetingCategory e class=user_device.

excluded_user_device

Tipo: matriz

Opcional.

Dispositivos que serão excluídos. Os dispositivos devem corresponder ao valor em user_os. Veja os valores possíveis na API de Pesquisa de Direcionamento com type=adTargetingCategory e class=user_device.

wireless_carrier

Tipo: matriz

Opcional.

O valor permitido é Wifi. Direcionado aos usuários de dispositivos móveis que estão conectados a redes Wi-Fi.

Opções de sistema operacional

Campo Descrição

iOS

Tipo: string

Dispositivos com iOS, entre eles iPhone, iPad e iPod.

iOS_ver_x.x_and_above

Tipo: string

Dispositivos com iOS que executam a versão x.x e superior do sistema operacional.


Opções: 2.0, 3.0, 4.0, 4.3, 5.0, 6.0, 7.0, 8.0 e 9.0. Exemplo: iOS_ver_4.0_and_above


Para anúncios de apps da Meta:

  • Os conjuntos de anúncios da SKAdNetwork e de Mensuração de Eventos Agregados da Meta são compatíveis somente com versões no intervalo iOS_ver_14.0_and_above.
  • Os conjuntos de anúncios da SKAdNetwork ou de Mensuração de Eventos Agregados da Meta são compatíveis somente com versões no intervalo iOS_ver_2.0_to_14.4.

iOS_ver_x.x_to y.y

Tipo: string

Dispositivos com iOS que executam as versões x.x a y.y do sistema operacional.


Opções: 2.0, 3.0, 4.0, 4.3, 5.0, 6.0, 7.0, 8.0 e 9.0.

Exemplo: iOS_ver_8.0_to_9.0, em que x.x deve ser menor que y.y.

Android

Tipo: string

Dispositivos com Android

Android_ver_x.x_and_above

Tipo: string

Dispositivos com Android que executam a versão x.x e superior.


Opções: 2.0, 2.1, 2.2, 2.3, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 4.3, 4.4, 5.0, 5.1, 6.0, 7.0, 7.1 e 8.0.

Exemplo: Android_ver_4.0_and_above

Android_ver_x.x_to y.y

Tipo: string

Dispositivos com Android que executam as versões x.x a y.y.


Opções: 2.0, 2.1, 2.2, 2.3, 3.0, 3.1, 3.2, 4.0, 4.1, 4.2, 4.3, 4.4, 5.0, 5.1, 6.0, 7.0, 7.1 e 8.0.

Exemplo: Android_ver_4.2_to_8.0, em que x.x. deve ser menor que y.y.

Direcionamento demográfico avançado

Direcionamento com base em relacionamentos, educação, finanças e acontecimentos.

Exemplos

Primeiro, consulte life_events:

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=life_events' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/search

Adicione os resultados a targeting_spec:

curl -X POST \
  -F 'name="My First AdSet"' \
  -F 'daily_budget=10000' \
  -F 'bid_amount=300' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'optimization_goal="REACH"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'promoted_object={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'targeting={
       "facebook_positions": [
         "feed"
       ],
       "age_max": 24,
       "age_min": 20,
       "behaviors": [
         {
           "id": 6002714895372,
           "name": "All travelers"
         }
       ],
       "device_platforms": [
         "mobile"
       ],
       "genders": [
         1
       ],
       "geo_locations": {
         "countries": [
           "US"
         ],
         "regions": [
           {
             "key": "4081"
           }
         ],
         "cities": [
           {
             "key": 777934,
             "radius": 10,
             "distance_unit": "mile"
           }
         ]
       },
       "interests": [
         {
           "id": "<INTEREST_ID>",
           "name": "<INTEREST_NAME>"
         }
       ],
       "life_events": [
         {
           "id": 6002714398172,
           "name": "Newlywed (1 year)"
         }
       ],
       "publisher_platforms": [
         "facebook",
         "audience_network"
       ]
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Agora direcionamos:

  • Localização – Japão, Estados Unidos (raio de 10 milhas de Menlo Park, Califórnia) ou Estados Unidos (Texas)
  • Idade – de 20 a 24 anos
  • Gênero – masculino
  • Interesses – futebol
  • Comportamentos – apenas viajantes frequentes
  • Acontecimento – recém-casados (um ano)
  • Propriedade da residência – locatários

Este é outro exemplo de direcionamento por localização, dados demográficos, status de relacionamento e interesses:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "age_max": 43, 
    "age_min": 18, 
    "genders": [1], 
    "geo_locations": { 
      "regions": [{"key":"3847"}], 
      "cities": [ 
        { 
          "key": "2430536", 
          "radius": 12, 
          "distance_unit": "mile" 
        } 
      ] 
    }, 
    "interests": [{"id":6003139266461,"name":"Movies"}], 
    "relationship_statuses": [ 
      2, 
      3, 
      4 
    ] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Opções possíveis

Nome Descrição

relationship_statuses

Tipo: matriz

Matriz de números inteiros que representam o status de relacionamento.

1 – solteiro(a)

2 – em um relacionamento

3 – casado(a)

4 – noivo(a)

6 – não especificado


Padrão: ALL se você especificar "Null" (Nulo) ou não informar um valor.

Restrições: não use 0.

life_events

Tipo: matriz

Matriz de objetos com o campo "id" e o campo opcional "name": [{'id': 123, 'name': 'foo'}, {'id': 456}, 789]

industries

Tipo: matriz

Matriz de objetos com o campo "id" e o campo opcional "name".

income

Tipo: matriz

Matriz de objetos com o campo "id" e o campo opcional "name".

family_statuses

Tipo: matriz

Matriz de objetos com o campo "id" e o campo opcional "name".

Trabalho e educação

Use a API de Pesquisa de Direcionamento para todas as opções.

Nome Descrição

education_schools

Tipo: matriz

Escolas, faculdades e instituições.


Limite: 200 instituições de ensino.

Exemplo: [{id: 105930651606, 'name': 'Harvard University'}, {id: 105930651607}, 105930651608]

education_statuses

Tipo: matriz

Matriz de números inteiros para o direcionamento com base no nível de escolaridade.

1 – HIGH_SCHOOL (Ensino Médio)

2 – UNDERGRAD (graduação incompleta)

3 – ALUM (ex-estudante)

4 – HIGH_SCHOOL_GRAD (Ensino Médio completo)

5 – SOME_COLLEGE (faculdade não especificada)

6 – ASSOCIATE_DEGREE (diploma de associado)

7 – IN_GRAD_SCHOOL (pós-graduação incompleta)

8 – SOME_GRAD_SCHOOL (pós-graduação não especificada)

9 – MASTER_DEGREE (mestrado completo)

10 – PROFESSIONAL_DEGREE (diploma profissional)

11 – DOCTORATE_DEGREE (doutorado completo)

12 UNSPECIFIED (não especificado)

13 – SOME_HIGH_SCHOOL (instituição de Ensino Médio não especificada)

college_years

Tipo: matriz

Matriz de números inteiros. Formatura na faculdade.


Limite: o primeiro ano permitido é 1980.

education_majors

Tipo: matriz

Graduações.


Exemplo: [{'id': 123, 'name': 'Computer Science'}, {'id': 456}, 789]

Limite: 200

work_employers

Tipo: matriz

Empresa, organização ou local de trabalho.


Exemplo: [{'id':'50431654','name':'Microsoft'}, {'id':50431655}, 50431656]

Limite: 200

work_positions

Tipo: matriz

Cargo informado pelo usuário.


Exemplo: [{'id':105763692790962, 'name':'Contractor'}, {'id':105763692790963}, 105763692790964]

Limite: 200

Públicos personalizados

Crie um público personalizado e adicione usuários. Você pode usar o público para fazer o direcionamento, seja para inclusão ou exclusão. Inclua até 500 públicos personalizados em custom_audiences e 500 em excluded_custom_audiences.

O campo excluded_custom_audiences em targeting_specs não é o mesmo que excluded_custom_audiences no público personalizado APP_COMBINATION.

Campo Descrição

custom_audiences

Tipo: matriz

Matriz de identificações ou objetos de público. Somente no campo 'id': [123, 456] ou [{'id': 123}, {'id': 456}]

excluded_custom_audiences

Tipo: matriz

Matriz de identificações ou objetos de público. Somente no campo 'id': [123, 456] ou [{'id': 123}, {'id': 456}]

targeting:{
     "geo_locations":{
       "countries":["US"],
     },
     "age_min":25,
     "age_max":40,
     "custom_audiences":[{"id":6004192254512}]}
     "excluded_custom_audiences":
       [{"id":6004192252847}],
 }

Localidades

Insira um direcionamento detalhado na localidade:

Campo Descrição

locales

Tipo: matriz

Consulte a seção Localidades em Pesquisa de direcionamento. Índices na submatriz "locales". Direcione o anúncio a contas da Central de Contas com idioma diferente do idioma comum para a localização. Forneça um ID para o idioma, como 5 para "alemão". Limite: 50. Confira o mapeamento de "localidades" virtuais para conjuntos de idiomas na seção sobre localidades em Pesquisa de direcionamento com type=adlocale.

Direcionamento por categoria ampla personalizada

Use categorias amplas para fazer um direcionamento personalizado criado ou permitido especificamente para sua conta. Para incluir as categorias "culinária" e "proprietário de pequena empresa":

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "user_adclusters": [ 
      {"id":6002714885172,"name":"Cooking"}, 
      {"id":6002714898572,"name":"Small Business Owners"} 
    ] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Para excluir as categorias "culinária" e "proprietário de pequena empresa":

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "exclusions": { 
      "user_adclusters": [ 
        {"id":6002714885172,"name":"Cooking"}, 
        {"id":6002714898572,"name":"Small Business Owners"} 
      ] 
    }, 
    "geo_locations": {"countries":["US"]} 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Para fazer o direcionamento de acordo com uma categoria ampla, a localização e os dados demográficos:

curl \
  -F 'name=My AdSet' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "relationship_statuses": [2], 
    "user_adclusters": [{"id":6002714886772,"name":"Food & Dining"}] 
  }' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

A seguinte opção está disponível:

Nome Descrição

user_adclusters

Tipo: matriz

Matriz de pares de nomes de identificação com clusters de categorias amplas. Veja as informações abaixo sobre como recuperar categorias amplas. Limite: 50 pares de nomes e identificações.

Para consultar esse direcionamento por conta de anúncios, faça uma solicitação HTTP GET:

https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/broadtargetingcategories

A resposta é uma matriz de pares chave-valor JSON.

Nome Descrição

id

Tipo: longo

O ID da categoria ampla é usado para a especificação de direcionamento do anúncio.

name

Tipo: string

Nome da categoria ampla.

parent_category

Tipo: string

Categoria principal da categoria ampla.

size_lower_bound

Tipo: número inteiro

Tamanho mínimo do público da categoria ampla.

size_upper_bound

Tipo: número inteiro

Tamanho máximo do público da categoria ampla.

type

Tipo: número inteiro

6 = categoria ampla.

type_name

Tipo: string

Categoria ampla.