SDK di Meta Business

Primi passi con l'SDK di Meta Business

Questo documento spiega come installare l'SDK di Meta Business e testare l'installazione. Gli SDK sono disponibili per Java, JavaScript, PHP, Python e Ruby. Se hai già installato l'API Marketing, scopri come aggiornare l'SDK di Meta Business.

Prima di iniziare

Dovrai avere accesso a quanto segue:

Java

Per le app Java, puoi usare l'ambiente di sviluppo che preferisci, purché supporti le build Maven.

Installare l'SDK

Per il tuo progetto Maven, aggiungi il seguente codice XML alla sezione dependency del tuo file 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>

Creare una classe Java

In src/main/java, crea una classe Java con nome TestFBJavaSDK e aggiungi il seguente codice. Assicurati di sostituire {access-token}, {appsecret} e {adaccount-id} con i tuoi valori.

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();
        }
    }}

Testare l'installazione

Crea ed esegui la tua app. Dovresti vedere il risultato nella finestra di registrazione della tua console. Se indica la presenza di un token scaduto, richiedi un nuovo token d'accesso della Pagina e riprova.

JavaScript (Node.js)

Per le app JavaScript, l'SDK viene distribuito come pacchetto Node.js.

Apri una finestra del terminale di comando e crea una nuova cartella di progetto. Crea, configura e installa il tuo progetto con il seguente comando:

npm init

Puoi aggiornare le impostazioni di configurazione in un secondo momento modificando direttamente il file package.json.

Installare l'SDK

Installa il pacchetto SDK con il seguente comando:

npm install --save facebook-nodejs-business-sdk

Modificare il file di progetto

Apri il file index.js e aggiungi il seguente codice. Sostituisci {access-token} e {adaccount-id} con i tuoi valori.

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);

Testare l'installazione

Testa la tua installazione con il seguente comando:

 node index.js

Dovresti vedere il risultato nella finestra del terminale. Se indica la presenza di un token scaduto, richiedi un nuovo token d'accesso della Pagina e riprova.

PHP

Per le app PHP, usa lo strumento di composizione per installare l'SDK.

Installare l'SDK

In una nuova cartella di progetto, crea composer.json con il seguente contenuto. Sostituisci {project-name}, {Your Name} e {your@email.com} con i tuoi valori.

{
    "name": "name/{project-name}",
    "type": "project",
    "require": {
        "facebook/php-business-sdk": "^8.0.3"
    },
    "authors": [
        {
            "name": "{Your Name}",
            "email": "{your@email.com}"
        }
    ]
}

Installa l'SDK eseguendo questo comando nella finestra del terminale:

composer install

Creare un file di progetto

Crea un file src/test.php con il seguente contenuto. Sostituisci {app-id}, {access-token}, {appsecret} e {adaccount-id} con i tuoi valori.

<?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;
}

Testare l'installazione

Testa la tua installazione con il seguente comando:

php src/test.php

Dovresti vedere il risultato nella finestra del terminale. Se indica la presenza di un token scaduto, richiedi un nuovo token d'accesso della Pagina e riprova.

Python

Per le app Python, l'SDK è distribuito come modulo pypi, quindi assicurati di avere pip installato. A seconda del tuo sistema, potresti dover configurare virtualenv, pyenv o conda.

Installare l'SDK

Installa l'SDK con il seguente comando.

pip install facebook_business

Creare un file di progetto

Crea il file test.py con il seguente contenuto. Sostituisci {app-id}, {access-token}, {appsecret} e {adaccount-id} con i tuoi valori.

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)

Testare l'installazione

Testa la tua installazione con il seguente comando:

python test.py

Dovresti vedere il risultato nella finestra del terminale. Se indica la presenza di un token scaduto, richiedi un nuovo token d'accesso della Pagina e riprova.

Ruby

Per Ruby, l'SDK è distribuito come pacchetto RubyGem.

Installare l'SDK

Da una finestra del terminale, esegui questo comando dalla cartella di progetto per installare l'SDK di Meta Business per Ruby. A seconda del tuo ambiente, potresti dover configurare rbenv o rvm, oppure usare sudo prima del comando.

gem install facebookbusiness

Creare un file di progetto

Crea un file test.rb con il seguente contenuto. Sostituisci {access-token}, {appsecret} e {adaccount-id} con i tuoi valori.

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

Testare l'installazione

Testa la tua installazione con il seguente comando:

ruby test.rb

Dovresti vedere il risultato nella finestra del terminale. Se indica la presenza di un token scaduto, richiedi un nuovo token d'accesso della Pagina e riprova.

Per gli attuali utenti dell'API Marketing

Per aggiornare l'SDK di Meta Business dall'API Marketing segui questi passaggi.

Java

Nel file pom.xml:

  • Aggiorna groupId da com.facebook.ads.sdk a com.facebook.business.sdk.
  • Aggiorna artifactId da facebook-java-ads-sdk a facebook-java-business-sdk.
  • Aggiorna version a v8.0.3.

Nodejs

Nel file package.json:

  • Aggiorna facebook-nodejs-ads-sdk a facebook-nodejs-business-sdk:v8.0.2.
  • Aggiorna tutti i riferimenti del nome del pacchetto facebook-nodejs-ads-sdk, come require('facebook-nodejs-ads-sdk'), a facebook-nodejs-business-sdk.
  • Esegui npm install.

PHP

Nel file composer.json:

  • Aggiorna facebook-ads-sdk a facebook-business-sdk con la versione 8.0.3.

Python

  • Esegui pip install facebook_business.
  • Aggiorna tutti i riferimenti allo spazio del nome facebookads a facebook_business.
  • Se hai un file .egg-info, aggiornalo da facebookads-*.egg-info al file egg-info appena installato come facebook_business-*.egg-info.

Ruby

  • Esegui gem install facebookbusiness.
  • Aggiorna tutti i riferimenti da require('facebook_ads') a require('facebookbusiness').

Ulteriori informazioni

Visualizza il codice sorgente per l'SDK di Meta Business su GitHub.