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

メッセージの特性

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

固有の項目

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

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

メッセージの特性

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

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

サーバー要件

注意！ 3秒間の待機時間をもつタイムアウトメカニズムが使用されます。この間にAppsFlyerがOKメッセージを受け取らなかった場合、AppsFlyerはこれをメッセージ送信の失敗と見なします。 

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

エンドポイント

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

注：Push API設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定の閲覧のみ可能です。

AppsFlyer計測のエンドポイントを追加する方法：

1. エクスポート > API Access に移動します。 Push API セクションまで下にスクロールします。
2. エンドポイントを追加をクリックしてください。
    
3. HTTPメソッドを選択します： POST または GET
4. Endpoint URLを入力してください。 このURLは安全ではありませんというメッセージが表示された場合は、AppsFlyerサポートにお問い合わせください。
5. 1つまたは複数のイベントタイプを選択してください。　注：アプリ内イベントメッセージが無効になっている場合は、アプリ内イベントは記録されていないことを意味します。
6. Push APIメッセージを設定するフィールドを選択します。注記：
   • 必須項目は常に送信されます：アプリID、イベント名、イベント時間、IDFA（iOS）または広告ID（Android）
   • 次の図に示すコントロールを使用して、オプションのフィールドを選択します。 
     • 最も一般的なフィールドは、デフォルトで選択されています。選択をキャンセルすることができます。
     • 必要に応じて、オプションのフィールドを選択ください。
     • オプションの項目をすべて削除するには、すべてクリアを使用してください。
     • nullまたは空の項目と関連するキーは送信しません。インポート/解析プロセスを検討する際には、このことを考慮してください。
7. 1つまたは複数のイベント（最大52イベント）またはすべてのアプリ内イベントを選択してください。
   • リストには、すでに記録されているイベントタイプが表示されます。イベントが見つからない場合は、テストデバイスを使用して、このタイプのイベントを送信します。
8. 保存をクリックしてください。
   Push APIがアクティブになりました。コンバージョンデータはエンドポイントに送信されます。
9. 次の手順を使用して、エンドポイントをテストします。

エンドポイントのテスト

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

注：Push API設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定の閲覧のみ可能です。

SKAdNetwork Push APIエンドポイントの追加：

1. エクスポート > 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メッセージをシームレスに統合し、保護できます。
各アプリIDに紐づくトークン名と値を定義することで、Push APIメッセージと共に送信されるauthorizationヘッダーをカスタマイズできます。これにより、メッセージは安全であるだけでなく、特定の要件に合わせて調整されます。

注：Push API設定を変更できるのは、AppsFlyerアカウント所有者のみです。他のアカウントユーザーは設定の閲覧のみ可能です。

エンドポイント設定の変更：

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

注：Push 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、およびエラーメッセージのスクリーンショットを送信してください。

いいえ。Push APIでは、認証トークンにのみ Authorization ヘッダーを使用できます。追加のカスタム ヘッダー（consumer-key など）はサポートされていません。

追加のパラメーターを渡す必要がある場合は、URLに含めてください。例：

https://your.server.com?consumer_key=abc456