En este documento, se explica cómo instalar el SDK de Meta para empresas y cómo probar la instalación. Hay SDK disponibles para Java, JavaScript, PHP, Python y Ruby. Si ya tienes la API de marketing instalada, descubre cómo puedes actualizarte con el SDK de Meta para empresas.
Necesitarás acceso a lo siguiente:
En las apps de Java, puedes usar cualquier entorno de desarrollo, pero debe admitir las compilaciones de Maven.
En tu proyecto de Maven, agrega el siguiente código XML en la sección dependency
del archivo pom.xml
:
<!-- https://mvnrepository.com/artifact/com.facebook.business.sdk/facebook-java-business-sdk --> <dependency> <groupId>com.facebook.business.sdk</groupId> <artifactId>facebook-java-business-sdk</artifactId> <version>[8.0.3,)</version> </dependency>
En src/main/java
, crea una clase de Java llamada TestFBJavaSDK
y, luego, agrega el siguiente código. Asegúrate de reemplazar {access-token}
, {appsecret}
y {adaccount-id}
con tus propios valores.
import com.facebook.ads.sdk.APIContext; import com.facebook.ads.sdk.APINodeList; import com.facebook.ads.sdk.AdAccount; import com.facebook.ads.sdk.Campaign; public class TestFBJavaSDK { public static final APIContext context = new APIContext( "{access-token}", "{appsecret}" ); public static void main(String[] args) { AdAccount account = new AdAccount("act_{{adaccount-id}}", context); try { APINodeList<Campaign> campaigns = account.getCampaigns().requestAllFields().execute(); for(Campaign campaign : campaigns) { System.out.println(campaign.getFieldName()); } } catch (Exception e) { e.printStackTrace(); } }}
Desarrolla y ejecuta tu app. Deberías ver el resultado en la ventana de registro de la consola. Si aparece un mensaje relacionado con un token vencido, solicita un nuevo token de acceso a la página y vuelve a intentarlo.
En el caso de las apps de JavaScript, el SDK se distribuye como paquete de Node.js.
Abre una ventana de terminal de comandos y crea una nueva carpeta de proyecto. Crea, configura e instala el proyecto con el siguiente comando:
npm init
Puedes actualizar la configuración más adelante editando directamente el archivo package.json
.
Instala el paquete del SDK con el siguiente comando:
npm install --save facebook-nodejs-business-sdk
Abre el archivo index.js
y agrega el siguiente código. Reemplaza {access-token}
y {adaccount-id}
por tus propios valores.
const bizSdk = require('facebook-nodejs-business-sdk'); const accessToken = '{access-token}'; const accountId = 'act_{{adaccount-id}}'; const FacebookAdsApi = bizSdk.FacebookAdsApi.init(accessToken); const AdAccount = bizSdk.AdAccount; const Campaign = bizSdk.Campaign; const account = new AdAccount(accountId); var campaigns; account.read([AdAccount.Fields.name]) .then((account) =>{ return account.getCampaigns([Campaign.Fields.name], { limit: 10 }) // fields array and params }) .then((result) =>{ campaigns = result campaigns.forEach((campaign) =>console.log(campaign.name)) }).catch(console.error);
Prueba la instalación con el siguiente comando:
node index.js
Deberías ver el resultado en la ventana de terminal. Si aparece un mensaje relacionado con un token vencido, solicita un nuevo token de acceso a la página y vuelve a intentarlo.
En las apps de PHP, usa Composer para instalar el SDK.
En una nueva carpeta de proyecto, crea composer.json
con el siguiente contenido. Reemplaza {project-name}
, {Your Name}
y {your@email.com}
por tus propios valores.
{ "name": "name/{project-name}", "type": "project", "require": { "facebook/php-business-sdk": "^8.0.3" }, "authors": [ { "name": "{Your Name}", "email": "{your@email.com}" } ] }
En la ventana de terminal, ejecuta el siguiente comando para instalar el SDK:
composer install
Crea un archivo src/test.php
con el siguiente contenido. Reemplaza {app-id}
, {access-token}
, {appsecret}
y {adaccount-id}
por tus propios valores.
<?php require_once __DIR__ . '/../vendor/autoload.php'; use FacebookAds\Api; use FacebookAds\Logger\CurlLogger; use FacebookAds\Object\AdAccount; use FacebookAds\Object\Campaign; use FacebookAds\Object\Fields\CampaignFields; $app_id = "{app-id}"; $app_secret = "{appsecret}"; $access_token = "{access-token}"; $account_id = "act_{{adaccount-id}}"; Api::init($app_id, $app_secret, $access_token); $account = new AdAccount($account_id); $cursor = $account->getCampaigns(); // Loop over objects foreach ($cursor as $campaign) { echo $campaign->{CampaignFields::NAME}.PHP_EOL; }
Prueba la instalación con el siguiente comando:
php src/test.php
Deberías ver el resultado en la ventana de terminal. Si aparece un mensaje relacionado con un token vencido, solicita un nuevo token de acceso a la página y vuelve a intentarlo.
En el caso de las apps de Python, el SDK se distribuye como módulo de pypi, por lo que debes asegurarte de tener pip instalado. Según el sistema que uses, es posible que debas configurar virtualenv
, pyenv
o conda
.
Instala el SDK con el siguiente comando.
pip install facebook_business
Crea el archivo test.py
con el siguiente contenido. Reemplaza {app-id}
, {access-token}
, {appsecret}
y {adaccount-id}
por tus propios valores.
from facebook_business.api import FacebookAdsApi from facebook_business.adobjects.adaccount import AdAccount my_app_id = '{app-id}' my_app_secret = '{appsecret}' my_access_token = '{access-token}' FacebookAdsApi.init(my_app_id, my_app_secret, my_access_token) my_account = AdAccount('act_{{adaccount-id}}') campaigns = my_account.get_campaigns() print(campaigns)
Prueba la instalación con el siguiente comando:
python test.py
Deberías ver el resultado en la ventana de terminal. Si aparece un mensaje relacionado con un token vencido, solicita un nuevo token de acceso a la página y vuelve a intentarlo.
En Ruby, el SDK se distribuye como paquete de RubyGem.
En una ventana de terminal, ejecuta el siguiente comando desde la carpeta del proyecto para instalar el SDK de Meta para empresas para Ruby. Según el entorno en el que trabajes, es posible que debas configurar rbenv o rvm, o bien usar sudo
antes del comando.
gem install facebookbusiness
Crea un archivo test.rb
con el siguiente contenido. Reemplaza {access-token}
, {appsecret}
y {adaccount-id}
por tus propios valores.
require 'facebookbusiness' FacebookAds.configure do |config| config.access_token = '{access-token}' config.app_secret = '{appsecret}' end ad_account = FacebookAds::AdAccount.get('act_{{adaccount-id}}', 'name') ad_account.campaigns(fields: 'name').each do |campaign| puts campaign.name end
Prueba la instalación con el siguiente comando:
ruby test.rb
Deberías ver el resultado en la ventana de terminal. Si aparece un mensaje relacionado con un token vencido, solicita un nuevo token de acceso a la página y vuelve a intentarlo.
Para actualizar el SDK de Meta para empresas desde la API de marketing, sigue estos pasos.
En el archivo pom.xml
:
groupId
de com.facebook.ads.sdk
a com.facebook.business.sdk
artifactId
de facebook-java-ads-sdk
a facebook-java-business-sdk
version
a v8.0.3
En el archivo package.json
:
facebook-nodejs-ads-sdk
a facebook-nodejs-business-sdk:v8.0.2
facebook-nodejs-ads-sdk
, como require('facebook-nodejs-ads-sdk')
, a facebook-nodejs-business-sdk
npm install
En el archivo composer.json
:
facebook-ads-sdk
a facebook-business-sdk
con la versión 8.0.3pip install facebook_business
facebookads
a facebook_business
.egg-info
, actualízalo de facebookads-*.egg-info
al archivo egg-info
que se acaba de instalar, como facebook_business-*.egg-info
gem install facebookbusiness
require('facebook_ads')
a require('facebookbusiness')
Consulta el código fuente del SDK de Meta para empresas en Github.