Personalización de activos según la ubicación

Utiliza esta solución para personalizar los activos de contenido que se muestran en diferentes ubicaciones de anuncios. Mantén el control del contenido mientras utilizas varias ubicaciones diferentes.

La personalización de activos según la ubicación es una de nuestras tres API que utilizan reglas de personalización de activos. Obtén más información sobre las reglas de personalización de activos.

Primeros pasos

Paso 1: Crear una campaña de anuncios y un conjunto de anuncios
Paso 2: Proporcionar contenido y personalizar activos
Paso 3: Crear el anuncio
Paso 4 (opcional): Obtener estadísticas y analizar resultados
Paso 5 (opcional): Leer el contenido del anuncio

La API dejó de admitir la personalización de activos según la ubicación con publicaciones preexistentes. Solo puedes utilizar esta opción en el administrador de anuncios.

Paso 2: Proporcionar contenido

Usa asset_feed_spec para proporcionar tu contenido. Puedes especificar varios activos de contenido para cada tipo de activo, incluidos videos, imágenes, secuencias, encabezados y textos del cuerpo. Solo proporciona una descripción del enlace, ya que esta descripción no se puede personalizar según la ubicación.

Para aplicar personalización:

Configura asset_customization_rules dentro de asset_feed_spec.
En cada regla, agrega customization_spec y etiquetas de activos.

En lo que respecta a la personalización de activos según la ubicación, cada asset_feed_spec debe tener adjunta más de una regla de personalización.

Consulta Reglas de personalización de activos.

Propiedades admitidas

Nombre de la propiedad Descripción

Nombre de la propiedad	Descripción
`customization_spec` Tipo: campos admitidos	Obligatorio. Ubicaciones en las que deseas mostrar los activos.
`image_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatorio para el formato `SINGLE_IMAGE`. Etiqueta de la imagen que deseas mostrar. Se adjunta a los activos de imagen en `asset_feed_spec`.
`video_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatorio para el formato `SINGLE_VIDEO`. Etiqueta del video que deseas mostrar. Se adjunta a los activos de video en `asset_feed_spec`.
`carousel_label` Formato: `{"name": "{LABEL_NAME}"}`	Obligatorio para el formato `CAROUSELS`. Etiqueta de la secuencia que deseas mostrar. Se adjunta a los activos de la secuencia en `asset_feed_spec`. Nota: Si vas a proporcionar secuencias a través de la personalización de activos según la ubicación, todos los adjuntos secundarios se deben definir dentro de la especificación de la lista de activos y se debe hacer referencia a ellos a través de etiquetas de anuncios. Es posible que los adjuntos secundarios no se puedan definir de forma directa. Consulta Opciones de la especificación de la lista de activos para obtener más detalles sobre el formato `carousels`.

customization_spec

Tipo: campos admitidos

Obligatorio.

Ubicaciones en las que deseas mostrar los activos.

image_label

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

Obligatorio para el formato SINGLE_IMAGE.

Etiqueta de la imagen que deseas mostrar. Se adjunta a los activos de imagen en asset_feed_spec.

video_label

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

Obligatorio para el formato SINGLE_VIDEO.

Etiqueta del video que deseas mostrar. Se adjunta a los activos de video en asset_feed_spec.

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

Obligatorio para el formato CAROUSELS.

Etiqueta de la secuencia que deseas mostrar. Se adjunta a los activos de la secuencia en asset_feed_spec.

Nota: Si vas a proporcionar secuencias a través de la personalización de activos según la ubicación, todos los adjuntos secundarios se deben definir dentro de la especificación de la lista de activos y se debe hacer referencia a ellos a través de etiquetas de anuncios. Es posible que los adjuntos secundarios no se puedan definir de forma directa. Consulta Opciones de la especificación de la lista de activos para obtener más detalles sobre el formato carousels.

Campos admitidos en `customization_spec`

Nombre de la propiedad	Descripción
`publisher_platforms`	Obligatorio. Ubicaciones posibles de tu anuncio. Las opciones son: `facebook`, `instagram`, `messenger` y `audience_network`.
`facebook_positions`	Opcional, pero es obligatorio si se seleccionó 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 es obligatorio si se seleccionó Instagram en `publisher_platforms`. Ubicaciones específicas de Instagram. Las opciones son: `stream`, `story`, `explore`, `explore_home`, `profile_feed` y `ig_search`. Nota: La ubicación `explore_home` solo admite el formato `SINGLE_IMAGE`.
`messenger_positions`	Opcional, pero es obligatorio si se seleccionó Messenger en `publisher_platforms`. Ubicaciones específicas de Messenger. Las opciones son: `messenger_home`, `sponsored_messages` y `story`.
`audience_network_positions`	Opcional, pero es obligatorio si se seleccionó 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 del 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

Ejemplo: personalización de activos para el inicio 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 activos para 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 en relación con las especificaciones de listas de activos.

Paso 5 (opcional): Leer el contenido del anuncio

En relación con los anuncios de personalización de activos según la ubicación, se deberán recuperar los campos de contenido relativos a Instagram mediante {ad-account-id}/ads. Por ejemplo: