Katalog

Jadwalkan Pengunggahan Kabar Data

Gunakan panduan ini untuk mengunggah dan menjadwalkan kabar Anda.

Unggah Kabar Anda

Untuk mengunggah kabar, Anda memerlukan izin catalog_management. Lihat Marketing API, Izin. Setelah Anda membuat katalog, gunakan catalog id untuk membuat dan menjadwalkan Kabar Produk:

curl -X POST \
  -F 'name="Test Feed"' \
  -F 'schedule={
       "interval": "DAILY",
       "url": "http://www.example.com/sample_feed.tsv",
       "hour": "22"
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/{product-catalog-id}/product_feeds
'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const ProductCatalog = bizSdk.ProductCatalog;
const ProductFeed = bizSdk.ProductFeed;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<PRODUCT_CATALOG_ID>';
const api = bizSdk.FacebookAdsApi.init(access_token);
const showDebugingInfo = true; // Setting this to true shows more debugging info.
if (showDebugingInfo) {
  api.setDebug(true);
}

const logApiCallResult = (apiCallName, data) => {
  console.log(apiCallName);
  if (showDebugingInfo) {
    console.log('Data:' + JSON.stringify(data));
  }
};

let fields, params;
fields = [
];
params = {
  'name' : 'Test Feed',
  'schedule' : {'interval':'DAILY','url':'http://www.example.com/sample_feed.tsv','hour':'22'},
};
const product_feeds = (new ProductCatalog(id)).createProductFeed(
  fields,
  params
);
logApiCallResult('product_feeds api call complete.', product_feeds);
require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\ProductCatalog;
use FacebookAds\Object\ProductFeed;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

$access_token = '<ACCESS_TOKEN>';
$app_secret = '<APP_SECRET>';
$app_id = '<APP_ID>';
$id = '<PRODUCT_CATALOG_ID>';

$api = Api::init($app_id, $app_secret, $access_token);
$api->setLogger(new CurlLogger());

$fields = array(
);
$params = array(
  'name' => 'Test Feed',
  'schedule' => array('interval' => 'DAILY','url' => 'http://www.example.com/sample_feed.tsv','hour' => '22'),
);
echo json_encode((new ProductCatalog($id))->createProductFeed(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);
from facebook_business.adobjects.productcatalog import ProductCatalog
from facebook_business.adobjects.productfeed import ProductFeed
from facebook_business.api import FacebookAdsApi

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<PRODUCT_CATALOG_ID>'
FacebookAdsApi.init(access_token=access_token)

fields = [
]
params = {
  'name': 'Test Feed',
  'schedule': {'interval':'DAILY','url':'http://www.example.com/sample_feed.tsv','hour':'22'},
}
print ProductCatalog(id).create_product_feed(
  fields=fields,
  params=params,
)
import com.facebook.ads.sdk.*;
import java.io.File;
import java.util.Arrays;

public class SAMPLE_CODE_EXAMPLE {
  public static void main (String args[]) throws APIException {

    String access_token = \"<ACCESS_TOKEN>\";
    String app_secret = \"<APP_SECRET>\";
    String app_id = \"<APP_ID>\";
    String id = \"<PRODUCT_CATALOG_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new ProductCatalog(id, context).createProductFeed()
      .setName(\"Test Feed\")
      .setSchedule(\"{\\"interval\\":\\"DAILY\\",\\"url\\":\\"http://www.example.com/sample_feed.tsv\\",\\"hour\\":\\"22\\"}\")
      .execute();

  }
}
require 'facebook_ads'

access_token = '<ACCESS_TOKEN>'
app_secret = '<APP_SECRET>'
app_id = '<APP_ID>'
id = '<PRODUCT_CATALOG_ID>'

FacebookAds.configure do |config|
  config.access_token = access_token
  config.app_secret = app_secret
end

product_catalog = FacebookAds::ProductCatalog.get(id)
product_feeds = product_catalog.product_feeds.create({
    name: 'Test Feed',
    schedule: {'interval':'DAILY','url':'http://www.example.com/sample_feed.tsv','hour':'22'},
})

Parameter schedule memungkinkan Anda untuk menjadwalkan pengunggahan kabar Anda. Opsi mencakup interval, url, hour. Bisa juga mencakup day_of_week, minute, username, dan password.

Catatan: Untuk username dan password, kami mendukung autentikasi dasar pada HTTP dan FTP.

Contoh — Jadwalkan Pengunggahan Kabar Anda

schedule: {"day_of_week":"FRIDAY","hour":17,"interval_count":1,"interval":"DAILY","minute":42,"next_scheduled_upload_time":"","password":pwd123,"status":"active","timezone":"Atlantic/Canary","url":"https://www.abc.com","username":aname}

Perbarui Masing-masing Produk

Perbarui data masing-masing produk secara realtime. Sertakan kolom yang telah diperbarui dalam HTTP POST, di mana retailer_id adalah ID produk dari kabar Anda. Ini harus dikodekan dengan base64url.

https://graph.facebook.com/catalog:{CATALOG_ID}:{base64urlencode(retailer_id)}

Lihat kolom yang dapat diubah di Produk, Referensi.

Jangan berikan kabar produk dengan pembaruan, pembuatan, atau penghapusan masing-masing produk dengan API. Hal ini dapat mengganggu pembaruan atau penghapusan produk yang Anda buat dengan API karena kami tidak melacaknya dengan kabar.

Jadwalkan Pengambilan Kabar Data

Kabar terjadwal tidak mendukung unggahan yang lebih sering dari sekali per jam. Jika Anda perlu memperbarui stok lebih cepat, kami sarankan untuk menggunakan API Unggah Langsung.

Jika Anda menggunakan API kami untuk membuat dan mengelola kabar, Anda perlu mengirimkan permintaan API kepada kami dengan detail jadwal pembaruan yang ingin Anda buat:

curl \
  -F 'name=Test Feed' \
  -F 'update_schedule={ 
    "interval": "HOURLY", 
    "url": "http:\/\/www.example.com\/sample_feed_updates.tsv",
    "hour": 22
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Kami mengambil kabar produk dari sistem Anda sesuai jadwal yang Anda tentukan. Ada dua jenis jadwal yang dapat Anda tentukan:

  • update_schedule — Unggahan membuat produk baru atau memperbarui produk yang sudah ada dengan informasi yang disediakan dalam file kabar data.
  • schedule — Unggahan menghasilkan operasi penyegaran lengkap pada kabar data Anda. Kami menghapus produk yang tidak ada dalam file, memperbarui yang sudah ada, dan membuat yang baru. Anda dapat menggunakan salah satu jadwal, atau keduanya, tergantung kebutuhan Anda.

Sebagai contoh: update_schedule dengan frekuensi HOURLY dan penggantian schedule dengan frekuensi DAILY.

Kami sarankan untuk menyiapkan update_schedule dengan data yang hanya diubah dalam file kabar data untuk pemrosesan feed yang lebih cepat. Hal ini terutama lebih baik untuk penjualan hari libur dan pembaruan harga dan ketersediaan yang lebih cepat. Disarankan juga untuk menandai produk sebagai "stok habis" daripada menghapusnya dari kabar agar kami dapat menargetkan ulang pengguna dengan produk serupa yang tersedia.

curl \
  -F 'name=Test Feed' \
  -F 'schedule={ 
    "interval": "DAILY", 
    "url": "http:\/\/www.example.com\/sample_feed.tsv"
  }' \
  -F 'update_schedule={ 
    "interval": "HOURLY", 
    "url": "http:\/\/www.example.com\/sample_feed_updates.tsv",
    "hour": 22
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/product_feeds

Tanggapan:

{ "id" : {FEED_ID} }

Lihat Referensi Kabar Data, Referensi Jadwal Kabar Data.

Pelajari Selengkapnya