항공편 광고 - 카탈로그 및 피드

Facebook에서 항공편 인벤토리를 홍보하려면 Facebook에 항공편과 관련된 정보를 공유해야 합니다. 항공편 카탈로그를 만든 다음 항공편 노선을 채우면 됩니다. 카탈로그를 입력하고 최신 상태로 유지하는 방법은 세 가지가 있습니다.

  1. 항공편 인벤토리로 '항공편 피드'에 CSV 또는 XML 파일 업로드
  2. 이벤트 활동을 사용하여 카탈로그를 자동으로 채우기
  3. 항공편 피드를 자동 생성된 항공편과 결합

커머스 관리자에서 항공편 카탈로그를 만들고 관리할 수 있습니다.

  1. 항공편 카탈로그 만들기
  2. Facebook에 피드 업로드
  3. 항공편 카탈로그에서 제품 세트 만들기
  4. 카탈로그를 이벤트 소스에 연결

항공편 피드 - 항공편을 Facebook에 업로드

항공편 피드는 항공편 인벤토리가 있는 파일입니다. 파일의 모든 행 또는 항목은 단일 노선을 나타냅니다. 전체 항공편 인벤토리가 피드에 포함되는 한 항공편 피드를 하나 이상 사용할 수 있습니다.

지원되는 항공편 피드 형식

CSV > 샘플 - 설명

CSV 샘플 | TSV 샘플(일반)

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

XML > 샘플 - 설명

XML 샘플

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

피드 파서는 UTF8, UTF16 또는 UTF32 텍스트 인코딩을 자동으로 감지하고 예상치 못한 바이트 시퀀스를 만나면 LATIN1로 기본 설정됩니다. 필드 값은 원하는 언어로 입력할 수 있지만 필드 이름은 아래 표시된 것과 같이 영어로 지정해야 합니다.

지원되는 필드 - 항공편 광고

다음의 지원되는 필드는 제품 카탈로그에 추가하는 항목을 위해 고안되었습니다.

현지화된 카탈로그는 항공편 광고에 지원되는 필드를 참조하세요.

필드 및 유형설명

origin_airport

유형: 문자열

필수 항목.

출발지의 IATA 코드입니다. 공항 및 도시 IATA 코드를 지원합니다. IATA 코드 검색을 사용하여 IATA 코드를 검증하세요. : 성능을 개선하려면 이 고유 ID 필드에 공백을 사용하지 마세요.

예: SFO

destination_airport

유형: 문자열

필수 항목.

목적지의 IATA 코드입니다. 공항 및 도시 IATA 코드를 지원합니다. IATA 코드 검색을 사용하여 IATA 코드를 검증하세요. : 성능을 개선하려면 이 고유 ID 필드에 공백을 사용하지 마세요.

예: JFK

image

유형: 개체

필수 항목.

최대 항목 수: 20

이 항공편에 대한 이미지 데이터입니다. 항공편에 대해 최대 20개의 이미지를 제공할 수 있습니다. 각 이미지에는 필드 두 개(urltag)가 포함됩니다. 이미지에 여러 개의 태그를 연결할 수 있습니다. 최소 하나의 image를 제공해야 합니다. 각 이미지의 최대 크기는 4MB입니다.

이미지 개체 매개변수를 참조하세요.

description

유형: 문자열

필수 항목.

최대 크기: 5,000

노선을 설명하는 짧은 단락입니다.

url

유형: 문자열

광고 수준에서 딥 링크를 지정하지 않는 경우에만 필요합니다. 광고 관리자Deep Link 필드 또는 API의 template_url_spec을 사용할 수 있습니다.

항공편을 볼 수 있는 외부 사이트 링크입니다. 광고 수준에서 딥 링크가 지정되면 딥 링크가 우선 적용됩니다.

origin_city

유형: 문자열

출발지 도시의 이름입니다.

예: San Francisco

destination_city

유형: 문자열

목적지 도시의 이름입니다.

예: New York

price

유형: 문자열

항공편의 가격입니다. 통화와 금액을 함께 지정해야 합니다.

예: 99.99 USD

applink

유형: 요소

모바일 앱에서 앱 링크를 사용하여 항공편 상세 정보 페이지에 바로 연결되는 딥 링크입니다. 다음과 같이 딥 링크를 지정할 수 있습니다(우선순위의 내림차순).

  1. 광고 수준에서 template_url_spec 사용
  2. 여기 피드에서 앱 링크 개체 사용
  3. 웹사이트에 앱 링크 메타 태그 추가

one_way_price

유형: 문자열

항공편의 편도 가격입니다. 통화와 금액을 함께 지정해야 합니다.

예: 99.99 USD

priority

유형: 정수

항공편의 우선순위입니다. 0(가장 낮은 우선순위)~5(가장 높은 우선순위)의 값입니다. 이 값이 없는 항공편은 우선순위=0입니다.

예: 5

status

유형: 문자열

카탈로그에서 품목이 활성화되어 있거나 보관되어 있는지 여부를 관리합니다. 활성 상태의 품목만 광고, Shop 또는 기타 채널에서 사용자에게 노출됩니다. 지원되는 값: active, archived. 항목은 기본적으로 활성화되어 있습니다. 품목 보관에 대해 자세히 알아보세요.


예: active


참고: 일부 파트너 플랫폼(예: Shopify)은 준비 상태의 카탈로그에 품목을 동기화할 수 있습니다. 이는 archived와 동일하게 동작합니다.

이 필드의 이름은 이전에 visibility였습니다. 이전의 필드 이름도 지원하지만 새 이름을 사용하는 것이 좋습니다.

이미지 개체 매개변수

필드 이름 및 유형설명

url

유형: 문자열

필수 항목.

항공편 이미지의 URL입니다. 다음 이미지 사양을 준수하세요.

  • 모든 이미지는 JPG, GIF 또는 PNG 형식이어야 합니다.

  • 슬라이드 광고 및 컬렉션 광고의 경우 이미지가 정사각형(1:1) 형식으로 표시됩니다. 최소 이미지 크기는 500x500픽셀입니다. 최상의 이미지 품질을 위해서는 1,024 x 1,024픽셀을 사용하는 것이 좋습니다.

  • 단일 이미지 광고의 경우 이미지가 1.91:1 화면 비율로 표시됩니다. 최소 이미지 크기는 500 x 500픽셀입니다. 최상의 이미지 품질을 위해서는 1200x628픽셀을 사용하는 것이 좋습니다.

tag

유형: 문자열

이미지의 내용을 나타내는 문자열입니다. 여러 개의 태그가 이미지와 연결될 수 있습니다.

예:

  • Fitness Center
  • Swimming Pool

선택 사항. INSTAGRAM_STANDARD_PREFERRED - 광고주가 피드의 이미지를 Instagram에 사용할 기본 이미지로 태깅할 수 있도록 합니다. 이 태그는 대소문자를 구분합니다.

iPhone과 iPad에 대해 별도의 앱이 있는 경우 iPhone 및 iPad 특정 정보를 지정하세요. 그렇지 않으면 iOS 정보만 지정하세요.

파일 이름 및 유형설명

ios_url

유형: string

iOS 앱용 맞춤 스키마입니다.

예: example-ios://electronic

ios_app_store_id

유형: string

App Store의 앱 ID입니다.

예: 1234

ios_app_name

유형: string

표시하기에 적합한 앱의 이름입니다.

예: Electronic Example iOS

iphone_url

유형: string

iPhone 앱용 맞춤 스키마입니다.

예: example-iphone://electronic

iphone_app_store_id

유형: string

App Store의 앱 ID입니다.

예: 5678

iphone_app_name

유형:string

표시하기에 적합한 앱의 이름입니다.

예: Electronic Example iPhone

ipad_url

유형: string

iPhone 앱용 맞춤 스키마입니다.

예: example-ipad://electronic

ipad_app_store_id

유형: string

App Store의 앱 ID입니다.

예: 9010

ipad_app_name

유형: string

표시하기에 적합한 앱의 이름입니다.

예: Electronic Example iPad

android_url

유형: string

Android 앱용 맞춤 스키마입니다.

예: example-android://electronic

android_package

유형: string

의향 생성을 위한 정규화된 패키지 이름입니다.

예: com.electronic

android_class

유형: string

의향 생성을 위한 활동 클래스 이름입니다.

예: com.electronic.Example

android_app_name

유형: string

표시하기에 적합한 앱의 이름입니다.

예: Electronic Example Android

제품 딥 링크

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

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

항공편 자동 생성 - 이벤트 활동을 사용하여 카탈로그에 자동으로 노선 추가

Facebook은 픽셀과 앱 이벤트 활동을 기반으로 카탈로그에 자동으로 노선을 추가할 수 있습니다. 이벤트가 카탈로그에 아직 존재하지 않는 노선을 수신할 때마다 노선이 자동으로 추가됩니다. 따라서 항공편 피드를 다루지 않고도 모든 항공편에 항공편 광고를 사용할 수 있습니다.

이 기능을 활성화하려면 POST 요청을 항공편 카탈로그로 보내고 generate_items_from_eventstrue로 설정하세요.

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를 사용하려면 비즈니스 관리자를 통해 첫 번째 카탈로그를 만들어 적절한 마케팅 API 액세스 수준을 확보하고 서비스 약관에 동의해야 합니다.

항공편 광고에 대한 항공편 카탈로그를 만들려면 verticalflights로 설정하세요.

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

API를 통한 항공편 피드 업로드

카탈로그를 만들고 나면 항공편 피드를 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 매개변수는 다음 연산자와 데이터로 구성됩니다.

연산자필터의 유형

i_contains

부분 문자열 포함. 대소문자를 구분합니다.

i_not_contains

부분 문자열을 포함하지 않음. 대소문자를 구분합니다.

contains

부분 문자열 포함. 대소문자를 구분합니다.

not_contains

부분 문자열을 포함하지 않음. 대소문자를 구분합니다.

eq

같음. 대소문자를 구분합니다.

neq

같지 않음. 대소문자를 구분합니다.

lt

작음. 숫자 필드에만 해당합니다.

lte

작거나 같음. 숫자 필드에만 해당합니다.

gt

큼 숫자 필드에만 해당합니다.

gte

크거나 같음 숫자 필드에만 해당합니다.

데이터필터링되는 데이터

origin_airport

출발지의 IATA 코드입니다.

destination_airport

목적지의 IATA 코드입니다.

price

항공편의 가격입니다. 가격은 센트 단위로 표시됩니다.

description

경로를 설명하는 짧은 문구입니다.