---
title: Facebookオーディエンス カスタマー提供クレデンシャルコネクタ構成ガイド
description: この記事では、お客様のCustomer Data HubアカウントでFacebookオーディエンス カスタマー提供クレデンシャルコネクタを構成する方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/facebook-audiences-customer-provided-credentials-connector/
---
この記事では、Facebookオーディエンス カスタマー提供クレデンシャルコネクタの構成方法について説明します。

## 前提条件

Facebookアプリの作成についての詳細は、[Facebook: アプリ開発](https://developers.facebook.com/docs/apps/)を参照してください。

コネクタを構成する前に、以下の手順を完了してください：

1. [Facebookカスタムオーディエンス利用規約](https://www.facebook.com/ads/manage/customaudiences/tos.php)に同意する。
1. Facebookアカウントに次のリダイレクトURIを追加する：`https://my.tealiumiq.com/oauth/facebook/callback.html`。Facebookアプリダッシュボードから**Facebookログイン > 構成**に移動し、URIを**有効なOAuthリダイレクトURIのFacebookアプリ**の下に入力します。
1. Facebookアプリで`ads_management`権限を要求する。`ads_management`権限により、アプリは所有する広告アカウント、または広告アカウント所有者からアクセス権を付与された広告アカウントを読み取りおよび管理できます。詳細については、[Facebook: 権限リファレンス](https://developers.facebook.com/docs/facebook-login/permissions/#reference-ads_management)を参照してください。

より良いレート制限など、より多くのアプリリソースを取得するには、広告管理**スタンダードアクセス**を要求してください。詳細については、[Facebook: アクセスと認証](https://developers.facebook.com/docs/marketing-api/access/)を参照してください。

## API情報

このコネクタは以下のベンダーAPIを使用します：

* API名：Facebook Graph API - Marketing API
* APIバージョン：v25.0
* APIエンドポイント：`https://graph.facebook.com`

## バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。並列処理により、イベントがベンダーに順不同で到達する可能性があります。順序が重要な場合は、イベントにシーケンス値を追加してください。詳細については、[バッチ処理アクション](https://docs.tealium.com/batched-actions/)を参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

* 最大リクエスト数：10000
* 最古のリクエストからの最大時間：10分
* リクエストの最大サイズ：1 MB

## 構成

コネクタマーケットプレースに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な説明については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

コネクタを追加した後、次の構成を構成します：

* **アプリID**：(必須) 接続したいFacebookアプリID。
* **アプリシークレット**：(必須) 接続したいFacebookアプリのアプリシークレット。
* **広告アカウントID**：(必須) 管理したいFacebook広告アカウントID。Facebook広告アカウントIDについての詳細は、[Facebook: Facebook広告アカウントID番号の検索](https://www.facebook.com/help/1492627900875762)を参照してください。

この接続は通常60日以内に期限切れになり、すべてのFacebook広告アクションに予測不可能な結果をもたらします。

いつでも**接続の確立/接続済み**をクリックして接続を再確立します。


<blockquote>
**接続の確立**ボタンをクリックする前に、使用している広告アカウントIDにリンクされているアカウントでFacebookにサインインしていることを確認してください。そうでない場合、生成されるトークンに問題が発生する可能性があります。
</blockquote>


## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| カスタムオーディエンスにユーザーを追加 | ✓ | ✗ |
| カスタムオーディエンスからユーザーを削除 | ✓ | ✗ |
| すべてのカスタムオーディエンスからユーザーをオプトアウト | ✓ | ✗ |

アクションの名前を入力し、アクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

### カスタムオーディエンスにユーザーを追加

サポートされている識別子のタイプは4つあります：メール、電話番号、ユーザーまたはアプリID、およびセカンダリID。複数のセカンダリ識別子がサポートされています。**FacebookユーザーID**を指定する場合は、**FacebookアプリID**も提供する必要があります。メールまたは電話番号は1つのみサポートされています。複数の識別子が指定されている場合、上記の順序で選択されます。たとえば、メールと電話番号の両方が指定されている場合、メールが選択されます（値がない場合を除く）。
#### パラメータ

| パラメータ | 説明 |
| --- | --- |
|追加するカスタムオーディエンス|  <ul><li>（必須）ターゲットカスタムオーディエンスを選択してください。</li><li>顧客ファイルから作成されたオーディエンスは表示されません。</li><li>このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、[Facebookカスタムオーディエンス規約](https://www.facebook.com/ads/manage/customaudiences/tos.php)に同意する必要があります。</li></ul> |
|メールアドレス|  <ul><li>メールアドレスに基づいてユーザーを特定します。</li></ul> |
|電話番号|  <ul><li>電話番号に基づいてユーザーを特定します。</li><li>国コード、市外局番、番号のみを含め、例えば `16505551212` のように記述します。</li></ul> |
|FacebookユーザーID|  <ul><li>Facebook IDに基づいてユーザーを特定します。</li><li>この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。</li></ul> |
|FacebookアプリID|  <ul><li>「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。</li><li>「FacebookユーザーID」を参照してください。</li></ul> |
|モバイル広告ID|  <ul><li>アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。</li></ul> |
|郵便番号|  <ul><li>郵便番号。</li><li>形式は国によって異なります。</li></ul> |
|市区町村|  <ul><li>ユーザーの市区町村。</li><li>小文字。</li><li>句読点やスペースは含まない。</li></ul> |
|国|  <ul><li>ユーザーの国。</li><li>2文字の国コード。</li><li>ISO 3166-1 Alpha-2形式。</li></ul> |
|米国の州|  <ul><li>アメリカ合衆国の州。</li><li>小文字。</li><li>2文字のANSI略語コード。</li></ul> |
|名|  <ul><li>ユーザーの名前。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|姓|  <ul><li>ユーザーの姓。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|イニシャル|  <ul><li>ユーザーの名のイニシャル。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|生年|  <ul><li>ユーザーの生年。</li><li>`YYYY`形式。</li><li>`1900`年から現在の年までの値。</li></ul> |
|誕生日|  <ul><li>ユーザーの誕生日。</li><li>`DD`形式。</li><li>`01`から`31`までの値。</li></ul> |
|誕生月|  <ul><li>ユーザーの誕生月。</li><li>`MM`形式。</li><li>`01`から`12`までの値。</li></ul> |
|性別|  <ul><li>ユーザーの性別。</li><li>`M`は男性、`F`は女性</li></ul> |
|ルックアライク値|  <ul><li>CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。</li><li>Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。</li></ul> |
|カスタムオーディエンスの上書き| （オプション）必須セクションの値を上書きするカスタムオーディエンスIDを提供します。このフィールドを使用すると、AudienceStream変数を使用してオーディエンスIDを入力できます。 |
|メールは既にSHA256でハッシュ化されています|  <ul><li>メールアドレスはすでに空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|メールにSHA256ハッシュを適用|  <ul><li>プレーンテキストのメールアドレス。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。文字列または文字列の配列を受け入れます。</li></ul> |
|電話は既にSHA256でハッシュ化されています|  <ul><li>電話番号はすでに空白をトリミングし、SHA256でハッシュ化されています。国コード、市外局番、番号のみを含め、先頭のゼロを除いて記述します。例えば、`16505551212`。</li></ul> |
|電話にSHA256ハッシュを適用|  <ul><li>プレーンテキストの電話番号。コネクタは空白をトリミングし、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|名は既にSHA256でハッシュ化されています|  <ul><li>名はすでに空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|名にSHA256ハッシュを適用|  <ul><li>プレーンテキストの名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|姓は既にSHA256でハッシュ化されています|  <ul><li>姓はすでに空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。</li></ul> |
|姓にSHA256ハッシュを適用|  <ul><li>プレーンテキストの姓。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|市区町村は既にSHA256でハッシュ化されています|  <ul><li>市区町村はすでに空白や句読点を含まず、小文字に変換し、SHA256でハッシュ化されています。例えば、`menlopark`。</li></ul> |
|市区町村にSHA256ハッシュを適用|  <ul><li>プレーンテキストの市区町村名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|州は既にSHA256でハッシュ化されています|  <ul><li>2文字の州コードはすでに空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。</li></ul> |
|州にSHA256ハッシュを適用|  <ul><li>プレーンテキストの2文字の州コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|郵便番号/ZIPは既にSHA256でハッシュ化されています|  <ul><li>郵便ZIPコードはすでに空白をトリミングし、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|郵便番号/ZIPにSHA256ハッシュを適用|  <ul><li>プレーンテキストの郵便ZIPコード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|国は既にSHA256でハッシュ化されています|  <ul><li>2文字の国コードはすでに空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。例えば、`us`。文字列または文字列の配列を受け入れます。</li></ul> |
|国にSHA256ハッシュを適用|  <ul><li>プレーンテキストの2文字の国コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|外部IDは既にSHA256でハッシュ化されています|  <ul><li>外部IDはすでにSHA256でハッシュ化されています。Metaは外部IDのハッシュ化を推奨しています。</li></ul> |
|外部IDにSHA256ハッシュを適用|  <ul><li>プレーンテキストの外部ID。コネクタは値をSHA256でハッシュ化して送信します。</li></ul> |
|生年月日は既にSHA256でハッシュ化されています|  <ul><li>生年月日はすでにSHA256でハッシュ化されています。Metaはこのフィールドのハッシュ化を要求しています。</li></ul> |
|生年月日にSHA256ハッシュを適用|  <ul><li>プレーンテキストの生年月日。コネクタは値をSHA256でハッシュ化して送信します。Metaはこのフィールドのハッシュ化を要求しています。</li></ul> |
|性別は既にSHA256でハッシュ化されています|  <ul><li>性別はすでにSHA256でハッシュ化されています。Metaはこのフィールドのハッシュ化を要求しています。</li></ul> |
|性別にSHA256ハッシュを適用|  <ul><li>プレーンテキストの性別値。コネクタは値をSHA256でハッシュ化して送信します。Metaはこのフィールドのハッシュ化を要求しています。</li></ul> |


<blockquote>
既存の保存されたアクションは、レガシーの**ユーザー識別子は既にハッシュ化されている**チェックボックスを使用しても、再構成なしで動作し続けます。同じ識別子に対して既にSHA256でハッシュ化されたバリアントとSHA256ハッシュを適用するバリアントがマッピングされている場合、既にSHA256でハッシュ化されたものが優先されます。
</blockquote>


### カスタムオーディエンスからユーザーを削除

サポートされている識別子のタイプは4つあります：メール、電話番号、ユーザーまたはアプリID、およびセカンダリID。複数のセカンダリ識別子がサポートされています。**FacebookユーザーID**を指定する場合は、**FacebookアプリID**も提供する必要があります。メールまたは電話番号は1つのみサポートされています。複数の識別子が指定された場合、上記のリストの順序で選択されます。たとえば、メールと電話番号の両方が指定されている場合、値がない限りメールが選択されます。
#### パラメータ

| パラメータ | 説明 |
| --- | --- |
|削除対象のカスタムオーディエンス|  <ul><li>(必須) 対象のカスタムオーディエンスを選択してください。</li><li>このコネクタを使用してFacebookでカスタムオーディエンスを構築する前に、[Facebookカスタムオーディエンス規約](https://www.facebook.com/ads/manage/customaudiences/tos.php)に同意する必要があります。</li></ul> |
|メールアドレス|  <ul><li>メールアドレスに基づいてユーザーを特定します。</li></ul> |
|電話番号|  <ul><li>電話番号に基づいてユーザーを特定します。</li><li>国コード、市外局番、番号のみを含め、例えば `16505551212` のように記述します。</li></ul> |
|FacebookユーザーID|  <ul><li>Facebook IDに基づいてユーザーを特定します。</li><li>この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。</li></ul> |
|FacebookアプリID|  <ul><li>「FacebookユーザーID」がユーザー識別子として使用される場合に必要です。</li><li>「FacebookユーザーID」を参照してください。</li></ul> |
|モバイル広告ID|  <ul><li>アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。</li></ul> |
|郵便番号|  <ul><li>郵便番号。</li><li>国によって正確な形式が異なります。</li></ul> |
|市区町村|  <ul><li>ユーザーの市区町村。</li><li>小文字。</li><li>句読点やスペースは含まない。</li></ul> |
|国|  <ul><li>ユーザーの国。</li><li>2文字の国コード。</li><li>ISO 3166-1 Alpha-2形式。</li></ul> |
|米国の州|  <ul><li>アメリカ合衆国の州。</li><li>小文字。</li><li>2文字のANSI略語コード。</li></ul> |
|名|  <ul><li>ユーザーの名前。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|姓|  <ul><li>ユーザーの姓。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|イニシャル|  <ul><li>ユーザーの名のイニシャル。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
|生年|  <ul><li>ユーザーの生年。</li><li>`YYYY`形式。</li><li>`1900`年から現在の年までの値。</li></ul> |
|生日|  <ul><li>ユーザーの生日。</li><li>`DD`形式。</li><li>`01`から`31`までの値。</li></ul> |
|生月|  <ul><li>ユーザーの生月。</li><li>`MM`形式。</li><li>`01`から`12`までの値。</li></ul> |
|性別|  <ul><li>ユーザーの性別。</li><li>`M`は男性、`F`は女性</li></ul> |
|ルックアライク値|  <ul><li>CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成する任意の数値。</li><li>Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。</li></ul> |
|カスタムオーディエンスの上書き| (オプション) 必須セクションの値を上書きするカスタムオーディエンスIDを提供します。このフィールドでは、AudienceStreamの変数を使用してオーディエンスIDを入力できます。 |
|メールは既にSHA256でハッシュ化されています|  <ul><li>メールアドレスは既に空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|メールにSHA256ハッシュを適用|  <ul><li>プレーンテキストのメールアドレス。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。文字列または文字列の配列を受け入れます。</li></ul> |
|電話番号は既にSHA256でハッシュ化されています|  <ul><li>電話番号は既に空白をトリミングし、SHA256でハッシュ化されています。国コード、市外局番、番号のみを含め、先頭のゼロを除いて記述します。例えば、`16505551212`。</li></ul> |
|電話番号にSHA256ハッシュを適用|  <ul><li>プレーンテキストの電話番号。コネクタは空白をトリミングし、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|名は既にSHA256でハッシュ化されています|  <ul><li>名は既に空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|名にSHA256ハッシュを適用|  <ul><li>プレーンテキストの名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|姓は既にSHA256でハッシュ化されています|  <ul><li>姓は既に空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。</li></ul> |
|姓にSHA256ハッシュを適用|  <ul><li>プレーンテキストの姓。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|市区町村は既にSHA256でハッシュ化されています|  <ul><li>市区町村は小文字でスペースや句読点を含まず、SHA256でハッシュ化されています。例えば、`menlopark`。</li></ul> |
|市区町村にSHA256ハッシュを適用|  <ul><li>プレーンテキストの市区町村名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|州は既にSHA256でハッシュ化されています|  <ul><li>2文字の州コードは既に空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。</li></ul> |
|州にSHA256ハッシュを適用|  <ul><li>プレーンテキストの2文字の州コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|郵便番号/ZIPは既にSHA256でハッシュ化されています|  <ul><li>郵便ZIPコードは既に空白をトリミングし、SHA256でハッシュ化されています。文字列または文字列の配列を受け入れます。</li></ul> |
|郵便番号/ZIPにSHA256ハッシュを適用|  <ul><li>プレーンテキストの郵便ZIPコード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|国は既にSHA256でハッシュ化されています|  <ul><li>2文字の国コードは既に空白をトリミングし、小文字に変換し、SHA256でハッシュ化されています。例えば、`us`。文字列または文字列の配列を受け入れます。</li></ul> |
|国にSHA256ハッシュを適用|  <ul><li>プレーンテキストの2文字の国コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
|外部IDは既にSHA256でハッシュ化されています|  <ul><li>外部IDは既にSHA256でハッシュ化されています。Metaは外部IDのハッシュ化を推奨しています。</li></ul> |
|外部IDにSHA256ハッシュを適用|  <ul><li>プレーンテキストの外部ID。コネクタは値をSHA256でハッシュ化して送信します。</li></ul> |
|生年月日は既にSHA256でハッシュ化されています|  <ul><li>生年月日は既にSHA256でハッシュ化されています。このフィールドにはハッシュ化が必要です。</li></ul> |
|生年月日にSHA256ハッシュを適用|  <ul><li>プレーンテキストの生年月日。コネクタは値をSHA256でハッシュ化して送信します。このフィールドにはハッシュ化が必要です。</li></ul> |
|性別は既にSHA256でハッシュ化されています|  <ul><li>性別は既にSHA256でハッシュ化されています。このフィールドにはハッシュ化が必要です。</li></ul> |
|性別にSHA256ハッシュを適用|  <ul><li>プレーンテキストの性別値。コネクタは値をSHA256でハッシュ化して送信します。このフィールドにはハッシュ化が必要です。</li></ul> |


<blockquote>
既存の保存されたアクションは、レガシーの**ユーザー識別子は既にハッシュ化されている**チェックボックスを使用しても、再構成なしで動作し続けます。同じ識別子に対して既にSHA256ハッシュ化されたバリアントとSHA256ハッシュを適用するバリアントがマッピングされている場合、既にSHA256ハッシュ化されたものが優先されます。
</blockquote>


### すべてのカスタムオーディエンスからユーザーをオプトアウトする


#### パラメータ

| パラメータ | 説明 |
| --- | --- |
| メールアドレス | <ul><li>メールアドレスに基づいてユーザーを識別します。</li></ul> |
| 電話番号 | <ul><li>電話番号に基づいてユーザーを識別します。</li><li>国コード、市外局番、番号のみの数字を含めてください。例：`16505551212`。</li></ul> |
| FacebookユーザーID | <ul><li>Facebook IDに基づいてユーザーを識別します。</li><li>この識別タイプを使用する場合は、対応する「FacebookアプリID」を提供する必要があります。</li></ul> |
| FacebookアプリID | <ul><li>「FacebookユーザーID」をユーザー識別子として使用する場合に必要です。</li><li>「FacebookユーザーID」を参照してください。</li></ul> |
| モバイル広告ID | <ul><li>アプリユーザーID、Appleの広告識別子（IDFA）、またはAndroidの広告IDに基づいてユーザーをターゲットにします。</li></ul> |
| 郵便番号 | <ul><li>郵便番号。</li><li>国によって形式が異なります。</li></ul> |
| 市区町村 | <ul><li>ユーザーの市区町村。</li><li>小文字。</li><li>句読点やスペースは含まない。</li></ul> |
| 国 | <ul><li>ユーザーの国。</li><li>2文字の国コード。</li><li>ISO 3166-1 Alpha-2形式。</li></ul> |
| 米国の州 | <ul><li>アメリカ合衆国の州。</li><li>小文字。</li><li>2文字のANSI略語コード。</li></ul> |
| 名 | <ul><li>ユーザーの名前。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
| 姓 | <ul><li>ユーザーの姓。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
| 名のイニシャル | <ul><li>ユーザーの名のイニシャル。</li><li>小文字。</li><li>句読点や特殊文字は含まない。</li><li>UTF-8形式。</li></ul> |
| 生年 | <ul><li>ユーザーの生年。</li><li>`YYYY`形式。</li><li>`1900`年から現在の年までの値。</li></ul> |
| 生日 | <ul><li>ユーザーの生日。</li><li>`DD`形式。</li><li>`01`から`31`までの値。</li></ul> |
| 生月 | <ul><li>ユーザーの生月。</li><li>`MM`形式。</li><li>`01`から`12`までの値。</li></ul> |
| 性別 | <ul><li>ユーザーの性別。</li><li>`M`は男性、`F`は女性</li></ul> |
| 類似値 | <ul><li>CRMデータからシードカスタムオーディエンスを作成する際に各ユーザーに構成される任意の数値。</li><li>Facebookはこの値を使用して、オーディエンス内のどのユーザーがあなたにとって最も価値があるかを定量的に判断します。</li></ul> |
| メールは既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、小文字に変換し、SHA256でハッシュ化されたメールアドレス。文字列または文字列の配列を受け入れます。</li></ul> |
| メールにSHA256ハッシュを適用 | <ul><li>プレーンテキストのメールアドレス。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。文字列または文字列の配列を受け入れます。</li></ul> |
| 電話は既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、SHA256でハッシュ化された電話番号。先頭のゼロを除いた国コード、市外局番、番号のみの数字を含みます。例：`16505551212`。</li></ul> |
| 電話にSHA256ハッシュを適用 | <ul><li>プレーンテキストの電話番号。国コード、市外局番、番号のみの数字を含みます。コネクタは空白をトリミングし、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 名は既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、小文字に変換し、SHA256でハッシュ化された名。文字列または文字列の配列を受け入れます。</li></ul> |
| 名にSHA256ハッシュを適用 | <ul><li>プレーンテキストの名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 姓は既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、小文字に変換し、SHA256でハッシュ化された姓。</li></ul> |
| 姓にSHA256ハッシュを適用 | <ul><li>プレーンテキストの姓。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 市は既にSHA256ハッシュ化済み | <ul><li>空白や句読点を含まない小文字の市名でSHA256ハッシュ化されています。例：`menlopark`。</li></ul> |
| 市にSHA256ハッシュを適用 | <ul><li>プレーンテキストの市名。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 州は既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、小文字に変換し、SHA256でハッシュ化された2文字の州コード。</li></ul> |
| 州にSHA256ハッシュを適用 | <ul><li>プレーンテキストの2文字の州コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 郵便/ZIPは既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、SHA256でハッシュ化された郵便ZIPコード。文字列または文字列の配列を受け入れます。</li></ul> |
| 郵便/ZIPにSHA256ハッシュを適用 | <ul><li>プレーンテキストの郵便ZIPコード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 国は既にSHA256ハッシュ化済み | <ul><li>空白をトリミングし、小文字に変換し、SHA256でハッシュ化された2文字の国コード。例：`us`。文字列または文字列の配列を受け入れます。</li></ul> |
| 国にSHA256ハッシュを適用 | <ul><li>プレーンテキストの2文字の国コード。コネクタは空白をトリミングし、小文字に変換し、SHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 外部IDは既にSHA256ハッシュ化済み | <ul><li>SHA256でハッシュ化された外部ID。Metaは外部IDのハッシュ化を推奨しています。</li></ul> |
| 外部IDにSHA256ハッシュを適用 | <ul><li>プレーンテキストの外部ID。コネクタはSHA256を使用して値をハッシュ化して送信します。</li></ul> |
| 生年月日は既にSHA256ハッシュ化済み | <ul><li>SHA256でハッシュ化された生年月日。このフィールドのハッシュ化はMetaによって要求されています。</li></ul> |
| 生年月日にSHA256ハッシュを適用 | <ul><li>プレーンテキストの生年月日。コネクタはSHA256を使用して値をハッシュ化して送信します。このフィールドのハッシュ化はMetaによって要求されています。</li></ul> |
| 性別は既にSHA256ハッシュ化済み | <ul><li>SHA256でハッシュ化された性別。このフィールドのハッシュ化はMetaによって要求されています。</li></ul> |
| 性別にSHA256ハッシュを適用 | <ul><li>プレーンテキストの性別値。コネクタはSHA256を使用して値をハッシュ化して送信します。このフィールドのハッシュ化はMetaによって要求されています。</li></ul> |


<blockquote>
既存の保存されたアクションは、レガシーの**ユーザー識別子は既にハッシュ化されている**チェックボックスを使用しても、再構成なしで引き続き機能します。同じ識別子に対して「既にSHA256ハッシュ化済み」と「SHA256ハッシュを適用」の両方がマッピングされている場合、「既にSHA256ハッシュ化済み」が優先されます。
</blockquote>


## Facebookオーディエンス顧客提供資格情報コネクタの使用

### 訪問ID属性の作成

Facebookオーディエンス顧客提供資格情報コネクタは、少なくとも1つの訪問ID属性を必要とし、Facebookオーディエンスに渡すことができます。

訪問ID属性の構成には、以下のリソースを使用してください：

* [訪問ID属性の構成](https://docs.tealium.com/visitor-id-attribute/)
* [FacebookマーケティングAPI](https://developers.facebook.com/docs/marketing-api/audiences-api)

### オーディエンスの定義

アカウントには複数の訪問ID属性が定義されている場合があります。この場合、訪問IDが割り当てられている訪問のみを含むオーディエンスを確実にするために、ブールデータ型で「Known Visitor」という名前の訪問スコープ属性を作成することが重要です。この属性を使用することで、Facebookに渡すことができる訪問IDが割り当てられている訪問のみがオーディエンスに含まれるようになります。未知の訪問をターゲットにすることはできません。


<blockquote>
このコネクタには、メール、電話、アプリ、またはユーザーIDなどの必要なIDパラメータがあります。これらのIDの少なくとも1つが必要です。これらのIDをオーディエンスフィルターに含めることで、コネクタエラーを回避するのに役立ちます。
</blockquote>


以下の例を使用して、`true`に構成された「Known Visitor」ブールデータ型の訪問フィルターを[作成します](https://docs.tealium.com/manage-audiences/)。バッジとブール属性を事前に追加するか、フィルターを作成する際に追加することができます。

![](https://docs.tealium.com/images/server-side-connectors/edit-audience-shoe-fan.png)
### Facebook AudiencesアカウントにTealiumを接続する

Facebook Audiencesアカウントとコネクタを構成するためには、アカウントIDが必要です。

Facebook AudiencesアカウントIDを取得するには、以下の手順に従ってください：

1. Facebook Audiencesアカウントにログインします。
1. [広告マネージャー](https://www.facebook.com/ads/manage)で広告アカウント、キャンペーン、広告セット、または広告をクリックします。
1. ブラウザのURLから`account_id`パラメータの値をコピーし、AudienceStreamのコネクタに戻ります。  
![](https://docs.tealium.com/images/server-side-connectors/facebook-account-id.png)

1. **構成**ウィンドウで、タイトルと関連するメモ、および上記からコピーした広告アカウントIDを追加します。
1. **接続を確立**をクリックして、接続を確認します。

### カスタムオーディエンスを作成する

Facebook Audiencesアカウントに接続したので、カスタムオーディエンスを作成する時が来ました。コネクタでカスタムオーディエンスを作成する前に、Facebookサイトで最初のカスタムオーディエンスを作成し、利用規約に同意する必要があります。

カスタムオーディエンスを作成するには、以下の手順に従ってください：

1. コネクタ構成で**作成**タブをクリックします。
1. 次のフィールドを構成します：
   * **オーディエンス名**（必須）：カスタムオーディエンスの名前。CRMからのオーディエンスまたはセグメント名を使用します（例：`Qualified Leads - US - Q3 2026`または`High Value Customers - EMEA`）。Metaはこの名前を使用してオーディエンスセグメントを識別します。
   * **オーディエンスメタデータ（JSON）**（オプション）：Meta APIの`description`パラメータにマッピングされたオーディエンス基準を記述するJSONオブジェクト。集計またはカテゴリ属性のキーバリューペアを使用します。PIIは含めないでください。例：`{"lifecycle_stage":"churned","region":"EMEA","tier":"high_value"}`。Metaはこのメタデータをオーディエンスラベルと最適化機能で使用します。ラベルの割り当てはMeta広告マネージャーで行われます。値はMetaがメタデータを解析するために有効なJSONでなければなりません。
1. **作成**をクリックします。  
`customer_file_source`パラメータは以下の値をサポートします：
    * `USER_PROVIDED_ONLY`
    * `PARTNER_PROVIDED_ONLY`
    * `BOTH_USER_AND_PARTNER_PROVIDED`

Facebook Audiencesサイトでは、顧客リスト、ウェブサイトのトラフィック、またはアプリのアクティビティに基づいてオーディエンスを作成するオプションがあります。この例では、顧客リストに基づいてオーディエンスを作成します。


<blockquote>
カスタムオーディエンスを使用するには、最低20エントリを含む必要があります。オーディエンスが正常に作成された場合、ボタンの横に小さなチェックアイコンが表示されます。
</blockquote>


### コネクタアクションを指定する

これで、コネクタが実行するアクションを指定する必要があります。

コネクタのアクションを指定するには、以下の手順に従ってください：

1. **アクション**タブをクリックします。
1. **カスタムオーディエンスにユーザーを追加**を選択します。  
![](https://docs.tealium.com/images/server-side-connectors/facebook-ads-connector-action-add-user-to-custom-audience.jpg)
1. **+ アクションを作成**をクリックします。

### コネクタアクションを構成する

コネクタのアクションを構成するには、以下の手順に従ってください：

1. **オーディエンス**メニューから、以前に作成した**Shoe-Fans**オーディエンスを選択します。  
**ユーザーを追加するカスタムオーディエンス**メニューには、Facebook Audiencesアカウントに存在するオーディエンスが表示されます。
1. **ユーザーを追加するカスタムオーディエンス**ドロップダウンリストから、訪問を追加したいオーディエンスを選択します。
1. **ターゲットユーザー識別子**ドロップダウンリストで、訪問のメール属性をFacebook Audiencesアカウントの対応する訪問識別子にマッピングします。
1. **WHEN**は**Joined Audience**に構成したままにします。
1. **保存**をクリックします。

### テスト

最も効果的なテスト方法は、[Trace](https://docs.tealium.com/about-trace/)を実行してイベントが適切に処理されていることを確認し、Facebookダッシュボードでカスタムオーディエンスが作成され、人が追加されていることを確認することです。

## FAQ

### なぜAudienceStreamのドロップダウンリストにオーディエンスが表示されないのですか？

Facebookに2,000以上のオーディエンスがある場合、それらはすべてAudienceStreamコネクタのドロップダウンリストで選択可能ではありません。

Facebookですべてのオーディエンスを表示し、特定のオーディエンスの識別子を選択するには、以下の手順に従ってください：

1. Facebook Audiencesアカウントにアクセス権を持つユーザーとしてFacebookにログインします。
1. <https://www.facebook.com/adsmanager/audiences>にアクセスします。
1. 探しているオーディエンスを見つけ、オーディエンスIDをコピーします。  
    
<blockquote>
オーディエンスIDが表示されない場合は、テーブル列ビューを変更してそれを含めることができます。
</blockquote>
  

    ![](https://docs.tealium.com/images/server-side-connectors/facebook-ads-find-audience-id.png)
1. AudienceStreamに戻り、AudienceStreamコネクタのカスタム値としてオーディエンスIDを入力します。