ข้อมูลจำเพาะของฟีดองค์ประกอบ

ช่อง asset_feed_spec ช่วยให้คุณสามารถแสดงชุดรวมชิ้นงานโฆษณาต่างๆ แก่ผู้ใช้ที่แตกต่างกันได้ วิธีตั้งค่าชุดรวมของคุณมีอยู่ด้วยกัน 2 วิธีดังนี้

• แบบอัตโนมัติ: คุณระบุองค์ประกอบของชิ้นงานโฆษณา จากนั้นเราจะแสดงชุดรวมโฆษณาต่างๆ แก่ผู้ใช้ที่แตกต่างกัน หากต้องการใช้ตัวเลือกนี้ โปรดดู "API ชิ้นงานโฆษณาแบบไดนามิก"
• ด้วยตนเอง: คุณระบุองค์ประกอบของชิ้นงานโฆษณา จากนั้นคุณเป็นคนสร้างกฎว่าจะแสดงองค์ประกอบเหล่านั้นอย่างไร หากต้องการใช้ตัวเลือกนี้ โปรดดู "กฎการปรับแต่งองค์ประกอบ"

ข้อมูลจำเพาะของฟีดองค์ประกอบจะประกอบด้วยคอลเลกชั่นขององค์ประกอบชิ้นงานโฆษณาต่างๆ เช่น รูปภาพ หัวเรื่อง เนื้อความ และอื่นๆ โดยคุณสามารถระบุองค์ประกอบชิ้นงานโฆษณาได้หลายรายการสำหรับองค์ประกอบแต่ละประเภท ทั้งนี้ รูปแบบของข้อมูลจำเพาะจะแตกต่างกันไปในแต่ละกรณีการใช้งาน ดูเพิ่มเติมได้ที่ข้อมูลอ้างอิง, ข้อมูลจำเพาะของฟีดองค์ประกอบ

สร้างฟีดองค์ประกอบ

คุณสามารถใช้ asset_feed_spec เพื่อระบุองค์ประกอบชิ้นงานโฆษณาหลายรายการ โดยมีข้อจำกัดต่อไปนี้

• สำหรับกฎการปรับแต่งองค์ประกอบทั้งหมด จะต้องมีกฎการปรับแต่งองค์ประกอบอย่างน้อย 2 กฎใน asset_feed_spec
• สำหรับชิ้นงานโฆษณาแบบไดนามิกasset_feed_specไม่ควรมีกฎการปรับแต่ง ในกรณีนี้ คุณสามารถผสมผสานทั้งรูปภาพและวิดีโอในตำแหน่งการจัดวางต่างๆ ได้โดยระบุ [“AUTOMATIC_FORMAT”] ใน ad_formats

ตัวอย่างเช่น หากต้องการสร้าง asset_feed_spec สำหรับชิ้นงานโฆษณาแบบไดนามิก ให้ส่งคำขอดังนี้

curl -X POST \
  -F 'name="Dynamic Ad Creative with Asset Feed Spec Sample"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>"
     }' \
  -F 'asset_feed_spec={
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         }
       ],
       "bodies": [
         {
           "text": "Begin Your Adventure"
         },
         {
           "text": "Once a Trainer, always a Trainer."
         }
       ],
       "titles": [
         {
           "text": "Level Up"
         },
         {
           "text": "Swipe to evolve"
         }
       ],
       "descriptions": [
         {
           "text": "First Dynamic Ad Creative Sample"
         }
       ],
       "ad_formats": [
         "SINGLE_IMAGE"
       ],
       "call_to_action_types": [
         "SHOP_NOW"
       ],
       "link_urls": [
         {
           "website_url": "https://www.example.com/"
         }
       ],
       "videos": []
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

คุณสามารถสร้าง asset_feed_spec ที่มีตัวเลือกวิดีโอ เนื้อความ และหัวเรื่อง 2 แบบได้เช่นกัน ดังนี้

curl \
-F 'object_story_spec={
       "page_id": "YOUR_PAGE_ID"
       "instagram_actor_id" : "INSTAGRAM_ACTOR_ID",
    }' \
-F "asset_feed_spec={'videos': [{'video_id':'2053108854721025', 'thumbnail_url':'<thumnail_url>', 'url_tags':'video=video1'},{'video_id':'2104406249780616', 'thumbnail_url':'<thumnail_url>','url_tags':'video=video2'}], 'bodies': [{'text':'Begin Your Adventure'}, {'text':'Once a Trainer, always a Trainer.'}], 'titles': [{'text':'Level Up'}, {'text':'Swipe to evolve'}], 'descriptions': [{'text':'Begin Your Adventure'}], 'ad_formats': ['SINGLE_IMAGE'], 'link_urls': [{'website_url':'<WEBSITE_URL>'}]}" \
-F 'access_token=<ACCESS_TOKEN>'  \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

ดูตัวเลือกทั้งหมดที่ใช้งานได้สำหรับข้อมูลจำเพาะของฟีดองค์ประกอบ

อ่านฟีดองค์ประกอบ

หากต้องการตรวจสอบชิ้นงานโฆษณาของคุณ ให้อ่าน asset_feed_spec ดังนี้

curl -X GET \
  -d 'fields="asset_feed_spec"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<CREATIVE_ID>/

'use strict';
const bizSdk = require('facebook-nodejs-business-sdk');
const AdCreative = bizSdk.AdCreative;

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_CREATIVE_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 = [
  'asset_feed_spec',
];
params = {
};
const sample_code = (new AdCreative(id)).get(
  fields,
  params
);
logApiCallResult('sample_code api call complete.', sample_code);

require __DIR__ . '/vendor/autoload.php';

use FacebookAds\Object\AdCreative;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

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

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

$fields = array(
  'asset_feed_spec',
);
$params = array(
);
echo json_encode((new AdCreative($id))->getSelf(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adcreative import AdCreative
from facebook_business.api import FacebookAdsApi

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

fields = [
  'asset_feed_spec',
]
params = {
}
print AdCreative(id).get(
  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 = \"<AD_CREATIVE_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdCreative(id, context).get()
      .requestAssetFeedSpecField()
      .execute();

  }
}

require 'facebook_ads'

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

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

ad_creative = FacebookAds::AdCreative.get(id ,'asset_feed_spec')

หากคุณมีฟีดชิ้นงานโฆษณาแบบไดนามิกที่มีรูปภาพและเนื้อความหลายแบบ การตอบกลับจะมีลักษณะดังนี้

{  
   "asset_feed_spec":{  
      "images":[  
         {  
            "url_tags":"image=image1",
            "hash":"785095162a2034666e0d0cc4ea1faf89"
         },
         {  
            "url_tags":"image=image2",
            "hash":"3a24122c13923569599be35567ce4e9e"
         }
      ],
      "bodies":[  
         {  
            "text":"Begin Your Adventure"
         },
         {  
            "text":"Once a Trainer, always a Trainer."
         }
      ],
      "call_to_action_types":[  
         "LEARN_MORE"
      ],
      "call_to_actions":[  
         {  
            "type":"LEARN_MORE"
         }
      ],
      "descriptions":[  
         {  
            "text":"Begin Your Adventure"
         }
      ],
      "link_urls":[  
         {  
            "website_url":"<WEBSITE_URL>"
         }
      ],
      "titles":[  
         {  
            "text":"Swipe to evolve"
         },
         {  
            "text":"Level Up"
         }
      ],
      "ad_formats":[  
         "SINGLE_IMAGE"
      ],
      "optimization_type":"REGULAR"
   },
   "id":"<AD_CREATIVE_ID>",
}

หากคุณมีฟีดชิ้นงานโฆษณาแบบไดนามิกที่มีวิดีโอ เนื้อความ และหัวเรื่องหลายแบบ การตอบกลับจะมีลักษณะดังนี้

{  
   "asset_feed_spec":{  
      "videos":[  
         {  
            "url_tags":"video=video1",
            "video_id":"2053108854721025",
            "thumbnail_url":"<thumnail_url>",
            "thumbnail_hash":"<thumnail_hash>"
         },
         {  
            "url_tags":"video=video2",
            "video_id":"2104406249780616",
            "thumbnail_url":"<thumnail_url>",
            "thumbnail_hash":"<thumnail_hash>"
         }
      ],
      "bodies":[  
         {  
            "text":"Begin Your Adventure"
         },
         {  
            "text":"Once a Trainer, always a Trainer."
         }
      ],
      "call_to_action_types":[  
         "LEARN_MORE"
      ],
      "call_to_actions":[  
         {  
            "type":"LEARN_MORE"
         }
      ],
      "descriptions":[  
         {  
            "text":"Begin Your Adventure"
         }
      ],
      "link_urls":[  
         {  
            "website_url":"<WEBSITE_URL>"
         }
      ],
      "titles":[  
         {  
            "text":"Swipe to evolve"
         },
         {  
            "text":"Level Up"
         }
      ],
      "ad_formats":[  
         "SINGLE_VIDEO"
      ],
      "optimization_type":"REGULAR"
   },
   "id":"<AD_CREATIVE_ID>",
}

แก้ไขฟีดองค์ประกอบ

คุณสามารถเพิ่ม แทนที่ หรือลบองค์ประกอบของชิ้นงานโฆษณาได้ โดยมีวิธีคือ ให้ระบุอีกชิ้นงานโฆษณาหนึ่งที่มี asset_feed_spec ใหม่

คุณสามารถทำสิ่งดังต่อไปนี้ได้

• เพิ่มองค์ประกอบ
• ลบองค์ประกอบเดิม
• แทนที่องค์ประกอบเดิมด้วยองค์ประกอบใหม่ทั้งหมด

คุณไม่สามารถทำสิ่งต่อไปนี้

• เปลี่ยนรูปแบบโฆษณา เช่น เปลี่ยนจาก SINGLE IMAGE เป็น VIDEO
• อัพเดตโฆษณาตามฟีดองค์ประกอบให้เป็นชิ้นงานโฆษณาที่ไม่ใช่แบบไดนามิก ซึ่งไม่มี asset_feed_spec

    curl \
      -F 'access_token=<ACCESS_TOKEN>' \
      -F 'creative={
          "creative_id": <CREATIVE_ID>,
       }' \
    https://graph.facebook.com/v21.0/<AD_ID>

เมื่อคุณสร้างชิ้นงานโฆษณาใหม่เพื่อนำมาแทนที่ชิ้นงานโฆษณาเก่า คุณยังคงต้องปฏิบัติตามข้อจำกัดทั้งหมดที่เกี่ยวข้อง