---
articleId: 2a3a79dd-fad5-4348-8759-f1614b3ce5a9
slug: data-destination-facebook-custom-audience
title: 転送先 - Facebook カスタムオーディエンス(β版)
parentCategoryId: 03f04962-e96f-49cb-9c01-d84d025cc41a
languageCode: ja
---
## 概要
Facebook カスタムオーディエンスに関するDocsです。
転送されたデータ（カスタマーリスト）からFacebook広告のカスタムオーディエンス（広告を配信するターゲット）を作成できます。

:::(Warning) (β版でのご提供)

本コネクタはβ版でのご提供となっています。
正式版リリース時には、仕様が変更される可能性があります。
:::

## 制約

:::(Warning) (転送データのハッシュ化)

転送されるデータは、`MADID`カラムの値を除いてすべて、`SHA-256`でハッシュ化し送信する必要があります。
:::

:::(Warning) (転送データのフォーマット)

[公式ドキュメント - 複数キーのハッシュ化と正規化](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/v25.0#hash)に記載されている表の、「ガイドライン」列に記載されているフォーマットに基づいたデータを転送してください。
フォーマットに基づかないデータを転送した場合、エラーが発生する場合があります。
:::

:::(Warning) (転送データの最大行数)

本コネクタへのデータ転送に利用しているMetaマーケティングAPIのレート制限により、**1時間**あたりに転送可能なデータ（カスタマーリスト）の最大行数は、約**5,000万行**です。
**5,000万行**以上のデータを転送したい場合は、複数の転送ジョブに分割して1時間ごとに転送ジョブを実行してください。
:::

## 設定項目

### STEP1 基本設定

:::(Warning) (接続情報に必要な権限)

接続情報の作成方法によって、必要な権限は異なります。
- **Facebookアカウントで作成**する場合
  使用するFacebookアカウントが、以下のいずれかを満たす必要があります。
  - Metaビジネスマネージャに関連付けられている広告アカウントの所有者であること
  - 広告アカウント所有者から、管理者または広告主としてのアクセス許可を付与されていること
- **システムユーザーで作成**する場合
  使用するアクセストークンに、**ads_management**権限が付与されている必要があります。
  詳しくは、[Facebook広告レポート、コンバージョン、カスタムオーディエンス用アプリ作成・トークン取得手順](/docs/how-to-create-facebook-app-and-get-token)を参照ください。
:::

| 項目名 | 必須 | 内容 |
| --- | --- | --- |
| Facebook接続情報 | ✓ | あらかじめ登録してある接続情報から、上述の必要な権限を持つものを選択します。 |
| 広告アカウントID | ✓ | カスタムオーディエンスを作成する広告アカウントIDを指定します。<br>広告アカウントIDの確認方法は、Metaビジネスヘルプセンター「[Facebook広告アカウントのID番号を見つける](https://www.facebook.com/business/help/1492627900875762)」をご参照ください。 |
| カスタムオーディエンス名 | ✓ | 作成および更新するカスタムオーディエンス名を指定します。<br>既存のカスタムオーディエンスを指定した場合、同名のカスタムオーディエンスのうち更新日時がもっとも新しいカスタムオーディエンスが更新されます。<br>存在しないカスタムオーディエンスを指定した場合、新たにカスタムオーディエンスが作成されます。 |
| カスタムオーディエンスの作成および更新完了まで待つ | - | 転送先による転送データの確認が完了するまで、転送ジョブを継続するかを選択します。<br>詳しくは、後述の[転送ジョブの継続設定について](/docs/data-destination-facebook-custom-audience#転送ジョブの継続設定について)を参照ください。 |

#### 転送ジョブの継続設定について

- **「有効」を選択した場合**
  - カスタムオーディエンスの作成および更新が完了するまで、転送ジョブを継続します。
  - 有効にすると、マッチング処理の完了を確認できますが、最大24時間かかることがあります。詳細は[公式ドキュメント](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/)をご確認ください。
  - 転送ジョブを開始して**1時間以上**経過してもジョブが終了しない場合は、下記の[対処方法](/docs/data-destination-facebook-custom-audience#転送ジョブが終了しない場合の対処方法)を参照ください。
- **「無効」を選択した場合**
  - カスタムオーディエンスの作成および更新の完了を待たずに、転送ジョブを終了します。
  - カスタムオーディエンスの作成および更新の完了を待たずに転送ジョブが終了するため、転送時間を節約できます。
  - カスタムオーディエンスの作成および更新状況は、[Meta広告マネージャ](https://www.facebook.com/business/tools/ads-manager)で確認できます。

## カラムマッピング

転送するデータからカスタムオーディエンスを作成するために、TROCCO上でカラム名や型をマッピングする必要があります。
TROCCOの転送設定STEP2**カラム定義**タブにて、マッピングを行ってください。
マッピングするカラムについては、[公式ドキュメント - 複数キーのハッシュ化と正規化](https://developers.facebook.com/docs/marketing-api/audiences/guides/custom-audiences/v25.0#hash)を参照ください。リンク先の表の「キー」列がカラム名に該当します。

:::(Warning) (必須カラムについて)

いずれのカラムも任意項目ですが、必ず1つ以上のカラムを指定してください。
:::

## 転送ジョブが終了しない場合の対処方法

**カスタムオーディエンスの作成および更新完了まで待つ**設定をした転送ジョブは、通常は1時間程度で完了となります。
ただし、利用しているMetaマーケティングAPIの都合上、さらに時間がかかる場合があります。

転送ジョブ実行ログに`"code":414`または`"code":300`を含む行が出力されている場合、転送ジョブをキャンセルしても構いません。
カスタマーリストの転送は完了しているため、カスタムオーディエンスの作成と更新が中断されることはありません。
カスタムオーディエンスの作成と更新状況は、[Meta広告マネージャ](https://www.facebook.com/business/tools/ads-manager)で確認できます。