Criativo do anúncio

Personalização de ativos por posicionamento

Use esta solução para personalizar os ativos de criativos exibidos em diferentes posicionamentos de anúncio. Mantenha o controle sobre o criativo enquanto usa vários posicionamentos diferentes.

A Personalização de Ativos por Posicionamento é uma das nossas três APIs que usam regras de personalização de ativos. Saiba mais sobre as regras de personalização de ativos.

Primeiros passos

A personalização de ativos por posicionamento com publicações existentes não é mais compatível com a API. Só é possível usar essa opção no Gerenciador de Anúncios.

Etapa 2: fornecer um criativo

Use asset_feed_spec para fornecer seu criativo. Você pode especificar vários ativos de criativo para cada tipo, incluindo imagens, vídeos, carrosséis, títulos e corpo de texto. Forneça apenas uma descrição do link, já que ela não pode ser personalizada por posicionamento.

Para aplicar a personalização:

  1. Inclua asset_customization_rules nas asset_feed_spec.
  2. Para cada regra, adicione customization_spec e rótulos de ativos.

Para a personalização de ativos por posicionamento, cada asset_feed_spec precisa ter mais de uma regra de personalização anexada a ela.

Consulte as regras de personalização de ativos.

Propriedades aceitas


Nome da propriedade Descrição

customization_spec

tipo: campos compatíveis

Obrigatório.

Posicionamentos onde você quer exibir os ativos.

image_label

formato: {"name": "{LABEL_NAME}"}

Obrigatório para o formato SINGLE_IMAGE.

Rótulo da imagem que você quer exibir. Está anexado aos ativos de imagem nas asset_feed_spec.

video_label

formato: {"name": "{LABEL_NAME}"}

Obrigatório para o formato SINGLE_VIDEO.

Rótulo do vídeo que você quer exibir. Está anexado aos ativos de vídeo nas asset_feed_spec.

carousel_label
formato: {"name": "{LABEL_NAME}"}

Obrigatório para o formato CAROUSELS.

Rótulo do carrossel que você quer exibir. Está anexado aos ativos de carrossel nas asset_feed_spec.

Observação: se estiver fornecendo carrosséis por meio do processo de personalização de ativos por posicionamento, todos os anexos derivados precisarão ser definidos nas especificações do feed de ativos e referenciados usando rótulos de anúncios. Os anexos derivados não podem ser definidos em linha. Consulte Opções de especificações do feed de ativos para saber mais sobre o formato carousels.

Campos compatíveis nas customization_spec


Nome da propriedade Descrição

publisher_platforms

Obrigatório.

Possíveis posicionamentos para seu anúncio. Opções aceitas: facebook, instagram, messenger e audience_network.

facebook_positions

Opcional; será necessário se o Facebook for selecionado em publisher_platforms.

Posicionamento específico do Facebook. Opções aceitas: feed, right_hand_column, marketplace, video_feeds, search e story.

instagram_positions

Opcional; será necessário se o Instagram for selecionado em publisher_platforms.

Posicionamentos específicos do Instagram. Opções aceitas: stream, story, explore, explore_home, profile_feed e ig_search.

Observação: o posicionamento explore_home é compatível apenas com o formato SINGLE_IMAGE.

messenger_positions

Opcional; será necessário se o Messenger for selecionado em publisher_platforms.

Posicionamentos específicos do Messenger. Opções aceitas: messenger_home, sponsored_messages e story.

audience_network_positions

Opcional; será necessário se o Audience Network for selecionado em publisher_platforms.

Posicionamento específico do Audience Network. Opções aceitas: classic, instream_video e rewarded_video.

Saiba mais sobre nossas opções de posicionamento disponíveis.

Exemplo – Configuração do feed

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Exemplo – Personalização de ativos da página Explorar do Instagram

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Exemplo – Personalização de ativos nos resultados da pesquisa do Instagram

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Veja todas as opções disponíveis para especificação do feed de ativos.

Etapa 5 (opcional): ler o criativo do anúncio

Para anúncios de personalização de ativos por posicionamento, os campos de criativos relacionados ao Instagram devem ser recuperados via {ad-account-id}/ads. Por exemplo:

https://graph.facebook.com/v21.0/{ad-account-id}/ads?fields=creative{effective_instagram_story_id,instagram_permalink_url}