Nội dung quảng cáo

Quảng cáo bằng nhiều ngôn ngữ

Tùy chỉnh các phần khác nhau của nội dung quảng cáo, chẳng hạn như hình ảnh, video, văn bản và nội dung của quảng cáo để tiếp cận người nói ngôn ngữ khác. Facebook tối ưu hóa quảng cáo của bạn để hiển thị đúng phiên bản ngôn ngữ với đúng người.

Nhờ đó, bạn có thể dễ dàng thiết lập quảng cáo bằng nhiều ngôn ngữ và cung cấp phiên bản ngôn ngữ phù hợp nhất của quảng cáo cho người xem, trong khi vẫn nhắm mục tiêu rộng rãi cho quảng cáo. Cũng nhờ vậy mà bạn sẽ có nội dung cá nhân hóa dựa trên ngôn ngữ của người xem mà vẫn tiết kiệm được chi phí quảng cáo.

Để biết thông tin chung về tính năng này, hãy xem phần Trung tâm trợ giúp quảng cáo, Quảng cáo cho đối tượng đa ngôn ngữ. Xem các mục tiêu chiến dịch quảng cáo được hỗ trợ.

Quảng cáo bằng nhiều ngôn ngữ là một trong 3 API sử dụng quy tắc tùy chỉnh tài sản của chúng tôi.

Bắt đầu

Trước khi bạn bắt đầu, hãy xem các hạn chế đối với sản phẩm này. Nếu trường hợp sử dụng của bạn đáp ứng các thông số của chúng tôi, hãy chuyển sang những bước sau đây:

Nếu bạn không có nguồn lực để tự mình dịch quảng cáo, hãy xem dịch vụ dịch tự động của chúng tôi.

Bước 2: Cung cấp nội dung thông qua asset_feed_spec

Nội dung quảng cáo bằng nhiều ngôn ngữ được chỉ định bằng asset_feed_spec. Nguồn cấp tài sản là tập hợp các thành phần nội dung khác nhau, chẳng hạn như hình ảnh, tiêu đề, nội dung, v.v. Bạn tạo asset_feed_spec tại /adcreative.

Để tạo asset_feed_spec, hãy cung cấp một mảng tài sản cho mỗi ngôn ngữ khác nhau. Thêm nhãn để gắn thẻ từng tài sản nhằm xác định ngôn ngữ của tài sản đó. Facebook sử dụng nhãn trong asset_customization_rules để nhóm các tài sản với nhau theo ngôn ngữ. Bạn nên cung cấp ít nhất một tài sản cho mỗi loại tài sản.

Thông số hiện có

Các thông số để cung cấp trong asset_feed_spec bao gồm:

Tên thuộc tính Mô tả

images

loại: mảng

Bắt buộc đối với định dạng quảng cáo SINGLE_IMAGE. Cung cấp url hoặc hash.

Hình ảnh dưới dạng url hoặc hash. Bạn nên cung cấp những hình ảnh có trong thư viện ảnh của tài khoản quảng cáo.


Cung cấp trường này dưới dạng mảng {"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]}.

videos

loại: mảng

Bắt buộc đối với định dạng quảng cáo SINGLE_VIDEO.

Mảng video_ids. Video nên có trong thư viện video của tài khoản quảng cáo.


Cung cấp trường này dưới dạng mảng {"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]}.

bodies

loại: mảng

Bắt buộc, nhưng url_tags là không bắt buộc.

Mảng nội dung chứa thông điệp chính của quảng cáo.


Cung cấp trường này dưới dạng mảng {"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}.

titles

loại: mảng

Bắt buộc, nhưng url_tags là không bắt buộc.

Mảng tiêu đề. Tiêu đề ngắn trong quảng cáo, thường hiển thị bên cạnh liên kết, hình ảnh hoặc video.


Cung cấp trường này dưới dạng mảng {"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}.

descriptions

loại: mảng

Bắt buộc, nhưng url_tags là không bắt buộc.

Mảng văn bản mô tả phụ, hiển thị ít nổi bật hơn nội dung hoặc tiêu đề.


Cung cấp trường này dưới dạng mảng {"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}. Sử dụng chuỗi trống với một khoảng trống cho nội dung mô tả trống.

link_urls

loại: mảng

Bắt buộc, nhưng display_url và deeplink_url là không bắt buộc.

Mảng URL liên kết.


Cung cấp trường này dưới dạng mảng {"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"}.

call_to_action_types

loại: mảng

Bắt buộc.

Mảng giá trị call-to-action-type.


Cung cấp trường này dưới dạng mảng nút kêu gọi hành động được hỗ trợ: ["<CALL_TO_ACTION>"].

ad_formats

Bắt buộc.

Mảng định dạng quảng cáo trên Facebook mà bạn muốn tạo quảng cáo. Các định dạng được hỗ trợ là: SINGLE_IMAGE, SINGLE_VIDEO.


Cung cấp trường này dưới dạng mảng định dạng quảng cáo được hỗ trợ: ["{<AD_FORMAT>}"].

asset_customization_rules

loại: xem bảng bên dưới trong mục Quy tắc tùy chỉnh tài sản

Bắt buộc.

Mảng quy tắc tùy chỉnh tài sản.

Quy tắc tùy chỉnh tài sản

Xác định các tài sản cùng xuất hiện cho những người xem nói một ngôn ngữ cụ thể. Mỗi quy tắc có một customization_spec dùng để xác định ngôn ngữ của những người xem tài sản này trong quá trình phân phối quảng cáo.

Cung cấp chính xác một quy tắc mặc định. Quy tắc này phải bao gồm các tài sản mà Facebook hiển thị nếu ngôn ngữ yêu thích của ai đó không khớp với bất kỳ ngôn ngữ nào được chỉ định trong nguồn cấp tài sản. Điều này sẽ giúp ngăn chặn tình trạng phân phối dưới mức cho quảng cáo.

Tên thuộc tính Mô tả

customization_spec

loại: {"locales": [<LOCALE1>, <LOCALE2>]}

Bắt buộc.

Xác định ngôn ngữ mà tài sản trong quy tắc này sẽ phân phối. Để biết các ngôn ngữ được hỗ trợ, hãy xem phần Ngôn ngữ hiện có.

image_label

loại: {"name": "<LABEL>"}

Bắt buộc đối với định dạng quảng cáo SINGLE_IMAGE.

Nhãn gắn liền với một trong những tài sản hình ảnh trên nguồn cấp dữ liệu tài sản.

video_label

loại: {"name": "<LABEL>"}

Bắt buộc đối với định dạng quảng cáo SINGLE_VIDEO.

Nhãn gắn liền với một trong những tài sản video trên nguồn cấp dữ liệu tài sản.

body_label

loại: {"name": "<LABEL>"}

Bắt buộc.

Nhãn gắn liền với một trong những tài sản nội dung trên nguồn cấp dữ liệu tài sản.

title_label

loại: {"name": "<LABEL>"}

Bắt buộc.

Nhãn gắn liền với một trong những tài sản tiêu đề trên nguồn cấp dữ liệu tài sản.

description_label

loại: {"name": "<LABEL>"}

Bắt buộc.

Nhãn gắn liền với một trong những tài sản mô tả trên nguồn cấp dữ liệu tài sản.

link_url_label

loại: {"name": "<LABEL>"}

Bắt buộc.

Nhãn gắn liền với một trong những tài sản link_url trên nguồn cấp dữ liệu tài sản.

is_default

loại: boolean

Bắt buộc.

Cờ boolean để xác định quy tắc mặc định. Bạn nên đặt chính xác một quy tắc với cờ is_default là true.

Ngôn ngữ hiện có

Ngôn ngữ bạn cung cấp trong customization_spec phải là ID ngôn ngữ được hỗ trợ trong tùy chọn nhắm mục tiêu quảng cáo. Hãy xem phần Nhắm mục tiêu và vị trí quảng cáo, Ngôn ngữ. Bạn có thể tìm kiếm ngôn ngữ cụ thể bằng cách sử dụng điểm cuối /search. Sử dụng thông số q để tìm kiếm một tên ngôn ngữ cụ thể. Để trống thông số này để lấy danh sách tất cả ngôn ngữ được hỗ trợ:

curl -G \
  -d "type=adlocale" \
  -d "q=en" \
  -d "limit=2" \
  -d "access_token=<ACCESS_TOKEN>" \ 
  https://graph.facebook.com/v21.0/search

Khi thành công, bạn sẽ nhận được một danh sách ngôn ngữ:

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

Bạn nên sử dụng các phím trong kết quả tìm kiếm nêu trên làm ngôn ngữ trong quy tắc tùy chỉnh tài sản của mình. Để biết thêm thông tin, hãy xem phần Tìm kiếm tùy chọn nhắm mục tiêu.

Bước 3: Tạo quảng cáo bằng cách sử dụng thông số nguồn cấp dữ liệu tài sản

Bạn có thể tạo nguồn cấp dữ liệu tài sản bằng cách sử dụng trường asset_feed_spec trong POST ad_account_ID/adcreatives:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Khi thành công, bạn sẽ nhận được ID của nội dung quảng cáo:

{"id":"238474593777777"}

Nếu asset_feed_spec không đáp ứng các hạn chế bên dưới, bạn sẽ gặp lỗi.

Để tạo quảng cáo có ID nội dung quảng cáo này, hãy gọi POST act_AD_ACCOUNT_ID/ads. Hoặc, để hiển thị ngôn ngữ khác trong quảng cáo của bạn, hãy cung cấp asset_feed_spec và object_story_spec trong thông số creative cho quảng cáo.

Để xác minh asset_feed_spec mới, hãy gọi GET trên ID quảng cáo hoặc ID nội dung quảng cáo:

curl -G \
-d 'fields=object_story_spec,asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>

Bước 4 (Không bắt buộc): Xem trước quảng cáo

Xem trước các phiên bản ngôn ngữ khác nhau của quảng cáo bằng cách sử dụng điểm cuối generatepreview. Thêm trường dynamic_asset_label có mã adlabel vào quy tắc để xem một phiên bản ngôn ngữ cụ thể.

Ví dụ: để xem trước phiên bản tiếng Pháp của nội dung ở trên:

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

Dịch tự động

Bạn có thể sử dụng dịch vụ dịch tự động nếu không có nguồn lực để tự mình dịch quảng cáo. Tính năng này sẽ dịch câu từ quảng cáo mặc định của bạn ra các ngôn ngữ khác để bạn có thể tiếp cận đối tượng đa ngôn ngữ.

Nguồn bản dịch tự động có thể tìm thấy trong tài sản văn bản do quy tắc tùy chỉnh tài sản mặc định chỉ định. Câu từ quảng cáo được dịch tự động sẽ có nhãn là “Đã dịch tự động”.

Để tạo bản dịch tự động của câu từ quảng cáo, hãy thêm autotranslate vào asset_feed_spec. Sau đó, chỉ định ngôn ngữ mà bạn muốn câu từ quảng cáo được dịch sang. Xem ví dụ:

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "optimization_type": "LANGUAGE",
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

Bạn có thể xem lại câu từ được dịch tự động bằng lệnh gọi đến trường asset_feed_spec trên nội dung.

Mọi chỉnh sửa đối với câu từ được dịch tự động thên thông số sẽ bị mất nếu bạn chỉ định ngôn ngữ tương tự trên trường autotranslate. Những chỉnh sửa này sẽ bị thay thế bằng bản dịch mới từ câu từ quảng cáo mặc định. Nếu bạn thực sự cần nội dung chỉnh sửa, hãy xóa ngôn ngữ khỏi trường autotranslate.

link_urls

Bạn có thể thêm URL liên kết tùy chỉnh vào phiên bản quảng cáo được dịch tự động.

Để thực hiện điều này, hãy thêm URL language-specific vào trường link_urls cùng với adlabel và thêm một quy tắc mới vào asset_customization_rules với các mã ngôn ngữ liên kết và link_url_label cho ngôn ngữ này.

Han chế

Sau đây là các hạn chế và giới hạn đối với nguồn cấp dữ liệu tài sản của bạn.

Định dạng quảng cáo

  • Chỉ một định dạng quảng cáo cho mỗi asset_feed_spec
  • Đối với định dạng SINGLE_IMAGE, bạn phải cung cấp ít nhất một hình ảnh.
  • Đối với định dạng SINGLE_VIDEO, bạn phải cung cấp ít nhất một video

Tài sản, Chung

  • Bạn có thể cung cấp tối đa 49 tài sản cho mọi loại tài sản ngoại trừ call_to_action_types.
  • Bạn phải cung cấp chính xác một tài sản call_to_action_type cho tất cả các mục tiêu.

Tài sản văn bản

  • Bạn phải cung cấp ít nhất một tài sản văn bản, chẳng hạn như title, nội dung, description và link_urls, cho mọi phiên bản ngôn ngữ trong nguồn cấp dữ liệu tài sản.
  • Tất cả tài sản văn bản phải có trường adlabels.
  • Độ dài tối đa: 255 ký tự cho tiêu đề, 4.096 ký tự cho nội dung và 10.000 ký tự cho mô tả.

Tài sản hình ảnh và video

  • Để biết kích thước hình ảnh được khuyến nghị cho vị trí quảng cáo và mục tiêu, hãy xem Hướng dẫn quảng cáo.
  • Bạn có thể sử dụng tối đa một tài sản hình ảnh hoặc video mà không cần adlabel. Chúng tôi sử dụng hình ảnh hoặc video này cho tất cả phiên bản ngôn ngữ.
  • Nếu cung cấp video hoặc hình ảnh khác, bạn phải thêm adlabel và cung cấp những nhãn này trong quy tắc tùy chỉnh tài sản.

Tài sản URL liên kết

  • Nếu bạn cung cấp url_tags, chúng tôi sẽ thêm thẻ đó vào link_url làm thông số cho từng tài sản trong quảng cáo.
  • Nếu bạn sử dụng mục tiêu APP_INSTALLS, link_url phải giống với promoted_object.object_store_url của nhóm quảng cáo.

Quy tắc tùy chỉnh tài sản

  • Bạn phải cung cấp một quy tắc tùy chỉnh tài sản cho mọi biến thể ngôn ngữ trong asset_feed_spec.
  • Bạn phải cung cấp một quy tắc mặc định. Đây là quy tắc tùy chỉnh tài sản có is_default được đặt thành true. Quy tắc này đóng vai trò là quy tắc dự phòng và cho phép quảng cáo hiển thị ngay cả khi ngôn ngữ của ai đó không khớp với bất kỳ ngôn ngữ nào trong asset_feed_spec.

Vị trí quảng cáo

  • Quảng cáo bằng nhiều ngôn ngữ hỗ trợ tất cả các vị trí quảng cáo.

Các mục tiêu và loại đích đến hiện có

  • LINK_CLICKS - Trang web và ứng dụng, không có Messenger.
  • APP_INSTALLS - Ứng dụng dành cho máy tính hoặc ứng dụng di động.
  • CONVERSIONS - Trang web và ứng dụng, không có Messenger.
  • REACH - Tất cả các loại đích đến.
  • BRAND_AWARENESS - Tất cả các loại đích đến.
  • VIDEO_VIEWS - Tất cả các loại đích đến

Cách mua được hỗ trợ

Các hướng dịch thuật được hỗ trợ

Các hướng dịch thuật sau đây được hỗ trợ. Sử dụng mã phương ngữ tương ứng trong trường autotranslate:

Ngôn ngữ nguồnNgôn ngữ đích của bản dịchMã phương ngữ

Tiếng Anh

Tiếng Tây Ban Nha

es_XX

Tiếng Anh

Tiếng Pháp

fr_XX

Tiếng Anh

Tiếng Đức

de_DE

Tiếng Anh

Tiếng Bồ Đào Nha

pt_XX

Tiếng Anh

Tiếng Ý

it_IT

Tiếng Anh

Tiếng Ả Rập

ar_AR

Tiếng Anh

Tiếng Hà Lan

nl_XX

Tiếng Anh

Tiếng Malaysia

ms_MY

Tiếng Anh

Tiếng Thụy Điển

sv_SE

Tiếng Anh

Tiếng Indonesia

id_ID

Tiếng Anh

Tiếng Ba Lan

pl_PL

Tiếng Anh

Tiếng Hindi

hi_IN

Tiếng Anh

Tiếng Đan Mạch

da_DK

Tiếng Anh

Tiếng Thổ Nhĩ Kỳ

tr_TR

Tiếng Anh

Tiếng Tagalog

tl_XX

Tiếng Anh

Tiếng Romania

ro_RO

Tiếng Đức

Tiếng Anh

en_XX

Tiếng Ả Rập

Tiếng Anh

en_XX

Tiếng Do Thái

Tiếng Anh

en_XX

Tiếng Tây Ban Nha

Tiếng Anh

en_XX

Tiếng Nhật

Tiếng Anh

en_XX

Tiếng Na Uy

Tiếng Anh

en_XX

Tiếng Pháp

Tiếng Anh

en_XX

Tiếng Hà Lan

Tiếng Anh

en_XX

Tiếng Thụy Điển

Tiếng Anh

en_XX