Estudio de aumento

Crea y ejecuta un experimento para medir la eficacia de tu campaña de Facebook. Determina cuál es la estrategia publicitaria que genera el mayor impacto comercial. Consulta Estudio del anuncio, Referencia.

Cuando creas un estudio de aumento, creas de manera aleatoria un grupo de prueba de cuentas del centro de cuentas que ve tus anuncios y un grupo de control que no ve tus anuncios.

Puedes compartir de forma segura datos de conversión de tu campaña publicitaria con Facebook usando píxeles de Facebook o eventos de la app. Facebook determina el incremento en las conversiones generado a partir de la campaña. Comparamos la cantidad de conversiones, las cuentas del centro de cuentas que las realizan y los ingresos comerciales disponibles entre los grupos de prueba y de control.

Configurar estudios

Configura un estudio con uno o más grupos, llamados celdas. Cuando configuras el estudio, Facebook aleatoriza el público para tus anuncios y asigna cuentas del centro de cuentas al grupo de prueba o al de control. Después de que llevas a cabo el estudio, Facebook calcula la diferencia entre los grupos de prueba y los grupos de control para que puedas evaluar el impacto de tus anuncios de Facebook en los objetivos comerciales.

Para configurar un estudio, realiza una llamada POST:

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

Puedes configurar un estudio con un solo grupo de prueba para ver cómo los anuncios de Facebook aumentan la actividad comercial. También puedes configurar un estudio con varios grupos de prueba, lo que te permite determinar el enfoque publicitario que mejor funciona para tu público.

Ejemplo: Configurar un estudio de aumento 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 lo siguiente:

Crear un grupo de prueba

Para comenzar, determina cuántas cuentas del centro de cuentas reciben tus anuncios y cuántas no. Debes crear un grupo de prueba cuando configures el estudio; proporciona una lista de objetos JSON en cells debajo de ad_studies. Consulta Celda del estudio del anuncio, Referencia. Un grupo de prueba contiene la siguiente información.

Ejemplo: leer grupos de prueba en 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 una celda y los porcentajes de tratamiento y control proporcionando 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 que creaste para tu negocio en ad_studies

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

También puedes ver todos los estudios asociados a tu cuenta publicitaria realizando una solicitud GET en {ad-account-ID/include_all_studies=true} con tu token de acceso.

Configurar varios grupos de prueba

Configura un estudio con varios grupos de prueba de usuarios de Facebook. Esto ayuda a medir el impacto incremental de diferentes estrategias de Facebook en los objetivos comerciales, como usar 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 la exclusión para cada grupo de prueba con respecto a la población general. Por ejemplo, tienes un estudio con dos grupos de prueba: el grupo A es un 50% tratamiento y un 20% control, y el grupo B es un 20% tratamiento y un 10% control. Esto equivale a que ~28,6%, o el 20%/70% de la población del grupo A serán usuarios de control y ~33,3%, o el 10%/30% de la población del grupo B serán usuarios de control.

Los porcentajes de tratamiento y control en los diferentes grupos de prueba normalmente deberían sumar 100. Sin embargo, podrían sumar menos de 100 en ciertos casos de uso específicos. Por ejemplo, cuando tienes tres grupos de prueba divididos equitativamente en 33%.

Puedes actualizar, agregar y eliminar grupos de prueba en un estudio.

• Para actualizar un grupo de prueba preexistente, consulta su identificador en el grupo de prueba.
• Para agregar un grupo de prueba nuevo, proporciona un objeto de grupo de prueba nuevo.
• Para eliminar un grupo de prueba, simplemente omítelo de cells cuando actualices 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 quieras medir y cómo envías los datos de conversión a Facebook. Un estudio de aumento requiere al menos un objetivo. No puedes modificar los objetivos una vez que el estudio está en circulación. Consulta Objetivo del estudio de anuncios, Referencia.

Ejemplo: crear y agregar 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 usas CONVERSIONS y usas el píxel de Facebook o una app para celulares como orígenes de eventos, debes proporcionar una lista de los nombres de los eventos que quieres capturar para el objetivo. Luego, Facebook puede reportar resultados en función de esos eventos de conversión específicos.

Crear un objetivo

Crea un objetivo publicando una lista de objetos JSON objectives al crear un estudio nuevo. Los objetivos contienen la siguiente información:

También puedes tener varios objetivos por estudio. El resultado se sumará según 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'

Puedes actualizar, agregar y eliminar objetivos en el nivel del estudio, de forma similar a cuando modificas grupos de prueba. Para actualizar un objetivo existente, consulta su identificador en el objeto objectives. Para agregar un objetivo nuevo, proporciona un objeto de objetivo nuevo. Para eliminar un objetivo, simplemente omítelo del parámetro objectives cuando lo actualices.

Ejemplo: Actualizar las fuentes de medición applications de un objetivo y eliminar sus fuentes de medición 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

Consultar los objetivos

Los objetivos de un estudio se definen durante la configuración del estudio. Consulta la guía de configuración sobre cómo definir objetivos para el estudio

Puedes leer los objetivos que se crearon para un estudio mediante 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"]'

Consultar los resultados

A fin de recuperar resultados correspondientes a un objetivo, puedes hacer una llamada GET al nodo del objetivo especificando el valor results en el parámetro fields. El campo last_updated_results también te indica cuándo se actualizaron los datos de los resultados para ese objetivo específico.

Ejemplo de la respuesta 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 cadenas de métricas de nombre y valores. Consulta el glosario de métricas de estudios de aumento de Facebook.

Con métricas de 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 métricas de 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>"
}

Desglosar resultados

Además de consultar los resultados correspondientes a cada objetivo, puedes elegir desglosar los resultados proporcionando el parámetro breakdowns.

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

Estas son las dimensiones de desglose disponibles:

Los resultados devuelven varios objetos JSON en la matriz según los desgloses disponibles. Por ejemplo, si se proporciona el cell_id, los resultados se desglosan en la cantidad de celdas del estudio. Puedes proporcionar uno o más desgloses. Sin embargo, 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 de una fecha específica

Puedes definir una fecha en la llamada a la API para obtener resultados del estudio que correspondan a esa fecha. Ten presente que la llamada devuelve el mismo resultado que devolvería si hicieras la llamada en la fecha correspondiente sin incluir el campo de fecha. La fecha debe ser de los últimos 30 días.

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