Meta Business SDK

Meta Business SDK 시작하기

이 문서에서는 Meta Business SDK를 설치하고 해당 설치를 테스트하는 방법을 설명합니다. SDK는 Java, JavaScript, PHP, Python 및 Ruby에서 사용 가능합니다. 마케팅 API가 이미 설치되어 있다면 Meta Business SDK로 업데이트하는 방법을 알아보세요.

시작하기 전에

다음 항목에 액세스할 수 있어야 합니다.

Java

Java 앱의 경우 자신이 원하는 개발 환경을 사용할 수 있으나 반드시 Maven 빌드를 지원해야 합니다.

SDK 설치하기

Maven 프로젝트에서 pom.xml 파일의 dependency 섹션에 다음 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>

Java 클래스 만들기

src/main/java에서 TestFBJavaSDK라는 Java 클래스를 만들고 다음 코드를 추가합니다. {access-token}, {appsecret} 및 {adaccount-id}를 원하는 값으로 바꿉니다.

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

설치 테스트

앱을 빌드하고 실행합니다. 콘솔 로깅 창에 결과가 표시됩니다. 만료된 토큰으로 인한 문제가 있는 경우 새로운 페이지 액세스 토큰을 요청하고 다시 시도하세요.

JavaScript (Node.js)

JavaScript 앱의 경우 SDK는 Node.js 패키지로 배포됩니다.

명령 터미널 창을 열고 새 프로젝트 폴더를 만듭니다. 다음 명령을 사용하여 프로젝트를 만들고 구성 및 설치합니다.

npm init

package.json 파일을 직접 편집하여 나중에 구성 설정을 업데이트할 수 있습니다.

SDK 설치하기

다음 명령을 사용하여 SDK 패키지를 설치합니다.

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

프로젝트 파일 수정

index.js 파일을 열고 다음 코드를 추가합니다. {access-token} 및 {adaccount-id}를 원하는 값으로 바꿉니다.

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

설치 테스트

다음 명령을 사용하여 설치를 테스트합니다.

 node index.js

터미널 창에 결과가 표시됩니다. 만료된 토큰으로 인한 문제가 있는 경우 새로운 페이지 액세스 토큰을 요청하고 다시 시도하세요.

PHP

PHP 앱의 경우 Composer를 사용하여 SDK를 설치합니다.

SDK 설치하기

새 프로젝트 폴더에서 다음과 같이 composer.json을 만듭니다. {project-name}, {Your Name} 및 {your@email.com}을 원하는 값으로 바꿉니다.

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

터미널 창에서 다음 명령을 실행하여 SDK를 설치합니다.

composer install

프로젝트 파일 만들기

다음과 같이 src/test.php 파일을 만듭니다. {app-id}, {access-token}, {appsecret} 및 {adaccount-id}를 원하는 값으로 바꿉니다.

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

설치 테스트

다음 명령을 사용하여 설치를 테스트합니다.

php src/test.php

터미널 창에 결과가 표시됩니다. 만료된 토큰으로 인한 문제가 있는 경우 새로운 페이지 액세스 토큰을 요청하고 다시 시도하세요.

Python

Python 앱의 경우 SDK는 pypi 모듈로 배포되므로 pip가 설치되어 있어야 합니다. 시스템에 따라 virtualenv, pyenv 또는 conda를 설정해야 할 수 있습니다.

SDK 설치하기

다음 명령을 사용하여 SDK를 설치합니다.

pip install facebook_business

프로젝트 파일 만들기

다음과 같이 test.py 파일을 만듭니다. {app-id}, {access-token}, {appsecret} 및 {adaccount-id}를 원하는 값으로 바꿉니다.

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)

설치 테스트

다음 명령을 사용하여 설치를 테스트합니다.

python test.py

터미널 창에 결과가 표시됩니다. 만료된 토큰으로 인한 문제가 있는 경우 새로운 페이지 액세스 토큰을 요청하고 다시 시도하세요.

Ruby

Ruby의 경우 SDK는 RubyGem 패키지로 배포됩니다.

SDK 설치하기

터미널 창을 통해 프로젝트 폴더에서 다음 명령을 실행하여 Ruby용 Meta Business SDK를 설치합니다. 환경에 따라 rbenv나 rvm을 설정하거나 명령 앞에 sudo를 사용해야 할 수 있습니다.

gem install facebookbusiness

프로젝트 파일 만들기

다음과 같이 test.rb 파일을 만듭니다. {access-token}, {appsecret} 및 {adaccount-id}를 원하는 값으로 바꿉니다.

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

설치 테스트

다음 명령을 사용하여 설치를 테스트합니다.

ruby test.rb

터미널 창에 결과가 표시됩니다. 만료된 토큰으로 인한 문제가 있는 경우 새로운 페이지 액세스 토큰을 요청하고 다시 시도하세요.

현재 마케팅 API 사용자의 경우

마케팅 API에서 Meta Business SDK로 업데이트하려면 다음 단계를 따르세요.

Java

pom.xml 파일에서:

  • groupId를 com.facebook.ads.sdk에서 com.facebook.business.sdk로 업데이트합니다.
  • artifactId를 facebook-java-ads-sdk에서 facebook-java-business-sdk로 업데이트합니다.
  • version을 v8.0.3으로 업데이트합니다.

Nodejs

package.json 파일에서:

  • facebook-nodejs-ads-sdk를 facebook-nodejs-business-sdk:v8.0.2로 업데이트합니다.
  • 패키지 이름 facebook-nodejs-ads-sdk의 모든 참조(예: require('facebook-nodejs-ads-sdk'))를 facebook-nodejs-business-sdk로 업데이트합니다.
  • npm install을 실행합니다.

PHP

composer.json 파일에서:

  • facebook-ads-sdk를 facebook-business-sdk 버전 8.0.3으로 업데이트합니다.

Python

  • pip install facebook_business를 실행합니다.
  • 네임스페이스 facebookads에 대한 모든 참조를 facebook_business로 업데이트합니다.
  • .egg-info 파일이 있을 경우 facebookads-*.egg-info에서 새로 설치된 egg-info 파일(예: facebook_business-*.egg-info)로 업데이트합니다.

Ruby

  • gem install facebookbusiness를 실행합니다.
  • require('facebook_ads')의 모든 참조를 require('facebookbusiness')로 업데이트합니다.

더 알아보기

Github에서 Meta Business SDK의 소스 코드를 확인해 보세요.