Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

BD-3677: Add troubleshooting for few or no direct opens for iOS push #8577

Merged
merged 5 commits into from
Dec 6, 2024
Merged

BD-3677: Add troubleshooting for few or no direct opens for iOS push #8577

Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
8674cd7
BD-3676
bre-fitzgerald Dec 6, 2024
85e8563
Minor punctuation change
bre-fitzgerald Dec 6, 2024
04b58a9
transforming reference links to inline
internetisaiah Dec 6, 2024
965e325
Apply suggestions from peer review
bre-fitzgerald Dec 6, 2024
76111ea
Apply suggestions from code review
internetisaiah Dec 6, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions ...atform_integration_guides/legacy_sdks/ios/push_notifications/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -160,4 +160,15 @@ Most of the code that handles deep links also handles push opens. First, ensure

If opens are being logged, check whether it is an issue with the deep link in general or with the deep linking push click handling. To do this, test to see if a deep link from an in-app message click works.

#### Few or no direct opens

_Direct Opens_ are not logged for test sends or silent push notifications. If you have sent an iOS push notification and know at least one user has clicked the notification, but few or no _Direct Opens_ have been logged, this is likely an integration issue.
bre-fitzgerald marked this conversation as resolved.
Show resolved Hide resolved

- Make sure that the messages are not being sent as [silent push notifications][1]. The message must have text in the title or body to not be considered silent.
internetisaiah marked this conversation as resolved.
Show resolved Hide resolved
- Check that you have set up push notifications according to the integration guide. Any form of click reporting, including _Direct Opens_, requires the following steps to be implemented correctly:
bre-fitzgerald marked this conversation as resolved.
Show resolved Hide resolved
- [Step 3:][2] On every single app launch, preferably within `application:didFinishLaunchingWithOptions:`, the code from step 3 needs to occur. The delegate property of `UNUserNotificationCenter.current()` needs to be assigned to an object that implements `UNUserNotificationCenterDelegate` and contains the `(void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:` method.
- [Step 5:][3] Verify that the `(void)userNotificationCenter:didReceiveNotificationResponse:withCompletionHandler:` method has been implemented.
bre-fitzgerald marked this conversation as resolved.
Show resolved Hide resolved

[1]: {{site.baseurl}}/developer_guide/platform_integration_guides/swift/push_notifications/silent_push_notifications/#sending-silent-push-notifications
[2]: {{site.baseurl}}/developer_guide/platform_integration_guides/swift/push_notifications/integration/#step-1-register-for-push-notifications-with-apns
[3]: {{site.baseurl}}/developer_guide/platform_integration_guides/legacy_sdks/ios/push_notifications/integration/#step-5-enable-push-handling