Nextdoor コネクタ構成ガイド | サーバーサイドコネクター

API 情報

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

API 名：Nextdoor API
API バージョン：v2
API エンドポイント：https://ads.nextdoor.com/v2/api
ドキュメント：Nextdoor API

コネクタのアクション

アクション名	AudienceStream	EventStream
コンバージョン送信	✗	✓

構成の構成

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

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

API トークン
(必須) ログインしているユーザーとその関連アカウントに固有の認証トークンを Nextdoor Ads Manager アカウントページで取得します。

アクション

アクション名を入力し、ドロップダウンメニューからアクションタイプを選択します。

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

コンバージョン送信

パラメータ

パラメータ	説明
イベント名	コンバージョン追跡イベントのタイプ。ドロップダウンリストから値を選択するか、カスタム文字列値を入力します。
アクションソース	コンバージョンが発生したチャネル。ドロップダウンリストから値を選択します。

コンバージョンイベントパラメータ

パラメータ	説明
クライアントID	Nextdoor Ads Manager 広告主ID。データソースIDまたはクライアントIDが必要です。
データソースID	Nextdoor Ads Manager データソースID。データソースIDまたはクライアントIDが必要です。
パートナーID	Nextdoor が生成した単一のパートナーに関連付けられたID。この値はすべてのコンバージョンAPIコールで必要です。
アクションソースURL	イベントが発生したブラウザのURL。URLは `http://` または `https://` で始まり、検証済みドメインと一致する必要があります。この値はウェブサイトイベントに必要です。
イベント時間	ISO 8601 形式のイベントのタイムスタンプ。
イベント時間エポック	`1970-01-01` からの秒数。ミリ秒は含まれません。イベント時間エポックまたはイベント時間が必要です。
テストイベント	この値は、このイベントがテストイベントであることを示します。デフォルト値は `False` です。
イベントタイムゾーン	コンバージョンイベントが発生した場所のタイムゾーンを示します。

顧客データ

統合には、次のパラメータのうち少なくとも1つまたは組み合わせが必要です：メールアドレス、電話番号、またはクリックID。

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みのメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	平文のメールアドレスを提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
電話番号（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの電話番号を提供します。
電話番号（SHA256ハッシュを適用）	平文の電話番号を提供し、コネクタはこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。
名（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの名を提供します。
名（SHA256ハッシュを適用）	平文の名を提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
姓（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの姓を提供します。
姓（SHA256ハッシュを適用）	平文の姓を提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
生年月日（既にSHA256ハッシュ化済み）	`YYYYMMDD` 形式でSHA256ハッシュ化済みの生年月日を提供します。
生年月日（SHA256ハッシュを適用）	平文の生年月日を提供し、コネクタはこの値を空白トリムし、SHA256ハッシュを使用して `YYYYMMDD` 形式でハッシュ化します。
住所（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの住所を提供します。
住所（SHA256ハッシュを適用）	平文の住所を提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
市区町村（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの市区町村を提供します。
市区町村（SHA256ハッシュを適用）	平文の市区町村を提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
州（既にSHA256ハッシュ化済み）	2文字の ANSI省略コードで小文字化された州の省略形を提供します。
州（SHA256ハッシュを適用）	州の省略形を提供し、コネクタはこの値を空白トリムし、小文字に変換し、2文字の ANSI省略コードでSHA256ハッシュを使用してハッシュ化します。
郵便番号（既にSHA256ハッシュ化済み）	SHA256ハッシュ化済みの郵便番号を提供します。
郵便番号（SHA256ハッシュを適用）	平文の郵便番号を提供し、コネクタはこの値を空白トリムし、小文字に変換し、SHA256ハッシュを使用してハッシュ化します。
国（既にSHA256ハッシュ化済み）	ISO 3166-1 alpha-2 で空白トリムされ、SHA256ハッシュ化された2文字の国コードを提供します。
国（SHA256ハッシュを適用）	平文の国コードを提供し、コネクタはこの値を空白トリムし、小文字に変換し、ISO 3166-1 alpha-2 を使用してSHA256ハッシュを使用してハッシュ化します。
クリックID	クリックスルーURLに添付された `ndclid` パラメータと同じです。
クライアントIPアドレス	有効なIPv4またはIPv6アドレスを提供します。
クライアントユーザーエージェント	イベントに対応する未ハッシュ化のブラウザユーザーエージェント。このパラメータはウェブサイトイベントで共有される Conversions API を使用する場合に必要です。すべてのイベントにクライアントIPアドレスとユーザーエージェントのパラメータを送信することで、イベントマッチングとキャンペーンの広告配信が向上する可能性があります。この情報はブラウザを通じて送信されるイベントに自動的に追加されますが、サーバーを通じて送信されるイベントの場合は手動で構成する必要があります。
配信最適化	`True` - データを最適化に使用できることを示します。 `False` - データは帰属にのみ使用されます。

カスタムおよびアプリイベント

パラメータ	説明
注文価値	(必須) 購入イベントに必要です。ISO 4217 形式の通貨コードに続いて、イベントに関連付けられた合計数値値（小数点以下2桁まで）を指定します。
注文ID	トランザクションの注文ID。この値はオフラインイベントに必要です。
アプリID	広告主に固有のIDに対応します。App StoreおよびGoogle Play StoreからのモバイルアプリIDを使用します。
プラットフォーム	ユーザーのプラットフォーム。値は `iOS` または `Android` です。
アプリバージョン	モバイルアプリバージョン。
配信カテゴリ	店内 - 顧客は購入した商品を受け取るために店内に入る必要があります。カーブサイド - 顧客は店に車で行き、車内で待機して注文を受け取ります。ホームデリバリー - 購入した商品が顧客の自宅に配送されます。

製品コンテキスト

パラメータ	説明
ID	(必須) 製品ID。
コンテンツ名	製品名。
数量	製品数量。
アイテム価格	製品のアイテム価格。
アプリ追跡有効	ユーザーがApp Tracking Transparency (ATT) のオプトアウトを選択したかどうかを示します。

自動重複排除

パラメータ	説明
自動重複排除	Tealium iQ タグ ID を提供すると、コネクタは Tealium iQ が送信するイベント ID の値を自動的に検索します。