目的地広告 - カタログとフィード

Facebookで旅行の目的地を宣伝するには、目的地の情報をFacebookに提供する必要があります。そのために、目的地カタログを作成し、カタログに目的地を入力します。

宣伝したい目的地を含む「目的地フィード」のCSVファイルまたはXMLファイルをアップロードする

目的地カタログは、コマースマネージャで作成および管理できます。

APIを使用してカタログを管理するには、次の手順に従います。

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

目的地フィード - Facebookに目的地をアップロードする

目的地フィードとは、宣伝したい目的地を含むファイルのことです。ファイル内の行(アイテム)がそれぞれ1つの目的地を表します。1つ以上の目的地フィードを使用できるのは、すべてのフィードを合わせると宣伝したい目的地がすべて含まれる場合に限られます。

サポートされている目的地フィードの形式

CSV - サンプルと説明

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

• 最初の行には、選択したフィールドの名前を、値を指定する順序でリストする必要があります。後続の行では、各目的地の対応する値を指定します。
• 空白文字またはコンマを含むフィールドは、"二重引用符"で囲む必要があります。
• ネストされたフィールドまたは複数値フィールド(address、neighborhood、imageなど)は、JSONエンコードされた値で表すか、JSONパス構文でラベリングされた「フラットな」プレーンテキスト列のセットで表すことができます(address.city、neighborhood[0]、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+ カタログ広告、広告テンプレートをご覧ください。

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

住所オブジェクトのパラメーター

以下のセクションは、この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を使用して、アップロードするすべてのフィードについてフィードオブジェクトを作成します。Facebookでは、日付を指定したアップロードと直接アップロードをサポートしています。

目的地カタログで目的地セットをフィルターする

目的地セットは目的地カタログのサブセットです。目的地広告を設定するには、目的地セットが必要です。したがって、目的地セットを少なくとも1つ作成する必要があります。

目的地セットは、目的地カタログに適用されるフィルターで定義します。例えば、大幅な値下げが行われたすべての目的地からなる目的地セットを作成できます。フィルターなしで目的地セットを作成することもできます。その場合、目的地セットにはカタログ内のすべての目的地が含まれます。

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