Alexaスキルを有効化するリンクを作成する (en_US / es_UD only)

アメリカのユーザー限定ですが、スキルの広告リンクなどに使えるスキル有効化リンクが作れるようになりました。

We are excited to announce Quick Links for Alexa (beta), a new capability available in the U.S. that lets you add a link from your mobile app, website, or online ads that customers can click to launch your skill. This makes it easy for customers to access your skill, and easy for you to track conversion from online ads. Learn more in our technical documentation.

https://developer.amazon.com/en-US/blogs/alexa/alexa-skills-kit/2020/07/quick-links-custom-tasks-isp

Requirement

いくつか条件がありますので、事前に確認しましょう。

  • USで公開されているスキルであること(en / esどちらもOK)
  • カスタムスキルであること
  • 子ども向けまたは HIPAA skillではないこと

See the Documentation

How to create a Link to the Skill

リンクの作成にはSkill IDが必要です。開発コンソールもしくはASK CLIから取得しましょう。

Copy skill ID from Alexa developer console

List and find it out from ASK CLI

% ask smapi list-skills-for-vendor | jq ".skills[] | .skillId , .nameByLocale"
"amzn1.ask.skill.xxx-xxx-xxx-xxx"
{
  "en-US": "Example Skill"
}

Link format

URLは以下のフォーマットです。

https://alexa-skills.amazon.com/apis/custom/skills/<YOUR_SKILL_ID>/launch

スキルIDが amzn1.ask.skill.xxxx-1234-5678-yyyy であれば、 https://alexa-skills.amazon.com/apis/custom/skills/amzn1.ask.skill.xxxx-1234-5678-yyyy/launchとなります。

What page will the user see from the link?

リンクをクリックすると、次のような LPが表示されます。

https://alexa-skills.amazon.com/apis/custom/skills/amzn1.ask.skill.bbd4b9ac-82ec-4e41-8947-1f816e535c04/launch

USアカウントでのログインを要求されますので、日本やドイツなどのユーザーはそもそもこのLPに辿り着けません。

多言語対応のスキルで利用する場合には、広告配信地域を絞るなどしてUSユーザー以外にクリックされて課金が発生することがないようにする必要があります。

Appendix: with Custom Task

ちなみにカスタムタスクも以下のようなURLで作れる様子です。これはカスタムタスクを扱うようになってから追って試します。

https://alexa-skills.amazon.com/apis/custom/skills/<skill-id>/tasks/<custom-task-name>/versions/<task-version>?<task-input-key1>=<task-input-value1>&<task-input-key2>=<task-input-value2>

Comment