--- title: Adformセグメントコネクタ構成ガイド description: この記事では、Adformセグメントコネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/adform-segments-connector/ --- ## API情報 このコネクタは以下のベンダーAPIを使用します： * API名：Adform API * APIバージョン：v1 * APIエンドポイント：`https://api.adform.com/v1/dmp` * ドキュメント：[Adform API](https://api.adform.com/v1/help/dmp) ## 構成 **コネクタマーケットプレイス**にアクセスし、新しいコネクタを追加します。コネクタの追加方法については、[コネクタ概要](https://docs.tealium.com/about-connectors/)の記事を参照してください。 コネクタを追加した後、以下の構成を構成します： * **クライアントID**：（必須）クライアントIDを提供してください。 * **クライアントシークレット**：（必須）クライアントシークレットを提供してください。 * **アカウントスコープタイプ**：Adformアカウントのアカウントモードを選択します： * **パートナーレベル**（デフォルト）：AdformパートナーIDを使用します。従来のAdform DMPアカウントにこのオプションを選択してください。 * **広告主レベル**：AdformオーディエンスマネージャーをAdform広告主IDで使用します。 * **AdformパートナーID**：（パートナーレベルで必須）AdformパートナーIDを入力してください。 * **Adform広告主ID**：（広告主レベルで必須）リストからAdform広告主IDを選択するか、手動で入力してください。表示されるのはアクティブな広告主のみです。 ## オーディエンスセグメントの管理 セグメントの作成と削除、オーディエンスセグメントからユーザーの追加または削除を行います。コネクタはAPIエンドポイントを使用して、Tealium AudienceStreamインスタンス内のセグメントを取得、作成、削除します。 アカウント管理者のみが動的オーディエンス生成を利用可能にするか、すべての動的に生成されたオーディエンスのデフォルト構成を調整することができます。管理者は価格を構成し、生存時間（TTL）を日数で指定し、データタイプを指定することができます。 セグメントを削除するには、**オーディエンスセグメントの削除**をクリックし、削除するオーディエンスセグメントを選択します。
デフォルトでは、動的にオーディエンスを作成する機能は利用できません。この機能を使用するには、Adform管理者にこの機能を利用可能にするよう依頼してください。
### パートナーレベル パートナーレベルのセグメントを作成するには、**新しいオーディエンスセグメント**をクリックし、以下の構成を構成します： |**構成**| **説明**| |---| ---| | 名前 | (必須) Adformに表示されるオーディエンスの名前。 | | AdformパートナーID | (必須) アカウントのAdformパートナーID。 | | カテゴリID | (必須) オーディエンスが属するカテゴリID。 | | オーナーID | (必須) オーディエンスオーナーID値。 | | 価格 | (必須) オーディエンスごとに構成する価格。 | | データタイプ | データ共有計画に応じてデータタイプを構成します： | | 生存時間（TTL） | (必須) オーディエンスセグメントのデータの寿命。 | | 頻度 | (必須) ユーザーがカテゴリに該当する回数。 | セグメントの状態は、オーディエンスセグメント名の隣に括弧内で表示されます。例：`カート放棄者 (active)` ### オーディエンスマネージャ オーディエンスマネージャのグローバルアカウント用の広告主レベルのオーディエンスを作成するには、**新しいオーディエンスセグメント (オーディエンスマネージャ)** をクリックし、以下の構成を構成します： |**構成**| **説明**| |---| ---| | 名前 | (必須) Adformに表示されるオーディエンスの名前。 | | サードパーティオーディエンスID | (必須) このオーディエンスの一意の外部識別子。ユーザーの追加/削除コールでセグメントIDとして使用されます。 | | カテゴリID | (必須) オーディエンスのカテゴリID。 | | 生存時間（TTL） | (必須) オーディエンスセグメントのデータの寿命。 | | 頻度 | (必須) ユーザーがカテゴリに該当する回数。 | | IDフュージョン | クロスデバイスのアイデンティティ解決のためにIDフュージョンを有効にします。デフォルト：`Yes`。 | | ルックアライク | ルックアライクオーディエンスモデリングを有効にします。デフォルト：`No`。 | ## アクション | アクション名 | AudienceStream | EventStream | | --- | :---: | :---: | |オーディエンスセグメントにユーザーを追加| ✓| ✓| |オーディエンスセグメントからユーザーを削除| ✓| ✓| |オーディエンスセグメントにユーザーを追加 (オーディエンスマネージャ)| ✓| ✓| |オーディエンスセグメントからユーザーを削除 (オーディエンスマネージャ)| ✓| ✓|
Adformセグメントコネクタは`UID`パラメータの送信をサポートしていません。`UID`パラメータが必要な場合、Adformは[Adformタグ](https://docs.tealium.com/adform-tag/)の使用を推奨します。
### オーディエンスセグメントにユーザーを追加 #### パラメータ |**パラメータ**| **説明**| |---| ---| |オーディエンスセグメント (`sg`)| オーディエンスセグメントを選択するか、オーナーIDを入力します。| |AdformパートナーID| (必須) アカウントのAdformパートナーID。| |GAID (`gaid`)| Google広告主訪問ID属性| |IDFA (`idfa`)| Apple広告主識別子| |ファーストパーティデータソース| 含まれているIDに責任を持つソースまたは技術プロバイダーのテキスト。これはトップレベルドメインであるべきです。例えば、`netid.de`| |ファーストパーティエージェントタイプ| ユーザー識別子が来るユーザーエージェントのタイプを識別する整数。可能なエージェントタイプの値： | |ファーストパーティID| ソースプロバイダーからのファーストパーティIDの識別子。これは長い文字列またはGUIDかもしれません。| ### オーディエンスセグメントからユーザーを削除 #### パラメータ |**パラメータ**| **説明**| |---| ---| |オーディエンスセグメント (`sg`)| オーディエンスセグメントを選択するか、オーナーIDを入力します。| |AdformパートナーID| (必須) アカウントのAdformパートナーID。| |GAID (`gaid`)| Google広告主訪問ID属性| |IDFA (`idfa`)| Apple広告主識別子| |ファーストパーティデータソース| 含まれているIDに責任を持つソースまたは技術プロバイダーのテキスト。これはトップレベルドメインであるべきです。例えば、`netid.de`| |ファーストパーティエージェントタイプ| ユーザー識別子が来るユーザーエージェントのタイプを識別する整数。可能なエージェントタイプの値： | |ファーストパーティID| ソースプロバイダーからのファーストパーティIDの識別子。これは長い文字列またはGUIDかもしれません。| ### オーディエンスマネージャのオーディエンスセグメントにユーザーを追加 [オーディエンスセグメントにユーザーを追加](#add-user-to-audience-segment)と同じパラメータを使用します。`sg`パラメータには、オーディエンスマネージャセグメントの**サードパーティオーディエンスID**を使用します。 ### オーディエンスマネージャのオーディエンスセグメントからユーザーを削除 [オーディエンスセグメントからユーザーを削除](#remove-user-from-audience-segment)と同じパラメータを使用します。`sg`パラメータには、オーディエンスマネージャセグメントの**サードパーティオーディエンスID**を使用します。 ## ファーストパーティID Adformは、現在利用可能なすべてのファーストパーティIDソリューションを受け入れます。コネクタは、コール内のオーディエンスにファーストパーティIDを割り当てます。 コネクタは以下のファーストパーティIDをサポートしています： |**プロバイダー名**| **ソース名**| |---| ---| |NetID| `netid.de`| |Britepool| `britepool.com`| |Liveramp (IdentityLink)| `liveramp.com`| |PubCommonID| `id5-sync.com`| |Lotame (Panorama ID)| `crwdcntrl.net`| |Unified ID 2.0| `uidapi.com`| |Prebid Shared ID| `sharedid.org`| |独自のプロプライエタリID| `your-top-level-domain.com` この値は、訪問のスティッチングに使用されるTealium訪問IDをAdformに送信するためにマッピングされる可能性があります。 |