スキルにAlexa広告IDを追加する手順
スキルでAlexa広告IDを使用することで、興味・関心に基づく広告の配信や広告分析レポートの生成ができます。スキルが広告を配信することを示す場合、Alexaは一意の広告IDと、ユーザーの興味・関心に基づく広告受け取りの設定をスキルに送信します。広告IDの概要については、Alexa広告IDについてを参照してください。
Alexaカスタムスキル、Alexa音楽スキル、Echo Show用ビデオスキルにAlexa広告IDを追加するには、以下の手順を完了してください。
advertisingオブジェクト
広告を宣言している認定済みスキルの場合、Alexaはスキルへのリクエストにadvertisingオブジェクトを含めます。このオブジェクトは、スキル内広告に関するユーザーのカスタマイズ設定を提供します。
プロパティ | 説明 | 型 | 必須 |
---|---|---|---|
|
OpenRTB API仕様の 形式は、ハイフンで区切られた、バージョン4のUUID文字列(8-4-4-4-12)です。 |
文字列 |
◯ |
|
ユーザーが興味・関心に基づく広告の受け取りを希望しているかどうかを示します。ユーザーが興味・関心に基づく広告と追跡を利用しないことを選択している場合は、 |
ブール値 |
◯ |
前提条件
advertisingオブジェクトを使用するには、スキルが次の要件を満たす必要があります。
- スキルはカスタムスキル、音楽スキル、Echo Show用ビデオスキルのいずれかである必要があります。
- スキルはAlexa広告IDに関するポリシーに準拠している必要があります。
広告IDを追加する手順
Alexaカスタムスキル、音楽スキル、Echo Show用ビデオスキルにadvertisingオブジェクトを追加するには、以下の手順を完了してください。
- 広告ID用にスキルをデザインします。
- advertisingオブジェクトにアクセスします。
- スキルを広告用に有効にします(カスタムスキルと音楽スキルのみ)。
- スキルのテストと認定を行います。
ステップ1: 広告ID用にスキルをデザインする
各リクエストでadvertisingオブジェクトを使用するようにスキルをデザインします。コードでは、advertisingId
へのすべてのアクセスの前に、limitAdTracking
フラグを確認するコードを配置します。limitAdTracking == true
の場合、ユーザーの選択に対応して追跡を無効にする必要があります。
ユーザーは、スキルセッションの最中または実行後に、いつでも広告IDをリセットし、興味・関心に基づく広告の受け取りの設定を変更できるため、広告のプロパティをキャッシュしないでください。Alexaは、次回のリクエストで最新の値をスキルに送信します。ユーザーによる明示的な同意がない限り、新しいadvertisingId
を以前のadvertisingId
や以前のadvertisingId
に紐づけされたデータに関連付けることはできません。また、ユーザーによる明示的な同意がない限り、advertisingId
に個人データを一切関連付けないでください。
ユーザーが興味・関心に基づく広告を受け取らないことを選択している場合でも、advertisingId
を分析に利用できますが、追跡と興味・関心に基づく広告を無効にする必要があります。
一部のリクエストでは、Alexaがadvertisingオブジェクトを含めない場合があります。advertisingId
を使用する場合でも、使用しない場合でも実行できるようにスキルをデザインします。
ステップ2: コードで広告IDにアクセスする
Alexaは、スキルタイプに基づいてスキルへの各リクエストにadvertisingオブジェクトを含めます。
- カスタムスキルの場合、Alexaは、スキルへのリクエストの
context
オブジェクトにadvertising
オブジェクトを含めます。 - 音楽スキルの場合、Alexaは、スキルへのリクエストの
RequestContext
オブジェクトにadvertising
オブジェクトを含めます。このadvertising
オブジェクトは音楽スキルとラジオスキルで利用できます。 - Echo Show用ビデオスキルの場合、Alexaは、
GetPlayableItemsMetadata
APIのpayload
にadvertising
オブジェクトを含めます。
各リクエストからadvertisingオブジェクトにアクセスすることで、ユーザーの興味・関心に基づく広告受け取りの選択を特定します。
以下の音楽スキルとビデオスキルの例では、ユーザーが興味・関心に基づく広告を受け取らないことを選択した場合の設定を示します。カスタムスキルの例も同じですが、オブジェクト名が大文字で始まるAdvertising
になります。
"advertising": {
"advertisingId": "8D5E212-165B-4CA0-909B-C86B9CEE0111",
"limitAdTracking": true
}
"advertising": {
"advertisingId": "00000000-0000-0000-0000-00000000",
"limitAdTracking": true
}
以下の例では、ユーザーが興味・関心に基づく広告を受け取ることを選択した場合の設定を示します。
"advertising": {
"advertisingId": "8D5E212-165B-4CA0-909B-C86B9CEE0111",
"limitAdTracking": false
}
ステップ3: スキルが広告を配信することを宣言する
Alexaがスキルにadvertisingオブジェクトを送信する前に、開発者はスキルで広告を配信することを宣言した後、スキルの認定を申請する必要があります。Amazonがスキルを認定するまで、スキルはadvertisingオブジェクトを受け取りません。
スキルでの広告配信の宣言は、Alexa開発者コンソールで行います。または、スキルマニフェストを直接更新してスキルでの広告配信を宣言できます。
Alexa開発者コンソールでスキルでの広告配信を宣言する
- Alexa開発者コンソールにサインインします。
- スキルの一覧からスキルを見つけ、アクションを選択のドロップダウンから編集を選択します。
- 次に公開ページに移動します。
- 日本語(日本)のストアでのプレビューページのプライバシーポリシーのURLで、プライバシーポリシーのURLを入力した後、保存して続行をクリックします。
- プライバシーとコンプライアンスページのこのスキルで広告は表示されますか?で、はいを選択します。
- リンクをクリックしてAlexaスキルの広告に関するポリシーを読んだ後、チェックボックスを選択して条件を読み準拠していることを確認します。
- 設定を保存するには、保存して続行をクリックします。
スキルマニフェストでスキルでの広告配信を宣言する
- エディターでスキルマニフェストファイルを開きます。
privacyAndCompliance
セクションに移動します。- 広告配信を宣言するには、
true
に設定したcontainsAds
プロパティを追加します。 - サポートする各ロケールについて、
locales
オブジェクトとロケール文字列およびprivacyPolicyUrl
を含めます。
ロケールごとに個別のプライバシーポリシーURLが必要です。 - マニフェストファイルを保存します。
- 変更後のマニフェストをデプロイするには、Alexa Skills Kitコマンドラインインターフェースを使用します。
次の例に、広告を宣言するスキルマニフェストを示します。
"privacyAndCompliance": {
"allowsPurchases": false,
"usesPersonalInfo": false,
"isChildDirected": false,
"isExportCompliant": true,
"containsAds": true,
"locales": {
"ja-JP": {
"privacyPolicyUrl": "https://www.example-uspolicy.com",
"termsOfUseUrl": "https://www.example-usterms.com"
},
"en-CA": {
"privacyPolicyUrl": "https://www.example-capolicy.com",
"termsOfUseUrl": "https://www.example-caterms.com"
}
}
}
ステップ4: スキルのテストと認定を行う
スキルの認定を申請する前に、ユーザーのカスタマイズ設定のオプトイン、オプトアウト、リセットオプションを処理できることを確認します。
認定の遅延を回避するために、スキルがAlexa広告IDのポリシー要件を満たしていることを確認します。検証を実行した後、スキルの認定を申請できます。
スキルの認定後、Alexaはスキルへのリクエストにadvertisingオブジェクトを含めます。
関連トピック
- Alexa音楽、ラジオ、ポッドキャストスキルAPIコンポーネントリファレンス
- カスタムスキルのJSONインターフェースのリファレンス
- Echo Show用VSK(Video Skills Kit)
- 認定の要件
最終更新日: 2023 年 04 月 06 日