เริ่มต้นใช้งาน Meta Business SDK

เอกสารนี้จะอธิบายวิธีการติดตั้ง Meta Business SDK และทดสอบการติดตั้ง SDK จะพร้อมใช้งานสำหรับ Java, JavaScript, PHP, Python และ Ruby หากคุณติดตั้ง API การตลาดไว้แล้ว ให้เรียนรู้วิธีการอัพเดตเป็น Meta Business SDK

ก่อนเริ่มต้น

คุณจะต้องมีสิทธิ์การเข้าถึงสิ่งต่างๆ ต่อไปนี้

• บัญชีผู้พัฒนาของ Meta
• แอพ Meta ที่ลงทะเบียนแล้วโดยมีการกำหนดค่าการตั้งค่าพื้นฐานไว้
• ข้อมูลลับของแอพของคุณ
• บัญชีโฆษณา
• โทเค็นการเข้าถึงเพจ

Java

สำหรับแอพ Java คุณสามารถใช้สภาพแวดล้อมการพัฒนาใดก็ได้ที่คุณต้องการ แต่สภาพแวดล้อมดังกล่าวต้องสนับสนุนบิลด์ Maven

ติดตั้ง SDK

ในโปรเจ็กต์ Maven ของคุณ ให้เพิ่มโค้ด XML ต่อไปนี้ไปที่ส่วน dependency ของไฟล์ 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>

สร้างคลาส Java

สร้างคลาส Java ที่เรียกว่า TestFBJavaSDK ในส่วน src/main/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

จากหน้าต่างเทอร์มินัล ให้เรียกใช้คำสั่งต่อไปนี้จากโฟลเดอร์โปรเจ็กต์เพื่อติดตั้ง Meta Business SDK สำหรับ Ruby คุณอาจต้องตั้งค่า 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')

เรียนรู้เพิ่มเติม

ดูซอร์สโค้ดสำหรับ Meta Business SDK ที่ Github