한국어로 번역이 아직 완료되지 않았습니다.
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의 소스 코드를 확인해 보세요.