Tài liệu này đã được cập nhật.
Bản dịch sang Tiếng Việt chưa hoàn tất.
Cập nhật bằng tiếng Anh: 13 tháng 11, 2023

Quảng cáo điểm đến - Danh mục và nguồn cấp dữ liệu

Để quảng cáo điểm đến trên Facebook, bạn phải chia sẻ thông tin về điểm đến với Facebook. Bạn có thể thực hiện việc này bằng cách tạo một danh mục điểm đến rồi điền thông tin điểm đến vào danh mục đó.

Tải file CSV hoặc XML lên cho "nguồn cấp dữ liệu điểm đến" có các điểm đến mà bạn muốn quảng cáo

Bạn có thể tạo và quản lý danh mục điểm đến trong Công cụ quản lý thương mại.

Cách sử dụng API để quản lý danh mục:

  1. Tạo danh mục điểm đến
  2. Tải nguồn cấp dữ liệu lên Facebook
  3. Tạo nhóm sản phẩm bằng danh mục điểm đến
  4. Liên kết danh mục với nguồn sự kiện

Nguồn cấp dữ liệu điểm đến - Tải điểm đến lên Facebook

Nguồn cấp dữ liệu điểm đến là một file có các điểm đến mà bạn muốn quảng cáo. Mỗi dòng hoặc mục trong file này biểu thị một điểm đến. Bạn có thể sử dụng một hoặc nhiều nguồn cấp dữ liệu điểm đến, miễn là tất cả các nguồn cấp dữ liệu chứa mọi điểm đến mà bạn muốn quảng cáo.

Định dạng nguồn cấp dữ liệu điểm đến được hỗ trợ

CSV - Mẫu và mô tả

Mẫu CSV | Mẫu TSV (đã làm phẳng) | Mẫu TSV (kiểu JSON)

  • Hàng đầu tiên phải liệt kê các tên trường đã chọn theo thứ tự cung cấp giá trị. Những hàng tiếp theo cung cấp các giá trị tương ứng cho mỗi điểm đến.
  • Bạn cần đưa các trường có chứa dấu cách hoặc dấu phẩy vào trong "dấu ngoặc kép".
  • Đối với những trường lồng nhau hoặc có nhiều giá trị address, neighborhood hoặc image, bạn có thể biểu thị bằng các giá trị mã hóa JSON hoặc bằng một tập hợp các cột văn bản thuần túy "đã làm phẳng" được gắn nhãn theo cú pháp đường dẫn JSON như address.city, neighborhood[0], image[0].url, image[0].tag[0], image[0].tag[1]. Bạn có thể sử dụng cả hai quy ước thay cho nhau trong cùng một file.

XML - Mẫu và mô tả

Mẫu XML

  • Nút XML <listings> gốc chứa một tập hợp nút <listing>, mỗi nút biểu thị một điểm đến.
  • File phải bắt đầu bằng thẻ khai báo <?xml hợp lệ.

The feed parser automatically detects UTF8, UTF16, or UTF32 text encodings, and defaults to LATIN1 if it encounters an unexpected byte sequences. You can provide text in field values in any language; however, field names must be given exactly as below, in English.

Trường thông tin được hỗ trợ - Điểm đến

Dưới đây là các trường thông tin được hỗ trợ dành cho những mặt hàng bạn thêm vào danh mục sản phẩm của mình.

Đối với danh mục được bản địa hóa, hãy xem phần trường thông tin được hỗ trợ cho điểm đến.

Tên và loại trườngMô tả

destination_id

loại: chuỗi

Bắt buộc.

Độ dài tối đa: 100

Thông tin nhận dạng duy nhất cho điểm đến trong danh mục. Hệ thống sẽ khớp ID này với bất kỳ content_ids nào được cung cấp trong ứng dụng destination của bạn và sự kiện pixel. Mẹo: Để cải thiện hiệu quả, hãy tránh sử dụng dấu cách cho trường thông tin nhận dạng duy nhất này.

address

loại: đối tượng

Bắt buộc.

Địa chỉ đầy đủ của điểm đến phải tương ứng với vị trí điểm đến.

Hãy xem phần Thông số đối tượng địa chỉ

image

loại: đối tượng

Bắt buộc.

Số mục tối đa: 20

Dữ liệu hình ảnh cho điểm đến này. Bạn có thể cung cấp tối đa 20 ảnh cho điểm đến. Mỗi hình ảnh có 2 trường: urltag. Bạn có thể liên kết nhiều thẻ với một hình ảnh. Bạn phải cung cấp tối thiểu một image. Kích thước mỗi hình ảnh có thể lên tới 4MB.

Hãy xem phần Thông số đối tượng hình ảnh

url

loại: chuỗi

Bắt buộc.

Liên kết đến trang web bên ngoài mà bạn có thể xem trang điểm đến. Bạn cũng có thể chỉ định URL ở cấp độ quảng cáo bằng cách sử dụng template_url_spec. URL ở cấp độ quảng cáo được ưu tiên hơn so với URL trong nguồn cấp dữ liệu.

type

loại: chuỗi

Bắt buộc.

Số mục tối đa: 20

Loại điểm đến như bãi biển, thành phố, ẩm thực, thắng cảnh, văn hóa, lịch sử, mua sắm, bảo tàng, tĩnh tâm, phong cảnh, thiên nhiên, kiến trúc, kinh doanh, người dân thân thiện, thư giãn, chợ đêm, núi non, đền chùa, đi bộ đường dài, lặn biển, v.v. Một điểm đến có thể thuộc nhiều loại khác nhau, nghĩa là một điểm đến có thể có nhiều thuộc tính như beachsightseeing.

name

loại: chuỗi

Bắt buộc.

Tên phổ biến nhất của điểm đến.

neighborhood

loại: chuỗi

Không bắt buộc.

Số mục tối đa: 20

Một hoặc nhiều khu vực của điểm đến.

Ví dụ: Soho, Las Vegas Strip

latitude

loại: float

Không bắt buộc.

Vĩ độ của điểm đến.

Ví dụ: 37.484100

longitude

loại: float

Không bắt buộc.

Kinh độ của điểm đến.

Ví dụ: -122.148252

description

loại: chuỗi

Không bắt buộc.

Kích thước tối đa: 5000

Đoạn văn ngắn mô tả điểm đến.

price

loại: chuỗi

Không bắt buộc. Có thể là giá thấp nhất hoặc giá trung bình của điểm đến này. Bạn phải chỉ định giá trị bằng đơn vị tiền tệ.

Ví dụ: 99.99 USD

price_change

loại: số nguyên

Không bắt buộc. Thay đổi về giá:

  • 0: Không có thay đổi về giá
  • -10: Giảm giá 10%
  • 20: Tăng giá 20%

Bạn có thể sử dụng trường này để xây dựng nhóm sản phẩm và dùng trong nội dung quảng cáo chung ("giá trung bình đã giảm X").

applink

loại: số nguyên

Không bắt buộc. Liên kết sâu thẳng đến trang chi tiết về điểm đến trong ứng dụng di động bằng cách sử dụng Liên kết ứng dụng. Hãy chỉ định liên kết sâu theo thứ tự ưu tiên, từ cao nhất đến thấp nhất:

  1. cấp độ quảng cáo bằng template_url_spec
  2. tại đây trong nguồn cấp dữ liệu bằng Đối tượng liên kết ứng dụng
  3. Bằng cách thêm thẻ meta Liên kết ứng dụng vào trang web của bạn.

status

Loại: chuỗi

Kiểm soát việc trạng thái của mặt hàng là đang hoạt động hay đã lưu trữ trong danh mục. Mọi người chỉ có thể xem những mặt hàng đang hoạt động trong quảng cáo, cửa hàng hoặc bất kỳ kênh nào khác. Giá trị được hỗ trợ: active, archived. Trạng thái mặc định của mặt hàng là đang hoạt động. Tìm hiểu thêm về cách lưu trữ mặt hàng.


Ví dụ: active


Lưu ý: Một số nền tảng đối tác như Shopify có thể đồng bộ mặt hàng với danh mục ở trạng thái staging. Trạng thái này có ý nghĩa tương tự archived.

Trước đây, trường này có tên là visibility. Mặc dù chúng tôi vẫn hỗ trợ tên trường cũ, nhưng bạn nên sử dụng tên mới.

Liên kết sâu đến sản phẩm

Cung cấp liên kết sâu trong nguồn cấp dữ liệu theo thông số Liên kết ứng dụng. Thông tin liên kết sâu trong nguồn cấp dữ liệu sẽ được ưu tiên hơn so với thông tin mà Facebook thu thập bằng siêu dữ liệu Liên kết ứng dụng thông qua trình thu thập dữ liệu web của chúng tôi.

Nếu đã có thông tin liên kết sâu từ Liên kết ứng dụng, bạn không cần phải chỉ định dữ liệu này. Facebook sử dụng thông tin từ Liên kết ứng dụng để hiển thị liên kết sâu chính xác. Để hiển thị liên kết sâu trong quảng cáo, hãy xem phần Quảng cáo danh mục Advantage+, Mẫu quảng cáo.

Thông số đối tượng hình ảnh

Tên và loại trườngMô tả

url

loại: chuỗi

Bắt buộc.

URL của hình ảnh điểm đến. Hãy tuân thủ các quy cách hình ảnh sau đây:

  • Tất cả hình ảnh phải có định dạng JPG, GIF hoặc PNG.

  • Đối với quảng cáo quay vòng và quảng cáo bộ sưu tập: Hình ảnh hiển thị ở định dạng vuông (1:1). Kích thước hình ảnh tối thiểu là 500 x 500 px. Bạn nên dùng kích thước 1024 x 1024 px để có chất lượng cao nhất.

  • Đối với quảng cáo một hình ảnh: Hình ảnh hiển thị với tỷ lệ khung hình 1,91:1. Kích thước hình ảnh tối thiểu là 500 x 500 px. Bạn nên dùng kích thước 1200 x 628 px để có chất lượng cao nhất.

tag

loại: chuỗi

Không bắt buộc.

Chuỗi biểu thị nội dung trong hình ảnh. Một hình ảnh có thể liên kết với nhiều thẻ.

Ví dụ: Fitness Center, Swimming Pool

INSTAGRAM_STANDARD_PREFERRED - Cho phép nhà quảng cáo gắn thẻ một hình ảnh cụ thể trong nguồn cấp dữ liệu làm hình ảnh mặc định dùng cho Instagram. Thẻ này có phân biệt chữ hoa chữ thường.

Thông số đối tượng địa chỉ

Đối với những trường lồng nhau hoặc có nhiều giá trị như address, bạn có thể biểu thị bằng các giá trị mã hóa JSON hoặc bằng một tập hợp các cột văn bản thuần túy "đã làm phẳng" được gắn nhãn theo cú pháp đường dẫn JSON như address.region. Bạn có thể sử dụng cả hai quy ước thay cho nhau trong cùng một file.

Tên và loại trườngMô tả

addr1 (address.addr1)

loại: chuỗi

Địa chỉ đường của điểm đến.

Ví dụ: 675 El Camino Real

address.city (city)

loại: chuỗi

Bắt buộc.

Thành phố của điểm đến.

Ví dụ: Palo Alto

address.region (region)

loại: chuỗi

Bắt buộc.

Tiểu bang, hạt, vùng hoặc tỉnh của điểm đến.

Ví dụ: California

address.postal_code (postal_code)

loại: chuỗi

Mã bưu chính hoặc mã zip của điểm đến. Bắt buộc trừ khi quốc gia không có hệ thống mã bưu chính.

Ví dụ:

  • 94125
  • NW1 3FG

address.country (country)

loại: chuỗi

Bắt buộc.

Quốc gia của điểm đến.

Ví dụ: United States

address.city_id (city_id)

loại: chuỗi

Giá trị để sử dụng trong URL liên kết sâu (template_url) trong nội dung quảng cáo chung.

If you have separate apps for iPhone and iPad, specify iPhone and iPad specific information. Otherwise specify only iOS information.

Field Name and TypeDescription

ios_url

type: string

A custom scheme for the iOS app.

Example: example-ios://electronic

ios_app_store_id

type: string

The app ID for the App Store.

Example: 1234

ios_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example iOS

iphone_url

type: string

A custom scheme for the iPhone app.

Example: example-iphone://electronic

iphone_app_store_id

type: string

The app ID for the App Store.

Example: 5678

iphone_app_name

type:string

The name of the app (suitable for display).

Example: Electronic Example iPhone

ipad_url

type: string

A custom scheme for the iPhone app.

Example: example-ipad://electronic

ipad_app_store_id

type: string

The app ID for the App Store.

Example: 9010

ipad_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example iPad

android_url

type: string

A custom scheme for the Android app.

Example: example-android://electronic

android_package

type: string

A fully-qualified package name for intent generation.

Exammple: com.electronic

android_app_name

type: string

The name of the app (suitable for display).

Example: Electronic Example Android

Dưới đây là các phần chỉ phù hợp để quản lý danh mục bằng API này.

Tạo danh mục điểm đến bằng API

Danh mục điểm đến là nơi chứa các điểm đến mà bạn muốn quảng cáo. Để sử dụng API danh mục, hãy đảm bảo bạn có Cấp độ truy cập API Marketing thích hợp và bạn đã chấp nhận Điều khoản dịch vụ bằng cách tạo danh mục đầu tiên thông qua Trình quản lý kinh doanh.

Để tạo danh mục điểm đến cho quảng cáo điểm đến, hãy đặt vertical thành 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

Tải nguồn cấp dữ liệu điểm đến lên qua API

Sau khi tạo danh mục, bạn phải tải nguồn cấp dữ liệu điểm đến lên Facebook. Sử dụng API để tạo đối tượng nguồn cấp dữ liệu cho mọi nguồn cấp dữ liệu mà bạn muốn tải lên. Chúng tôi hỗ trợ tải lên theo lịch và tải lên trực tiếp.

Lọc danh mục điểm đến về nhóm điểm đến

Nhóm điểm đến là tập hợp con của danh mục. Để thiết lập quảng cáo điểm đến, bạn cần có nhóm điểm đến. Do đó, bạn phải tạo ít nhất một nhóm điểm đến.

Nhóm điểm đến được xác định bằng cách áp dụng bộ lọc cho danh mục điểm đến. Chẳng hạn, bạn có thể tạo nhóm điểm đến chứa tất cả điểm đến có mức giảm giá lớn. Hãy lưu ý rằng bạn cũng có thể tạo nhóm điểm đến không có bất kỳ bộ lọc nào. Trong trường hợp đó, nhóm điểm đến sẽ chứa tất cả các điểm đến trong danh mục của bạn.

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

Thông số filter được tạo thành từ các toán tử và dữ liệu sau:

OperatorsFilter Type

i_contains

Contains substring. Operator is case-insensitive.

i_not_contains

Does not contain substring. Operator is case-insensitive.

contains

Contains substring. Operator is case-insensitive.

not_contains

Does not contain substring. Operator is case-insensitive.

eq

Equal to. Operator is case-insensitive.

neq

Not equal to. Operator is case-insensitive.

lt

Less than. For numeric fields only.

lte

Less than or equal to. For numeric fields only.

gt

Greater than. For numeric fields only.

gte

Greater than or equal to. For numeric fields only.

Dữ liệuDữ liệu được lọc

country

Quốc gia của đích đến.

price

Giá của điểm đến này. Giá được tính bằng cent.

currency

Đơn vị tiền tệ.

price_change

Giảm hoặc tăng giá.

city

Thành phố của điểm đến.

description

Mô tả của điểm đến này.

name

Tên của điểm đến này.

destination_set_id

Thông tin nhận dạng duy nhất cho đích đến trong danh mục.