Push APIでのローデータストリーミング

メッセージの特性

使用可能なメッセージタイプ

固有の項目

このセクションでは、SKANで利用できるメッセージ（レポートタイプ）と、メッセージの識別方法について説明します。このセクションを読み、SKAN計測のエンドポイントを設定してください。

関連記事：SKAN ローデータ項目。Push APIメッセージには、同様の構造と項目があります。

メッセージの特性

SKANアトリビューションのメッセージタイプ

SKANアトリビューションのメッセージタイプの決定

注：これは iOSから直接送信されるポストバックコピーのメッセージには適用されません。

サーバーが次の要件に準拠していることを確認してください。

サーバー要件

注意！2秒間のタイムアウトが適用されます。この間にAppsFlyerがOKメッセージを受け取らなかった場合、AppsFlyerはメッセージ送信の失敗と認識します。 

• このチェックリストを使用して、AppsFlyer計測のエンドポイント設定を進めてください。図の数字は、チェックリストの行番号を表しています。
• このセクションはSKAdNetwork計測には関係ありません。SKAdNetwork計測の設定をご覧ください。

エンドポイント

エンドポイント計画テーブル

注意： プッシュAPI設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定を表示できます。

1. Report > API Access に移動します。 Push API セクションまで下にスクロールします。
2. エンドポイントを追加をクリックしてください。
   
3. HTTPを選択してください：POST または GET
4. Endpoint URL を入力してください。このURLは安全ではありません というメッセージが表示された場合は、AppsFlyerサポートにお問い合わせください。
5. 1つまたは複数のイベントタイプを選択してください。注：アプリ内イベントメッセージが無効になっている場合は、アプリ内イベントは記録されていないことを意味します。
6. Push API メッセージを設定するフィールドを選択します。注意：
   
   • 常に送信される必須フィールド：App ID, Event name, Event time, IDFA (iOS) または Advertising ID (Android)
   • 次の図に示すコントロールを使用して、オプションのフィールドを選択します。

     

     • 最も一般的な項目は、デフォルトで選択されています。選択をキャンセルすることができます。
     • 必要に応じて、オプションのフィールドを選択ください。
     • オプションの項目をすべて削除するには、すべてクリアを使用してください。
     • nullまたは空の項目と関連するキーは送信しません。インポート/解析プロセスを検討する際には、このことを考慮してください。
7. 1つまたは複数のイベント（最大52イベント）またはすべてのアプリ内イベントを選択してください。
   
   • リストには、すでに記録されているイベントタイプが表示されます。イベントが見つからない場合は、テストデバイスを使用して、このタイプのイベントを送信します。
8. 保存をクリックしてください。
   Push APIがアクティブになりました。コンバージョンデータはエンドポイントに送信されます。
9. 次の手順を使用して、エンドポイントをテストします。

エンドポイントをテストするには、次の手順を実行します。

1. テスト送信をクリックしてください。テスト送信ボタンの下にテスト結果のメッセージが表示されます。
   テストメッセージがエンドポイントに送信されます。テストに失敗した場合、AppsFlyer IPアドレスを許可リストに追加しているか確認してください。
   注意！タイムアウトメカニズム (2秒間の待機時間) が使用されます。この間にAppsFlyerがOKメッセージを受け取らなかった場合、AppsFlyerはこれをメッセージ送信の失敗と見なします。
2. 御社エンドポイントがテストメッセージを受信したことを確認してください。
   送信されたメッセージのコピーを確認してください。

注意： プッシュAPI設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定を表示できます。

1. Report > API Access に移動します。 Push API セクションまで下にスクロールします。
2. 計測エンティティでSKAdNetworkを選択してください。 
3. エンドポイントを追加をクリックしてください。
   注：アプリごとに1-3個のSKAdNetworkエンドポイントを定義できます。
4. HTTPを選択してください：POST または GET
5. Endpoint URLを入力してください。 このURLは安全ではありません というメッセージが表示された場合は、AppsFlyerサポートにお問い合わせください。
6. nullまたは空の項目と関連するキーは送信しません。インポート/解析プロセスを検討する際には、このことを考慮してください。
7. 保存をクリックしてください。
   Push APIがアクティブになりました。このエンドポイントにデータが送信されます。

Push API 認証トークンを使用すると、クライアントは、要求されたトークンを含むカスタマイズ可能な認証ヘッダーを追加することで、Push-API メッセージをシームレスに統合して保護できます。
Push-API メッセージと共に送信される承認ヘッダーは、各アプリID に関連付けられたトークン名と値を定義することでカスタマイズできます。 これにより、メッセージが安全であるだけでなく、特定の要件に合わせて調整されます。

注意： プッシュAPI設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定を表示できます。

 エンドポイントの設定を変更する方法：

1. レポート > API Access に移動します。Push APIセクションまで下にスクロールします。
2. 変更したいエンドポイントを特定します。
3. 修正を行います。
4. [保存] をクリックします。

注意： プッシュAPI設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定を表示できます。

エンドポイントを削除する方法：

1. レポート > API Accessに移動します。 Push API access セクションまで下にスクロールします。
2. エンドポイントを削除をクリックしてください。
3. [保存] をクリックします。
   エンドポイントが削除されます。

テストメッセージが届かず、IPアドレスでサーバーへのアクセスを制限している場合は、AppsFlyer のすべてのIPアドレスを許可していることを確認してください。

ユーザー獲得リエンゲージメント期間中に、リターゲティングキャンペーンの一環として購入イベントが発生すると、アプリ内イベントのリターゲティングが重複します。これは、ユーザー獲得メディアソースとリターゲティングメディアソースの両方に収益を計上するために行われます。

両方を有効にしている場合にのみ、重複するイベントが発生します。

• インストール後のアプリ内イベント
• リターゲティングアプリ内イベント

アプリ内イベントを特定し重複を排除してください

• アプリ内イベントメッセージは、アプリ内イベントが記録された後にのみ選択できます。
• テストデバイスを使用してアプリ内イベントを生成するか、S2S APIを使用して手動で生成します。

エンドポイントとして Amazon CloudFront を使用している場合は、CloudFront が拒否コード 421 でメッセージを拒否しているかどうかを確認してください。この場合には、CloudFront が HTTPS リクエストを処理する方法の選択を参照してください。

症状：エンドポイントURLを設定すると、このURLは安全ではありません というメッセージが表示されます。

必要なアクション：AppsFlyerサポートに連絡し、アプリID、エンドポイントURL、およびエラーメッセージのスクリーンショットを送信してください。