Personalização de ativo de segmento

Com esta solução, é possível personalizar ativos de anúncio de acordo com os tipos de direcionamento geográfico. Para personalizar ativos com diferentes posicionamentos, consulte Placement Asset Customization.

A Personalização de Ativo de Segmento é uma das nossas três APIs que usam regras de personalização de ativo. Consulte Regras de personalização de ativo.

Com o lançamento da versão 8.0 da API de Marketing, todos os casos de uso não relacionados à geolocalização foram descontinuados na Personalização de Ativo de Segmento. Agora, todas as regras de direcionamento precisam conter informações de geolocalização nas respectivas especificações. Há uma exceção para a regra padrão, que não precisa incluir localização geográfica.

Primeiros passos

Antes de começar, verifique as restrições do produto. Se o caso de uso atender às nossas especificações, prossiga para as seguintes etapas:

Etapa 2: fornecer criativo do anúncio

Opções de personalização

O anúncio pode ser personalizado por localização geográfica. É possível fazer isso criando uma regra com especificações de personalização. O tipo de personalização aceito é o seguinte:

  • Geolocalizações – Compatível com countries, regions, cities, geo_markets, zips e location_types.

O formato para definir a especificação de personalização é semelhante ao formato de direcionamento principal. Consulte Direcionamento básico.

Criar regras de personalização de ativo

Com as regras de personalização de ativo, é possível agrupar ativos que aparecem juntos em determinada localização geográfica. Cada regra tem um customization_spec que define as localizações geográficas das pessoas que podem ver os ativos no momento da veiculação de anúncio.

Durante a criação das regras, é possível especificar uma prioridade para cada uma delas. Caso contrário, cada uma recebe um número de prioridade conforme a posição na lista de regras. Por exemplo, a primeira regra na lista recebe a prioridade 1.

Defina uma regra-padrão a fim de evitar a veiculação de uma combinação aleatória de ativos para pessoas que não atendam às regras. Para isso, faça o seguinte:

  • Crie um customization_spec vazio. Use chaves de abertura e fechamento ao final da regra, desta forma: {}.
  • Atribua a prioridade mais baixa à regra. Este é o número total de regras, incluindo a regra-padrão. Se você tiver 10 regras mais a padrão, a prioridade da regra-padrão será 11.

A regra-padrão faz a correspondência entre um ativo criativo e pessoas que não atendem às regras anteriores.

Na configuração, as regras que não são a padrão devem corresponder a um percentual alto do público-alvo.

Configurar a especificação do feed de ativos

Crie um asset_feed_spec e adicione regras de personalização ao campo asset_customization_rules. É possível adicionar até 50 regras de personalização.

Para cada regra, é preciso especificar customization_spec, priority e as etiquetas do ativo. Seu customization_specnão pode ter mais de 50 condições em uma única regra.

Exemplo de configuração do feed de ativos:

curl \
-F 'object_story_spec={
       "page_id": "<YOUR_PAGE_ID>",
       "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>"
    }' \
-F 'asset_feed_spec={
 "images": [
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image1"}]}, 
   {"hash":"<IMAGE_HASH>", "adlabels":[{"name":"image2"}]}
 ], 
 "bodies": [
   {"text":"Motor City Mission Corps", "adlabels":[{"name":"body1"}]}
 ], 
 "titles": [
   {"text":"Link title 1 goes here", "adlabels":[{"name":"title1"}]}, 
   {"text":"Link title 2 goes here", "adlabels":[{"name":"title2"}]},
   {"text":"Link title 3 goes here", "adlabels":[{"name":"title3"}]}
 ], 
 "call_to_action_types":[
   "LEARN_MORE"
 ],
 "descriptions": [
   {"text":"Begin Your Adventure"}
 ], 
 "ad_formats": [
   "SINGLE_IMAGE"
 ], 
 "link_urls": [
   {"website_url":"https://www.example.com/"}
 ],
 "asset_customization_rules": [
   { 
     "customization_spec": {
        "geo_locations": {
          "countries": ["US"]
        }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title1"},
     "priority": 1
   },
   {
     "customization_spec": {
       "geo_locations": {
          "countries": ["GB"]
        }
     }, 
     "image_label": {"name": "image1"},
     "title_label": {"name": "title2"},
     "priority": 2
   },
   {
     "customization_spec": {
       "geo_locations": {
         "cities": [
           {"key": "2481714"},
           {"key": "2481868"}
         ]
       }
     },
     "image_label": {"name": "image1"},
     "title_label": {"name": "title3"},
     "priority": 4
   },
   {
     "customization_spec": {}, 
     "image_label": {"name":"image2"},
     "title_label": {"name":"title1"},
     "priority": 5
  }]}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Veja todas as opções disponíveis para especificação do feed de ativos. Consulte as próximas etapas em Regras de personalização de ativo.

Etapa 3 (opcional): ver uma prévia do anúncio

Veja uma prévia das diferentes versões da regra de direcionamento do anúncio usando o ponto de extremidade /generatepreview. Também é possível adicionar um campo dynamic_asset_label com o número de prioridade da regra para ver a versão em um idioma específico.

Por exemplo, para ver a prévia de uma regra com prioridade 1:

curl -G --data-urlencode 
'creative={ 
  "object_story_spec": { 
    "page_id": "<PAGE_ID>" 
  },
  "asset_feed_spec": {
    ...
    "asset_customization_rules": [
      { 
        "customization_spec": { 
          "geo_locations": { 
          "countries": ["US"] 
          } 
        },
        "image_label": {
          "name": "image1"
        },
        "title_label": {
          "name": "title1"
        },
        "priority": 1
    },
    ...
    ]
  }
}' 
-d 'ad_format=DESKTOP_FEED_STANDARD' 
-d 'dynamic_asset_label=1'
-d 'access_token=<ACCESS_TOKEN>' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/generatepreviews

Restrições

Categoria de anúncio especial – Há conjuntos diferentes de restrições para anunciantes que estejam nos Estados Unidos e tenham anúncios imobiliários, de emprego e crédito em veiculação ou veiculem anúncios direcionados para o país. Esses anunciantes devem seguir as restrições da categoria de anúncio especial em asset_feed_spec. Saiba mais sobre Categorias de anúncio especial.

Validação do objetivo da campanhaAPP_ENGAGEMENT não é compatível.

Posicionamentos compatíveis – Todos os posicionamentos são compatíveis.

Tipo de compraAlcance e frequência ou AUCTION.

Personalização de posicionamento – Se a personalização de posicionamento for usada em alguma das regras, todas as regras devem incluir a personalização de posicionamento.

As restrições de asset_feed_spec são as mesmas de anúncios baseados em feed sem regras de personalização. Com as seguintes exceções:

  • Cada imagem ou vídeo deve ter uma etiqueta anexada.
  • Apenas uma imagem ou vídeo por asset_customization_rule é elegível para exibição.
  • Formatos de anúncio – Dois ad_formats são compatíveis: SINGLE_IMAGE e SINGLE_VIDEO. Apenas um ad_format é permitido por feed de ativo.
  • É possível fornecer apenas um item em call_to_actions_types.
  • Para cada configuração de posicionamento em um direcionamento de conjunto de anúncios, é preciso fornecer pelo menos uma asset_customization_rule.