API de marketing

Anuncios de video y secuencia

Puedes crear, medir y optimizar de forma sencilla los anuncios de video y secuencia en Facebook a través de la API. Consulta Facebook para empresas, Anuncios por secuencia. Para formatos de video compatibles con los anuncios, consulta el Servicio de ayuda para anunciantes, Videos

Anuncios con video

Documentos de referencia

Para crear un anuncio con video en un objetivo VIDEO_VIEWS y optimizar la puja para aumentar el alcance, sigue estos pasos:

Paso 1: Proporciona contenidos del anuncio

Crea un anuncio con video con el identificador del video preexistente y un video subido a Facebook.

Necesitarás lo siguiente:

  • Permisos pages_read_engagement y ads_management
  • Un video subido al punto de conexión act_{ad-account-id}/advideos
curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Presentación

Si deseas extender o lanzar campañas de marcas para teléfonos con funciones básicas en mercados emergentes o para crear un video simple, prueba las presentaciones con imágenes (se necesitan al menos 3 imágenes). Carga imágenes en un activo de video. Por ejemplo:

curl \
  -F 'slideshow_spec={ 
  "images_urls": [ 
  "<IMAGE_URL_1>", 
  "<IMAGE_URL_2>", 
  "<IMAGE_URL_3>" 
  ], 
  "duration_ms": 2000, 
  "transition_ms": 200 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph-video.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/advideos
 
  Open In Graph API Explorer

Consulta Prácticas recomendadas de contenido de video y Referencia: Anuncios con video.

Paso 2: Crea una campaña publicitaria

Configura el objetivo en VIDEO_VIEWS:

curl -X POST \
  -F 'name="Video Views campaign"' \
  -F 'objective="OUTCOME_ENGAGEMENT"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/campaigns
  
Open In Graph API Explorer

Consulta Referencia: Campaña, AdObjectives en PHP y AdObjectives en Python.

Paso 3: Crea un conjunto de anuncios

Si tu objetivo es lograr el menor costo por reproducción posible, debes emparejar el objetivo de la campaña de reproducción de video con el optimization_goal=THRUPLAY de un conjunto de anuncios. Puedes configurar bidding_event en IMPRESSIONS o THRUPLAY, para pagar por impresión o por reproducción de video. Consulta las pujas de CPV.

curl \
  -F 'name=A CPV Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2024-05-06T04:45:29+0000' \
  -F 'end_time=2024-06-06T04:45:29+0000' \
  -F 'billing_event=THRUPLAY' \
  -F 'optimization_goal=THRUPLAY' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
  "device_platforms": ["mobile"], 
  "geo_locations": {"countries":["US"]}, 
  "publisher_platforms": ["facebook"] 
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets


  Open In Graph API Explorer

Las calificaciones de costos por reproducción son más bajas para conjuntos de anuncios con optimization_goal=THRUPLAY en comparación con los CPV de compra de alcance y frecuencia optimizada para las reproducciones de videos. La fecha final debe ser en el futuro. Consulta Referencia: Conjunto de anuncios.

Paso 4: Crea un anuncio

Usa el conjunto de anuncios existente y el contenido del anuncio:

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
  "creative_id": "<CREATIVE_ID>"
  }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

Cuando un objetivo de la campaña es VIDEO_VIEWS, de forma predeterminada el anuncio obtiene las especificaciones de seguimiento correctas que definen las acciones seguidas por un anuncio. Por ejemplo, las reproducciones de videos:

{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}

Consulta Administrador de anuncios: Mis campañas y Referencia: Anuncio.

Reconocimiento de marca de ejemplo

Para crear un anuncio con video para el reconocimiento de marca, consulta el blog de reconocimiento de marca

Alcance y frecuencia de ejemplo

Documentos de referencia

Para que un video llegue a más gente, usa el objetivo de la campaña de reproducción de video con Alcance y frecuencia. Tienes que crear una predicción, reservarla y asignarla a tu conjunto de anuncios.

Sigue la creación de reproducción de video, pero aplica el alcance y la frecuencia en tu conjunto de anuncios. Especifica estos parámetros adicionales:

-F "rf_prediction_id=<RESERVATION_ID>" \

Video para respuesta directa

Para motivar a la gente para que pase del reconocimiento a la acción, consulta Contenido de video en el formato por secuencia.

  • Llega a las personas que vieron un video. Del reconocimiento a la afinidad y la consideración. Consulta remarketing.
  • Interactúa con marcas y productos. Agrega una llamada a la acción para visitar una página específica en tu sitio web. Consulta llamada a la acción.

Remarketing

El remarketing de anuncios con video permite que los anunciantes realicen una segmentación para ciertos públicos personalizados desde videos pagados u orgánicos en Facebook e Instagram. Usa esta función para lograr que las personas pasen del reconocimiento a los objetivos más profundos del embudo, como la afinidad y la consideración. Consulta Investigación: Combinaciones de contenido que funcionan.

Necesitas un permiso de anunciante para la página que contiene un video para crear un público para ese video.

Para el público, configura subtype=ENGAGEMENT. Luego escribe reglas para el público que desees crear. Cada regla tiene un object_id, como un identificador de video, y event_name. El event_name es uno de los siguientes:

  • video_watched: número de veces que se reprodujo el video durante un total de tres segundos como mínimo, o casi en su totalidad, lo que ocurra primero.
  • video_completed: número de veces que se reprodujo el video hasta el 95% de su duración, incluidas las reproducciones que saltaron hasta este punto.
  • video_view_10s: número de veces que se reprodujo el video durante un total de diez segundos como mínimo, o casi en su totalidad, lo que ocurra primero.
  • video_view_15s: número de veces que se reprodujo el video durante un total de quince segundos como mínimo, o casi en su totalidad, lo que ocurra primero.
  • video_view_25_percent: número de veces que se reprodujo el video hasta el 25% de su duración, incluidas las reproducciones que saltaron hasta este punto.
  • video_view_50_percent: número de veces que se reprodujo el video hasta el 50% de su duración, incluidas las reproducciones que saltaron hasta este punto.
  • video_view_75_percent: número de veces que se vio el video hasta el 75% de su duración, incluidas las visualizaciones que saltaron hasta este punto.

Puedes combinar videos para crear un público según varios videos y acciones. Por ejemplo, un público puede tener reproducciones de 3 segundos del video A y reproducciones completa de los videos B y C.

Esto genera un público de los últimos 14 días de espectadores de videos de más de 3 segundos del video 1 y espectadores del video 2 completo. El público también completa automáticamente los espectadores antes de la creación del público con prefill=true.

curl \
  -F 'name=Video Ads Engagement Audience' \
  -F 'subtype=ENGAGEMENT' \
  -F 'description=Users who watched my video' \
  -F 'prefill=1' \
  -F 'rule=[ 
  {"object_id":"%video_id_1","event_name":"video_watched"}, 
  {"object_id":"%video_id_2","event_name":"video_completed"} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/customaudiences
  
Open In Graph API Explorer

Se admite respaldo para las reproducciones de videos después del 16 de octubre, 2015.

Llamada a la acción

Los videos con llamada a la acción (CTA) incita a las personas a obtener más información y a visitar una página específica en un sitio web. Mejora el rendimiento cuando tu objetivo principal es conducir reproducciones de video o reconocimiento de marca y tu objetivo secundario es conseguir clics fuera del sitio. Debes usar un enlace de video para esto último. Cómo mostrar las llamadas a la acción:

  • En el caso de celulares y computadoras, se muestran como parte de la publicación. Cuando se pausa el video, se muestran al lado de la opción Reanudar.
  • Para celulares, cuando alguien hace clic en un video para ver en pantalla completa, se muestra una CTA flotante como una superposición de video.
  • Las publicaciones externas con video y enlace no muestran CTA.

Puedes usar videos con llamada a la acción solo con los siguientes objetivos de campaña:

Consulta Expansión de video a objetivos adicionales Esto genera un anuncio con video con la llamada a la acción GET_DIRECTIONS:

curl \
  -F 'object_story_spec={ 
  "page_id": "<PAGE_ID>", 
  "video_data": { 
  "call_to_action": { 
  "type": "GET_DIRECTIONS", 
  "value": { 
  "link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\"" 
  } 
  }, 
  "image_url": "<THUMBNAIL_URL>", 
  "link_description": "Come check out our new store in Menlo Park!", 
  "video_id": "<VIDEO_ID>" 
  } 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
   https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Métricas de videos

Estadísticas de publicación con video, orgánico

Documentos de referencia

Obtén más información sobre el rendimiento de los videos en Facebook y toma decisiones más fundamentadas sobre el contenido de video. Actualmente, solo ofrecemos métricas cuando alguien comienza a ver videos. Esto incluye reproducciones de video, reproducciones de videos únicos, la duración promedio de la reproducción de video y la retención de público. Observa en qué parte las personas abandonan tus videos y qué partes les resulta más interesante.

Estadísticas de anuncios con video, pagados

Usa la API de estadísticas de anuncios. La respuesta contiene varias métricas de videos.

Tipo de video

Recupera estadísticas de anuncio con video agrupadas según el tipo de video, por ejemplo, reproducción automática o reproducción con un clic. Incluye action_video_type en action_breakdowns. Los valores previstos para action_video_type son total, click_to_play y auto_play.

Actualmente estamos en fase de prueba limitada para la opción action_video_type. Para identificar a los clientes con desglose, consulta CAN_USE_VIDEO_METRICS_BREAKDOWN para la cuenta publicitaria.

curl -G \
  -d 'action_breakdowns=action_video_type' \
  -d 'date_preset=last_30_days' \
  -d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
  -d 'access_token= <ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
   
Open In Graph API Explorer

La respuesta incluye objetos con action_type como video_view y contiene una clave action_video_type:

{
  "data": [
    {
      "actions": [
        ...
        {
          "action_type": "video_play", 
          "value": 9898
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 921129
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 915971
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 5158
        }
      ], 
      "video_avg_pct_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 60.59
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 60.47
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 80.63
        }
      ], 
      "video_complete_watched_actions": [
        {
          "action_type": "video_view", 
          "action_video_type": "total", 
          "value": 156372
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "auto_play", 
          "value": 154015
        }, 
        {
          "action_type": "video_view", 
          "action_video_type": "click_to_play", 
          "value": 2357
        }
      ], 
      "date_start": "2014-12-26", 
      "date_stop": "2015-03-25"
    }
  ], 
  "paging": {
    "cursors": {
      "before": "MA==", 
      "after": "MA=="
    }
  }
}

Consulta la API de estadísticas de anuncios.

Consigue más espacio de contenido en el feed y atrae a las personas a tu sitio web o a la app para celulares a fin de obtener la conversión. Crea un anuncio por secuencia de dos modos:

No se admiten los anuncios por secuencia en Facebook Stories.

Crear directamente

Crea una publicación de la página de anuncio por secuencia durante la creación del contenido del anuncio. Especifica el contenido de la publicación de la página en object_story_spec, que crea una publicación de página oculta de adcreatives. Consulta Contenido del anuncio. Por ejemplo:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "link_data": { 
      "child_attachments": [ 
        { 
          "description": "$8.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product1", 
          "name": "Product 1", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$9.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product2", 
          "name": "Product 2", 
          "video_id": "<VIDEO_ID>" 
        }, 
        { 
          "description": "$10.99", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/product3", 
          "name": "Product 3" 
        } 
      ], 
      "link": "<URL>" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

La respuesta es un identificador de contenido:

{"id":"<CREATIVE_ID>"}

Crea una publicación y luego el anuncio

Crea una publicación de página oculta. child_attachments es una matriz de objetos de enlace. En cada objeto de enlace, picture, name y description son opcionales. Puedes publicarlos a través de la página pero solo con un token de acceso a la página.

curl -X GET \
  -d 'message="Browse our latest products"' \
  -d 'published=0' \
  -d 'child_attachments=[
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 1",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 2",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 3",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       },
       {
         "link": "<APP_STORE_URL>",
         "name": "Product 4",
         "description": "$4.99",
         "image_hash": "<IMAGE_HASH>"
       }
     ]' \
  -d 'caption="WWW.EXAMPLE.COM"' \
  -d 'link="http://www.example.com/products"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<PAGE_ID>/posts
  
Open In Graph API Explorer

Luego, proporciona contenido del anuncio con la publicación de página oculta. Usa el id del object_story_id en el contenido del anuncio.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Crea un anuncio con video por secuencia

Los anuncios con video por secuencia pueden tener subtítulos en el adjunto secundario para personalizar la URL que se muestra en el final de la pantalla:

"child_attachments": [
 {
   "link": "https://www.facebookmarketingdevelopers.com/",
   "name": "Facebook Marketing Developers",
   "description": "Facebook Marketing Developers",
   "call_to_action": {
     "type": "APPLY_NOW",
     "value": {
      "link_title": "Facebook Marketing Developers"
     }
   },
   "video_id": "123",
   "caption": "mycustomlinkcaption.com"
  },
]

Para obtener detalles sobre los adjuntos secundarios, usa el identificador y llama a la API Graph, Video, Referencia.

Crear un anuncio sobre apps para celulares

Limitaciones:

  • Los anuncios por secuencia sobre apps para celulares admiten una sola app
  • Mínimo de 3 imágenes en comparación con 2 en anuncios por secuencia de anuncios sin app
  • Los anuncios por secuencia sobre apps para celulares deben tener una llamada a la acción
  • La tarjeta final (que, por lo general, muestra la foto de perfil de la página) no se mostrará en los anuncios por secuencia sobre apps para celulares. Ten en cuenta que debes especificar el mismo enlace de las tiendas de app en cada child_attachment. No tienes que especificar el enlace nuevamente en la call_to_action:{'value':{'link':... }}}

Por ejemplo, para crear un anuncio por secuencia para instalaciones de la aplicación para celulares:

\

curl -X POST \
  -F 'name="Carousel app ad"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "message": "My message",
         "link": "http://www.example.com/appstoreurl",
         "caption": "WWW.ITUNES.COM",
         "name": "The link name",
         "description": "The link description",
         "child_attachments": [
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           },
           {
             "link": "http://www.example.com/appstoreurl",
             "image_hash": "<IMAGE_HASH>",
             "call_to_action": {
               "type": "USE_MOBILE_APP",
               "value": {
                 "app_link": "<DEEP_LINK>"
               }
             }
           }
         ],
         "multi_share_optimized": true
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Solo puedes hacer tus publicaciones cuando la página de Facebook esté asociada con la app para celulares. Además, tienes que usar un token de acceso a la página.

curl \
  -F 'message=My description' \
  -F 'link=<APP_STORE_URL>' \
  -F 'caption=WWW.ITUNES.COM' \
  -F 'child_attachments=[ 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    }, 
    { 
      "link": "<APP_STORE_URL>", 
      "image_hash": "<IMAGE_HASH_I>", 
      "call_to_action": { 
        "type": "USE_MOBILE_APP", 
        "value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"} 
      } 
    } 
  ]' \
  -F 'multi_share_optimized=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/<PAGE_ID>/feed

Usa el id de la respuesta para crear el contenido del anuncio.

curl -X POST \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

Especificación de campos

Este es un anuncio por secuencia en iOS que muestra cómo se usan los campos descriptos.

Nombre Descripción

child_attachments

Tipo: objeto

Una matriz de 2 a 10 elementos de objetos de enlace necesarios para anuncios por secuencia. Debes usar al menos 3 objetos para un rendimiento óptimo; 2 objetos para permitir las integraciones ligeras. El uso de 2 objetos puede arrojar resultados de campaña óptimos.

child_attachments.link

Tipo: cadena

La URL de enlace o la URL de la tienda de apps se adjuntan en la publicación. Obligatorio.

child_attachments.picture

Tipo: URL

Imagen de vista previa asociada al enlace. Relación de aspecto 1:1 y un mínimo de 458 x 458 píxeles para una mejor visualización. Debe especificarse picture o image_hash.

child_attachments.image_hash

Tipo: cadena

Hash de la imagen de vista previa asociada al enlace desde tu biblioteca de imágenes. Usa una relación de aspecto de 1:1 y un tamaño mínimo de 458 × 458 píxeles para obtener una mejor visualización. Debe especificarse picture o image_hash.

child_attachments.name

Tipo: cadena

Título de la vista previa del enlace. Si no se especifica, se usa el título de la página vinculada. Por lo general, se trunca después de los 35 caracteres. Debes configurar un name único, ya que las interfaces de Facebook muestran acciones reportadas por name.

child_attachments.description

Tipo: cadena

Cualquier precio, descuento o dominio de sitio web. Si no se especifica, se extrae y usa el contenido de la página vinculada. Por lo general, se trunca después de los 30 caracteres.

child_attachments.call_to_action

Tipo: objeto

Llamada a la acción opcional. Consulta Llamada a la acción. No tienes que especificar el enlace nuevamente en call_to_action:{'value':{'link':... }}}

child_attachments.video_id

Tipo: cadena

Identificador del video con anuncio. Se puede usar en cualquier elemento secundario. Si se especifica, también se debe configurar image_hash o picture.

message

Tipo: cadena

El cuerpo principal de la publicación, denominado también "mensaje de estado".

link

Tipo: cadena

URL de un enlace a "Ver más". Obligatorio.

caption

Tipo: cadena

URL que se muestra en el enlace "Ver más". No se aplica a los anuncios por secuencia sobre apps para celulares.

multi_share_optimized

Tipo: booleano

Si está configurado en true, automáticamente selecciona y ordena las imágenes y los enlaces. De lo contrario, usa el orden original de los elementos secundarios. El valor predeterminado es true.

multi_share_end_card

Tipo: booleano

Si se configura como false, elimina la tarjeta final, que muestra el icono de la página. El valor predeterminado es true.

Estadísticas de anuncio por producto

Agrupa las acciones de anuncios por secuencia por cada producto con actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']. Cada child_attachment tiene un identificador de tarjeta diferente. action_carousel_card_id y action_carousel_card_name es únicamente para anuncios por secuencia.

Obtén las siguientes estadísticas por tarjeta:

  • website_ctr: disponible cuando se especifica fields=['website_ctr']
  • app_install, app_use, apps.uses, credit_spent, mobile_app_install, tab_view, link_click, mobile_app_install, app_custom_event.*, offsite_conversion.*: disponible cuando se especifica fields=['actions']. Otras acciones no están disponibles con un desglose por tarjetas.
curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
  -d 'level=ad' \
  -d 'date_preset=last_30_days' \
  -d 'time_increment=all_days' \
  -d 'breakdowns=placement' \
  --data-urlencode 'filtering=[ 
    { 
      "field": "action_type", 
      "operator": "IN", 
      "value": ["link_click"] 
    } 
  ]' \
  -d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Respuesta:

{
...
   "website_ctr": [
      {
         "action_carousel_card_id": "1",
         "action_type": "link_click",
         "value": 51.401869158878
      },
      {
         "action_carousel_card_id": "2",
         "action_type": "link_click",
         "value": 50.980392156863
      }
   ],
   "placement": "mobile_feed",
   "date_start": "2015-05-25",
   "date_stop": "2015-05-28"
}

También puedes solicitar cost_per_action_type para un desglose de costos por tipo de acción:

curl -G \
  -d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
  -d 'level=ad' \
  -d 'breakdowns=placement' \
  -d 'fields=impressions,campaign_name,cost_per_action_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/insights
  
Open In Graph API Explorer

Ejemplo de respuesta:

{
   "data": [
      {
         "impressions": "1862555",
         "campaign_name": "My Campaign",
         "cost_per_action_type": [
            {
               "action_carousel_card_name": "My Carousel Card 1",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.093347346315861
            },
            {
               "action_carousel_card_name": "My Carousel Card 2",
               "action_type": "app_custom_event.fb_mobile_activate_app",
               "value": 0.38324089579301
            },
            ...
         ],
      }
   ]
}
  • Las métricas de desglose por secuencia de action_report_time=impression son inexactas antes del 20 de junio de 2015.
  • Las métricas de desglose por secuencia para action_report_time=conversion son inexactas antes del 20 de julio, 2015.

Ubicaciones

Si solo seleccionas right_hand_column como tu ubicación, solo puedes usar un único video o un formato por secuencia en tu grupo de anuncios. No admitimos el formato de video con una sola ubicación right_hand_column seleccionada. Consulta Segmentación y ubicación avanzadas

Por ejemplo, crea un conjunto de anuncios con right_hand_column como tu única ubicación:

curl \
  -F 'name=RHS only Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=500' \
  -F 'start_time=2017-11-21T15:41:36+0000' \
  -F 'end_time=2017-11-28T15:41:36+0000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'bid_amount=100' \
  -F 'targeting={ 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook"] ,
    "facebook_positions": ["right_hand_column"] ,  
  }' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets
  
Open In Graph API Explorer

Proporciona contenido del anuncio con video:

curl \
  -F 'name=Sample Creative' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"} 
  }' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

O bien, proporciona un formato de anuncio de Canvas para contenido del anuncio:

curl \
  -F 'image_hash=<IMAGE_HASH>' \
  -F 'object_story_spec={ 
    "link_data": { 
      "call_to_action": {"type":"LEARN_MORE"}, 
      "image_hash": "<IMAGE_HASH>", 
      "link": "CANVAS_LINK", 
      "name": "Creative message" 
    }, 
    "page_id": "<PAGE_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

Si intentas crear un anuncio con el conjunto de anuncios y el contenido del anuncio:

curl \
  -F 'name=My Ad' \
  -F 'adset_id=<AD_SET_ID>' \
  -F 'creative={"creative_id":"<CREATIVE_ID>"}' \
  -F 'status=ACTIVE' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

En caso de que recibas un código de error, debes proporcionar un contenido admitido o cambiar la segmentación.

Consulta también: