diff --git a/docs/WORLD_APPS_JA_EN_DISTRIBUTION_2026-11-11.md b/docs/WORLD_APPS_JA_EN_DISTRIBUTION_2026-11-11.md new file mode 100644 index 00000000..b26447d3 --- /dev/null +++ b/docs/WORLD_APPS_JA_EN_DISTRIBUTION_2026-11-11.md @@ -0,0 +1,46 @@ +# International app acquisition — first controlled Japanese/English distribution wave + +Prepared 2026-11-11. **Source-only draft. No social accounts connected in Metricool and no posts or videos published.** The native gameplay footage, signed production release and feature wording must be checked before release. + +## Why this wave +- The English purpose-based guide already exists at `/guides/quick-games/`; do not produce duplicate English content. +- Added a distinct Japanese search guide at `/guides/quick-games/ja/`, with reciprocal en/ja hreflang, index entry, catalog-verified Android packages and anonymous click events. +- Start with controlled en/ja experiments; there is no reliable country-by-country iOS/Android conversion proof to support an immediate 17-country rollout. +- The Japanese page is **not live merely because GitHub is merged**. The VPS deployment allowlist and read-only live check must both succeed. + +## Eight original short-video briefs (not generated, not published) + +Use a real screen recording from the *currently installed signed* app. Trim to 8–20 seconds; add native-language subtitles. Do not fabricate vote totals, leaderboards, daily challenges, app reviews, installs, or other user outcomes. Verify that the first-value action shown is available on the published version. + +| App | Creative | EN hook | JA hook | Actual on-screen demonstration | CTA | +|---|---|---|---|---|---| +| Blur | blur-visual-01 | Can you guess before the image clears? | ぼかし画像、見える前に当てられる? | Open a real picture, reveal, enter a guess, show truthful result | See the game guide | +| Blur | blur-reveal-02 | How many clues would you need? | あなたは何回で分かる? | One authentic reveal sequence without invented scores | Explore Blur | +| Dotchi | dotchi-choice-01 | A or B — which would you pick? | AとB、あなたはどっち? | Real current production A/B vote and any result only if returned by app | Explore Dotchi | +| Dotchi | dotchi-choice-02 | Your choice might surprise you | みんなと意見は同じ? | Authentic non-personal question; show no invented aggregate results | Try a two-choice poll | +| Instant Judge | judge-opinion-01 | Your answer in a few seconds? | 数秒で選ぶならどっち? | Real photo/dilemma voting UI, avoid fake immediate results | Explore Instant Judge | +| Instant Judge | judge-scenario-02 | One quick question, your call | この問い、あなたならどう選ぶ? | One production question with actual tap, no invented consensus | Find the app | +| BrainBurst | trivia-question-01 | Can you solve this quiz? | このクイズ、分かる? | Actual built-in published quiz content, no claim of constant fresh items | See quick games | +| BrainBurst | trivia-round-02 | A quick break, a quiz question | 休憩中に一問挑戦 | One valid question and real completion | Explore BrainBurst | + +## Privacy-safe link and measurement contract + +**Until the Japanese landing is verified live, publish neither its link nor a claim of availability.** + +Suggested social bio or post URLs after live smoke: + +- English: `https://appdevelopsk.com/guides/quick-games/?utm_source=youtube&utm_medium=organic_social&utm_campaign=world_apps_202611&utm_content=blur-visual-01` +- Japanese: `https://appdevelopsk.com/guides/quick-games/ja/?utm_source=youtube&utm_medium=organic_social&utm_campaign=world_apps_202611&utm_content=blur-visual-01-ja` + +For an actual TikTok/Instagram/Reddit placement, use its **true** `utm_source`, and `utm_content` corresponding to its creative ID. Avoid app-store links with hypothetical iOS IDs, personal answers, user identifiers or private prediction text. Do not assume generic UTM parameters survive Play installation; the existing app-guide Play links include a Play referrer, but attributed installs require separate confirmation. + +Track for each creative: upload date, platform, country/language, verified view count, outbound guide visits, `guide_store_click` / `download_click`, 28d Play acquisitions, signed app first-success events, and mature D1/D7 by app/country when available. The funnel steps are separate metrics and are not proof of causal attribution by themselves. + +## Minimum publication gates +1. Run `node --test tests/japanese-quick-games-discovery.test.mjs` in a full site checkout and validate actual production-video footage. +2. Deploy using `bash scripts/publish_app_discovery.sh --dry-run`, then operator-controlled `--apply`; it is non-destructive and explicitly lists the new file. +3. Confirm `bash scripts/check_app_discovery_live.sh` passes against the actual site. Confirm the sitemap URL is 200 and the English/Japanese pages have reciprocal hreflang. +4. Publish **one** real video in each of the first two languages. No platform login for distribution is currently connected through Metricool; manual connection is needed before scheduling. +5. Review after 7 days; count *real outbound app traffic and first successful actions*, not impressions or bot visits. Run an extended 14–30 day check before claiming D7 or monthly-user improvement. + +Existing source PRs for first-play and consent improvements remain independent; do not consider these landing changes a Flutter release. diff --git a/guides/quick-games/index.html b/guides/quick-games/index.html index 6af3fd83..cb42f66a 100644 --- a/guides/quick-games/index.html +++ b/guides/quick-games/index.html @@ -6,6 +6,9 @@ Quick mobile games for a short break | SK Apps + + + @@ -30,6 +33,7 @@

Quick mobile games for a short break

Not every break needs a long session. Decide whether you want to spot clues, give an opinion, solve a small logic problem, or answer trivia.

+

日本語版:すきま時間に遊べるAndroidゲーム

How to choose

  1. Want a visual surprise? Choose an image-guessing game where the picture becomes clearer as you play.
  2. Want to react and compare opinions? Choose a community voting game instead of a puzzle.
  3. Want a simple A-or-B choice? Pick a poll, vote and compare answers with friends in Dotchi.
  4. diff --git a/guides/quick-games/ja/index.html b/guides/quick-games/ja/index.html new file mode 100644 index 00000000..142d821c --- /dev/null +++ b/guides/quick-games/ja/index.html @@ -0,0 +1,81 @@ + + + +すきま時間に遊べるAndroidゲーム4選|画像当て・二択・クイズ | SK Apps + + + + + + + + + + + + + + + + +

    すきま時間に遊べるAndroidゲームを選ぶ

    +

    短い休憩でも、遊びたいことは人によって違います。写真の答えを考える、二択を選ぶ、すぐに投票する、クイズで知識を試す。目的に合わせて4つのアプリを紹介します。

    +

    English: Quick mobile games

    +
    +

    何をして遊びたい?

      +
    • 絵から答えを推測するなら、画像当てゲーム。
    • +
    • 友人と意見の違いを楽しむなら、二択の投票。
    • +
    • 短い時間で判断したいなら、写真・質問への投票。
    • +
    • 考える時間を楽しみたいなら、知識クイズ。
    • +
    +

    遊び方から選ぶ4アプリ

    +

    下記はアプリの選び方の案内であり、順位やダウンロード数の比較ではありません。機能や国別の提供状況は配信中のGoogle Playページでご確認ください。

    +
    +Blurのアプリアイコン +

    1. Blur — 少しずつ見える画像を当てたい

    ぼかされた写真から手がかりを見つける画像当てゲーム。画像が見えてきた段階で、答えを考えます。

    +Google Playで確認 +機能・サポート
    +
    +Dotchiのアプリアイコン +

    2. Dotchi — AかBかを選びたい

    二択の質問に答えて、自分とほかの人の選択を比較する投票アプリ。公開中の内容はストアでご確認ください。

    +Google Playで確認 +機能・サポート
    + +
    +BrainBurstのアプリアイコン +

    4. BrainBurst — クイズに挑戦したい

    知識を使うクイズに挑戦したいときの選択肢。問題内容や利用可能な機能はストアで確認できます。

    +Google Playで確認 +機能・サポート
    +
    +

    よくある質問

    +

    iPhoneでも遊べますか?

    このページでは確認済みのAndroid向けGoogle Playリンクだけを案内しています。iOS版の公開状況はそれぞれの公式案内をご確認ください。

    +

    オフラインでも遊べますか?

    通信が必要な機能はアプリによって異なります。ストアに記載された条件と、インストールしたバージョンの案内をご確認ください。

    +
    +

    英語版のゲームガイド / ほかのアプリも探す

    +
    提供元:SK Apps。リンク先はGoogle Playです。掲載内容は地域・アプリのバージョンにより変わります。広告やインストール増加の保証はありません。
    + diff --git a/scripts/check_app_discovery_live.sh b/scripts/check_app_discovery_live.sh index b5e6e3e0..d6386510 100644 --- a/scripts/check_app_discovery_live.sh +++ b/scripts/check_app_discovery_live.sh @@ -46,6 +46,15 @@ fetch '/sitemap.xml' 'sitemap.xml' for slug in quick-games daily-habits decision-helpers ai-tools; do grep -Fq "https://appdevelopsk.com/guides/$slug/" "$tmp/sitemap.xml" || { echo "FAIL sitemap missing $slug" >&2; exit 1; } done +# Verify that the Japanese acquisition guide is really deployed, not merely committed. +fetch '/guides/quick-games/ja/' 'quick-games-ja.html' +grep -Fq '' "$tmp/quick-games-ja.html" || { echo 'FAIL Japanese guide language mismatch' >&2; exit 1; } +grep -Fq 'https://appdevelopsk.com/guides/quick-games/ja/' "$tmp/quick-games-ja.html" || { echo 'FAIL Japanese guide canonical missing' >&2; exit 1; } +grep -Fq 'hreflang="ja" href="https://appdevelopsk.com/guides/quick-games/ja/"' "$tmp/quick-games.html" || { echo 'FAIL English guide missing Japanese hreflang' >&2; exit 1; } +grep -Fq 'utm_campaign=quick_games_ja' "$tmp/quick-games-ja.html" || { echo 'FAIL Japanese store attribution missing' >&2; exit 1; } +grep -Fq 'guide_store_click' "$tmp/quick-games-ja.html" || { echo 'FAIL Japanese guide store-click event absent' >&2; exit 1; } +grep -Fq 'https://appdevelopsk.com/guides/quick-games/ja/' "$tmp/sitemap.xml" || { echo 'FAIL Japanese guide omitted from live sitemap' >&2; exit 1; } + for slug in brain-burst snaplingo; do fetch "/support/$slug/" "$slug.html" grep -Fq 'data-position="hero"' "$tmp/$slug.html" || { echo "FAIL $slug first-screen Play CTA not yet live" >&2; exit 1; } diff --git a/scripts/publish_app_discovery.sh b/scripts/publish_app_discovery.sh index 7b0bfa83..f2b8d974 100644 --- a/scripts/publish_app_discovery.sh +++ b/scripts/publish_app_discovery.sh @@ -15,7 +15,7 @@ root="${APP_SITE_DEPLOY_ROOT:-/var/www/html}" if [[ ! "$host" =~ ^[a-zA-Z0-9_.@-]+$ || ! "$root" =~ ^/var/www/[a-zA-Z0-9_./-]+$ ]]; then echo 'Invalid APP_SITE_DEPLOY_HOST or APP_SITE_DEPLOY_ROOT' >&2; exit 2 fi -files=(index.html apps.html sitemap.xml robots.txt guides/quick-games/index.html guides/daily-habits/index.html guides/decision-helpers/index.html guides/ai-tools/index.html support/brain-burst/index.html support/snaplingo/index.html support/face-reaction-battle/index.html support/twotaku/index.html support/debate-me/index.html support/idea-market/index.html support/blur/index.html support/instant-judge/index.html support/roast-me/index.html support/future-me/index.html support/tappitsu-battle/index.html support/taletime/index.html support/dog-breeds-encyclopedia/index.html) +files=(index.html apps.html sitemap.xml robots.txt guides/quick-games/index.html guides/quick-games/ja/index.html guides/daily-habits/index.html guides/decision-helpers/index.html guides/ai-tools/index.html support/brain-burst/index.html support/snaplingo/index.html support/face-reaction-battle/index.html support/twotaku/index.html support/debate-me/index.html support/idea-market/index.html support/blur/index.html support/instant-judge/index.html support/roast-me/index.html support/future-me/index.html support/tappitsu-battle/index.html support/taletime/index.html support/dog-breeds-encyclopedia/index.html) for file in "${files[@]}"; do [[ -s "$file" ]] || { echo "Missing source file: $file" >&2; exit 2; } done diff --git a/sitemap.xml b/sitemap.xml index 8e1311f4..b634744f 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -317,6 +317,7 @@ https://appdevelopsk.com/terms/idea-market/2026-11-04yearly0.3 https://appdevelopsk.com/csae-standards/2026-08-18yearly0.3 https://appdevelopsk.com/guides/quick-games/2026-11-07monthly0.7 + https://appdevelopsk.com/guides/quick-games/ja/2026-11-11monthly0.7 https://appdevelopsk.com/guides/daily-habits/2026-11-07monthly0.7 https://appdevelopsk.com/guides/decision-helpers/2026-11-07monthly0.7 https://appdevelopsk.com/guides/ai-tools/2026-11-07monthly0.7 diff --git a/tests/japanese-quick-games-discovery.test.mjs b/tests/japanese-quick-games-discovery.test.mjs new file mode 100644 index 00000000..2df1b034 --- /dev/null +++ b/tests/japanese-quick-games-discovery.test.mjs @@ -0,0 +1,69 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import {readFileSync} from 'node:fs'; +const read = p => readFileSync(new URL('../'+p, import.meta.url),'utf8'); +const ja = read('guides/quick-games/ja/index.html'); +const en = read('guides/quick-games/index.html'); +const sitemap = read('sitemap.xml'); +const apps = JSON.parse(read('apps_data.json')); +const base='https://appdevelopsk.com/guides/quick-games/'; +const jaUrl=base+'ja/'; + +test('Japanese page has unique canonical, accurate locale and reciprocal hreflang',()=>{ + assert.match(ja,//); + assert.match(ja,new RegExp('')); + for (const page of [ja,en]) { + assert.ok(page.includes('hreflang="ja" href="'+jaUrl+'"')); + assert.ok(page.includes('hreflang="en" href="'+base+'"')); + assert.ok(page.includes('hreflang="x-default" href="'+base+'"')); + } + assert.match(ja,/

    すきま時間に遊べるAndroidゲームを選ぶ<\/h1>/); + assert.doesNotMatch(ja,/aggregateRating|reviewCount|ratingValue/); +}); + +test('Japanese guide only promotes four real catalog apps with the correct Android package',()=>{ + const links=[...ja.matchAll(/x[1]),slugs); + for (const [,slug,url] of links) { + const item=apps.find(a=>a.app===slug&&!a.hidden); + assert.ok(item,'missing visible catalog app '+slug); + assert.ok(url.includes('id='+item.pkg),slug+' package mismatch'); + assert.ok(url.includes('referrer=utm_source%3Dappdevelopsk'),slug+' referrer absent'); + assert.ok(url.includes('utm_campaign=quick_games_ja')); + assert.ok(!/itunes\.apple\.com|apps\.apple\.com/.test(url)); + } +}); + +test('Japanese guide is discoverable and uses existing anonymous event names',()=>{ + assert.equal((sitemap.match(/https:\/\/appdevelopsk\.com\/guides\/quick-games\/ja\/<\/loc>/g)||[]).length,1); + assert.match(ja,/guide_store_click/); + assert.match(ja,/download_click/); + assert.match(ja,/app_detail_click/); + assert.match(ja,/placement:'guide_card'/); + assert.doesNotMatch(ja,/document\.querySelector\(['"]input|search_text|email_address|user_id/); +}); + +test('JSON-LD names map directly to the four app listings without invented ratings',()=>{ + const raw=ja.match(/