Google Display & Video 360 Customer Match コネクタ構成ガイド | サーバーサイドコネクタ

API情報

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

API名：Google Audience Partner API
APIバージョン：v1
APIエンドポイント：https://audiencepartner.googleapis.com/v1
ドキュメンテーション：Google Ads API: Customer Matchの開始方法

コネクタアクション

アクション名	AudienceStream	EventStream
Customer Matchリストに追加	✓	✓
Customer Matchリストから削除	✓	✓
Customer Matchリストに追加（複数の識別子）	✓	✓
Customer Matchリストから削除（複数の識別子）	✓	✓

要件

このコネクタを構成する前に、Google Display & Video 360アカウントでTealiumをリンクしたアカウントとして追加してください。

詳細については、Google Display & Video 360: 外部データ管理プラットフォームまたはカスタマーマッチアップローダーパートナーからのオーディエンスリストの共有を参照してください。

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについてを参照してください。

このコネクタを追加すると、ベンダーのデータプラットフォームポリシーを受け入れるように求められます。

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

顧客ID
- 必須。 TealiumにリンクされたGoogle DV360パートナーID。Google DV360ダッシュボードからパートナーIDを見つけるには、パートナー構成 > 基本詳細に移動します。
ターゲット製品
- 必須。 リンクされたアカウントのターゲット製品。

コネクタの構成が完了したら、完了をクリックします。

アクション構成 — パラメータとオプション

続行をクリックしてコネクタアクションを構成します。アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

複数の識別子を渡す場合を除き、単一の識別子アクションを使用することをお勧めします。

ユーザー識別子

各アクションはユーザー識別子を必要とし、これらの値は正規化され、SHA-256を使用してハッシュ化される必要があります。マッピングされる各ユーザー識別子の値は以下の要件を満たす必要があります：

小文字
テキストの始めと終わりから空白を削除
SHA-256でハッシュ化

すでに正規化されハッシュ化された属性をマッピングすることも、コネクタにそれらを正規化しハッシュ化させることもできます。シナリオに適したマッピングを選択します。

選択するUser Listタイプによって、ユーザー識別子のタイプが決まります。User Listタイプは以下のいずれかになります：

CONTACT_INFO
MOBILE_ADVERTISING_ID

以下のユーザー識別子フィールドがサポートされています：

ユーザー識別子フィールド説明

ユーザー識別子フィールド	説明
`CONTACT_INFO`	ハッシュ化されたメール、ハッシュ化された電話番号、または住所情報を提供します。住所情報：国コード - ユーザーの住所の2文字の国コードをISO-3166-1 alpha-2形式で提供します。住所情報：名（すでにSHA256でハッシュ化） - 空白を削除し、小文字にした名前を提供します。この値はSHA256でハッシュ化されています。住所情報：名（SHA256ハッシュを適用） - プレーンテキストの名前を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。住所情報：姓（すでにSHA256でハッシュ化） - 空白を削除し、小文字にした姓を提供します。この値はSHA256でハッシュ化されています。住所情報：姓（SHA256ハッシュを適用） - プレーンテキストの姓を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。住所情報：郵便番号 - ユーザーの住所の郵便番号を提供します。メールアドレス（すでにSHA256でハッシュ化） - 空白を削除し、小文字にしたメールアドレスを提供します。この値はSHA256でハッシュ化されています。メールアドレス（SHA256ハッシュを適用） - プレーンテキストのメールアドレスを提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。電話番号（すでにSHA256でハッシュ化） - 空白を削除した電話番号を提供します。この値はSHA256でハッシュ化されています。電話番号（SHA256ハッシュを適用） - プレーンテキストの電話番号を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。
`MOBILE_ADVERTISING_ID`	モバイルID（必須） - モバイルデバイスID（広告ID/IDFA）。

CONTACT_INFO

ハッシュ化されたメール、ハッシュ化された電話番号、または住所情報を提供します。
住所情報：国コード - ユーザーの住所の2文字の国コードをISO-3166-1 alpha-2形式で提供します。
住所情報：名（すでにSHA256でハッシュ化） - 空白を削除し、小文字にした名前を提供します。この値はSHA256でハッシュ化されています。
住所情報：名（SHA256ハッシュを適用） - プレーンテキストの名前を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。
住所情報：姓（すでにSHA256でハッシュ化） - 空白を削除し、小文字にした姓を提供します。この値はSHA256でハッシュ化されています。
住所情報：姓（SHA256ハッシュを適用） - プレーンテキストの姓を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。
住所情報：郵便番号 - ユーザーの住所の郵便番号を提供します。
メールアドレス（すでにSHA256でハッシュ化） - 空白を削除し、小文字にしたメールアドレスを提供します。この値はSHA256でハッシュ化されています。
メールアドレス（SHA256ハッシュを適用） - プレーンテキストのメールアドレスを提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。
電話番号（すでにSHA256でハッシュ化） - 空白を削除した電話番号を提供します。この値はSHA256でハッシュ化されています。
電話番号（SHA256ハッシュを適用） - プレーンテキストの電話番号を提供します。コネクタはこの値をSHA256ハッシュでハッシュ化します。

MOBILE_ADVERTISING_ID

モバイルID（必須） - モバイルデバイスID（広告ID/IDFA）。

アクション — Customer Matchリストに追加（単一の識別子）

バッチ制限

このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、以下のいずれかの閾値が達成されるか、プロファイルが公開されるまでキューに入れられます：

リクエストの最大数：100000
最も古いリクエストからの最大時間：1440分
リクエストの最大サイズ：50MB

パラメータ

パラメータ	説明
Customer Matchリスト	Customer Matchリストを選択します。Tealiumコネクタで作成されたリストのみが利用可能です。

アクション — Customer Matchリストから削除（単一の識別子）

バッチ制限

リクエストの最大数：100000
最も古いリクエストからの最大時間：1440分
リクエストの最大サイズ：50MB

パラメータ

パラメータ	説明
Customer Matchリスト	Customer Matchリストを選択します。Tealiumコネクタで作成されたリストのみが利用可能です。

アクション — Customer Matchリストに追加（複数の識別子）

バッチ制限

リクエストの最大数：33000
最も古いリクエストからの最大時間：1440分
リクエストの最大サイズ：50MB

パラメータ

パラメータ	説明
Customer Matchリスト	Customer Matchリストを選択します。Tealiumコネクタで作成されたリストのみが利用可能です。

アクション — Customer Matchリストから削除（複数の識別子）

バッチ制限

リクエストの最大数：33000
最も古いリクエストからの最大時間：1440分
リクエストの最大サイズ：50MB

パラメータ

パラメータ	説明
Customer Matchリスト	Customer Matchリストを選択します。Tealiumコネクタで作成されたリストのみが利用可能です。