よくある問題

この記事では、フロービルダーでフローを作成する際によく発生する問題を、原因と解決策とともにまとめています。

フローのプレビューまたは公開ができない

次のいずれかの問題がある場合、フローの公開またはプレビューはできません。

• 設定が不完全なインタラクション。よくあるケース：
  • ターゲット URL が設定されていない Open URL アクション。
  • 遷移先が指定されていない Navigate to screen アクション — アクション設定後に遷移先の画面が削除された場合にも発生します。
  • 演算子または値が設定されていない条件アクション。
  • 変数や値が割り当てられていない Set variable アクション。
  • プロダクトが指定されていない（アプリ内ストア）、または Web ペイウォール URL が設定されていない（Web 決済）Purchase アクション。
  • アクション ID が設定されていない Custom アクション。
  • タイトルまたはメッセージが空の Show alert アクション。
  • 対象要素が選択されていない Show または Hide アクション。
  • ターゲットプロダクトが指定されていない Select product アクション — ターゲットのプロダクト要素が削除された場合、プロダクトグループ外に移動された場合、または別の画面に残っている場合にも発生します。
  • 再利用可能なコンポーネント内に保存された Select product アクション、または複数の画面で使用されている要素 ID を対象とするもの。
• 要素がない画面。
• プロダクトが紐付けられていないプロダクト要素 — 参照しているプロダクトを削除した場合に発生することがあります。
• 無効なリモートコンフィグ JSON は配信プロセス全体を停止させます — 下書きの保存すらできません。

公開前に確認するには、Adapty アプリでフローをプレビューしてください。フローの読み込みに失敗した場合、エラーメッセージに詳細が表示されます。

このリストは、フローの保存を妨げる問題についてまとめたものです。これらのチェックをすべてパスしたフローでも、実際のユーザーにとって安全でない場合があります（復元アクションがない、購入ボタンが機能しない、翻訳が欠けているなど）。そのような問題は フロー監査スキル で確認できます。こちらはエラーメッセージではなく、合否の判定で終わります。

「Something went wrong」エラーで公開に失敗する

このエラーは、フローの設定に問題があるのではなく、Adapty 側で公開リクエストが失敗したことを意味します。そのため、メッセージは汎用的な内容になっています。ライブ版はそのまま変更されていません。エラーメッセージに表示されている Request ID をコピーして、support@adapty.io までお送りください。チームが失敗したリクエストを特定します。

購入時にオファーが適用されない

ビルダーは各プロダクト要素にプロダクトが設定されているかどうかを検証しますが、プロダクトのオファーは検証しません。オファーがストアまたは Adapty で変更・削除された場合でも、フローは引き続き公開でき、オファーなしで購入が実行されます。オファーを変更した後は、フローを再度開き、影響を受ける各プロダクト要素のオファーを再選択してから再公開してください。

プレビューでオファー価格が空になる

ビルダーのプレビューはストアに接続できないため、offer_price、offer_billing_period、offer_full_duration は値の代わりに変数名が波括弧付きで表示されます。これらはSDKがアプリ内でフローをレンダリングする際に解決されます。オファータイプに依存する条件をプレビューするには、プロダクトとオファーのプレビューを参照してください。

16進数カラーの省略形入力後に公開が失敗する

カラーは必ず #FFFFFF のように6桁の16進数で入力してください。カラーフィールドは短い値も受け付けますが、自動的に展開されないため、#FFF のような省略形はSDKの設定に不正な形式で渡され、公開が拒否されます。不透明度は関係ありません——同じ値は不透明度100%でも失敗します。最もコストのかかる例外は4桁の値です。これは公開は成功しますが、意図していない色がレンダリングされます。

タイポグラフィの変更がエレメントの状態に反映されない

Selected などの状態に独自のタイポグラフィ設定がある場合、Default 状態のタイポグラフィを変更しても（別のテキストスタイルを適用する場合も含む）、その状態には影響しません。各状態のタイポグラフィは直接編集してください。

テキストスタイルを削除すると要素のスタイルが失われる

テキストスタイルを削除しても、そのスタイルを使用していた要素にその設定はコピーされません。削除後、それらの要素はデフォルトのタイポグラフィにフォールバックします。スタイルを削除する前に、影響を受ける要素を別のスタイルに変更するか、タイポグラフィを手動で設定してください。

条件と変数が要素IDの変更後に機能しなくなる

条件やテキスト変数は要素IDで要素を参照しており、IDを変更しても参照は自動的に更新されません。参照が暗黙的に解決されなくなります。要素IDは参照する前に設定してください。変更が必要な場合は、すべての条件と変数の参照を新しいIDに合わせて更新してください。例外はプログレスバーのセグメントで、セグメント名を変更すると参照が自動的に更新されます。

条件または変数が空の値に解決される

変数ピッカーにはすべての画面のフィールドが表示されるため、条件やテキスト変数が、ユーザーがまだ入力していないフィールドを参照してしまうことがあります。実行時、そのような参照は空の値に解決されます。フロー内で前の画面で収集されたフィールドのみを参照するようにしてください。

Set variable アクションで選択中のプロダクトが変わらない

どのプロダクトが選択されているかは変数として割り当てられるものではないため、Set variable で選択を変更することはできません。代わりに Select product アクションを使用してください。

画像や動画がアップロードできない

フローのメディア制限を超えているファイルはアップロードできません。ファイルが画像および動画の要件を満たしているか確認してください：

以下のフォーマットはサポートされていません：

• アニメーションGIFおよびアニメーションWEBP: モーションを追加するには、代わりにVideoエレメントを使用してください。
• SVG: ファイルをPNGまたはWEBPとしてエクスポートしてください。アイコンの場合はアップロード不要です。IconエレメントがバンドルされたTabler Iconsライブラリから描画します。

フッターが表示されない

フッターは縦スクロールが有効になっている画面にのみ表示されます。Screen settings > Scroll で縦スクロールを有効にしてください。