フライト広告 - カタログとフィード

Facebookでフライトインベントリーを宣伝するには、フライトの情報をFacebookに提供する必要があります。提供するには、フライトカタログを作成し、フライトルートを入力します。カタログに入力し、カタログを最新の状態に保つ方法は3つあります。

1. フライトインベントリーのあるフライトフィードのCSVまたはXMLファイルをアップロードする
2. カタログを自動的に入力するイベントアクティビティを使用する
3. フライトフィードを、自動生成されるフライトと組み合わせる

フライトカタログはコマースマネージャで作成および管理できます。

1. フライトカタログを作成する
2. Facebookにフィードをアップロードする
3. フライトカタログから商品セットを作成する
4. カタログとイベントソースを関連付ける

フライトフィード - フライトをFacebookにアップロードする

フライトフィードとは、フライトインベントリーを持つファイルです。ファイル内のラインまたはアイテムはそれぞれ、1つのルートを表しています。すべてのフィードを合わせるとすべてのフライトインベントリーが格納される場合に限り、1つ以上のフライトフィードを使用できます。

サポートされているフライトフィード形式

CSV >サンプル-説明

CSVサンプル | TSVサンプル(フラット)

• 先頭行には、選択したフィールド名を列挙する必要があります。ここに列挙した順序で値を指定することになります。その後の行では、各フライトに対応する値が提供されます。
• 空白やコンマを含むフィールドは"二重引用符 "で囲む必要があります。
• image imageなどのネストされたフィールドや複数値フィールドは、JSONエンコードされた値または、JSONパス構文を使用してラベリングされた「フラット」なプレーンテキスト列を使用して表されます(例image[0].url, image[0].tag[0], image[0].tag[1].どちらも、同じファイルで同時に使用できます。

XML >サンプル-説明

XMLサンプル

• ルート<listings> XMLノードが一連の<listing>ノードを囲み、各ノードが1つのフライトを表します。
• ファイルの最初には、有効な<?xml宣言タグを記述する必要があります。

サポートされているフィールド - フライト広告

次のサポートされているフィールドは、商品カタログに追加するアイテム用です。

ローカライズされたカタログについては、「フライト広告用のサポートされているフィールド」をご覧ください。

画像オブジェクトのパラメーター

商品ディープリンク

App Linksの仕様に従って、フィードでディープリンクを指定します。フィードのディープリンク情報は、FacebookがウェブクローラーでApp Linksメタデータを使用して収集する情報よりも優先されます。

App Linksからのディープリンク情報がすでにある場合、このデータを指定する必要はありません。Facebookは、App Linksからの情報を使用して正しいディープリンクを表示します。広告にディープリンクを表示する方法については、Advantage+ カタログ広告、広告テンプレートをご覧ください。

フライトの自動生成 - イベントアクティビティを使用して、ルートをカタログに自動追加する

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を使用するには、ビジネスマネージャで最初のカタログを作成することにより、適切なマーケティング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

API経由でフライトフィードをアップロードする

カタログを作成したら、次はフライトフィードをFacebookにアップロードする必要があります。APIを使用して、アップロードするすべてのフィードのフィードオブジェクトを作成します。スケジュール設定されたアップロードも、直接アップロードもサポートされています。

フライトカタログを絞り込んでフライトセットを作成する

フライトセットはカタログのサブセットです。フライト広告を設定するには、少なくとも1つのフライトセットを作成する必要があります。

フライトセットは、フライトカタログにフィルターを適用することで定義します。例えば、ロンドン発のすべてのルートを持つフライトセットを作成できます。フィルターを使用せずにフライトセットを作成することもできます。この場合、フライトセットにはカタログ内のすべてのフライトが含まれます。

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パラメーターは、次の演算子とデータで構成されています。