Impact Conversionsコネクタ設定ガイド | サーバーサイドコネクタ

コネクタのアクション

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

設定の構成

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

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

アカウントSID
必須。Impactによって定義されます（例：MhyXaouO5Ijnw658m6kXoqwlo1IasLKJBX）
認証トークン
必須。Impactによって定義されます（例：t0k5Lr3GciUAqR0JNj1CzxKE2XTEmK5i）

アクション

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

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

アクション - コンバージョンの送信

コンバージョンパラメータ

以下の2つのパラメータを含める必要があります：

パラメータ	説明
キャンペーンID	(必須) Impactが提供する一意の整数型のキャンペーン識別子。
注文ID	(必須) アプリ内コンバージョンの一意の英数字の追跡可能なID。

以下の2つのパラメータのうち1つを含める必要があります：

パラメータ	説明
アクショントラッカーID	Impactが提供する一意の整数型のトラッカー識別子。
イベントタイプコード	コンバージョンイベントのタイプ。Impactプラットフォームのイベントタイプ > アクション > 表示/編集 > コードに移動して、すべてのコードを表示します。

以下のアトリビューションキーパラメータのうち少なくとも1つを含める必要があります：

パラメータ	説明
カスタムプロファイルID	広告主が自身で設定したユーザ識別子の文字列値。ユーザが初回訪問イベントを記録した際にカスタムプロファイルIDが渡された場合、ここでも同じカスタムプロファイルIDの値を渡す必要があります。
クリックID	ランディングページのURLまたはPage Load APIのレスポンスで取得したクリックIDの文字列値。
顧客ID	あなたのプラットフォームが顧客アカウントに割り当てる一意の英数字の顧客識別子。
ユニークコンバージョンURL	コンバージョンを紹介したパートナーまたはソースのユニークなURL。このパラメータは、ユニークなドメインをパートナーに設定して割り当てる場合にのみ使用します。
Google広告ID	顧客がコンバージョンしたモバイルデバイスに関連付けられたGoogle広告ID。
IDFA	顧客がコンバージョンしたモバイルデバイスに関連付けられたAppleの広告ID（IDFA）。
IDFV	顧客がコンバージョンしたモバイルデバイスに関連付けられたAppleのベンダーID（IDFV）。
メディアID	アトリビューションを強制したいパートナーまたはソースの一意の識別子。

以下の追加パラメータが利用可能です：

パラメータ	説明
デバイス製造元	顧客がコンバージョンに使用したモバイルデバイスの製造元。 Android: `manufacturer = android.os.Build.MANUFACTURER;` Apple: `NSString *manufacturer = @"Apple";`
アプリパッケージ	ユーザがインストールしたモバイルアプリのパッケージ名。モバイルコンバージョンのみに適用します。
アプリインストールリファラー	アプリがインストールされたときにGoogle Play Storeが渡すインストールリファラー。Androidコンバージョンのみに適用します。
アプリバージョン	モバイルアプリのバージョン。モバイルコンバージョンのみに適用します。
コールID	コールトラッキングコンバージョンの顧客の一意の識別子。この値は、コンバージョンを発生させた元のコールレコードとのマッチングに使用されます。
ロケーションID	宿泊イベントに使用され、このコンバージョンで指定されたロケーションの一意の識別子です。
ロケーション名	宿泊イベントに使用され、このコンバージョンで指定されたロケーションの名前です。
ロケーションタイプ	宿泊イベントに使用され、このコンバージョンで指定されたロケーションのカテゴリです。
プロパティID	モバイルアプリのコンバージョンの場合、この値は`impact.com`上のアプリのシステムアプリIDです。この値を見つけるには、Impactプラットフォームの設定 > モバイルアプリに移動します。
トラッキング同意	ユーザがリクエストの時点でトラッキングに同意を提供したかどうかを示します。これは、あなたの同意管理プラットフォームまたはAppleのATT（App Tracking Transparency）のようなフレームワークを通じて導出されます。
顧客の都市	顧客の都市。
ディスポジションコード	Impactのイベントタイプ設定でカスタムディスポジションコードを設定している場合、このコンバージョンから生じるアクションのデフォルトのディスポジションとしてその値を提出できます。
顧客のメール	顧客のメールのSHA1ハッシュ文字列。
顧客のステータス	`New`または`Returning`の文字列値を使用します。
顧客の郵便番号	顧客の郵便番号。
支払いタイプ	注文の支払いタイプを表す文字列。
注文リベート	注文リベートの金額を表す小数。報告のみに使用します。
イベント日	`NOW`の文字列値またはISO-8601または"dd-MMM-yyyy HH:mm:ss z"形式の日付を使用します。`NOW`がデフォルトで使用されます。
注文プロモーションコード	クーポンまたはプロモーションコードの文字列。注文にプロモーションコードがない場合は、空の文字列を使用します。デフォルト値は空の文字列です。このパラメータは単一のコードのみをサポートし、複数のコードはサポートしていません。
通貨コード	販売アクションに必要です。デフォルトでは`USD`が使用されます。ISO 4217の通貨コードを受け入れます。
ユーザーエージェント	ブラウザとオペレーティングシステムを識別する文字列。
IPアドレス	顧客のIPアドレスを表す文字列。

コンバージョン販売アイテム

アイテムレベルの詳細を渡す場合、以下のアイテムパラメータが必要です：

すべての配列とリストは等しい長さでなければなりません。単一値の属性は、他のすべての配列と同じ長さの配列に展開され、値が繰り返されます。

パラメータ	説明
アイテムカテゴリ	アイテムカテゴリ識別子の文字列型。Impactに渡すためのキーに配列とリストの値をマップします。
アイテムSKU	アイテム固有の英数字識別子。Impactに渡すためのキーに配列とリストの値をマップします。
アイテム小計	Impactに渡すためのキーに配列とリストの値をマップします。
アイテム数量	ラインアイテムの数量を表す整数値。Impactに渡すためのキーに配列とリストの値をマップします。
アイテム価格	このアイテムの各製品の個別の単価。アイテム小計を使用する場合、このパラメータに値を設定しないでください。

以下のアイテムパラメータはオプションです：

パラメータ	説明
アイテムプロモーションコード	注文のアイテムに適用されたプロモーションコード。このパラメータは特定のパートナーに設定されたユニークなトラッキングコードとは動作しません。
アイテム合計割引	このラインアイテムに適用された割引（このタイプの各製品に対してだけではない）。この金額は自動的にItemSubTotalから差し引かれ、支払いと報告目的のための最終販売額を決定します。
アイテムサブカテゴリ	該当する場合、アイテムレベルで参照される製品のサブカテゴリ。
アイテム名	参照される製品の名前。
アイテムMPN	参照される製品の製造元部品番号（MPN）。
アイテムブランド	参照される製品のブランド名。
アイテム割引	このタイプのアイテムを購入した各アイテムに適用された割引。
アイテム配送タイプ	このアイテムに指定された配送方法のタイプ、例えば、`STORE`。
支払いタイプ	注文の支払いタイプを表す文字列。
注文割引後の小計	アイテムの報告がない注文レベルのコンバージョンの報告に使用されます。割引、税金、送料、その他の費用を差し引いた後の注文の小計。アイテムレベルのデータを提出する場合、この値を設定しないでください。
注文割引	販売の場合、これは注文全体に適用された割引です。割引は自動的に注文合計から処理時に差し引かれます。アイテムの金額が使用される場合、割引は送信された各アイテムの金額から比例的に差し引かれます。送料は含めないでください。
注文送料	このパラメータは主に小売販売に使用されます。これはこのコンバージョンの送料です。送料は支払い目的の合計販売額には含めないでください。
注文税金	このパラメータは主に小売販売に使用されます。これはこのコンバージョンの税金です。送料は支払い目的の合計販売額には含めないでください。
注文マージン	このパラメータは主に小売販売に使用されます。これはコンバージョンで得られた総マージン（収益からコストを差し引いたもの）です。通常、これは`ItemMargin`パラメータを通じてアイテムレベルで提供されるか、製品カタログを通じて提供されます。
ギフト購入	ギフト購入を追跡している場合、コンバージョンの注文をギフト購入としてマークするために`true`に設定します。注文がギフト購入でない場合は`false`に設定します。