Nextdoor コネクタ構成ガイド

API 情報

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

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

構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

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

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

アクション

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

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

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

コンバージョン送信

パラメータ

パラメータ	説明
イベント名	コンバージョン追跡イベントのタイプ。リストから値を選択するか、カスタム文字列値を入力します。利用可能な値には、`Add to Cart`、`Initiate Checkout`、`Search`、`Add to Wishlist`、`Subscribe`、`View Content`があります。
アクションソース	コンバージョンが発生するチャネル。ドロップダウンリストから値を選択します。

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

パラメータ	説明
クライアントID	Nextdoor Ads Manager 広告主ID。データソースIDまたはクライアントIDが必要です。
データソースID	Nextdoor Ads Manager データソースID。データソースIDまたはクライアントIDが必要です。
パートナーID	単一のパートナーに関連付けられた Nextdoor 生成のID。この値はすべての Conversion API コールで必要です。
アクションソースURL	イベントが発生したブラウザのURL。URLは `http://` または `https://` で始まり、検証済みドメインと一致する必要があります。この値はウェブサイトイベントに必要です。
イベントID	一意のイベントを識別できる文字列またはハッシュ化されたID。これは、CAPIとピクセル追跡からのイベントの重複を防ぐために必要です。イベントIDまたは自動重複排除が必要です。
イベント時間	イベントのタイムスタンプを ISO 8601 形式で表示します。イベント時間エポックまたはイベント時間が必要です。
イベント時間エポック	`1970-01-01` からの秒数。ミリ秒は含まれません。イベント時間エポックまたはイベント時間が必要です。
テストイベント	このイベントがテストイベントであるかどうかを示します。デフォルト値は `False` です。
イベントタイムゾーン	コンバージョンイベントが発生した場所のタイムゾーンを示します。

顧客データ

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

パラメータ	説明
メールアドレス（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化されたメールアドレスを提供します。
メールアドレス（SHA256ハッシュを適用）	平文のメールアドレスを提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
外部ID	広告主からのユニークID、例えばロイヤルティ会員ID、ユーザーID、外部クッキーIDなど。特定のイベントに対して1つ以上の外部IDを送信できます。他のチャネルを通じて外部IDを送信する場合は、Conversions APIと同じ形式を使用してください。
電話番号（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された電話番号を提供します。
電話番号（SHA256ハッシュを適用）	平文の電話番号を提供し、コネクタがこの値を空白トリムし、SHA256ハッシュを使用してハッシュ化します。
名（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された名を提供します。
名（SHA256ハッシュを適用）	平文の名を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
姓（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された姓を提供します。
姓（SHA256ハッシュを適用）	平文の姓を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
生年月日（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化され、`YYYYMMDD` 形式の生年月日を提供します。
生年月日（SHA256ハッシュを適用）	平文の生年月日を提供し、コネクタがこの値を空白トリムし、`YYYYMMDD` 形式でSHA256ハッシュを使用してハッシュ化します。
住所（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された住所を提供します。
住所（SHA256ハッシュを適用）	平文の住所を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
市区町村（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された市区町村を提供します。
市区町村（SHA256ハッシュを適用）	平文の市区町村を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
州（既にSHA256ハッシュ化済み）	既に小文字化された2文字の ANSI省略コード形式の州略語を提供します。
州（SHA256ハッシュを適用）	州略語を提供し、コネクタがこの値を空白トリム、小文字化し、2文字の ANSI省略コード形式でSHA256ハッシュを使用してハッシュ化します。
郵便番号（既にSHA256ハッシュ化済み）	既にSHA256ハッシュ化された郵便番号を提供します。
郵便番号（SHA256ハッシュを適用）	平文の郵便番号を提供し、コネクタがこの値を空白トリム、小文字化し、SHA256ハッシュを使用してハッシュ化します。
国（既にSHA256ハッシュ化済み）	既に空白トリムされ、SHA256ハッシュ化された ISO 3166-1 alpha-2 形式の2文字の国コードを提供します。
国（SHA256ハッシュを適用）	平文の国コードを提供し、コネクタがこの値を空白トリム、小文字化し、ISO 3166-1 alpha-2 形式でSHA256ハッシュを使用してハッシュ化します。
クリックID	クリックスルーURLに添付された `ndclid` パラメータと同じです。
クライアントIPアドレス	イベントに対応するブラウザのIPアドレスは、有効なIPV4またはIPV6アドレスである必要があります。IPV6対応ユーザーの場合、IPV4よりもIPV6が望ましいです。正確なイベントレポートを保証するために、常に実際のIPアドレスを提供してください。この値をハッシュ化しないでくださいすべてのイベントに対してクライアントIPアドレスおよびユーザーエージェントパラメータを提供することで、キャンペーンのイベントマッチングと広告配信が向上する可能性があります。この情報はブラウザを通じて送信されるイベントに自動的に追加されますが、サーバーを通じて送信されるイベントの場合は手動で構成する必要があります。
クライアントユーザーエージェント	イベントに対応する未ハッシュ化のブラウザユーザーエージェント。このパラメータは、Conversions APIを使用して共有されるウェブサイトイベントに必要です。すべてのイベントに対してクライアントIPアドレスおよびユーザーエージェントパラメータを送信することで、キャンペーンのイベントマッチングと広告配信が向上する可能性があります。この情報はブラウザを通じて送信されるイベントに自動的に追加されますが、サーバーを通じて送信されるイベントの場合は手動で構成する必要があります。
配信最適化	`True`：データを最適化に使用できることを示します。 `False`：データは帰属のみに使用されることを示します。

カスタムイベントとアプリイベント

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

商品コンテキスト

パラメータ	説明
ID	(必須) 商品ID。
コンテンツ名	商品名。
数量	商品の数量。
アイテム価格	商品の価格。
アプリ追跡有効	ATTのユーザーオプトアウト構成。アプリイベントを追跡し、Conversions APIを通じてNextdoorに送信するかどうかを指定します。 `False`: アプリイベントの追跡を無効にします。アプリイベントはNextdoorに送信されません。 `True`: アプリイベントの追跡を有効にします。アプリイベントはNextdoorに送信され、帰属と測定のために使用されます。

自動重複排除

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