Personalización de piezas por ubicación

Usa esta solución para personalizar las piezas de contenido que se muestran en diferentes ubicaciones de anuncios. Mantén el control del contenido a la vez que usas varias ubicaciones distintas.

La personalización de piezas por ubicación es una de nuestras tres API que utilizan las reglas de personalización de piezas. Obtén más información sobre las reglas de personalización de piezas.

Primeros pasos

Paso 1: Crear una campaña publicitaria y un conjunto de anuncios
Paso 2: Proporcionar el contenido y personalizar las piezas
Paso 3: Crear el anuncio
Paso 4 opcional: Obtener insights y analizar los resultados
Paso 5 opcional: Leer el contenido del anuncio

Se ha dejado de admitir la personalización de piezas por ubicación con las publicaciones existentes mediante la API. Solo puedes usar esta opción en el Administrador de anuncios.

Paso 2: Proporcionar el contenido

Usa asset_feed_spec para proporcionar el contenido. Puedes especificar varias piezas de contenido para cada tipo de pieza, tales como imágenes, vídeos, secuencias, títulos y texto del cuerpo. Proporciona solo una descripción del enlace, ya que la descripción del enlace no se puede personalizar por ubicación.

Para aplicar la personalización:

Establece asset_customization_rules en asset_feed_spec.
Para cada regla, añade customization_spec y etiquetas de piezas de contenido.

Para la personalización de piezas por ubicación, las especificaciones asset_feed_spec deben tener más de una regla de personalización asociada.

Consulta Reglas de personalización de piezas.

Propiedades admitidas

Nombre de la propiedad Descripción

Nombre de la propiedad	Descripción
`customization_spec` Tipo: Campos admitidos	Obligatorio. Ubicaciones en las que quieres mostrar las piezas de contenido.
`image_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatoria para el formato `SINGLE_IMAGE`. Etiqueta de la imagen que quieres mostrar. Se asocia a las piezas de contenido de imagen en `asset_feed_spec`.
`video_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatoria para el formato `SINGLE_VIDEO`. Etiqueta del vídeo que quieres mostrar. Se asocia a las piezas de contenido de vídeo en `asset_feed_spec`.
`carousel_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatoria para el formato `CAROUSELS`. Etiqueta de la secuencia que quieres mostrar. Se asocia a las piezas de contenido de secuencia en `asset_feed_spec`. Nota: si se proporcionan secuencias mediante la personalización de activos de ubicación, todos los archivos adjuntos secundarios deberán estar definidos en la especificación de listas de piezas de contenido y referenciados mediante “adlabels”. Es posible que los archivos adjuntos secundarios no estén definidos inline. Consulta las opciones de la especificación de listas de piezas de contenido para obtener más información sobre el formato `carousels`.

customization_spec

Tipo: Campos admitidos

Obligatorio.

Ubicaciones en las que quieres mostrar las piezas de contenido.

image_label

Formato: {"name": "{LABEL_NAME}"}

Obligatoria para el formato SINGLE_IMAGE.

Etiqueta de la imagen que quieres mostrar. Se asocia a las piezas de contenido de imagen en asset_feed_spec.

video_label

Formato: {"name": "{LABEL_NAME}"}

Obligatoria para el formato SINGLE_VIDEO.

Etiqueta del vídeo que quieres mostrar. Se asocia a las piezas de contenido de vídeo en asset_feed_spec.

carousel_label
Formato: {"name": "{LABEL_NAME}"}

Obligatoria para el formato CAROUSELS.

Etiqueta de la secuencia que quieres mostrar. Se asocia a las piezas de contenido de secuencia en asset_feed_spec.

Nota: si se proporcionan secuencias mediante la personalización de activos de ubicación, todos los archivos adjuntos secundarios deberán estar definidos en la especificación de listas de piezas de contenido y referenciados mediante “adlabels”. Es posible que los archivos adjuntos secundarios no estén definidos inline. Consulta las opciones de la especificación de listas de piezas de contenido para obtener más información sobre el formato carousels.

Campos admitidos en `customization_spec`

Nombre de la propiedad	Descripción
`publisher_platforms`	Obligatorio. Posibles ubicaciones para el anuncio. Las opciones son `facebook`, `instagram`, `messenger` y `audience_network`.
`facebook_positions`	Opcional, pero obligatorio si se selecciona Facebook en `publisher_platforms`. Ubicación específica de Facebook. Las opciones son `feed`, `right_hand_column`, `marketplace`, `video_feeds`, `search` y `story`.
`instagram_positions`	Opcional, pero obligatorio si se selecciona Instagram en `publisher_platforms`. Ubicaciones específicas de Instagram. Las opciones son `stream`, `story`, `explore`, `explore_home`, `profile_feed` e `ig_search`. Nota: La ubicación `explore_home` solo admite el formato `SINGLE_IMAGE`.
`messenger_positions`	Opcional, pero obligatorio si se selecciona Messenger en `publisher_platforms`. Ubicaciones específicas de Messenger. Las opciones son `messenger_home`, `sponsored_messages` y `story`.
`audience_network_positions`	Opcional, pero obligatorio si se selecciona Audience Network en `publisher_platforms`. Ubicación específica de Audience Network. Las opciones son `classic`, `instream_video` y `rewarded_video`.

Obtén más información sobre nuestras opciones de ubicación disponibles.

Ejemplo: configuración de listas

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

Ejemplo: personalización de piezas de la sección Explorar de 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

Ejemplo: personalización de piezas de los resultados de búsqueda de 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

Consulta todas las opciones disponibles para una especificación de listas de piezas de contenido.

Paso 5 opcional: Leer el contenido del anuncio

En el caso de los anuncios de personalización de piezas por ubicación, los campos de contenido relacionados con Instagram se deben recuperar mediante {ad-account-id}/ads. Por ejemplo: