Google Cloud Pub/Sub コネクタ構成ガイド
この記事では、Google Cloud Pub/Subコネクタの構成方法について説明します。Tealiumは、コネクタマーケットプレイスで2つのPub/Subコネクタを提供しています：Google Cloud Pub/Subコネクタ（3-legged OAuth）とGoogle Cloud Pub/Sub（Service Account）コネクタ（2-legged OAuth）。
コネクタのアクション
Google Cloud Pub/Sub コネクタ
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トピックへのイベントデータの送信 | ✗ | ✓ |
| トピックへの訪問データの送信 | ✓ | ✗ |
| トピックへのカスタマイズデータの送信（アドバンス） | ✓ | ✓ |
| トピックへのログイベントの送信 | ✓ | ✓ |
アクション
Google Cloud Pub/Sub (Service Account) コネクタ
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トピックへのイベントデータの送信 | ✗ | ✓ |
| カスタムURLを使用したイベントデータの送信 | ✗ | ✓ |
| トピックへの訪問データの送信 | ✓ | ✗ |
| トピックへのカスタマイズデータの送信（アドバンス） | ✓ | ✓ |
| トピックへのログイベントの送信 | ✓ | ✓ |
前提条件
Google Cloud Pub/Sub コネクタ
このコネクタは、ユーザー入力を必要とするクライアントIDとシークレットを使用した3-legged OAuthフローを使用して認証します。このコネクタを構成する前に、以下の手順を完了してください：
- Google Cloudプロジェクトで、アプリケーションタイプがウェブアプリケーションのOAuthクライアントID資格情報を作成します。
- Tealiumサーバーを許可リストに追加し、接続成功時に必要なコールバックを提供するために、Google Cloudウェブアプリケーションの構成を更新します。Google CloudコンソールでCredentialsに移動し、以下の値でOAuthクライアントIDの構成を編集します。各選択肢について、TealiumインスタンスのURLで使用されるサブドメインに応じて値のうちの1つを追加します。
- 認証済みJavaScriptの起源：
https://my.tealiumiq.comhttps://my.tealiumiq.comhttps://[privatecloud subdomain].tealiumiq.com
- 認証済みリダイレクトURI：
https://my.tealiumiq.com/oauth/google/callback.htmlhttps://my.tealiumiq.com/oauth/google/callback.htmlhttps://[private cloud subdomain].tealiumiq.com/oauth/google/callback.html
- 認証済みJavaScriptの起源：
- コネクタ構成で使用する以下の構成をメモしておきます
- プロジェクトID
- クライアントID
- クライアントシークレット
Google Cloud Pub/Sub (Service Account) コネクタ
このコネクタは、Google Cloudサービスアカウントに基づいた2-legged OAuthフローを使用し、アクセスします。コネクタを構成する前に、Pub/Sub Publisherの役割を持つGoogle Cloudプロジェクトでサービスアカウントを作成します。サービスアカウントの作成についての詳細は、Google CloudドキュメンテーションのAccess Control with IAMを参照してください。サービスアカウントを作成した後、コネクタ構成で使用する以下の構成をメモしておきます：
- プロジェクトID
- サービスアカウントのメール
- サービスアカウントのキー
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法についての一般的な指示については、About Connectorsを参照してください。
コネクタを追加した後、追加したコネクタに基づいて以下の構成を構成します：
Google Cloud Pub/Sub コネクタ
- Google Cloud Platform Project ID
必須。あなたのGoogle Cloud Platform Project ID。 - Client ID
必須。アプリケーションタイプがウェブアプリケーションのGoogle CloudプロジェクトのOAuthクライアントID。 - Client Secret
必須。あなたのGoogle Cloudプロジェクトであなたに割り当てられたクライアントシークレットを入力します。
Google Cloud Pub/Sub (Service Account) コネクタ
- Google Cloud Platform Project ID
必須。あなたのGoogle Cloud Platform Project ID。 - Client Email
必須。あなたのGoogle Cloudプロジェクトで使用されるサービスアカウントのメールアドレス。 - Private Key
必須。あなたのGoogle Cloudプロジェクトのサービスアカウント用に生成されたプライベートキー。
アクション構成 - パラメータとオプション
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
Pub/Subトピックにスキーマが添付されている場合、トピックへのカスタマイズデータの送信アクションを使用して、スキーマに一致する厳密なJSON定義を指定します。
アクション - トピックへのイベントデータの送信
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージ属性 | カスタムPub/Subメッセージ属性に属性値をマップします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は自動的に公開されたメッセージで更新された名前を反映します。 |
| オーダリングキー | Pub/Subトピックの購読者がメッセージを公開された順序で受信できるように、オーダリングキー値をマップまたは入力します。詳細については、Google: Order messagesを参照してください。 |
カスタムURLを使用したイベントデータの送信
| パラメータ | 説明 |
|---|---|
| URL Override | 必須。データを送信するカスタムURLを入力します。 |
| メッセージ属性 | メッセージ属性に値をマップします |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は更新を反映します。 |
| オーダリングキー | Pub/Subトピックの購読者がメッセージを公開された順序で受信できるように、オーダリングキー値をマップまたは入力します。詳細については、Google: Order messagesを参照してください。 |
アクション - トピックへの訪問データの送信
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージ属性 | カスタムPub/Subメッセージ属性に属性値をマップします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| 現在の訪問データを含める | このボックスをチェックすると、公開されたメッセージに訪問データと現在の訪問データの両方が含まれます。 |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は自動的に公開されたメッセージで更新された名前を反映します。 |
| オーダリングキー | Pub/Subトピックの購読者がメッセージを公開された順序で受信できるように、オーダリングキー値をマップまたは入力します。詳細については、Google: Order messagesを参照してください。 |
アクション - トピックへのカスタマイズデータの送信（アドバンス）
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージデータ | 必須。メッセージデータを構築するための値を提供します。テンプレートサポートの場合、テンプレート名を参照してテンプレートからメッセージデータを生成します。単純な1レベルのJSON形式の場合は、名前に値をマップします。それ以外の場合は、テンプレート名を参照し、Custom Message Definitionオプションのみを選択します。 |
| メッセージ属性 | カスタムPub/Subメッセージ属性に属性値をマップします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| テンプレート変数 | テンプレートのデータ入力としてテンプレート変数を提供します。詳細については、Template Variables Guideを参照してください。ネストされたテンプレート変数はドット表記で名前を付けます。例：items.name。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | メッセージ属性またはデータで参照されるテンプレートを提供します。詳細については、Templates Guideを参照してください。テンプレートは、名前でサポートされるフィールドに二重中括弧で挿入されます。例： {{SomeTemplateName}}。 |
| オーダリングキー | Pub/Subトピックの購読者がメッセージを公開された順序で受信できるように、オーダリングキー値をマップまたは入力します。詳細については、Google: Order messagesを参照してください。 |
トピックへのログイベントの送信
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。ログイベントを送信するトピックを選択します。 |
| メッセージ属性 | メッセージ属性に値をマップします。 |
ベンダー文書
最終更新日 :: 2025年January月10日