API de Marketing

Regras de personalização de ativo

Use esta solução para definir quais criativos você quer exibir nos seus anúncios. Durante a criação de anúncio, você poderá selecionar a combinação de ativos a ser exibida com base nas suas regras de personalização de ativo. Exemplos de ativos criativos incluem imagens, vídeos, texto e corpo de um anúncio.

Oferecemos três APIs que usam regras de personalização de ativo:

Todos os anúncios que usam asset_feed_spec precisam conter ao menos duas regras de personalização de direcionamento. Caso o criativo use asset_feed_spece tenha menos de duas regras, não será possível criar o anúncio.

Primeiros passos

Etapa 1: criar uma campanha de anúncios e um conjunto de anúncios

É possível criar uma campanha de anúncios padrão para regras de personalização de ativo, mas há limitações:

API Objetivos de campanha compatíveis

Personalização de ativo de segmento

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Personalização de ativo de posicionamento

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LEAD_GENERATION, LINK_CLICKS, REACH, VIDEO_VIEWS.

Anúncios em vários idiomas

APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, LINK_CLICKS, REACH, VIDEO_VIEWS.

Para o conjunto de anúncios, use o ponto de extremidade do conjunto de anúncios padrão e defina is_dynamic_creative como false.

Para criar um conjunto de anúncios em uma campanha com optimization_goal definido como conversions:

curl \
  -F 'status=PAUSED'
  -F 'name=Sample Ad Set'
  -F 'campaign_id=<CAMPAIGN_ID>'
  -F 'optimization_goal=OFFSITE_CONVERSIONS'
  -F 'is_dynamic_creative=false'
  -F 'lifetime_budget=1000'
  -F 'promoted_object={"pixel_id": "<PIXEL_ID>", "custom_event_type": "PURCHASE"}'
  -F 'billing_event=IMPRESSIONS'
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP'
  -F 'targeting={"geo_locations": {"countries": ["US"]}}'
  -F 'start_time=2019-04-02'
  -F 'end_time=2019-04-09'
  -F access_token=<ACCESS_TOKEN>
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

Se você usar asset_feed_spec com um conjunto de anúncios otimizado para APP_INSTALLS, você precisará especificar link_url (por exemplo, http://www.abc.com). A link_urldeve ser igual àobject_store_url no promoted_object. Forneça apenas um parâmetro link_url no asset_feed_spec.

asset_feed_spec fornece o criativo para criativo dinâmico, personalização de ativo de posicionamento, anúncios em vários idiomas e personalização de ativo de segmento. O formato da especificação é diferente para cada solução.

Etapa 2: fornecer o criativo do anúncio

Forneça o seu criativo por meio de asset_feed_spec. Um feed de ativos é uma coleção de diferentes elementos de criativo, como imagens, títulos, corpos e assim por diante. É possível especificar diferentes ativos criativos para cada tipo de ativo.

Crie um asset_feed_spec em /adcreative. Para aplicar as opções de personalização, defina asset_customization_rules em asset_feed_spec.

Após a configuração, verifique o seu asset_feed_spec:

curl -G 
-d "access_token=<ACCESS_TOKEN>"
-d "fields=asset_feed_spec" 
https://graph.facebook.com/<API_VERSION>/<AD_CREATIVE_ID>

Ao criar o anúncio, forneça uma referência para a identificação do criativo. É possível criar diversos anúncios por conjunto de anúncios.

curl 
  -F 'name=Asset Custom Rule Ad' 
  -F 'adset_id=<ADSET_ID>' 
  -F 'access_token=<ACCESS_TOKEN>' 
  -F 'creative={
      "creative_id": <CREATIVE_ID>,
   }' 
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

Após a criação: