Google Cloud Pub/Sub コネクタ構成ガイド
この記事では、Google Cloud Pub/Sub コネクタを構成する方法について説明します。Tealiumはコネクタマーケットプレイスで2種類のPub/Subコネクタを提供しています：Google Cloud Pub/Sub コネクタ（3-legged OAuth）とGoogle Cloud Pub/Sub（サービスアカウント）コネクタ（2-legged OAuth）。
アクション
Google Cloud Pub/Sub（サービスアカウント）コネクタ
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| トピックへイベントデータ送信 | ✗ | ✓ |
| カスタムURLでイベントデータ送信 | ✗ | ✓ |
| トピックへ訪問データ送信 | ✓ | ✗ |
| トピックへカスタマイズデータ送信（高度） | ✓ | ✓ |
前提条件
Google Cloud Pub/Sub コネクタ
このコネクタは、クライアントIDとシークレットが必要な三者間OAuthフローを使用して認証します。このコネクタを構成する前に、以下のステップを完了してください：
- Google CloudプロジェクトでウェブアプリケーションタイプのOAuthクライアントIDクレデンシャルを作成します。
- Google Cloudのウェブアプリケーション構成を更新して、Tealiumサーバーを許可リストに追加し、接続成功時に必要なコールバックを提供します。Google Cloudコンソールで認証情報に移動し、OAuthクライアントID構成を以下の値で編集します。各選択について、TealiumインスタンスのURLに使用されるサブドメインに応じて値を追加します。
- 認可された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（サービスアカウント）コネクタ
このコネクタは、Google Cloudサービスアカウントに基づいた二者間OAuthフローを使用します。コネクタを構成する前に、Pub/Subパブリッシャーの役割を持つサービスアカウントをGoogle Cloudプロジェクトで作成してください。サービスアカウントの作成についての詳細は、Google Cloudのドキュメントアクセス制御とIAMを参照してください。サービスアカウントを作成した後、コネクタ構成に使用する以下の構成情報をメモしておきます：
- プロジェクトID
- サービスアカウントのメール
- サービスアカウントキー
構成の構成
コネクタマーケットプレイスに移動して新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについてを参照してください。
コネクタを追加した後、追加したコネクタに基づいて以下の構成を構成します：
Google Cloud Pub/Sub コネクタ
- Google Cloud Platform プロジェクトID
必須。あなたのGoogle Cloud PlatformプロジェクトIDです。 - クライアントID
必須。あなたのGoogle CloudプロジェクトにあるウェブアプリケーションタイプのOAuthクライアントIDです。 - クライアントシークレット
必須。あなたのGoogle Cloudプロジェクトで割り当てられたクライアントシークレットを入力してください。
Google Cloud Pub/Sub（サービスアカウント）コネクタ
- Google Cloud Platform プロジェクトID
必須。あなたのGoogle Cloud PlatformプロジェクトIDです。 - クライアントメール
必須。あなたのGoogle Cloudプロジェクトで使用されるサービスアカウントのメールアドレスです。 - プライベートキー
必須。あなたのGoogle Cloudプロジェクトのサービスアカウントで生成されたプライベートキーです。
アクション構成 - パラメータとオプション
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
パブリッシュするPub/Subトピックにスキーマが添付されている場合は、トピックへカスタマイズデータ送信アクションを使用して、スキーマに合わせた厳密なJSON定義を指定してください。
アクション - トピックへイベントデータ送信
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージ属性 | 属性値をカスタムPub/Subメッセージ属性にマッピングします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は公開されたメッセージで更新された名前を自動的に反映します。 |
| オーダリングキー | オーダリングキーバリューをマッピングまたは入力して、Pub/Subトピックのサブスクライバーが公開された順序でメッセージを受信できるようにします。詳細については、Google: メッセージの順序を参照してください。 |
カスタムURLでイベントデータ送信
| パラメータ | 説明 |
|---|---|
| URLオーバーライド | 必須。データを送信するカスタムURLを入力します。 |
| メッセージ属性 | 属性値をメッセージ属性にマッピングします |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は更新を反映します。 |
| オーダリングキー | オーダリングキーバリューをマッピングまたは入力して、Pub/Subトピックのサブスクライバーが公開された順序でメッセージを受信できるようにします。詳細については、Google: メッセージの順序を参照してください。 |
アクション - トピックへ訪問データ送信
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージ属性 | 属性値をカスタムPub/Subメッセージ属性にマッピングします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| 現在の訪問データを含む | このボックスをチェックすると、公開されたメッセージに訪問データと現在の訪問データの両方が含まれます。 |
| 属性名の印刷 | 属性名が更新された場合、ペイロードの名前は公開されたメッセージで更新された名前を自動的に反映します。 |
| オーダリングキー | オーダリングキーバリューをマッピングまたは入力して、Pub/Subトピックのサブスクライバーが公開された順序でメッセージを受信できるようにします。詳細については、Google: メッセージの順序を参照してください。 |
アクション - トピックへカスタマイズデータ送信（高度）
パラメータ
| パラメータ | 説明 |
|---|---|
| プロジェクトトピック | 必須。メッセージを公開するPub/Subプロジェクトのトピックを選択します。 |
| メッセージデータ | 必須。メッセージデータを構築するための値を提供します。テンプレートサポートの場合、テンプレート名を参照してメッセージデータを生成します。値を単純な1レベルのJSON形式の名前にマッピングするか、テンプレート名を参照してカスタムメッセージ定義オプションのみを選択します。 |
| メッセージ属性 | 属性値をカスタムPub/Subメッセージ属性にマッピングします。Toドロップダウンリストでメッセージ属性キーを入力します。 |
| テンプレート変数 | テンプレートでデータ入力としてテンプレート変数を提供します。詳細については、テンプレート変数ガイドを参照してください。ドット表記を使用してネストされたテンプレート変数に名前を付けます。例：items.name。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
| テンプレート | メッセージ属性またはデータで参照されるテンプレートを提供します。詳細については、テンプレートガイドを参照してください。テンプレートは、サポートされているフィールドに名前で二重中括弧で注入されます。例： {{SomeTemplateName}}。 |
| オーダリングキー | オーダリングキーバリューをマッピングまたは入力して、Pub/Subトピックのサブスクライバーが公開された順序でメッセージを受信できるようにします。詳細については、Google: メッセージの順序を参照してください。 |
ベンダー文書
最終更新日 :: 2025年March月14日