# TD Profiles APIとFacebookカスタムオーディエンスの統合

適切なオーディエンスをターゲットとした最適化されたFacebook広告を作成します。Profiles APIとセグメントを使用することで、すでにウェブサイトにアクセスしている、またはウェブサイトに登録している訪問者のリストを作成し、彼らに最適化されたFacebook広告を送信できます。

**この統合とFacebookカスタムオーディエンスへのジョブ結果の書き込みの違いは何ですか?**

Facebookカスタムオーディエンスを使用するには、メールアドレスや電話番号などのユーザー識別情報が必要です。Profiles API統合により、そのようなパラメータなしでセグメントをFacebookカスタムオーディエンスに送信できます。代わりに、Facebook Pixelを使用します。

* [前提条件](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#prerequisites)
* [PixelIDを使用したTD Profiles APIとFacebookの統合](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#integrate-td-profiles-api-with-facebook-custom-audience)
* [Facebook Pixel IDの取得](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#get-facebook-pixel-ids)
* [ウェブサイトへのJavaScriptの設定](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#setup-javascript-on-your-website)
* [Facebook JavaScriptタグ](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#facebook-javascript-tag)
* [Treasure Data JavaScript SDK](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#treasure-data-javascript-sdk)
* [ケース v1.9.x](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#h3__1894618024)
* [ケース v2.x.x](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#case-v2xx)
* [統合ステータスの確認](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#confirm-integration-status)
* [カスタムオーディエンスの作成](/ja/products/customer-data-platform/audience-studio/profiles/integrate-td-profiles-api-with-facebook-custom-audience#create-custom-audience)


## 前提条件

* Treasure Dataの基本知識
* Facebookビジネスアカウントのアカウント


## PixelIDを使用したTD Profiles APIとFacebookの統合

1. Audience Studio > Profile API Tokensに移動します。


![](/assets/image-20190829-174200.c5493cf7ac711fdc6fae367a80ffbbb7b7177d703a4c1c2561ba32a1fccaa986.cf3845cb.png)

1. 新規トークンをクリックします。


![](/assets/image-20190829-174058.ea7f2e4c2ced34c2dcbfc7f0043d7ed715c7c10b0ad7ed8aadf9befdedc81531.cf3845cb.png)

1. キーカラムの指定やパーソナライゼーションを適用する顧客のセグメントの指定など、APIトークンを設定するためのフィールドに入力します。セグメントを検索するために必要なキーカラムを選択します。この例では、td_global_idが選択されています。また、Profiles APIで使用するセグメントを登録します。選択したキーがセグメントに関連付けられている場合、Profiles APIはセグメントIDを返します。


![](/assets/image-20190829-174025.008af2d29ed4fc512e7088ebe5aeadeb940ea419274d80a8ebf709aeae90f10c.cf3845cb.png)

1. トークンを保存します。


## Facebook Pixel IDの取得

Facebook Pixel IDは、Facebookビジネスアカウントで取得できます。
[https://www.facebook.com/business/help/952192354843755](https://www.facebook.com/business/help/952192354843755)を参照してください

![](/assets/image-20190829-174303.14d3b6cdd1837b54734b3cf5eab8ca4626089c3ed3c33653088a83fe458fde93.cf3845cb.png)

## ウェブサイトへのJavaScriptの設定

### Facebook JavaScriptタグ

ウェブサイトにFacebook JavaScriptタグを統合します。スクリプト内の「YOUR_PIXEL_ID」をPixel IDに置き換えます。

詳細については、[https://developers.facebook.com/docs/facebook-pixel/implementation](https://developers.facebook.com/docs/facebook-pixel/implementation)を参照してください

### Treasure Data JavaScript SDK

2つのバージョンのJavaScript SDKを提供しています。使用するバージョンは、この手順で使用されるfetchUserSegments関数のレスポンス形式に影響します。JavaScript SDK バージョン2の使用を推奨します。

### ケース v1.9.x

fetchUserSegments関数は、訪問者がウェブサイトにアクセスしたときに関連するセグメントIDを返します。`trackCustom`パラメータを使用してfbq関数にセグメントIDを追加すると、それらがFacebookに送信されます。

fbq関数のパラメータには以下が必要です: (1): イベント名（任意）、(2): Facebook上のカラム名（任意）、(3): fetchUserSegments関数からのセグメントID


```javascript
<script type="text/javascript">
var td = new Treasure({
  ...
});

var successCallback = function (key, segments) {
  // send to FB
  fbq('trackCustom','event_tracking',{'td_segment_id': segments.join(',')});  // fbq('trackCustom','(1)',{'(2)': (3)});
};

td.fetchUserSegments({
  audienceToken: [token1, token2],
  keys: {some_key: 'value'}
}, successCallback);
</script>
```

### ケース v2.x.x

JS SDK v2以降はv1.9以前とは異なるレスポンス形式を返すため、追加のロジックステップでfetchUserSegments関数からセグメントIDのみを抽出する必要があります。その後、trackCustomパラメータを使用してfbq関数にセグメントIDを追加し、IDをFacebookに送信します。

fbq関数のパラメータには以下が必要です: (1): イベント名（任意）、(2): Facebook上のカラム名（任意）、(3): fetchUserSegments関数からのセグメントID


```javascript
<script type="text/javascript">
var td = new Treasure({
  ...
});

function sendSegmentId2Fb(seg) {
  var segIdAll = [];
  for (var i = 0; i < seg.length; i++) {
    segIdAll = segIdAll.concat(seg[i].values);
  };
  var segId = segIdAll.filter(function (x,i,self) {return self.indexOf(x) === i;});

  // send to FB
  fbq('trackCustom','event_tracking',{'td_segment_id': segId.join(',')});  // fbq('trackCustom','(1)',{'(2)': (3)});
};

var successCallback = function(values) {
  sendSegmentId2Fb(values);
};

td.fetchUserSegments({
  audienceToken: [token1, token2],
  keys: {some_key: 'value'}
}, successCallback);
</script>
```

## 統合ステータスの確認

JavaScript統合がトリガーされた後、Facebookビジネスアカウントページでデータ統合のステータスを確認できます。

1. Events ManagerセクションのPixelsに移動します。


![](/assets/image-20190829-173001.289ac32674b7b3952c0dc71cd976b66353c037991e1a431e16cd6ec81b98754d.cf3845cb.png)

1. 統合したPixelを選択します。


![](/assets/image-20190829-173039.e09531590e7da1eb1bc1fa7bcc522bf99fb70183290b238b760b806034965f02.cf3845cb.png)

1. Activityメニューをクリックし、fbq関数を使用して呼び出したトラッキングターゲット名を確認します。


![](/assets/image-20190829-173106.bb38f26917bc4cb3d1e7e9a90eb1899b632ad145ac3ec985ee9e8e4fdc708cb7.cf3845cb.png)

## カスタムオーディエンスの作成

データがFacebook側に保存された後、そのデータを使用してカスタムオーディエンスを作成できます。

1. Event Managersに移動し、Pixelsをクリックします。


![](/assets/image-20190829-173156.82d6aebdc6fc9a84140ee1d33f9611a84e95382bb99bff555ca1cb57eb8ab830.cf3845cb.png)

1. Pixelを選択します。


![](/assets/image-20190829-173231.0c80cbd64b460c83a3cf9655c631d48953e41146bed2bc9383463d609719212a.cf3845cb.png)

1. カスタムオーディエンスの作成をクリックします。


![](/assets/image-20190829-173326.9f0d3412ebcb31de8b97031187225eb09fec2a99ca9d48abff4ef015f1d0b549.cf3845cb.png)

1. 広告を送信する条件を選択します


* イベント名を選択
* 条件を選択（例：td_segment_idに`<セグメントID>`が含まれる）


1. カスタムオーディエンス名を設定します。


![](/assets/image-20190829-173911.0439e6cbe5fe3caa9565dc88e2acc0f075220e222e4588a4eaecf376e76a1a40.cf3845cb.png)

1. 最後に、カスタムオーディエンスのステータスを確認できます。


![](/assets/image-20190911-202237.872a1e2f04c44a57c37ad2fde7ffa8b6c73f3c99250f5d9044a85b26e3766b5e.cf3845cb.png)