Étude de croissance

Créez et réalisez une étude pour mesurer l’efficacité de votre campagne sur Facebook. Déterminez quelle stratégie publicitaire produit l’impact commercial le plus important. Voir la page Enquête publicitaire, Référence.

Lorsque vous créez une étude Lift, vous créez un groupe de test aléatoire constitué de comptes d’Espace Comptes qui voient vos publicités et un groupe témoin qui ne les voit pas.

Vous pouvez partager en toute sécurité les données de conversion issues de votre campagne publicitaire avec Facebook grâce aux pixels Facebook ou à l’outil de suivi des évènements d’application. Facebook détermine la hausse des conversions générée par votre campagne. Nous comparons le nombre de conversions, le nombre de comptes d’Espace Comptes effectuant une conversion et le montant du revenu des ventes disponible entre les groupes de test et témoin.

Configurer les études

Configurez une étude avec un ou plusieurs groupes, appelés cellules. Lorsque vous configurez votre étude, Facebook sélectionne de façon aléatoire l’audience de vos publicités et affecte les comptes d’Espace Comptes soit au groupe de test, soit au groupe témoin. Une fois l’étude effectuée, Facebook calcule la différence entre les groupes de test et les groupes témoin pour vous permettre d’évaluer l’impact de vos publicités Facebook par rapport à vos objectifs commerciaux.

Pour configurer une étude, effectuez un appel POST :

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

Vous pouvez configurer une étude avec un seul groupe de test pour savoir dans quelle mesure les publicités Facebook génèrent une hausse d’activité. Vous pouvez également configurer une étude avec plusieurs groupes de test, ce qui vous permet de déterminer quelle approche publicitaire fonctionne le mieux pour votre audience.

Exemple : configurer une étude de croissance avec un groupe de test

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'

Pour créer une nouvelle étude, indiquez les éléments suivants :

Créer un groupe de test

Pour commencer, déterminez combien de comptes d’Espace Comptes reçoivent vos publicités et combien ne les reçoivent pas. Vous devez créer un groupe de test lorsque vous configurez l’étude. Transférez une liste d’objets JSON dans cells sous ad_studies. Consultez la section Cellule d’étude publicitaire, Référence. Un groupe de test contient les informations suivantes.

Exemple : consulter les groupes de test d’une étude

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

Exemple : mettre à jour ou modifier les informations des cellules ainsi que les pourcentages de traitement et de contrôle en indiquant l’ID de cellule dans 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>'

Exemple : consulter toutes les études que vous avez créées dans ad_studies concernant votre entreprise

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

Vous pouvez également consulter toutes les études associées à votre compte publicitaire en envoyant une demande GET sur {ad-account-ID/include_all_studies=true} avec votre token d’accès.

Configurer plusieurs groupes de test

Configurez une étude avec plusieurs groupes de test d’utilisateurs Facebook. Cela permet de mesurer l’impact incrémentiel de différentes stratégies Facebook sur vos objectifs commerciaux, en utilisant par exemple différentes options de ciblage publicitaire. Pour configurer une étude avec plusieurs groupes de test, indiquez une liste de groupes de test dans 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 détermine le pourcentage d’exclusion pour chaque groupe de test par rapport à la population totale. Prenons pour exemple une étude avec deux groupes de test : le groupe A a un pourcentage de traitement de 50 % avec un pourcentage de contrôle de 20 % et le groupe B un pourcentage de traitement de 20 % avec un pourcentage de contrôle de 10 %. Par conséquent, environ 28,6 % (ou 20 %/70 %) de la population du groupe A sera constituée d’utilisateurs de contrôle, contre environ 33,3 % (ou 10 %/30 %) dans le groupe B.

La somme du pourcentage de traitement et du pourcentage de contrôle des différents groupes de test doit normalement être égale à 100. Toutefois, dans certains cas spécifiques, cette somme peut être inférieure à 100. C’est par exemple le cas lorsque vous avez trois groupes de test uniformément répartis à raison de 33 % chacun.

Vous pouvez mettre à jour, ajouter et supprimer les groupes de test d’une étude.

• Pour mettre à jour un groupe de test existant, reportez-vous à son ID dans le groupe de test.
• Pour ajouter un groupe de test, indiquez un nouvel objet de groupe de test.
• Pour supprimer un groupe de test, retirez-le simplement des cells lorsque vous mettez à jour l’étude :

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>'

Définir les objectifs publicitaires

Définissez les objectifs publicitaires que vous voulez mesurer et la manière dont vous transmettez les données de conversion à Facebook. Une étude de croissance nécessite au moins un objectif. Vous ne pouvez pas modifier les objectifs après le lancement de l’étude. Consultez la section Objectif de l’étude publicitaire, Référence.

Exemple : créer l’objectif CONVERSIONS et l’ajouter à une étude

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 vous utilisez CONVERSIONS, ainsi qu’un pixel Facebook ou une application mobile comme sources d’évènements, vous devez fournir la liste des noms d’évènements que vous voulez enregistrer pour l’objectif en question. Facebook peut ensuite signaler les résultats en se fondant sur ces évènements de conversion en particulier.

Créer un objectif

Créez un objectif en transférant une liste d’objets JSON objectives lorsque vous créez une nouvelle étude. Les objectifs contiennent les informations suivantes :

Vous pouvez également configurer plusieurs objectifs par étude. Les résultats seront compilés en fonction des objectifs. Vous trouverez ci-dessous un exemple d’étude portant sur plusieurs objectifs.

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'

Vous pouvez mettre à jour, ajouter et supprimer les objectifs d’une étude directement au niveau de l’étude, en procédant de la même manière qu’au niveau des groupes de test. Pour mettre à jour un objectif existant, reportez-vous à son ID dans l’objet objectives. Pour ajouter un objectif, indiquez un nouvel objet d’objectif. Pour supprimer un objectif, retirez-le simplement du paramètre objectives lors de sa mise à jour.

Exemple : mettre à jour les sources de mesure applications d’un objectif et supprimer ses sources de mesure 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>'

Exemple : consulter les objectifs d’une étude

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

Rapports

Récupérer les objectifs

Les objectifs d’une étude sont définis durant sa configuration. Consultez le guide de configuration pour savoir comment définir les objectifs de votre étude.

Vous pouvez consulter les objectifs qui ont été créés pour une étude en effectuant un appel GET vers l’arête objectives de l’étude.

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

Récupérer les résultats

Pour récupérer les résultats relatifs à un objectif, vous pouvez effectuer un appel GET au nœud de l’objectif en spécifiant results dans le paramètre fields. Le champ last_updated_results vous indique également quand la dernière mise à jour des données de résultats pour cet objectif a eu lieu.

Exemple de réponse affiché au format JSON décrypté pour une lecture plus aisée.

Commande :

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

Les données collectées constituent un objet JSON qui contient le nom des indicateurs et les chaînes de valeurs. Consultez le glossaire des indicateurs de croissance Facebook.

Avec des acheteurs :

{
	"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>"
}

Sans acheteurs :

{
	"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>"
}

Répartition des résultats

En plus de la récupération des résultats par objectif, vous pouvez opter pour une répartition des résultats en indiquant le paramètre breakdowns.

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

Les critères de répartition suivants sont disponibles :

Les résultats renvoient plusieurs objets JSON dans la grille, selon les répartitions disponibles. Par exemple, si cell_id est indiqué, les résultats sont répartis selon le nombre de cellules de l’étude. Vous pouvez indiquer une ou plusieurs répartitions. Toutefois, dans le cas de plusieurs répartitions, un minimum de 100 conversions générées par les groupes de test et témoin doivent être combinées pour pouvoir afficher des résultats.

{
  "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
    ...
  }],
}

Résultats pour un horodatage spécifique

Vous pouvez spécifier un horodatage dans votre appel d’API pour obtenir les résultats de l’étude associés à une date précise. Notez que l’appel renvoie les mêmes résultats que s’il avait été effectué à la date concernée sans y inclure le champ d’horodatage. La date spécifiée ne doit pas remonter à plus de 30 jours.

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