Estudio de lift

Crea y pon en marcha un experimento para medir la eficacia de tu campaña de Facebook. Determina cuál es la estrategia publicitaria que genera el mayor impacto para tu empresa. Consulta la referencia sobre el estudio publicitario.

Al crear un estudio de lift, se crea un grupo de prueba aleatorio de cuentas del Centro de cuentas que ven tus anuncios y un grupo de control que no los ve.

Puedes compartir de forma segura los datos de conversión de la campaña publicitaria con Facebook mediante píxeles de Facebook o eventos de la aplicación. Facebook determina el aumento de las conversiones derivado de la campaña. Comparamos el número de conversiones, las cuentas del Centro de cuentas que las han realizado y los ingresos de ventas disponibles de los grupos de prueba y control.

Configurar estudios

Configura un estudio con uno o varios grupos, también llamados celdas. Cuando se configura un estudio, Facebook selecciona de forma aleatoria la audiencia para los anuncios y asigna cuentas del Centro de cuentas al grupo de prueba o control. Tras realizar el estudio, Facebook calcula la diferencia entre estos grupos para que puedas evaluar el impacto que tienen los anuncios de la plataforma en tus objetivos de negocio.

Para configurar un estudio, haz una llamada POST:

'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Puedes configurar un estudio con un solo grupo de prueba para comprobar cómo generan nuevas oportunidades de negocio los anuncios de Facebook. También puedes configurar un estudio con varios grupos de prueba a fin de determinar cuál es el mejor enfoque publicitario para tu audiencia.

Ejemplo: configurar un estudio de lift con un grupo de prueba

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Para crear un estudio nuevo, proporciona la siguiente información:

Crear un grupo de prueba

Para empezar, determina cuántas cuentas del Centro de cuentas reciben tus anuncios y cuántas no. Al configurar el estudio, debes crear un grupo de prueba y pasar una lista de objetos JSON a cells en ad_studies. Consulta la referencia sobre las celdas del estudio del anuncio. Un grupo de prueba contiene la siguiente información.

Ejemplo: leer los grupos de prueba de un estudio

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>/cells'

Ejemplo: actualizar o modificar la información de la celda y los porcentajes de tratamiento y control al proporcionar el identificador de la celda en cells

curl \
  -F 'cells=[{id:<CELL_ID>,treatment_percentage:80,control_percentage:20}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Ejemplo: leer todos los estudios creados en ad_studies para el negocio

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Para ver todos los estudios asociados con la cuenta publicitaria, envía una solicitud GET a {ad-account-ID/include_all_studies=true} con el identificador de acceso.

Configurar varios grupos de prueba

Configura un estudio con varios grupos de prueba de usuarios de Facebook. Así puedes medir el impacto incremental de las diferentes estrategias de Facebook en tus objetivos empresariales, como el uso de diferentes opciones de segmentación de anuncios. Para configurar un estudio con varios grupos de prueba, proporciona una lista de grupos de prueba en cells.

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"group A",description:"description of group A",treatment_percentage:50,control_percentage:20,campaigns:[<CAMPAIGN_ID1>]},{name:"group B",description:"description of group B",treatment_percentage:20,control_percentage:10,campaigns:[<CAMPAIGN_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

control_percentage determina el grupo de exclusión de cada grupo de prueba en relación con la población total. Por ejemplo, imagina que tienes un estudio con dos grupos de prueba: el grupo A tiene un tratamiento del 50 % y un control del 20 %, mientras que el grupo B tiene un tratamiento del 20 % y un control del 10 %. Esto produce un resultado de ~28,6 % o 20 %/70 % de la población en el grupo A como usuarios de control, y un resultado de ~33,3 % o 10 %/30 % de la población en el grupo B para el mismo fin.

Por lo general, la suma de los porcentajes de tratamiento y control en los grupos de prueba debe ser igual a 100. Sin embargo, puede ser inferior a esta cifra con ciertos casos de uso específicos. Por ejemplo, si tienes tres grupos de prueba que están divididos de manera uniforme al 33 %.

Si lo deseas, puedes actualizar, añadir y eliminar grupos de prueba en un estudio.

• Para actualizar un grupo de prueba existente, consulta su correspondiente identificador.
• Para añadir un nuevo grupo de prueba, proporciona un nuevo objeto de este tipo de grupo.
• Para eliminar un grupo de prueba, solo tienes que omitirlo de cells al actualizar el estudio:

curl \
  -F 'cells=[{id:<CELL_ID1>,treatment_percentage:60,control_percentage:10},{name:"group C",description:"replacing group B",treatment_percentage:25,control_percentage:5,campaigns:[<CAMPAIGN_ID3>]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Definir objetivos publicitarios

Define los objetivos publicitarios que deseas medir y cómo se deben pasar los datos de conversión a Facebook. Un estudio de lift requiere al menos un objetivo. Una vez iniciado el estudio, los objetivos no se pueden modificar. Consulta la referencia sobre el objetivo del estudio publicitario.

Ejemplo: crear y añadir el objetivo CONVERSIONS a un estudio

curl \
  -F 'name="new study"' \
  -F 'description="description of my study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"new objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID>}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Si utilizas CONVERSIONS, así como el píxel de Facebook o la aplicación para móviles como orígenes del evento, debes proporcionar una lista de los nombres de evento que quieres capturar para el objetivo. De este modo, Facebook podrá notificar los resultados en función de estos eventos de conversión específicos.

Crear un objetivo

Para crear un objetivo, pasa una lista de objetos JSON objectives cuando crees un estudio nuevo. Los objetivos contienen la siguiente información:

Si lo deseas, puedes definir varios objetivos por estudio. El resultado se recopilará en función de los objetivos. A continuación, se incluye un ejemplo de un estudio con varios objetivos.

curl \
  -F 'name="another study"' \
  -F 'description="description of another study"' \
  -F 'start_time=1435622400' \
  -F 'end_time=1436918400' \
  -F 'cooldown_start_time=1433116800' \
  -F 'observation_end_time=1438300800' \
  -F 'viewers=[<USER_ID1>, <USER_ID2>]' \
  -F 'type=LIFT' \
  -F 'cells=[{name:"test group",description:"description of my test group",treatment_percentage:90,control_percentage:10,adaccounts:[<ACCOUNT_ID1>,<ACCOUNT_ID2>]}]' \
  -F 'objectives=[{name:"first objective objective",is_primary:true,type:"CONVERSIONS",applications:[{id:<APP_ID1>},{id:<APP_ID2>}]},{name:"scond  objective",type:"CONVERSIONS",applications:[{id:<APP_ID3>,event_names:["fb_mobile_purchase"]}],adspixels:[{id:<FB_PIXEL_ID>,event_names:["fb_pixel_purchase","fb_pixel_lead"]}]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_studies'

Si deseas actualizar, añadir y eliminar objetivos en un estudio, puedes hacerlo en el nivel de estudio de forma similar al proceso de modificación de los grupos de prueba. Para actualizar un objetivo existente, consulta su identificador en el objeto objectives. Para añadir un objetivo nuevo, proporciona un nuevo objeto “objective”. Para eliminar un objetivo, omítelo del parámetro objectives cuando lo actualices.

Ejemplo: actualizar los orígenes de medición de applications de un objetivo y eliminar los de adspixels

curl \
  -F 'objectives=[{id:<OBJECTIVE_ID>,name:"new objective name",applications:[{id:<APP_ID>}],adspixels:[]}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_ID>'

Ejemplo: leer los objetivos de un estudio

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Informes

Recuperar objetivos

Los objetivos de un estudio se definen durante su configuración. Consulta en la guía de configuración cómo definir los objetivos del estudio.

Para leer los objetivos que se crearon para un estudio, haz una llamada GET al perímetro objectives del estudio.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Recuperar los resultados

Para recuperar los resultados de un objetivo, haz una llamada GET al nodo del objetivo y especifica results en el parámetro de los campos. El campo last_updated_results también te indica cuándo se actualizaron por última vez los datos de los resultados de este objetivo concreto.

Ejemplo de respuesta que se muestra como JSON analizado para facilitar la lectura.

Comando:

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

Los datos resultantes son un objeto JSON que contiene el nombre de las métricas y cadenas de valores. Consulta el Glosario de métricas de lift de Facebook.

Con compradores:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"buyers_control_raw_scaled":37672.615701199,
	"buyers_exposed":30085.482427228,
	"buyers_frequentist_pValue":0.00064950107027983,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961,
	"buyers_test":40732.369934386,
	"buyers_control_scaled":41990.129061459,
	"buyers_incremental":-1257.7591270729,
	"buyers_notExposed":36617.935710157,
	"buyers_confidence":0.19318944031404,
	"buyers_multicell_confidence":null,
	"buyers_incremental_lower":-2905.5296282828,
	"buyers_incremental_upper":426.25813050358,
	"buyers_multicell_rank":null,
	"buyers_incremental_share":-0.041806181107957,
	"buyers_CPiB":-20.718593440578}"
	  ],
	  "id": "<objective_id>"
}

Sin compradores:

{
	"results": [
	"{"cell_id":"<cell_id>",
	"population_test":2334212,
	"population_control":123407,
	"population_reached":1862084,
	"impressions":19020874,
	"spend":26059,
	"conversions_control_raw_scaled":110918.27003534,
	"conversions_exposed":86961.044050743,
	"conversions_raw_pValue":0.12863848309723,
	"conversions_test":104412.89695396,
	"conversions_control_scaled":104575.81331581,
	"conversions_incremental":-162.91636184894,
	"conversions_notExposed":87123.960412592,
	"conversions_confidence":0.69291721817069,
	"conversions_multicell_confidence":null,
	"conversions_incremental_lower":-3470.6251396487,
	"conversions_incremental_upper":3235.0644420632,
	"conversions_multicell_rank":null,
	"conversions_incremental_share":-0.001873440730011,
	"conversions_CPiC":-159.95324044961}"
	  ],
	  "id": "<objective_id>"
}

Resultados desglosados

Además de recuperar los resultados por objetivo, puedes proporcionar el parámetro breakdowns para desglosarlos.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&breakdowns=["cell_id"]'

A continuación, se enumeran las dimensiones de desglose disponibles:

Los resultados devuelven varios objetos JSON en la matriz en función de los desgloses disponibles. Por ejemplo, si se proporciona cell_id, los resultados se desglosan según la cantidad de celdas del estudio. Aunque puedes proporcionar uno o varios desgloses, la combinación de estos debe tener al menos 100 conversiones de los grupos de prueba y control combinados para que se muestren los resultados.

{
  "id": "<STUDY_OBJECTIVE_ID>",
  "results": [
  {
    "cell_id": "<CELL_ID1>",
    ...
    Default fields where the values are specific to the <CELL_ID1> breakdown
    ...
  },
  {
    "cell_id": "<CELL_ID2>",
    ...
    Default fields where the values are specific to the <CELL_ID2> breakdown
    ...
  }],
}

Resultados para una marca de fecha concreta

Puedes especificar una marca de fecha en la llamada a la API para obtener resultados del estudio de una fecha concreta. Ten en cuenta que la llamada devuelve el mismo resultado que devolvería si realizaras la misma llamada en esa fecha específica sin incluir el campo de marca de fecha. La fecha debe situarse en los 30 días anteriores.

curl -G \
      -d 'access_token=<ACCESS_TOKEN>' \
      'https://graph.facebook.com/<API_VERSION>/<STUDY_OBJECTIVE_ID>?fields=results&ds=2020-03-01'