Facebook에서 항공편 인벤토리를 홍보하려면 Facebook에 항공편과 관련된 정보를 공유해야 합니다. 항공편 카탈로그를 만든 다음 항공편 노선을 채우면 됩니다. 카탈로그를 입력하고 최신 상태로 유지하는 방법은 세 가지가 있습니다.
커머스 관리자에서 항공편 카탈로그를 만들고 관리할 수 있습니다.
항공편 피드는 항공편 인벤토리가 있는 파일입니다. 파일의 모든 행 또는 항목은 단일 노선을 나타냅니다. 전체 항공편 인벤토리가 피드에 포함되는 한 항공편 피드를 하나 이상 사용할 수 있습니다.
"
큰따옴표"
로 묶어야 합니다. image
)는 JSON 인코딩 값을 사용하거나 image[0].url
, image[0].tag[0]
, image[0].tag[1]
등 JSON 경로 구문을 사용하여 레이블이 지정된 '일반' 텍스트 열의 세트로 나타낼 수 있습니다. 같은 파일 내에서 두 규칙은 상호 교환이 가능합니다.<listings>
XML 노드 한 개에 일련의 <listing>
노드가 포함되며, 이들 노드는 각각 항공편을 나타냅니다.<?xml
선언 태그로 시작해야 합니다.피드 파서는 UTF8
, UTF16
또는 UTF32
텍스트 인코딩을 자동으로 감지하고 예상치 못한 바이트 시퀀스를 만나면 LATIN1
로 기본 설정됩니다. 필드 값은 원하는 언어로 입력할 수 있지만 필드 이름은 아래 표시된 것과 같이 영어로 지정해야 합니다.
다음의 지원되는 필드는 제품 카탈로그에 추가하는 항목을 위해 고안되었습니다.
현지화된 카탈로그는 항공편 광고에 지원되는 필드를 참조하세요.
필드 및 유형 | 설명 |
---|---|
유형: 문자열 | 필수 항목. 출발지의 IATA 코드입니다. 공항 및 도시 IATA 코드를 지원합니다. IATA 코드 검색을 사용하여 IATA 코드를 검증하세요. 팁: 성능을 개선하려면 이 고유 ID 필드에 공백을 사용하지 마세요. 예: |
유형: 문자열 | 필수 항목. 목적지의 IATA 코드입니다. 공항 및 도시 IATA 코드를 지원합니다. IATA 코드 검색을 사용하여 IATA 코드를 검증하세요. 팁: 성능을 개선하려면 이 고유 ID 필드에 공백을 사용하지 마세요. 예: |
유형: 개체 | 필수 항목. 최대 항목 수: 20 이 항공편에 대한 이미지 데이터입니다. 항공편에 대해 최대 20개의 이미지를 제공할 수 있습니다. 각 이미지에는 필드 두 개( 이미지 개체 매개변수를 참조하세요. |
유형: 문자열 | 필수 항목. 최대 크기: 5,000 노선을 설명하는 짧은 단락입니다. |
유형: 문자열 | 광고 수준에서 딥 링크를 지정하지 않는 경우에만 필요합니다. 광고 관리자의 항공편을 볼 수 있는 외부 사이트 링크입니다. 광고 수준에서 딥 링크가 지정되면 딥 링크가 우선 적용됩니다. |
유형: 문자열 | 출발지 도시의 이름입니다. 예: |
유형: 문자열 | 목적지 도시의 이름입니다. 예: |
유형: 문자열 | 항공편의 가격입니다. 통화와 금액을 함께 지정해야 합니다. 예: |
유형: 요소 | 모바일 앱에서 앱 링크를 사용하여 항공편 상세 정보 페이지에 바로 연결되는 딥 링크입니다. 다음과 같이 딥 링크를 지정할 수 있습니다(우선순위의 내림차순).
|
유형: 문자열 | 항공편의 편도 가격입니다. 통화와 금액을 함께 지정해야 합니다. 예: |
유형: 정수 | 항공편의 우선순위입니다. 0(가장 낮은 우선순위)~5(가장 높은 우선순위)의 값입니다. 이 값이 없는 항공편은 우선순위=0입니다. 예: |
유형: 문자열 | 카탈로그에서 품목이 활성화되어 있거나 보관되어 있는지 여부를 관리합니다. 활성 상태의 품목만 광고, Shop 또는 기타 채널에서 사용자에게 노출됩니다. 지원되는 값: 예: 참고: 일부 파트너 플랫폼(예: Shopify)은 준비 상태의 카탈로그에 품목을 동기화할 수 있습니다. 이는 이 필드의 이름은 이전에 |
필드 이름 및 유형 | 설명 |
---|---|
유형: 문자열 | 필수 항목. 항공편 이미지의 URL입니다. 다음 이미지 사양을 준수하세요.
|
유형: 문자열 | 이미지의 내용을 나타내는 문자열입니다. 여러 개의 태그가 이미지와 연결될 수 있습니다. 예:
선택 사항. |
iPhone과 iPad에 대해 별도의 앱이 있는 경우 iPhone 및 iPad 특정 정보를 지정하세요. 그렇지 않으면 iOS 정보만 지정하세요.
파일 이름 및 유형 | 설명 |
---|---|
유형: string | iOS 앱용 맞춤 스키마입니다. 예: |
유형: string | App Store의 앱 ID입니다. 예: 1234 |
유형: string | 표시하기에 적합한 앱의 이름입니다. 예: |
유형: string | iPhone 앱용 맞춤 스키마입니다. 예: |
유형: string | App Store의 앱 ID입니다. 예: |
유형:string | 표시하기에 적합한 앱의 이름입니다. 예: |
유형: string | iPhone 앱용 맞춤 스키마입니다. 예: |
유형: string | App Store의 앱 ID입니다. 예: |
유형: string | 표시하기에 적합한 앱의 이름입니다. 예: |
유형: string | Android 앱용 맞춤 스키마입니다. 예: |
유형: string | 의향 생성을 위한 정규화된 패키지 이름입니다. 예: |
유형: string | 의향 생성을 위한 활동 클래스 이름입니다. 예: |
유형: string | 표시하기에 적합한 앱의 이름입니다. 예: |
앱 링크 사양에 따라 피드에 딥 링크를 제공합니다. 피드의 딥 링크 정보는 Facebook 웹 크롤러로 앱 링크 메타데이터와 함께 수집하는 모든 정보보다 우선합니다.
앱 링크의 딥 링크 정보가 있다면 이 데이터를 지정할 필요가 없습니다. Facebook은 앱 링크의 정보를 사용하여 올바른 딥 링크를 표시합니다. 광고에 딥 링크를 표시하려면 어드밴티지+ 카탈로그 광고, 광고 템플릿을 참조하세요.
Facebook은 픽셀과 앱 이벤트 활동을 기반으로 카탈로그에 자동으로 노선을 추가할 수 있습니다. 이벤트가 카탈로그에 아직 존재하지 않는 노선을 수신할 때마다 노선이 자동으로 추가됩니다. 따라서 항공편 피드를 다루지 않고도 모든 항공편에 항공편 광고를 사용할 수 있습니다.
이 기능을 활성화하려면 POST
요청을 항공편 카탈로그로 보내고 generate_items_from_events
를 true
로 설정하세요.
curl \ -F 'flight_catalog_settings={generate_items_from_events:1}' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
자동 추가된 노선은 (광고에 표시할) 이미지가 없습니다. 그러므로 모든 자동 생성된 노선에 사용할 일반 이미지를 제공해야 합니다.
curl \ -F 'fallback_image_url=http://example.com/some.image_1.jpg' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>
카탈로그를 픽셀 및/또는 앱에 연결하고 항공편 광고 이벤트를 받는 즉시 카탈로그가 채워집니다. 카탈로그를 쿼리하면 이를 확인할 수 있습니다.
curl \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/<VERSION>/<CATALOG_ID>/flights
자동 생성된 노선과 항공편 피드 업로드를 결합할 수 있습니다. 이러한 옵션을 결합하면 모든 항공편에 항공편 광고를 활용하면서도 항공편 피드를 사용하여 가장 중요한 노선에 맞춤 설정 이미지를 제공할 수 있습니다.
이렇게 하려면 항공편 피드 업로드 단계와 카탈로그 자동 채우기 단계를 결합하면 됩니다.
다음 섹션은 이 API를 사용하여 카탈로그를 관리하는 경우에만 해당합니다.
항공편 카탈로그는 항공편 인벤토리의 컨테이너입니다. 카탈로그 API를 사용하려면 비즈니스 관리자를 통해 첫 번째 카탈로그를 만들어 적절한 마케팅 API 액세스 수준을 확보하고 서비스 약관에 동의해야 합니다.
항공편 광고에 대한 항공편 카탈로그를 만들려면 vertical
을 flights
로 설정하세요.
curl -X POST \ -F 'name="Test Flight Catalog"' \ -F 'vertical="flights"' \ -F 'access_token=<ACCESS_TOKEN>' \ https://graph.facebook.com/v10.0/{business-id}/owned_product_catalogs
카탈로그를 만들고 나면 항공편 피드를 Facebook에 업로드해야 합니다. API를 사용하여 업로드할 모든 피드에 대해 피드 개체를 만듭니다. 예약된 업로드와 직접 업로드가 가능합니다.
항공편 세트는 카탈로그의 일부입니다. 항공편 광고를 설정하려면 항공편 세트를 하나 이상 만들어야 합니다.
항공편 세트는 항공편 카탈로그에 적용되는 필터로 정의됩니다. 예를 들어 런던에서 출발하는 모든 노선으로 항공편 세트를 만들 수 있습니다. 필터 없이 항공편 세트를 만들 수도 있습니다. 이 경우 항공편 세트에는 카탈로그의 모든 항공편이 포함됩니다.
use FacebookAds\Object\ProductSet;
use FacebookAds\Object\Fields\ProductSetFields;
$flight_set = new ProductSet(null, <PRODUCT_CATALOG_ID>);
$flight_set->setData(array(
ProductSetFields::NAME => 'Test Flight Set',
ProductSetFields::FILTER => array(
'origin_airport' => array(
'eq' => 'LHR',
),
),
));
$flight_set->create();
from facebookads.adobjects.productset import ProductSet
flight_set = ProductSet(None, <PRODUCT_CATALOG_ID>)
flight_set[ProductSet.Field.name] = 'Test Flights Set'
flight_set[ProductSet.Field.filter] = {
'origin_airport': {
'eq': 'SFO',
},
}
flight_set.remote_create()
curl \
-F 'name=Test Flight Set' \
-F 'filter={"origin_airport":{"eq":"LHR"}}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v2.11/<PRODUCT_CATALOG_ID>/product_sets
filter
매개변수는 다음 연산자와 데이터로 구성됩니다.
연산자 | 필터의 유형 |
---|---|
| 부분 문자열 포함. 대소문자를 구분합니다. |
| 부분 문자열을 포함하지 않음. 대소문자를 구분합니다. |
| 부분 문자열 포함. 대소문자를 구분합니다. |
| 부분 문자열을 포함하지 않음. 대소문자를 구분합니다. |
| 같음. 대소문자를 구분합니다. |
| 같지 않음. 대소문자를 구분합니다. |
| 작음. 숫자 필드에만 해당합니다. |
| 작거나 같음. 숫자 필드에만 해당합니다. |
| 큼 숫자 필드에만 해당합니다. |
| 크거나 같음 숫자 필드에만 해당합니다. |
데이터 | 필터링되는 데이터 |
---|---|
| 출발지의 IATA 코드입니다. |
| 목적지의 IATA 코드입니다. |
| 항공편의 가격입니다. 가격은 센트 단위로 표시됩니다. |
| 경로를 설명하는 짧은 문구입니다. |