このページは Cloud Translation API によって翻訳されました。

添付ファイルのデータ形式

Nearby Notifications の添付ファイルを追加する最も簡単な方法は、 <ph type="x-smartling-placeholder"></ph> Google ビーコンダッシュボード。または、 <ph type="x-smartling-placeholder"></ph> Proximity Beacon API と添付ファイルのデータ形式については、後述します。

Nearby Notifications 機能の添付ファイルでは、 com.google.nearby 名前空間、2 文字の言語必要に応じて -debug サフィックスを追加します。

添付ファイルは、JSON を使用してフォーマットする必要があります。例:

    {
      "title": "Example",
      "url": "https://www.example.com"
    }

JSON 形式では、必要に応じて以下のようにより具体的なターゲティングを設定できます。

    {
      "title": "Example",
      "url": "https://www.example.com",
      "targeting":[
        {
          "startDate": "2017-01-01",
          "endDate": "2017-01-31",
          "startTimeOfDay": "9:00",
          "endTimeOfDay": "17:00",
          "anyOfDaysOfWeek": [1, 2, 3, 4, 5, 6, 7],
          "anyOfAppInstallStates": ["INSTALLED", "NOT_INSTALLED"]
        }
      ]
    }

ここで

title - コンテンツのタイトル。title の長さは短くしてください 40 文字以下、50 文字未満にする必要があります。これにより、行動を促すことができます。たとえば、Order with your phone, skip the line、Set up your thermostat、Learn more about sea otters です。
url - アプリ、ウェブサイト、サービスの URL。
target - 通知の公開設定を制限するオプションのルール自動的に最適化されます。

URL 形式

Nearby の通知は、次の 3 つの URL 形式をサポートしています。

ウェブ URL
アプリのインテント
自由形式のアプリのインテント

ウェブ URL

ウェブ URL とは、通常の URL のことです。ウェブ URL を受信すると、デフォルトのブラウザで URL を開くように求められます。特別なアプリなし構成が必要です。ウェブ URL は HTTPS を使用し、通常の URL:

  https://www.example.com

ウェブ URL から通知が表示されない場合、次の原因が考えられます。

HTTPS の代わりに HTTP を使用する
play.google.com などのアプリストアへのリンクは禁止されています。ウェブページ役立つ情報やアクションがランディングページに直接移動できます

アプリのインテント

アプリインテント URL は、アプリでインテントをトリガーするために使用されます。アプリのインテントが URL を受信すると、関連付けられたアプリは URL（対応するアプリのインテントフィルタが存在する場合）。アプリががインストールされていない場合、ユーザーは Google Play ストアにリダイレクトされ、アプリをインストールします。変更後アプリがインストールされたら、アプリを起動して機能を続行できます。デベロッパーが指定します。アプリインテントの URL の形式は次のとおりです。

  intent://host/path#Intent;scheme=yourscheme;package=com.yourapp.ui;end;

インテント URL のフォーマット設定について詳しくは、以下をご覧ください。 Chrome での Android インテントインテントエクストラは渡されないことに注意してください。

インテントを作成し、 intent.toUri(Intent.URI_INTENT_SCHEME) 使用します。

    Intent intent = new Intent()
        .setData(new Uri.Builder()
            .scheme("yourscheme")
            .authority("host")
            .appendPath("path")
            .build())
        .setPackage("com.yourapp.ui");
    Log.i(TAG, "Use this intent url: " + intent.toUri(Intent.URI_INTENT_SCHEME));

自由形式のアプリのインテント

このオプションは、アプリのインテントが、スキーマ、パス、パッケージ名の形式を設定しますこのオプションは、インテントの URL がください。

ユーザーを Google Play ストアではなく、指定された URL にリダイレクトするよう選択できます。アプリがインストールされていないというイベントを S.browser_fallback_url パラメータをインテントに追加します。

intent://host/path#Intent;scheme=yourscheme;package=com.yourapp.ui; \
  S.browser_fallback_url=http%3A%2F%2Fm.yoursite.com%2Fpath%2F%;end;

コンテンツターゲティング

ルール

Nearby 通知は、次の 4 つのターゲティングルールをサポートしています。

日付
時間帯
曜日
アプリのインストール状態

日付

dateStart と dateEnd を使用して、表示する期間を指定します。 ISO 8601 形式で表示されます。次の例は、2017 年 1 月中の通知を示しています。

    {
      "title": "January 2017",
      "url": "https://www.example.com",
      "targeting":[
        {
          "startDate": "2017-01-01",
          "endDate": "2017-01-31"
        }
      ]
    }

時間帯

「timeOfDayStart」および "timeOfDayEnd"特定の期間内の 1 日の期間を ISO 8601 形式で表します。次の例は、毎日午前 9 時から午後 5 時までの通知を示しています。

    {
      "title": "Work time",
      "url": "https://www.example.com",
      "targeting":[
        {
          "startTimeOfDay": "9:00",
          "endTimeOfDay": "17:00"
        }
      ]
    }

曜日

「anyOfDaysOfWeek」広告を配信する曜日を指定します。表示されます。形式は ISO 8601 で、1（月曜日）から 7（日曜日）までです。次の例は、土曜日と日曜日の通知を示しています。

    {
      "title": "Weekends",
      "url": "https://www.example.com",
      "targeting":[
        {
          "anyOfDaysOfWeek": [6, 7]
        }
      ]
    }

アプリのインストール状態

"anyOfAppInstallStates"アプリケーションに基づいて添付ファイルの公開設定を行うインストール状態を確認します。これは、アプリインテント URL に対してのみ機能します。次の例は、アプリがインストールされていないときの通知を示しています。

    {
      "title": "App not installed",
      "url": "intent://host/path#Intent;package=com.example",
      "targeting":[
        {
          "anyOfAppInstallStates": ["NOT_INSTALLED"]
        }
      ]
    }

ルールの組み合わせ

アタッチメントごとに複数のターゲティングルールを設定できます。ルールの同じターゲット設定オブジェクトを AND 結合します。次の例をご覧ください。土曜日と日曜日の午前 9 時から午後 5 時まで通知を表示します。

    {
      "title": "Weekend and work time",
      "url": "https://www.example.com",
      "targeting":[
        {
          "startTimeOfDay": "9:00",
          "endTimeOfDay": "17:00"
          "anyOfDaysOfWeek": [6, 7]
        }
      ]
    }

異なるターゲティングオブジェクトのルールは、OR で結合されます。次のこの例では、月曜日から金曜日の午前 9 時から午後 5 時まで、土曜と日曜も終日表示されます

    {
      "title": "Weekend or work time",
      "url": "https://www.example.com",
      "targeting":[
        {
          "anyOfDaysOfWeek": [6, 7]
        },
        {
          "startTimeOfDay": "9:00",
          "endTimeOfDay": "17:00"
        }
      ]
    }

アプリにインテントフィルタを追加する

指定された URL のスキーム、ホスト、パスを処理するようにアプリを設定する必要があります。そのためには、AndroidManifest.xml に要素を追加して、 <intent-filter> スキーム、ホスト、パスを照合し、カテゴリでブラウズ可能としてマーク次のように指定します。

  <intent-filter>
    <action android:name="android.intent.action.VIEW"/>
     <!-- both categories below are required -->
     <category android:name="android.intent.category.BROWSABLE"/>
     <category android:name="android.intent.category.DEFAULT"/>
    <data android:host="host"
          android:pathPrefix="/path"
          android:scheme="yourscheme"/>
  </intent-filter>

詳しくは以下をご覧ください。アプリリンクの処理