목적지 광고 - 카탈로그 및 피드

Facebook에서 목적지를 홍보하려면 목적지에 대한 정보를 Facebook과 공유해야 합니다. 목적지 카탈로그를 만든 다음 목적지를 입력하면 됩니다.

홍보할 목적지가 포함된 '목적지 피드'에 대한 CSV 또는 XML 파일 업로드

커머스 관리자에서 목적지 카탈로그를 만들고 관리할 수 있습니다.

API로 카탈로그를 관리하는 방법은 다음과 같습니다.

1. 목적지 카탈로그를 만듭니다.
2. Facebook에 피드를 업로드합니다.
3. 목적지 카탈로그에서 제품 세트를 만듭니다.
4. 카탈로그를 이벤트 소스에 연결합니다.

목적지 피드 - Facebook에 목적지 업로드

목적지 피드는 홍보할 목적지가 포함된 파일입니다. 파일의 모든 행 또는 항목이 단일 목적지를 나타냅니다. 홍보할 목적지가 피드에 모두 포함되는 한 목적지 피드를 하나 이상 사용할 수 있습니다.

지원되는 목적지 피드 형식

CSV - 샘플 및 설명

CSV 샘플 | TSV 샘플(일반) | TSV 샘플(JSON 스타일)

• 첫 번째 행에는 값이 제공될 순서에 따라 선택된 필드 이름이 나열되어야 합니다. 이후 행에서는 목적지별로 해당하는 값을 제공합니다.
• 공백이나 쉼표가 포함된 필드는 "큰따옴표"로 묶어야 합니다.
• 중첩 또는 다중값 필드(예: address, neighborhood 또는 image)는 JSON 인코딩된 값을 사용하거나 address.city, neighborhood[0], image[0].url, image[0].tag[0], image[0].tag[1] 등 JSON 경로 구문을 사용하여 레이블이 지정된 '일반' 텍스트 열의 세트로 나타낼 수 있습니다. 같은 파일 내에서 두 규칙은 상호 교환 가능합니다.

XML - 샘플 및 설명

XML 샘플

• 루트 <listings> XML 노드 한 개에 일련의 <listing> 노드가 포함되며, 이들 노드는 각각 목적지를 나타냅니다.
• 파일은 올바른 <?xml 선언 태그로 시작해야 합니다.

지원되는 필드 - 목적지

다음의 지원되는 필드는 제품 카탈로그에 추가하는 항목에 맞게 디자인됩니다.

현지화된 카탈로그는 목적지에 지원되는 필드를 참조하세요.

제품 딥 링크

앱 링크 사양에 따라 피드에 딥 링크를 제공합니다. 피드의 딥 링크 정보는 Facebook 웹 크롤러로 앱 링크 메타데이터와 함께 수집하는 모든 정보보다 우선합니다.

앱 링크의 딥 링크 정보가 있다면 이 데이터를 지정할 필요가 없습니다. Facebook은 앱 링크의 정보를 사용하여 올바른 딥 링크를 표시합니다. 광고에 딥 링크를 표시하려면 어드밴티지+ 카탈로그 광고, 광고 템플릿을 참조하세요.

이미지 개체 매개변수

주소 개체 매개변수

다음 섹션은 이 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를 사용하여 업로드할 모든 피드에 대해 피드 개체를 만듭니다. 예약된 업로드와 직접 업로드가 가능합니다.

목적지 카탈로그를 목적지 세트로 필터링

목적지 세트는 카탈로그의 일부분입니다. 목적지 광고를 설정하려면 목적지 세트가 필요합니다. 따라서 항공편 세트를 하나 이상 만들어야 합니다.

목적지 세트는 목적지 카탈로그에 적용되는 필터로 정의됩니다. 예를 들어 가격이 크게 인하된 모든 목적지로 목적지 세트를 만들 수 있습니다. 필터 없이 목적지 세트를 만들 수도 있습니다. 이 경우 목적지 세트에 카탈로그의 모든 목적지가 포함됩니다.

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 매개변수는 다음 연산자와 데이터로 구성됩니다.