Bắt đầu sử dụng quảng cáo danh mục Advantage+

Với quảng cáo danh mục Advantage+, bạn có thể tạo quảng cáo được cá nhân hóa nhắm mục tiêu đến đúng đối tượng dựa trên một nhóm sản phẩm.

Trước khi bạn bắt đầu

Để tạo chiến dịch quảng cáo danh mục Advantage+, bạn cần có:

• Một Trang Facebook đại diện cho nhà quảng cáo. Ngoài ra, nếu bạn chạy chiến dịch này trên Instagram, hãy thêm Tài khoản Instagram nếu muốn.
• Một tài khoản quảng cáo có thông tin thanh toán đã đăng ký.
• Một danh mục - chẳng hạn như danh mục sản phẩm - có trong tài khoản Trình quản lý kinh doanh của bạn.

Bạn có thể tùy ý thiết lập một đối tượng sản phẩm động, nhưng không bắt buộc phải đặt các trường hợp bao gồm hoặc loại trừ nhóm sản phẩm trong phần cài đặt nhắm mục tiêu.

Bước 1: Tạo chiến dịch quảng cáo

Hãy xem tài liệu về Chiến dịch quảng cáo để tìm hiểu cách tạo chiến dịch quảng cáo.

Ở cấp độ này, bạn phải đặt mục tiêu quảng cáo qua trường objective. Đối với quảng cáo danh mục Advantage+, các mục tiêu được hỗ trợ là PRODUCT_CATALOG_SALES, CONVERSIONS, LINK_CLICKS hoặc APP_INSTALLS. Nếu objective bạn cung cấp là CONVERSIONS, LINK_CLICKS hoặc APP_INSTALLS, bạn không cần phải thêm trường promoted_object.

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Bước 2: Tạo nhóm quảng cáo

Đối với quảng cáo danh mục Advantage+, bạn phải chỉ định product_set_id trong promoted_object cho cấp độ nhóm quảng cáo để quảng bá các sản phẩm trong nhóm sản phẩm đó.

Ngoài ra, bạn cũng có thể xác định sự kiện chuyển đổi riêng cho nhóm sản phẩm đó bằng cách chỉ định custom_event_type trong promoted_object khi optimization_goal là OFFSITE_CONVERSIONS. Điều này giúp nhắm mục tiêu quảng cáo đến những người đã thực hiện sự kiện đó trong ứng dụng hoặc trang web của bạn.

Ví dụ: nếu bạn đặt sự kiện này là ADD_TO_CART thì tức là sự kiện Thêm vào giỏ hàng sẽ là sự kiện chuyển đổi. Theo mặc định, custom_event_type được đặt là PURCHASE. Hãy tìm hiểu thêm về các giá trị và sự kiện tiêu chuẩn cho custom_event_type tại bài viết Theo dõi chuyển đổi thuộc phần Meta Pixel.

Nếu bạn muốn tối ưu hóa cho lượt chuyển đổi ngoài trang web - bao gồm cả lượt chuyển đổi từ sự kiện trong ứng dụng lẫn Facebook Pixel - đồng thời được lập hóa đơn theo lượt hiển thị, hãy:

• Đặt optimization_goal là OFFSITE_CONVERSIONS
• Đặt billing_event là IMPRESSIONS

Bạn có thể tìm thêm chi tiết về những cách kết hợp hợp lệ giữa optimization_goal và billing_event trong phần Mục tiêu tối ưu hóa và Sự kiện lập hóa đơn.

Dưới đây là ví dụ về cách tạo một nhóm quảng cáo được lập hóa đơn theo IMPRESSIONS và tối ưu hóa cho OFFSITE_CONVERSIONS:

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ "geo_locations": {"countries":["US"]}, 
    "dynamic_audience_ids": ["<DYNAMIC_AUDIENCE_ID>"] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

DYNAMIC_AUDIENCE_ID tham chiếu đến đối tượng của sản phẩm. Bạn có thể bỏ qua dynamic_audience_ids trong lệnh gọi nếu muốn.

Ví dụ: đối với các trường hợp sử dụng thương mại điện tử, bạn có thể bỏ qua dynamic_audience_ids trong lệnh gọi. Thay vào đó, bạn có thể gửi thông tin nhắm mục tiêu theo hành vi như một phần của thông số product_audience_specs hoặc excluded_product_audience_specs. Dưới đây là những quy cách được xác định bằng chính các thông số mà bạn dùng để tạo đối tượng của sản phẩm.

Thông số

Nhắm mục tiêu lại

Trong ví dụ này, chúng tôi nhắm mục tiêu đến những người đã xem sản phẩm trong 3-5 ngày qua nhưng chưa mua sản phẩm. Vị trí quảng cáo nằm trên nguồn cấp dữ liệu di động và Audience Network. Hãy tạo đối tượng này như sau:

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "publisher_platforms": ["facebook","audience_network"], 
    "device_platforms": ["mobile"], 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":<PRODUCT_SET_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Bán chéo hoặc bán nâng cấp

Dưới đây là ví dụ về cách quảng cáo các sản phẩm mà người dùng chưa xem:

curl \
-F 'name=Case 1 Adset' \
-F 'bid_amount=3000' \
-F 'billing_event=IMPRESSIONS' \
-F 'status=ACTIVE' \
-F 'daily_budget=15000' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'targeting= { \
            "geo_locations": { \
            "countries":["US"], \
             }, \
            "interests":[ \
                {"id":6003397425735,"name":"Tennis"}, \
            ], \
        }' \
-F 'promoted_object={"product_set_id”:<PRODUCT_SET_ID>}' \
-F 'access_token=<ACCESS_TOKEN>’ \
https://graph.facebook.com/<API_VERSION>/act_<ACCOUNT_ID>/adsets

Cách bán chéo giữa các nhóm sản phẩm:

• Cung cấp đối tượng của sản phẩm có các quy tắc sự kiện liên quan đến nhóm sản phẩm A.
• Hiển thị các sản phẩm từ nhóm sản phẩm B trong quảng cáo bằng cách đặt product_set_id là nhóm sản phẩm B ở cấp độ nội dung quảng cáo.

Ví dụ: một doanh nghiệp muốn tăng doanh số bán túi xách trong PRODUCT_SET_1 bằng cách nhắm mục tiêu quảng cáo đến những người dùng hiện có đã quan tâm đến giày dép trong PRODUCT_SET_2. Hãy đặt product_set_id trong product_audience_specs là ID hoặc giày của PRODUCT_SET_2 và product_set_id trong promoted_object là ID hoặc túi xách của PRODUCT_SET_1.

curl \
  -F 'name=My cross sell ad set' \
  -F 'bid_amount=3000' \
  -F 'billing_event=LINK_CLICKS' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"ViewContent"}}}], 
        "exclusions": [{"retention_seconds":432000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_2_ID>", 
        "inclusions": [{"retention_seconds":259200,"rule":{"event":{"eq":"ViewContent"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_1_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets  

Đồng thời, đặt product_set_id trong nội dung là ID của PRODUCT_SET_1.

  curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Nhắm mục tiêu đối tượng rộng

Ngoài nhắm mục tiêu lại và bán chéo cho khách hàng hiện có, bạn còn có thể sử dụng quảng cáo danh mục Advantage+ để nhắm mục tiêu đến đối tượng rộng bằng tùy chọn nhắm mục tiêu theo độ tuổi, giới tính và các thông tin nhân khẩu học khác, cùng những sản phẩm liên quan trong danh mục sản phẩm của bạn. Bằng cách kết hợp đối tượng mục tiêu rộng với tùy chọn đặt giá thầu cho lượt chuyển đổi ngoài trang web, quảng cáo danh mục Advantage+ cho phép bạn mở rộng đáng kể phạm vi tiếp cận của quảng cáo một cách hiệu quả.

Cách nhắm mục tiêu đến đối tượng rộng:

• Tạo đối tượng bằng tùy chọn nhắm mục tiêu theo thông tin nhân khẩu học cơ bản, chẳng hạn như phụ nữ trên 18 tuổi ở Hoa Kỳ.
• Thêm customOptimize cho OFFSITE_CONVERSIONS thông qua các tín hiệu thể hiện ý định rõ ràng hơn, chẳng hạn như Purchase hoặc InitiateCheckout.

Trong ví dụ sau, chúng tôi tạo một nhóm quảng cáo nhắm mục tiêu đến phụ nữ trong độ tuổi từ 30-65 ở Hoa Kỳ, loại trừ các khách hàng đã mua sản phẩm trong 10 ngày qua. Chúng tôi sẽ đặt giá thầu là 8 USD, sử dụng OFFSITE_CONVERSIONS cho sự kiện PURCHASE.

curl \
  -F 'name=Broad Audience Targeting' \
  -F 'bid_amount=800' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={ 
    "age_max": 65, 
    "age_min": 30, 
    "geo_locations": {"countries":["US"]}, 
    "genders": [2], 
    "excluded_product_audience_specs": [ 
      { 
        "product_set_id": "<PRODUCT_SET_ID>", 
        "inclusions": [{"retention_seconds":864000,"rule":{"event":{"eq":"Purchase"}}}] 
      } 
    ] 
  }' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type":"PURCHASE"}' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Hạng mục dành cho quảng cáo danh mục Advantage+

Hạng mục dành cho quảng cáo danh mục Advantage+ gồm có 2 tùy chọn nội dung mới cho nền tảng quảng cáo danh mục Advantage+. Bạn có thể dùng cả 2 tùy chọn này để cá nhân hóa nội dung dành cho người đi mua hàng sắp đưa ra quyết định. Với tính năng này, bạn có thể tạo một danh mục hình ảnh nội dung thứ hai, nhỏ mà hiệu quả hơn để đại diện cho từng hạng mục (ngoài danh mục hình ảnh sản phẩm bạn đã có) và chúng tôi sẽ so khớp các hạng mục sản phẩm với mọi người trong quảng cáo của bạn giống cách chúng tôi so khớp sản phẩm với mọi người.

Bạn cũng có thể dùng hạng mục dành cho quảng cáo danh mục Advantage+ với bất kỳ tùy chọn nhắm mục tiêu nào trong mục tiêu lưu lượng truy cập, lượt chuyển đổi hoặc doanh số theo danh mục. Nếu bạn không có hình ảnh chất lượng cao đại diện cho từng hạng mục hoặc thương hiệu, Facebook có thể tự động tạo ảnh ghép (kích thước 2x2) từ những sản phẩm hàng đầu cho từng nhóm sản phẩm.

Khi đối ghép hình ảnh mới này với các danh mục sản phẩm hiện có, bạn có thể dùng một trong 3 cột trong nguồn cấp dữ liệu để nhóm các mặt hàng với nhau: thương hiệu, loại sản phẩm và hạng mục sản phẩm của Google.

Trong ví dụ về danh mục bên dưới, cột Loại sản phẩm có 5 giá trị khác nhau. Nhà quảng cáo có thể cung cấp tối đa 5 ảnh ghép hoặc ảnh lối sống - một ảnh cho mỗi giá trị khác nhau trong product_type. Loại sản phẩm là tiêu chí phân loại của hạng mục. Đây chính là tên của trường danh mục được dùng để xác định hạng mục. Giá trị của trường danh mục là giá trị tiêu chí của hạng mục.

Bạn có thể xác định rõ ràng một hạng mục theo:

• ID danh mục sản phẩm
• Tiêu chí phân loại (thương hiệu, loại sản phẩm hoặc hạng mục sản phẩm của Google)
• Giá trị tiêu chí (lấy từ danh mục)

Bạn có thể liên kết từng hạng mục (ví dụ: mỗi nhóm sản phẩm được xác định theo các giá trị khác nhau ở một trong những cột được chỉ định ở trên) với các tài sản sau:

• Tên - Tên ngắn của hạng mục hiển thị với người dùng (tối đa 40 ký tự).
• Mô tả - Mô tả về hạng mục hiển thị với người dùng (tối đa 20 ký tự).
• destination_uri - URL của trang đích khi người dùng nhấp vào hạng mục.
• image_url - Không bắt buộc. URL của ảnh lối sống đại diện cho hạng mục. Nếu bạn không cung cấp image_url, chúng tôi sẽ tự động tạo ảnh ghép từ các sản phẩm hàng đầu của hạng mục đó.

Trong thời gian phân phối quảng cáo, chúng tôi sẽ chủ động so khớp từng tài khoản trong Trung tâm quảng cáo với các hạng mục mà họ có khả năng sẽ phản hồi nhất bằng cách sử dụng mô hình máy học tương tự các mô hình hỗ trợ quảng cáo danh mục Advantage+ hiện nay.

API Quản lý hạng mục

Thông tin về hạng mục được lưu ở cấp độ danh mục, nghĩa là những quảng cáo khác nhau quảng bá các hạng mục từ cùng một danh mục sẽ có tài sản giống nhau, giống như các quảng cáo quảng bá sản phẩm sẽ có chung tài sản được xác định trong các danh mục. Chúng tôi hỗ trợ các tùy chọn nội dung khác nhau để tùy chỉnh quảng cáo theo hạng mục.

Bên dưới là các API để lấy và cập nhật thông tin về hạng mục.

Đọc

Yêu cầu

  curl -G \
    -d 'fields=["criteria_value","name","description","destination_uri","image_url"]' \
    -d 'categorization_criteria=product_type' \
    -d 'filter={"price_amount":{"gt":1500}}' \ # optional
    -d 'access_token=<ACCESS_TOKEN>' \
    https://graph.facebook.com/v19.0/<PRODUCT_CATALOG_ID>/categories

Chúng tôi truy vấn tất cả sản phẩm (hỗ trợ bộ lọc tùy chọn) và tìm 1.000 hạng mục hàng đầu (sắp xếp theo số lượng sản phẩm).

Phản hồi mẫu

{
  "data": [
    {
      "criteria_value": "clothes",
      "name": "Awesome clothes",
      "description": "Check out these awesome clothes!",
      "destination_uri": "http://www.example.com/clothes",
      "image_url": "http://www.example.com/clothes.jpg"
    },
    ...
    {
      "criteria_value": "shoes",
      "name": "Awesome shoes",
      "description": "Check out these awesome shoes!",
      "destination_uri": "http://www.example.com/shoes",
      "image_url": "http://www.example.com/shoes.jpg"
    }
  ]
}

Cập nhật

Bạn có thể chỉ định thông tin về nhiều hạng mục trong dữ liệu. Mỗi hạng mục cần có categorization_criteria và criteria_value. Các trường name, description, destination_uri và image_url là trường không bắt buộc. Trong lần đầu tiên cập nhật thông tin về hạng mục, bạn phải chỉ định destination_uri. Nếu không muốn phân phối hạng mục nào đó, bạn chỉ cần để trống destination_uri.

Lưu ý: Facebook hiện chưa hỗ trợ tính năng xóa hạng mục.

Yêu cầu

curl \
  -F 'data=[{"categorization_criteria":"product_type","criteria_value":"product_type_value","name":"Name","description":"Description","destination_uri":"http://www.example.com/","image_url":"<IMAGE_URL>"}]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<lPRODUCT_CATALOG_ID>/categories

Tạo quảng cáo

Cách tạo quảng cáo có hạng mục dành cho quảng cáo danh mục Advantage+ tương tự như cách tạo quảng cáo cho quảng cáo danh mục Advantage+ khác, nhưng cách chọn nội dung thì hơi khác một chút. Bạn vẫn quảng bá nhóm sản phẩm bằng quảng cáo hạng mục động, chỉ khác là chúng tôi sẽ hiển thị nội dung hạng mục.

curl \
  -F "name=Dynamic Category Ad Creative" \
  -F 'object_story_spec={"page_id": "<PAGE_ID>", "template_data": {"description": "{{category.description}}", "link": "https://www.example.com/", "message": "<MESSAGE>", "name": "{{category.name}}"}}' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'categorization_criteria=brand' \
  -F 'category_media_source=MIXED' \ # optional
  -F access_token=<ACCESS_TOKEN> \
  https://graph.facebook.com/v19.0/act_<ACCOUNT_ID>/adcreatives

Lệnh này sẽ tạo ra nội dung quảng cáo theo hạng mục hiển thị ở định dạng quay vòng:

Mã hạng mục

Mã hạng mục được hỗ trợ:

• category.name - Tên hạng mục trong nhóm sản phẩm được quảng cáo.
• category.description - Nội dung mô tả hạng mục trong nhóm sản phẩm được quảng cáo.
• category.destination_uri - URI trang đích của hạng mục.
• category.min_price - Giá tối thiểu cho hạng mục này trong nhóm sản phẩm được quảng cáo. Thông tin này được lấy từ danh mục.

Thông số

Tên	Mô tả
categorization_criteria	Chỉ định loại hạng mục cần sử dụng. Giá trị: brand product_type google_product_category
category_media_source	Chỉ định cách hiển thị thẻ quay vòng hạng mục. Giá trị: mixed (mặc định) Sử dụng hình ảnh của hạng mục này nếu có. Nếu hạng mục này không có hình ảnh, hãy sử dụng products_collage. category Sử dụng hình ảnh của hạng mục. Hãy bỏ qua hạng mục này nếu hạng mục này không có hình ảnh. products_collage Tạo ảnh ghép (kích thước 2x2) từ các hình ảnh về sản phẩm trong hạng mục này. products_slideshow Hiển thị bản trình chiếu sản phẩm từ hạng mục này.

Trong khi tạo nội dung quảng cáo theo hạng mục, chúng tôi sẽ tìm kiếm các hạng mục tiềm năng có thể hiển thị.

Lưu ý: Chúng tôi lọc bỏ các hạng mục không có tên hoặc URL trang đích. Chúng tôi cũng lọc bỏ các hạng mục không có hình ảnh nếu category_media_source = category.

Lỗi thường gặp

Không tạo được nội dung nếu có ít hơn 4 hạng mục đủ điều kiện (ví dụ: nếu bạn muốn dùng hạng mục dành cho quảng cáo danh mục Advantage+ làm nội dung cho chiến dịch nào đó, file nguồn cấp dữ liệu của bạn phải có ít nhất 4 giá trị khác nhau trong một cột cho trước).

Bước 3: Cung cấp nội dung quảng cáo

Các mẫu quảng cáo danh mục Advantage+ sử dụng bài viết nội tuyến trên trang để tạo nội dung cho mẫu quảng cáo danh mục Advantage+.

Tạo nội dung cho mẫu

Cách tạo nội dung cho mẫu quảng cáo danh mục Advantage+ tương tự với cách tạo các nội dung quảng cáo khác. Điểm khác biệt là bạn có thể thêm các thông số của mẫu để hiển thị chính xác vào thời gian chạy, dựa trên dữ liệu trong file nguồn cấp dữ liệu của bạn.

Tạo mẫu dựa trên đối tượng template_data của object_story_spec và sử dụng các trường sau:

Ví dụ

Tạo mẫu quảng cáo danh mục Advantage+ quay vòng

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Sử dụng mẫu quảng cáo danh mục Advantage+ có lớp phủ hình ảnh

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}",
      "image_layer_specs": [
        {
          "layer_type": "image",
          "image_source": "catalog"
        },
        {
          "layer_type": "frame_overlay",
          "blending_mode": "lighten",
          "frame_image_hash": "<HASH>",
          "frame_source": "custom",
          "opacity": 100,
          "overlay_position": "center",
          "scale": 100
        },
        {
          "layer_type": "text_overlay",
          "content": {
            "type": "price"
          },
          "opacity": 100,
          "overlay_position": "top_left",
          "overlay_shape": "rectangle",
          "shape_color": "DF0005",
          "text_color": "FFFFFF",
          "text_font": "open_sans_bold"
        }
      ]
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

Tạo mẫu quảng cáo danh mục Advantage+ cho một sản phẩm có nút kêu gọi hành động

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "force_single_link": true, 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Tạo mẫu quảng cáo danh mục Advantage+ quay vòng, trong đó hình ảnh quảng cáo sử dụng hình ảnh đầu tiên từ mảng hình ảnh bổ sung

Để xem trước quảng cáo danh mục Advantage+ có additional_image_index, bạn phải chuyển toàn bộ object_story_spec cho điểm cuối /generatepreviews. Nếu chỉ chuyển object_story_id, bạn sẽ không tạo được bản xem trước.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "additional_image_index": 0, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Tạo mẫu quảng cáo danh mục Advantage+ quay vòng cho một sản phẩm, trong đó mỗi hình ảnh đều lấy từ mảng hình ảnh bổ sung trong danh mục

curl -X POST \
     -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
     -F 'object_story_spec={
           "page_id": <PAGE_ID>,
           "template_data": {
             "message": "Test {{product.name | titleize}}",
             "link": "<YOUR_LINK_URL>",
             "name": "Headline {{product.price}}",
             "description": "Description {{product.description}}",
             "multi_share_end_card": false,
             "force_single_link": true,
             "show_multiple_images": true,
           }
         }' \
     -F 'product_set_id=<PRODUCT_SET_ID>' \
     -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Tạo mẫu quảng cáo danh mục Advantage+ quay vòng có thẻ đầu tiên là thẻ tĩnh về phiếu giảm giá

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "child_attachments": [ 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "30% off", 
          "image_hash": "<IMAGE_HASH>", 
          "link": "https:\/\/www.link.com\/coupon", 
          "name": "Coupon Static Card", 
          "static_card": true 
        }, 
        { 
          "call_to_action": {"type":"SHOP_NOW"}, 
          "description": "Description {{product.description}}", 
          "name": "Headline {{product.price}}" 
        } 
      ], 
      "link": "<LINK>", 
      "message": "Test Message" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Tạo bản trình chiếu quảng cáo quay vòng từ mẫu quảng cáo danh mục Advantage+

Chúng tôi sẽ hiển thị từng thẻ động trong quảng cáo quay vòng dưới dạng bản trình chiếu. Mỗi bản trình chiếu sẽ hiển thị hình ảnh từ một mặt hàng động nếu mặt hàng đó có nhiều hình ảnh. Nếu mặt hàng động chỉ có một hình ảnh, chúng tôi sẽ hiển thị thẻ dưới dạng hình ảnh tĩnh.

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={
    "page_id": "PAGE_ID",
    "template_data": {
      "call_to_action": {"type":"SHOP_NOW"},
      "description": "Description {{product.description}}",
      "link": "LINK",
      "message": "Test {{product.name | titleize}}",
      "name": "Headline {{product.price}}",
      "format_option": "carousel_slideshows"
    }
  }' \
  -F 'product_set_id=PRODUCT_SET_ID' \
  -F 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/AD_ACCOUNT_ID/adcreatives

Phản hồi cho những lệnh gọi này là ID của nội dung mới trong mẫu quảng cáo danh mục Advantage+.

{"id":"creative_id"}

Tải danh mục lên

Khi tải danh mục lên, bạn có thể chỉ định các thẻ chuỗi gồm chữ và số ngẫu nhiên cho từng hình ảnh trong mỗi thuộc tính.

<listing>
 <hotel_id>hotel_1</hotel_id>
 ...
 <image>
 <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg (https://l.facebook.com/l.php?u=https%3A%2F%2Fmedia-cdn.tripadvisor.com%2Fmedia%2Fphoto-o%2F05%2Fca%2F40%2Faf%2Fthe-epiphany-a-joie-de.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>exterior</tag>
 <tag>first image</tag>
 <tag>tree</tag>
 </image>
 <image>
 <url>http://www3.hilton.com/resources/media/hi/DFWANHH/en_US/img/shared/full_page_image_gallery/main/HH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg (http://l.facebook.com/l.php?u=http%3A%2F%2Fwww3.hilton.com%2Fresources%2Fmedia%2Fhi%2FDFWANHH%2Fen_US%2Fimg%2Fshared%2Ffull_page_image_gallery%2Fmain%2FHH_exteriorview001_1270x560_FitToBoxSmallDimension_Center.jpg&h=ATPTuLcCa7Vsnmn07cEVa0YseTFl1C2hOax9NezejmXDbR48w3CLdjLlwlpuGCRDQmuafQvk03ybGqfhk-2mBcH7xtuKAsnuuq9xKwBd8DwfuBMZkq3n1qX5MdychRKGy2bo2ax9BZQzgqVDY_AvC1EqE6aAdUEc)</url>
 <tag>skyline</tag>
 ...
 </image>
 ...
</listing>

Tạo nội dung quảng cáo

Khi tạo nội dung quảng cáo, bạn có thể chuyển một mảng preferred_image_tags qua object_story_spec.

curl \
 -F 'name=Ad Creative Test'\
 -F 'object_story_spec={
     "page_id": '<PAGE_ID>',
     "template_data": {
       "preferred_image_tags": ["skyline","exterior"],
       "call_to_action": {"type":"BOOK_TRAVEL"},
       "description": "{{hotel.description}}",
       "link": "<URL>",
        "message": "Book your stay in {{hotel.city}}",
        "name": "{{hotel.name | titleize}}"
     }
    }' \
 -F 'product_set_id=<PRODUCT_SET_ID>' \
 -F 'access_token=<ACCESS_TOKEN>' \
 https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Bật video cho quảng cáo danh mục Advantage+

Các bước chính để tạo quảng cáo danh mục Advantage+ vẫn không có gì thay đổi. Để bật video, bạn cần thêm dữ liệu video và cung cấp dữ liệu đó trong danh mục. Hãy xem bên dưới để biết các thay đổi cần thực hiện khi bạn tạo hoặc cập nhật danh mục.

Bước 1: Thiết lập danh mục

Khi bạn thêm video vào danh sách, các trường url và tag sẽ được hỗ trợ. Hiện tại, mỗi sản phẩm chỉ được hỗ trợ một video.

<?xml version="1.0" encoding="utf-8"?>
<listings>
  <title>Test hotel feed</title>
  <listing>
    <hotel_id>hotel_1</hotel_id>
    <name>Test Hotel 1</name>
    <description>A very nice hotel</description>
    <brand>Facebook</brand>
    <address format="simple">
      <component name="addr1">180 Hamilton Ave</component>
      <component name="city">Palo Alto</component>
      <component name="city_id">12345</component>
      <component name="region">California</component>
      <component name="postal_code">94301</component>
      <component name="country">United States</component>
    </address>
    <latitude>37.4435997</latitude>
    <longitude>-122.1615219</longitude>
    <neighborhood>Palo Alto</neighborhood>
    <neighborhood>Silicon Valley</neighborhood>
    <margin_level>8</margin_level>
    <base_price>200.5 USD</base_price>
    <phone>+1 650 666-3311</phone>
    <star_rating>2.5</star_rating>
    <guest_rating>
      <score>7.8</score>
      <rating_system>tripAdvisor</rating_system>
      <number_of_reviewers>300</number_of_reviewers>
    </guest_rating>
    <guest_rating>
      <score>9.8</score>
      <rating_system>Hotels.com</rating_system>
      <number_of_reviewers>35000</number_of_reviewers>
    </guest_rating>
    <image>
      <url>https://media-cdn.tripadvisor.com/media/photo-o/05/ca/40/af/the-epiphany-a-joie-de.jpg</url>
      <tag>front view</tag>
      <tag>first image</tag>
    </image>
    <image>
      <url>http://www.jdvhotels.com/content/uploads/2014/06/72-1200x800.jpg</url>
      <tag>room</tag>
      <tag>bed</tag>
    </image>
    <loyalty_program>Starwood</loyalty_program>
    <url>http://www.jdvhotels.com/hotels/california/silicon-valley-hotels/the-epiphany-hotel/</url>
    <applink property="ios_url" content="example-ios://electronic"/>
    <applink property="ios_app_store_id" content="42"/>
    <applink property="ios_app_name" content="Electronic Example iOS"/>
*    <video>
      <url>http://example.com/some_video1.mp4</url>
      <tag>City</tag>
      <tag>Package</tag>
    </video>*
  </listing>
</listings>

Quy cách video

Bước 2: Sử dụng API để lấy siêu dữ liệu về video cho mục đích khắc phục sự cố

Bạn có thể sử dụng API để kiểm tra dữ liệu đã tải lên. Đối với mỗi mục, hãy cho phép truy vấn "siêu dữ liệu về video".

Yêu cầu

curl -i -X GET \
 "https://graph.intern.facebook.com/v19.0/1234567890?fields=videos_metadata.fields(video,tags,url)&access_token=<ACCESS TOKEN>"

Phản hồi mẫu

Bước 3: Bật video trong nội dung hoặc quảng cáo

Để bật nội dung video cấp độ sản phẩm trong quảng cáo, hãy xem tài liệu Tạo quảng cáo bằng file phương tiện động .

Theo dõi lượt click và mẫu

Nếu theo dõi lượt click vào liên kết thông qua công cụ theo dõi lượt click của bên thứ ba trước khi chuyển hướng đến URL của sản phẩm cuối cùng, bạn có thể sử dụng trường template_url_spec trong nội dung quảng cáo. Nhờ đó, bạn có thể thêm mẫu công cụ theo dõi lượt click ở cấp độ quảng cáo mà không cần mã hóa cứng mẫu trong file nguồn cấp dữ liệu của mình. Bạn cũng có thể sử dụng trường này để tạo mẫu cho liên kết sâu.

Trong trường này, bạn có thể sử dụng các trường động như URL hoặc ID sản phẩm. Các trường đó phải được mã hóa url nếu giá trị của chúng có thể chứa các ký tự khiến URL không hợp lệ.

Ví dụ

Cách tạo mẫu quảng cáo danh mục Advantage+ quay vòng bằng cài đặt template_url_spec:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "description": "Description {{product.description}}", 
      "link": "<URL>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'template_url_spec={ 
    "ios": { 
      "app_store_id": "123", 
      "url": "example:\/\/link\/?nav=item.view&id={{product.retailer_id | urlencode}}&referrer=http:\/\/rover.example.com\/rover\/1\/711-198453-24755-9\/16%3Fitemid={{product.retailer_id | urlencode | urlencode}}" 
    }, 
    "web": { 
      "url": "http:\/\/clicktrack.com\/cm325?id={{product.retailer_id | urlencode}}&redirect_url={{product.url | urlencode | urlencode}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Sử dụng dữ liệu thuộc file nguồn cấp dữ liệu trong mẫu của bạn

Khi một quảng cáo hiển thị, Facebook sẽ thay thế nội dung trong phần {{ }} bằng các giá trị phù hợp từ file nguồn cấp dữ liệu của bạn. Các giá trị có sẵn cho mẫu là:

Tùy chọn

Một số giá trị của mẫu có thể nhận được các tùy chọn - theo thứ tự bất kỳ - ở định dạng sau:

{{field option1 option2 ...}}

Dưới đây là các tùy chọn có sẵn:

Thuộc tính biến đổi

Bạn có thể sử dụng các giá trị mẫu có thuộc tính biến đổi để điều chỉnh giá trị của mình dựa trên định dạng này:

{{field | transform}}

Hãy sử dụng một trong những thuộc tính biến đổi sau:

Chỉ định hành vi nhấp vào quảng cáo mong muốn từ thiết bị di động

Khi hiển thị nội dung động, bạn có thể chỉ định hành vi mong muốn khi một người nhấp vào quảng cáo trong ứng dụng Facebook gốc. Bạn cần đáp ứng 2 yêu cầu sau để có thể sử dụng liên kết sâu:

1. Ứng dụng di động gốc - nơi người dùng sẽ được chuyển đến - hỗ trợ liên kết sâu (iOS hoặc Android).
2. Thông tin liên kết sâu đã được đưa vào file nguồn cấp dữ liệu hoặc thông tin liên kết sâu có sẵn thông qua Liên kết ứng dụng.

Nếu cả 2 yêu cầu này đều được đáp ứng, bạn có thể sử dụng trường applink_treatment trong khi tạo nội dung quảng cáo để chỉ định hành vi mong muốn khi một người dùng nhấp vào quảng cáo.

Ví dụ

Khi bạn tạo một mẫu quảng cáo danh mục Advantage+ quay vòng có nút kêu gọi hành động, nút này sẽ liên kết sâu đến một ứng dụng gốc nếu có, còn không sẽ liên kết đến trang web:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_web_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives  

Khi bạn tạo một mẫu quảng cáo danh mục Advantage+ quay vòng có hỗ trợ thẻ URL, thẻ này sẽ liên kết sâu đến một ứng dụng gốc nếu có, còn không sẽ liên kết đến cửa hàng ứng dụng của ứng dụng đó:

curl \
  -F 'name=Advantage+ Catalog Ads Template Creative Sample' \
  -F 'applink_treatment=deeplink_with_appstore_fallback' \
  -F 'object_story_spec={ 
    "page_id": "<PAGE_ID>", 
    "template_data": { 
      "call_to_action": {"type":"SHOP_NOW"}, 
      "description": "Description {{product.description}}", 
      "link": "<LINK>", 
      "message": "Test {{product.name | titleize}}", 
      "name": "Headline {{product.price}}" 
    } 
  }' \
  -F 'product_set_id=<PRODUCT_SET_ID>' \
  -F 'access_token<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Tạo danh mục được bản địa hóa cho quảng cáo danh mục Advantage+

Hãy xem chi tiết trong phần Danh mục được bản địa hóa cho quảng cáo danh mục Advantage+.

Bước 4: Tạo quảng cáo

Cuối cùng, bạn có thể tạo quảng cáo. Quảng cáo này sẽ tham chiếu đến một nội dung quảng cáo.

Ví dụ

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="<AD_SET_ID>"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

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

const access_token = '<ACCESS_TOKEN>';
const app_secret = '<APP_SECRET>';
const app_id = '<APP_ID>';
const id = '<AD_ACCOUNT_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' : 'My Ad',
  'adset_id' : '<adSetID>',
  'creative' : {'creative_id':'<adCreativeID>'},
  'status' : 'PAUSED',
};
const ads = (new AdAccount(id)).createAd(
  fields,
  params
);
logApiCallResult('ads api call complete.', ads);

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

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Ad;
use FacebookAds\Api;
use FacebookAds\Logger\CurlLogger;

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

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

$fields = array(
);
$params = array(
  'name' => 'My Ad',
  'adset_id' => '<adSetID>',
  'creative' => array('creative_id' => '<adCreativeID>'),
  'status' => 'PAUSED',
);
echo json_encode((new AdAccount($id))->createAd(
  $fields,
  $params
)->exportAllData(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adaccount import AdAccount
from facebook_business.adobjects.ad import Ad
from facebook_business.api import FacebookAdsApi

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

fields = [
]
params = {
  'name': 'My Ad',
  'adset_id': '<adSetID>',
  'creative': {'creative_id':'<adCreativeID>'},
  'status': 'PAUSED',
}
print AdAccount(id).create_ad(
  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_ACCOUNT_ID>\";
    APIContext context = new APIContext(access_token).enableDebug(true);

    new AdAccount(id, context).createAd()
      .setName(\"My Ad\")
      .setAdsetId(<adSetID>L)
      .setCreative(
          new AdCreative()
            .setFieldId(\"<adCreativeID>\")
        )
      .setStatus(Ad.EnumStatus.VALUE_PAUSED)
      .execute();

  }
}

require 'facebook_ads'

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

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

ad_account = FacebookAds::AdAccount.get(id)
ads = ad_account.ads.create({
    name: 'My Ad',
    adset_id: '<adSetID>',
    creative: {'creative_id':'<adCreativeID>'},
    status: 'PAUSED',
})

Xin chúc mừng! Bạn đã tạo xong quảng cáo danh mục Advantage+ đầu tiên của mình. Vui lòng bỏ trạng thái tạm dừng để bắt đầu phân phối quảng cáo.

Bước tiếp theo

Xem trước quảng cáo danh mục Advantage+

Bạn có thể tạo bản xem trước cho nội dung động bằng điểm cuối Xem trước quảng cáo. Hãy chỉ định thông số product_item_ids hoặc chỉ định nhiều product_item_ids để xem trước quảng cáo quay vòng.

curl -X GET \
  -d 'ad_format="DESKTOP_FEED_STANDARD"' \
  -d 'product_item_ids=[
       "<PRODUCT_ITEM_ID>"
     ]' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CREATIVE_ID>/previews

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

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 = [
];
params = {
  'ad_format' : 'DESKTOP_FEED_STANDARD',
  'product_item_ids' : ['<productItemID>'],
};
const previewss = (new AdCreative(id)).getPreviews(
  fields,
  params
);
logApiCallResult('previewss api call complete.', previewss);

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

use FacebookAds\Object\AdCreative;
use FacebookAds\Object\AdPreview;
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(
);
$params = array(
  'ad_format' => 'DESKTOP_FEED_STANDARD',
  'product_item_ids' => array('<productItemID>'),
);
echo json_encode((new AdCreative($id))->getPreviews(
  $fields,
  $params
)->getResponse()->getContent(), JSON_PRETTY_PRINT);

from facebook_business.adobjects.adcreative import AdCreative
from facebook_business.adobjects.adpreview import AdPreview
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 = [
]
params = {
  'ad_format': 'DESKTOP_FEED_STANDARD',
  'product_item_ids': ['<productItemID>'],
}
print AdCreative(id).get_previews(
  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).getPreviews()
      .setAdFormat(AdPreview.EnumAdFormat.VALUE_DESKTOP_FEED_STANDARD)
      .setProductItemIds(\"[\\"<productItemID>\\"]\")
      .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)
previewss = ad_creative.previews({
    fields: {  },
    ad_format: 'DESKTOP_FEED_STANDARD',
    product_item_ids: ['<productItemID>'],
})

Thông số

Tìm nạp số liệu thống kê quảng cáo sản phẩm

Bạn có thể tìm nạp số liệu thống kê cho mỗi sản phẩm bằng cách thực hiện lệnh gọi GET đến điểm cuối thông tin chi tiết. Hãy thêm product_id vào thông số fields.

Thao tác này sẽ cho thấy số liệu thống kê về mọi sản phẩm trong các nhóm sản phẩm của một tài khoản được hiển thị trong quảng cáo danh mục Advantage+.

Ví dụ

Ví dụ trên đây sẽ báo cáo clicks, actions và impressions cho từng product_id.

Yêu cầu

use FacebookAds\Object\AdAccount;
use FacebookAds\Object\Fields\AdsInsightsFields;
use FacebookAds\Object\Values\AdsInsightsActionBreakdownsValues;
use FacebookAds\Object\Values\AdsInsightsDatePresetValues;
use FacebookAds\Object\Values\AdsInsightsBreakdownsValues;

$account = new AdAccount('act_<AD_ACCOUNT_ID>');

$fields = array(
  AdsInsightsFields::ACCOUNT_NAME,
  AdsInsightsFields::IMPRESSIONS,
  AdsInsightsFields::ACTIONS,
);

$params = array(
  'date_preset' => AdsInsightsDatePresetValues::LAST_WEEK,
  'action_breakdowns' => array(
    AdsInsightsActionBreakdownsValues::ACTION_TYPE,
  ),
  'breakdowns' => array(
    AdsInsightsBreakdownsValues::PRODUCT_ID,
  ),
);

$stats = $account->getInsights($fields, $params);

from facebookads.adobjects.adaccount import AdAccount
from facebookads.adobjects.adsinsights import AdsInsights

account = AdAccount('act_<AD_ACCOUNT_ID>')

fields = [
    AdsInsights.Field.account_name,
    AdsInsights.Field.impressions,
    AdsInsights.Field.actions,
]

params = {
    'date_preset': 'last_week',
    'actions_group_by': ['action_type'],
    'breakdowns': [
        AdsInsights.Breakdowns.product_id,
    ],
}

stats = account.get_insights(fields=fields, params=params)

APINodeList<AdsInsights> adsInsightss = new AdAccount(act_<AD_ACCOUNT_ID>, context).getInsights()
  .setDatePreset(AdsInsights.EnumDatePreset.VALUE_LAST_WEEK)
  .setActionBreakdowns("[\"action_type\"]")
  .setBreakdowns("[\"product_id\"]")
  .requestField("account_name")
  .requestField("impressions")
  .requestField("actions")
  .execute();

curl -G \
  -d 'date_preset=last_week' \
  -d 'action_breakdowns=["action_type"]' \
  -d 'breakdowns=["product_id"]' \
  -d 'fields=account_name,impressions,actions' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.8/act_<AD_ACCOUNT_ID>/insights

Phản hồi

{
 "data": [ 
   {
      "account_id": "123456", 
      "product_id": "60750", 
      "date_start": "2015-02-03", 
      "date_stop": "2015-02-03", 
      "impressions": 880, 
      "clicks": 8, 
      "actions": [ 
        {
          "action_type": "link_click", 
          "value": 6
        }, 
        {
          "action_type": "offsite_conversion.other", 
          "value": 5
        },  
        {
          "action_type": "offsite_conversion", 
          "value": 5
        }
      ], 
      "account_name": "My Account"
    }, 
 ], 
...
}

Tìm nạp bình luận và lượt thích

Bạn có thể truy xuất các bình luận, lượt thích và product_id cho bài viết quảng cáo danh mục Advantage+. Hãy thực hiện lệnh gọi GET như dưới đây bằng một post_id. post_id là effective_object_story_id của nội dung quảng cáo, ở định dạng PageID_PostID.

Lưu ý: Bạn không thể sử dụng điểm cuối này để truy xuất bình luận trên Instagram.

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<POST_ID>/dynamic_posts

Điểm cuối này sẽ trả về các đối tượng bài viết động.

Sau khi lấy các bài viết động, bạn có thể tìm nạp comments, likes, product_id và child_attachments cho định dạng quay vòng, nếu có.

Tìm hiểu thêm

• Thiết lập danh mục
• Tạo đối tượng
• Tài liệu tham khảo về nhóm quảng cáo
• Tài liệu tham khảo về nội dung quảng cáo
• Khóa học trên Meta Blueprint: Chuẩn bị và thiết lập danh mục cho quảng cáo danh mục Advantage+
• Khóa học trên Meta Blueprint: Khắc phục sự cố về danh mục cho quảng cáo danh mục Advantage+
• Chương trình đào tạo trực tiếp trên Meta Blueprint: Khắc phục sự cố về danh mục cho quảng cáo danh mục Advantage+