Apple News Workflow Tutorial

An Apple News message is a push notification that links to an Apple News Story and is delivered via the Apple News app on iOS and macOS. Learn more in Apple News Notifications.

What You'll Do

In this tutorial, you will:

  1. Enter your message's content.
  2. Choose which Apple New Story the message will link to.
  3. Optionally select recipient countries.
  4. Preview and send the message.

Features and options are explained along the way.

Steps

  1. Open your project from the dashboard, then click Create and select the Apple News workflow.
  2. Enter the Push Notification Text you want to accompany the Apple News story, limited to 130 characters.
    The preview updates as you compose your message. The Channel Name entered when setting up the service appears in bold.

  3. Click Select a story, then click to select from the list that appears.Story information displayed:

    • Title
    • Share URL: If the story has a canonical URL, it is displayed here instead of the share URL.
    • Status: Only Live or Processing stories may be selected. If an article is processing, the message will be sent when processing is complete. A story that was retracted cannot be selected.
  4. Optionally select recipient Countries. This defaults to All. Available countries are dependent on the selections made when setting up the service with Urban Airship, not necessarily the countries you have configured with Apple.

    Select the radio button for Choose, then click to make your selection from the list that appears. After your first selection, use the Select a country dropdown menu to add another country.
  5. Confirm the message appearance and content in the preview.

  6. Send your message! Click Send Now at the bottom of your window. If the selected story is still processing, the button will instead be labeled Send When Live.
Note

We validate the country selection when Send Now is clicked. If a country selected here is not configured in your Apple News publisher channel settings, you will see the error Country not available when attempting to send to that country. Edit country selection in Settings » Platforms. See: Configure Apple News.

Note

Messages cannot be retracted or deleted.

History

Go to Messages » Apple News to see a year's history of your Apple News messages.

Tutorials