โฆษณาปลายทาง - แค็ตตาล็อกและฟีด

หากต้องการโปรโมทปลายทางบน Facebook คุณต้องแชร์ข้อมูลเกี่ยวกับสถานที่ดังกล่าวกับ Facebook โดยคุณสร้างแค็ตตาล็อกปลายทาง แล้วกรอกรายละเอียดปลายทางลงไป

อัพโหลดไฟล์ CSV หรือ XML สำหรับ "ฟีดปลายทาง" ด้วยข้อมูลของปลายทางที่คุณต้องการโปรโมท

คุณสามารถสร้างและจัดการแค็ตตาล็อกปลายทางของคุณได้ในตัวจัดการการค้า

หากต้องการใช้ API เพื่อจัดการแค็ตตาล็อกของคุณ:

  1. สร้างแค็ตตาล็อกปลายทาง
  2. อัพโหลดฟีดของคุณลงใน Facebook
  3. สร้างชุดสินค้าจากแค็ตตาล็อกปลายทางของคุณ
  4. เชื่อมโยงแค็ตตาล็อกกับแหล่งที่มาของเหตุการณ์

ฟีดปลายทาง - อัพโหลดปลายทางของคุณลงใน Facebook

ฟีดปลายทางคือไฟล์ที่มีปลายทางที่คุณต้องการโปรโมท ทุกบรรทัดหรือรายการในไฟล์จะแสดงปลายทางแห่งเดียว คุณสามารถใช้ฟีดปลายทางได้มากกว่า 1 ฟีด ตราบใดที่ฟีดทั้งหมดมีปลายทางทั้งหมดที่คุณต้องการโปรโมท

รูปแบบของฟีดปลายทางที่รองรับ

CSV - ตัวอย่างและคำอธิบาย

ตัวอย่าง CSV | ตัวอย่าง TSV (ปรับให้เป็นระนาบเดียวกัน) | ตัวอย่าง TSV (สไตล์ JSON)

  • แถวแรกต้องแสดงชื่อช่องที่เลือกไว้ตามลำดับของค่าที่ระบุไว้ แถวต่อมาจะแสดงค่าของปลายทางแต่ละแห่ง
  • คุณควรใส่เครื่องหมาย"อัญประกาศคู่"คลุมช่องที่มีการเว้นวรรคหรือเครื่องหมายจุลภาค
  • ช่องที่ซ้อนกันหรือมีหลายค่า เช่น address, neighborhood หรือ image สามารถแสดงโดยใช้ค่าที่มีการเข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ "ปรับให้เป็นระนาบเดียว" และมีการกำกับโดยใช้รูปแบบคำสั่งพาธ JSON เช่น address.city, neighborhood[0], image[0].url, image[0].tag[0] และ image[0].tag[1] ทั้ง 2 รูปแบบสามารถใช้แทนกันได้ในไฟล์เดียวกัน

XML - ตัวอย่างและคำอธิบาย

ตัวอย่าง XML

  • โหนด XML <listings> รากจะครอบคลุมชุดโหนด <listing> ซึ่งแต่ละโหนดจะหมายถึงปลายทางแต่ละแห่ง
  • ไฟล์จะต้องขึ้นต้นด้วยแท็กประกาศ <?xml ที่ถูกต้อง

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

ช่องที่รองรับ - ปลายทาง

ช่องที่รองรับต่อไปนี้ออกแบบมาสำหรับสินค้าที่คุณเพิ่มลงในแค็ตตาล็อกสินค้า

โปรดดูช่องที่รองรับปลายทางสำหรับแค็ตตาล็อกที่แปลภาษาแล้ว

ชื่อและประเภทของช่องคำอธิบาย

destination_id

ประเภท: สตริง

จำเป็นต้องระบุ

ความยาวสูงสุด: 100

ตัวระบุที่ไม่ซ้ำกันของคุณสำหรับปลายทางในแค็ตตาล็อก โดยตัวระบุนี้จะตรงกับ content_ids ใดๆ ที่ระบุไว้ในเหตุการณ์ในแอพและพิกเซล destination ของคุณ เคล็ดลับ: เพื่อปรับปรุงประสิทธิภาพให้ดีขึ้น โปรดหลีกเลี่ยงการเว้นวรรคสำหรับช่องตัวระบุที่ไม่ซ้ำกันนี้

address

ประเภท: อ็อบเจ็กต์

จำเป็นต้องระบุ

ที่อยู่เต็มของปลายทางที่ต้องระบุตำแหน่งที่ตั้งได้อย่างถูกต้อง

โปรดดูพารามิเตอร์อ็อบเจ็กต์ที่อยู่

image

ประเภท: อ็อบเจ็กต์

จำเป็นต้องระบุ

จำนวนรายการสูงสุด: 20

ข้อมูลรูปภาพสำหรับปลายทางนี้ คุณสามารถเพิ่มรูปภาพให้กับปลายทางได้สูงสุด 20 รูป รูปภาพแต่ละรูปมี 2 ช่อง: url และ tag คุณสามารถมีแท็กที่เชื่อมโยงกับภาพได้มากกว่าหนึ่งแท็ก คุณต้องมีอย่างน้อย 1 image แต่ละรูปมีขนาดสูงสุดได้ถึง 4 MB

ดูพารามิเตอร์อ็อบเจ็กต์รูปภาพ

url

ประเภท: สตริง

จำเป็นต้องระบุ

ลิงก์ไปยังเว็บไซต์ภายนอกที่คุณสามารถดูหน้าปลายทางได้ คุณสามารถระบุ URL ในระดับโฆษณาโดยใช้ template_url_spec ได้อีกด้วย โดย URL ในระดับโฆษณาจะมีความสำคัญมากกว่า URL ในฟีด

type

ประเภท: สตริง

จำเป็นต้องระบุ

จำนวนรายการสูงสุด: 20

ประเภทของปลายทาง เช่น ชายหาด เมือง อาหาร การเที่ยวชมทิวทัศน์ วัฒนธรรม ประวัติศาสตร์ ช้อปปิ้ง พิพิธภัณฑ์ การพักผ่อนอันเงียบสงบ การชมทัศนียภาพ ธรรมชาติ สถาปัตยกรรม ธุรกิจ ผู้คนที่เป็นมิตร การผ่อนคลาย ตลาดกลางคืน ภูเขา สถานที่ทางศาสนา การปีนเขา การดำน้ำ และอื่นๆ ซึ่งปลายทางอาจเชื่อมโยงกับหลากหลายประเภท หมายถึงปลายทางอาจมีหลายคุณลักษณะ ได้แก่ beach และ sightseeing

name

ประเภท: สตริง

จำเป็นต้องระบุ

ชื่อที่เป็นที่รู้จักมากที่สุดสำหรับปลายทางนี้

neighborhood

ประเภท: สตริง

ระบุหรือไม่ก็ได้

จำนวนรายการสูงสุด: 20

ย่านที่อยู่ใกล้ปลายทางอย่างน้อย 1 แห่ง

ตัวอย่าง: Soho, Las Vegas Strip

latitude

ประเภท: ทศนิยม

ระบุหรือไม่ก็ได้

ละติจูดของปลายทาง

ตัวอย่าง: 37.484100

longitude

ประเภท: ทศนิยม

ระบุหรือไม่ก็ได้

ลองจิจูดของปลายทาง

ตัวอย่าง: -122.148252

description

ประเภท: สตริง

ระบุหรือไม่ก็ได้

ขนาดสูงสุด: 5,000

ย่อหน้าสั้นๆ ที่บรรยายเกี่ยวกับปลายทาง

price

ประเภท: สตริง

ระบุหรือไม่ก็ได้ จะเป็นราคาต่ำสุดหรือราคาเฉลี่ยของปลายทางนี้ก็ได้ คุณจะต้องระบุมูลค่าพร้อมสกุลเงิน

ตัวอย่าง: 99.99 USD

price_change

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้ การเปลี่ยนแปลงราคา:

  • 0: ไม่มีการเปลี่ยนแปลงราคา
  • -10: ราคาลดลง 10%
  • 20: ราคาเพิ่มขึ้น 20%

สามารถใช้เพื่อสร้างชุดสินค้าและในชิ้นงานโฆษณาทั่วไป ("ราคาเฉลี่ยลดลงไป X")

applink

ประเภท: องค์ประกอบ

ระบุหรือไม่ก็ได้ Deep Link ไปยังหน้ารายละเอียดของปลายทางในแอพมือถือที่ใช้ลิงก์ที่ไปยังแอพ ระบุ Deep Link ตามลำคับความสำคัญจากมากที่สุดไปจนถึงน้อยที่สุดได้ดังนี้:

  1. ในระดับโฆษณาโดยใช้ template_url_spec
  2. ดำเนินการในฟีดโดยใช้อ็อบเจ็กต์ลิงก์ที่ไปยังแอพ
  3. โดยเพิ่มแท็กเมตาของลิงก์ที่ไปยังแอพในเว็บไซต์ของคุณ

status

ประเภท: สตริง

ควบคุมว่าจะเปิดใช้งานหรือจัดเก็บสินค้าในแค็ตตาล็อก ซึ่งผู้คนจะเห็นเฉพาะสินค้าที่เปิดใช้งานในโฆษณา ร้านค้า หรือช่องทางอื่นๆ ของคุณ ค่าที่รองรับ: active, archived ทั้งนี้ สินค้าจะเปิดใช้งานเป็นค่าเริ่มต้น โปรดเรียนรู้เพิ่มเติมเกี่ยวกับการจัดเก็บสินค้า


ตัวอย่าง: active


หมายเหตุ: แพลตฟอร์มของพาร์ทเนอร์บางแพลตฟอร์ม เช่น Shopify อาจซิงค์สินค้ากับแค็ตตาล็อกของคุณโดยใช้สถานะ "กำลังจัดเตรียม" ซึ่งมีลักษณะการทำงานเช่นเดียวกับ archived

ช่องนี้มีชื่อเดิมว่า visibility แม้เราจะรองรับชื่อช่องแบบเดิมอยู่ แต่เราก็ขอแนะนำให้คุณใช้ชื่อแบบใหม่

Deep Link ของสินค้า

ระบุ Deep Linkในฟีดตามข้อมูลจำเพาะของลิงก์ที่ไปยังแอพ ข้อมูล Deep Link ในฟีดมีความสำคัญมากกว่าข้อมูลใดๆ ที่ Facebook เก็บรวบรวมไว้ผ่านเมตาดาต้าของลิงก์ที่ไปยังแอพโดยเว็บครอว์เลอร์ของเรา

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

พารามิเตอร์อ็อบเจ็กต์รูปภาพ

ชื่อและประเภทของช่องคำอธิบาย

url

ประเภท: สตริง

จำเป็นต้องระบุ

URL ของรูปภาพปลายทาง ดำเนินการตามข้อมูลจำเพาะสำหรับรูปภาพต่อไปนี้

  • รูปภาพทั้งหมดต้องเป็นรูปแบบ JPG, GIF หรือ PNG

  • สำหรับโฆษณาแบบภาพสไลด์และโฆษณาคอลเลกชั่น: รูปภาพที่แสดงต้องเป็นแบบสี่เหลี่ยมจัตุรัส (1:1) ขนาดขั้นต่ำของรูปภาพคือ 500 x 500 พิกเซล เราขอแนะนำให้ใช้รูปภาพขนาด 1024 x 1024 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด

  • สำหรับโฆษณาที่มีรูปภาพรูปเดียว: รูปภาพที่แสดงต้องมีอัตราส่วนกว้างยาวเท่ากับ 1.91:1 ขนาดขั้นต่ำของรูปภาพคือ 500 x 500 พิกเซล เราขอแนะนำให้ใช้รูปภาพขนาด 1200 x 628 พิกเซล เพื่อให้ได้คุณภาพที่ดีที่สุด

tag

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่ที่นำเสนอสิ่งที่อยู่ในรูปภาพ รูปภาพ 1 รูปสามารถมีแท็กที่เชื่อมโยงกับรูปภาพได้หลายแท็ก

ตัวอย่าง: Fitness Center, Swimming Pool

INSTAGRAM_STANDARD_PREFERRED - ทำให้ผู้ลงโฆษณาสามารถแท็กรูปภาพที่ต้องการในฟีดเป็นรูปภาพเริ่มต้นที่จะใช้สำหรับ Instagram แท็กนี้คำนึงถึงอักษรตัวพิมพ์เล็กและตัวพิมพ์ใหญ่

พารามิเตอร์อ็อบเจ็กต์ที่อยู่

ช่องที่ซ้อนกันหรือมีหลายค่า เช่น address สามารถแสดงได้โดยใช้ค่าที่เข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ “ปรับให้เป็นระนาบเดียว” และมีการกำกับโดยใช้รูปแบบคำสั่งพาธ JSON เช่น address.region ทั้ง 2 รูปแบบสามารถใช้แทนกันได้ในไฟล์เดียวกัน

ชื่อและประเภทของช่องคำอธิบาย

addr1 (address.addr1)

ประเภท: สตริง

ที่อยู่ของปลายทาง

ตัวอย่าง: 675 El Camino Real

address.city (city)

ประเภท: สตริง

จำเป็นต้องระบุ

เมืองที่ปลายทางตั้งอยู่

ตัวอย่าง: Palo Alto

address.region (region)

ประเภท: สตริง

จำเป็นต้องระบุ

รัฐ เขตปกครอง ภูมิภาค หรือจังหวัดของปลายทาง

ตัวอย่าง: California

address.postal_code (postal_code)

ประเภท: สตริง

รหัสไปรษณีย์ของปลายทาง จำเป็นต้องระบุ ยกเว้นประเทศไม่มีระบบรหัสไปรษณีย์

ตัวอย่าง:

  • 94125
  • NW1 3FG

address.country (country)

ประเภท: สตริง

จำเป็นต้องระบุ

ประเทศที่ปลายทางตั้งอยู่

ตัวอย่าง: United States

address.city_id (city_id)

ประเภท: สตริง

ค่าที่ใช้ใน URL ของ Deep Link (template_url) ในชิ้นงานโฆษณาทั่วไป

หากคุณมีแอพแยกกันสำหรับ iPhone และ iPad โปรดระบุข้อมูลเฉพาะของ iPhone และ iPad หรือระบุเฉพาะข้อมูล iOS

ชื่อและประเภทช่องกรอกข้อมูลคำอธิบาย

ios_url

ประเภท: สตริง

ขั้นตอนการกำหนดเองสำหรับแอพ iOS

ตัวอย่างเช่น: example-ios://electronic

ios_app_store_id

ประเภท: สตริง

ID ของแอพสำหรับ App Store

ตัวอย่างเช่น: 1234

ios_app_name

ประเภท: สตริง

ชื่อแอพ (ที่เหมาะสมสำหรับแสดง)

ตัวอย่างเช่น: Electronic Example iOS

iphone_url

ประเภท: สตริง

ขั้นตอนการกำหนดเองสำหรับแอพ iPhone

ตัวอย่างเช่น: example-iphone://electronic

iphone_app_store_id

ประเภท: สตริง

ID ของแอพสำหรับ App Store

ตัวอย่างเช่น: 5678

iphone_app_name

ประเภท: สตริง

ชื่อแอพ (ที่เหมาะสมสำหรับแสดง)

ตัวอย่างเช่น: Electronic Example iPhone

ipad_url

ประเภท: สตริง

ขั้นตอนการกำหนดเองสำหรับแอพ iPhone

ตัวอย่างเช่น: example-ipad://electronic

ipad_app_store_id

ประเภท: สตริง

ID ของแอพสำหรับ App Store

ตัวอย่างเช่น: 9010

ipad_app_name

ประเภท: สตริง

ชื่อแอพ (ที่เหมาะสมสำหรับแสดง)

ตัวอย่างเช่น: Electronic Example iPad

android_url

ประเภท: สตริง

ขั้นตอนการกำหนดเองสำหรับแอพ Android

ตัวอย่างเช่น: example-android://electronic

android_package

ประเภท: สตริง

ชื่อแพ็คเกจที่มีคุณสมบัติสมบูรณ์สำหรับสร้างความต้องการซื้อ

ตัวอย่างเช่น: com.electronic

android_class

ประเภท: สตริง

ประเภทกิจกรรมที่มีคุณสมบัติสมบูรณ์สำหรับสร้างความต้องการซื้อ

ตัวอย่างเช่น: com.electronic.Example

android_app_name

ประเภท: สตริง

ชื่อแอพ (ที่เหมาะสมสำหรับแสดง)

ตัวอย่างเช่น: Electronic Example Android

ส่วนต่อไปนี้เกี่ยวข้องกับการจัดการแค็ตตาล็อกของคุณโดยใช้ API นี้เท่านั้น

สร้างแค็ตตาล็อกปลายทางโดยใช้ API

แค็ตตาล็อกปลายทางคือที่เก็บรวบรวมปลายทางที่คุณต้องการโปรโมท หากต้องการใช้ API แค็ตตาล็อก โปรดตรวจสอบให้แน่ใจว่าคุณมีระดับของสิทธิ์การเข้าถึง API การตลาดที่เหมาะสม และคุณได้ยอมรับข้อกำหนดในการใช้บริการโดยสร้างแค็ตตาล็อกแรกผ่านตัวจัดการธุรกิจ

หากต้องการสร้างแค็ตตาล็อกปลายทางสำหรับโฆษณาปลายทาง ให้ตั้งค่า vertical เป็น destinations:

curl -X POST \
  -F 'name="Test Destination Catalog"' \
  -F 'vertical="destinations"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v10.0/BUSINESS_ID/owned_product_catalogs

อัพโหลดฟีดปลายทางของคุณผ่านทาง API

เมื่อคุณได้สร้างแค็ตตาล็อกแล้ว คุณจะต้องอัพโหลดฟีดปลายทางของคุณลงใน Facebook ใช้ API เพื่อสร้างอ็อบเจ็กต์ฟีดสำหรับทุกๆ ฟีดที่คุณต้องการอัพโหลด เราขอสนับสนุนให้ใช้การอัพโหลดแบบกำหนดเวลาและการอัพโหลดโดยตรง

กรองแค็ตตาล็อกปลายทางให้เป็นชุดปลายทาง

ชุดปลายทางเป็นชุดย่อยของแค็ตตาล็อกของคุณ หากต้องการตั้งค่าโฆษณาปลายทาง คุณต้องมีชุดปลายทาง ดังนั้น คุณจึงต้องสร้างชุดปลายทางอย่างน้อย 1 ชุด

ชุดปลายทางจะกำหนดโดยตัวกรองที่ใช้กับแค็ตตาล็อกปลายทาง ตัวอย่างเช่น คุณสามารถสร้างชุดปลายทางที่มีปลายทางทั้งหมดที่ราคาลดลงเป็นอย่างมาก โปรดทราบว่าคุณสามารถสร้างชุดปลายทางโดยที่ไม่มีตัวกรองได้เช่นกัน ในกรณีดังกล่าว ชุดปลายทางจะประกอบด้วยปลายทางทั้งหมดในแค็ตตาล็อกของคุณ

use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;

$destination_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);

$destination_set->setData(array(
  ProductSetFields::NAME => 'Test Destination Set',
  ProductSetFields::FILTER => array(
    'price_change' => array(
      'lt' => -20,
    ),
  ),
));

$destination_set->create();
from facebookads.adobjects.productset import ProductSet

destination_set = ProductSet(None, <PRODUCT_CATALOG_ID>)

destination_set[ProductSet.Field.name] = 'Test Destination Set'
destination_set[ProductSet.Field.filter] = {
    'price_change': {
        'lt': -20,
    },
}

destination_set.remote_create()
curl \
  -F 'name=Test Destination Set' \
  -F 'filter={"price_change":{"lt":-20}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.10/<PRODUCT_CATALOG_ID>/product_sets

พารามิเตอร์ filter จะประกอบด้วยตัวดำเนินการและข้อมูลต่อไปนี้

ตัวควบคุมประเภทของฟิลเตอร์

i_contains

ประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

i_not_contains

ไม่ต้องประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

contains

ประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

not_contains

ไม่ต้องประกอบด้วยสตริงย่อย ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

eq

เท่ากับ ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

neq

ไม่เท่ากับ ตัวควบคุมเป็นตัวอักษรที่ไม่ต้องตรงตามตัวพิมพ์เล็กหรือพิมพ์ใหญ่

lt

น้อยกว่า สำหรับช่องตัวเลขเท่านั้น

lte

น้อยกว่าหรือเท่ากับ สำหรับช่องตัวเลขเท่านั้น

gt

มากกว่า สำหรับช่องตัวเลขเท่านั้น

gte

มากกว่าหรือเท่ากับ สำหรับช่องตัวเลขเท่านั้น

ข้อมูลข้อมูลที่กำลังกรอง

country

ประเทศที่ปลายทางตั้งอยู่

price

ราคาสำหรับปลายทางนี้ ราคาอยู่ในหน่วยเซนต์

currency

สกุลเงิน

price_change

ราคาลดลงหรือเพิ่มขึ้น

city

เมืองที่ปลายทางตั้งอยู่

description

คำอธิบายสำหรับปลายทางนี้

name

ชื่อสำหรับปลายทางนี้

destination_set_id

ตัวระบุที่ไม่ซ้ำกันของคุณสำหรับปลายทางในแค็ตตาล็อก