Push APIストリーミングローデータ (V2)

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

関連記事：SKAdNetworkローデータ項目。これには、レポートの例も含まれています。Push APIメッセージには、同様の構造と項目があります。

SKAdNetwork計測メッセージタイプの決定フロー

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

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

エンドポイント

• API 設定を変更できるのは、管理者だけです。チームメンバーは、Push API 設定を見ることができます。

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

1. インテグレーション > APIアクセス を開いてください。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. 次の手順を使用して、エンドポイントをテストします。
10. Facebookに紐づくイベントを受け取るには、まずFacebookの利用規約に同意する必要があります。（AppsFlyer計測に必要ですが、SKAdNetwork計測では不要です。）

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

1. テスト送信をクリックしてください。
   テスト送信ボタンの下にテスト結果のメッセージが表示されます。
   テストメッセージがエンドポイントに送信されます。テストに失敗した場合、AppsFlyer IPアドレスを許可リストに追加しているか確認してください。
2. エンドポイントがテストメッセージを受信したことを確認します。
   送信されたメッセージのコピーを表示してください。

注：アドミンのみがAPI設定を変更できます。チームメンバーは、Push API 設定を閲覧できます。

SKAdNetwork Push APIの SKAdNetworkエンドポイントを追加する方法：

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

注：アドミンのみがAPI設定を変更できます。チームメンバーは、Push API 設定を閲覧できます。

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

1. インテグレーション > APIアクセス を開いてください。Push APIセクションまでスクロールダウンしてください。
2. 変更したいエンドポイントを特定します。
3. 修正を行います。
4. [保存] をクリックします。

注：アドミンのみがAPI設定を変更できます。チームメンバーは、Push API 設定を閲覧できます。

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

1. インテグレーション > APIアクセス を開いてください。Push APIセクションまでスクロールダウンしてください。
2. エンドポイントを削除をクリックしてください。
3. [保存] をクリックします。
   エンドポイントが削除されます。

注：アドミンのみがAPI設定を変更できます。チームメンバーは、Push API 設定を閲覧できます。

エンドポイントを V1.0 から V2.0 に移行する方法：

1. インテグレーション > APIアクセス を開いてください。Push APIセクションまでスクロールダウンしてください。
2. 移行先のエンドポイントを探します。
3. Push API メッセージを設定するフィールドを選択します。
   
   • 常に送信される必須フィールド：App ID, Event name, Event time, IDFA (iOS) または Advertising ID (Android)
   • 次の図に示すコントロールを使用して、オプションのフィールドを選択します。

     

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

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

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

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

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

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

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

デフォルトでは、 Facebookの利用規約に同意するまで、Facebookはユーザーレベルのローデータをリリースしません。
規約に同意すると、Facebook から送られるユーザーレベルのデータは Push API を介して送信されます。

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

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

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