Memulai Meta Business SDK

Dokumen ini menjelaskan cara menjelaskan cara menginstal Meta Business SDK dan menguji penginstalan. SDK tersedia untuk Java, JavaScript, PHP, Python, dan Ruby. Jika Marketing API sudah terinstal, pelajari cara memperbarui Meta Business SDK.

Sebelum Memulai

Anda akan memerlukan akses ke beberapa hal berikut:

Akun Developer Meta
Aplikasi Meta terdaftar dengan Pengaturan Dasar yang telah dikonfigurasi
Rahasia Aplikasi
Akun Iklan
Token Akses Halaman

Java

Untuk aplikasi Java, Anda dapat menggunakan lingkungan pengembangan apa pun yang Anda suka, tetapi juga harus mendukung build Maven.

Menginstal SDK

Tambahkan kode XML berikut ke bagian dependency dari file pom.xml di proyek Maven Anda:

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

Membuat Kelas Java

Di bawah src/main/java, buat kelas Java yang disebut TestFBJavaSDK, dan tambahkan kode berikut. Pastikan untuk mengganti {access-token}, {appsecret}, dan {adaccount-id} dengan nilai Anda.

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

Menguji Penginstalan Anda

Buat dan jalankan aplikasi Anda. Hasil seharusnya dapat dilihat di jendela login konsol. Jika ada keluhan tentang token yang kedaluwarsa, minta token Akses Halaman baru dan coba lagi.

JavaScript (Node.js)

Untuk aplikasi JavaScript, SDK didistribusikan sebagai paket Node.js.

Buka jendela terminal perintah dan buat folder proyek baru. Buat, konfigurasikan, dan instal proyek Anda dengan perintah berikut:

npm init

Anda dapat memperbarui pengaturan konfigurasi nanti dengan mengedit file package.json langsung.

Menginstal SDK

Instal paket SDK dengan perintah berikut:

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

Mengubah File Proyek

Buka file index.js dan tambahkan kode berikut. Ganti {access-token} dan {adaccount-id} dengan nilai Anda.

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

Menguji Penginstalan Anda

Uji penginstalan Anda dengan perintah berikut:

 node index.js

Hasil seharusnya dapat dilihat di jendela terminal. Jika ada keluhan tentang token yang kedaluwarsa, minta token Akses Halaman baru dan coba lagi.

PHP

Untuk aplikasi PHP, gunakan Composer untuk menginstal SDK.

Menginstal SDK

Di folder proyek baru, buat composer.json dengan konten berikut. Ganti {project-name}, {Your Name}, dan {your@email.com} dengan nilai Anda.

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

Instal SDK dengan menjalankan perintah berikut di jendela terminal Anda:

composer install

Membuat File Proyek

Buat file src/test.php dengan konten berikut. Ganti {app-id}, {access-token}, {appsecret}, dan {adaccount-id} dengan nilai Anda.

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

Menguji Penginstalan Anda

Uji penginstalan Anda dengan perintah berikut:

php src/test.php

Hasil seharusnya dapat dilihat di jendela terminal. Jika ada keluhan tentang token yang kedaluwarsa, minta token Akses Halaman baru dan coba lagi.

Python

Untuk aplikasi Python, SDK didistribusikan sebagai modul pypi, jadi pastikan pip sudah terinstal. Tergantung sistem, Anda mungkin perlu menyiapkan virtualenv, pyenv, atau conda.

Menginstal SDK

Instal SDK dengan perintah berikut.

pip install facebook_business

Membuat File Proyek

Buat file test.py dengan konten berikut. Ganti {app-id}, {access-token}, {appsecret}, dan {adaccount-id} dengan nilai Anda.

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)

Menguji Penginstalan Anda

Uji penginstalan Anda dengan perintah berikut:

python test.py

Hasil seharusnya dapat dilihat di jendela terminal. Jika ada keluhan tentang token yang kedaluwarsa, minta token Akses Halaman baru dan coba lagi.

Ruby

Untuk Ruby, SDK didistribusikan sebagai paket RubyGem.

Menginstal SDK

Dari jendela terminal, jalankan perintah berikut dari folder proyek Anda untuk menginstal Meta Business SDK untuk Ruby. Tergantung pada lingkungan Anda, Anda mungkin perlu mengatur rbenv atau rvm, atau menggunakan sudo sebelum perintah.

gem install facebookbusiness

Membuat File Proyek

Buat file test.rb dengan konten berikut. Ganti {access-token}, {appsecret}, dan {adaccount-id} dengan nilai Anda.

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

Menguji Penginstalan Anda

Uji penginstalan Anda dengan perintah berikut:

ruby test.rb

Hasil seharusnya dapat dilihat di jendela terminal. Jika ada keluhan tentang token yang kedaluwarsa, minta token Akses Halaman baru dan coba lagi.

Untuk Pengguna Marketing API Saat Ini

Untuk memperbarui Meta Business SDK dari Marketing API, ikuti langkah-langkah ini.

Java

Di file pom.xml:

Perbarui groupId dari com.facebook.ads.sdk ke com.facebook.business.sdk
Perbarui artifactId dari facebook-java-ads-sdk ke facebook-java-business-sdk
Perbarui version ke v8.0.3

Nodejs

Di file package.json:

Perbarui facebook-nodejs-ads-sdk ke facebook-nodejs-business-sdk:v8.0.2
Perbarui semua referensi nama paket facebook-nodejs-ads-sdk, seperti require('facebook-nodejs-ads-sdk'), ke facebook-nodejs-business-sdk
Jalankan npm install

PHP

Di file composer.json:

Perbarui facebook-ads-sdk ke facebook-business-sdk dengan versi 8.0.3

Python

Jalankan pip install facebook_business
Perbarui semua referensi ke namespace facebookads menjadi facebook_business
Jika Anda memiliki file .egg-info, perbarui dari facebookads-*.egg-info ke file egg-info yang baru diinstal, seperti facebook_business-*.egg-info

Ruby

Jalankan gem install facebookbusiness
Perbarui semua referensi dari require('facebook_ads') ke require('facebookbusiness')

Pelajari Selengkapnya

Lihat kode sumber untuk Meta Business SDK di GitHub.