Create ACS-places-inapp.md #16
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
PravinPK
reviewed
Oct 28, 2019
ivandocs/ACS-places-inapp.md
Outdated
| Before we begin, this guide assumes that you have a mobile application already configured with the Adobe Experience Platform Mobile SDK, including the Adobe Campaign Standard extension. | ||
|
|
||
| ### Prerequisites | ||
| 1. Integration the [Adobe Experience Platform Mobile SDK](https://aep-sdks.gitbook.io/docs/getting-started/get-the-sdk) into your app. |
There was a problem hiding this comment.
Integration of or
Integrate the
ivandocs/ACS-places-inapp.md
Outdated
|
|
||
| ### Sending In-App Messages based on Geo-fence entry or exit | ||
| 1. In your Adobe Campaign Standard instance, click **Create In-App message**. | ||
| 2. For the message type select **Target all users of a Mobile application**. |
There was a problem hiding this comment.
remove the extra space
2. For
|
|
||
| In addition to the data elements for Location Service, ensure that you create Mobile Core data elements for _App ID_ and _Experience Cloud ID_. | ||
|
|
||
| ## Create a rule to send location data to Adobe Campaign Standard |
There was a problem hiding this comment.
This information is also provided by @sbenedicadb at
https://github.com/jiabingeng/places-service-docs/blob/master/places-solution-integrations/campaign/postbacks.md
we might need to consolidate them in one
fix a few spelling errors.
fix more typos.
PravinPK
reviewed
Oct 29, 2019
ivandocs/validation.md
Outdated
| | Step | Description | Expected Result | | ||
| |------ |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |-------------------------------------------------------------------------------------------------------------------------------------- | | ||
| | 1 | Confirm that the proper manifest keys have been entered for Android to grant access to track location: https://placesdocs.com/places-services-by-adobe-documentation/configure-places-in-the-sdk/places-monitor-extension/using-the-places-monitor-extension#add-permissions-to-the-manifest | Confirmed | | ||
| | 1a | Confirm location updates are configured in iOS. Also ensure that you have the appropriate plist keys setup in iOS to request user permission to track location: https://placesdocs.com/places-services-by-adobe-documentation/configure-places-in-the-sdk/places-monitor-extension/using-the-places-monitor-extension#enable-location-updates-in-background | Confirmed | |
There was a problem hiding this comment.
Confirm location updates are configured in iOS
to
Confirm background mode for location updates is enabled for your application.
PravinPK
reviewed
Oct 29, 2019
| | 5 | Confirm that the correct environments are configured for testing. Launch environment ID should match your Launch development environment | Confirmed | | ||
| | 6 | Create GPX files for each POI that you want to test. GPX files can be used in local development environment to simulate a location entry. See links below for information on creating and using GPX files. <br>https://stackoverflow.com/questions/17292783/gpx-files-for-ios-simulator<br>https://mapstogpx.com/mobiledev.php<br>https://blackpixel.com/writing/2013/05/simulating-locations-with-xcode.html<br>https://qacumtester.wordpress.com/2014/02/27/location-testing-in-mobile-apps/ | GPX files created and loaded into app project | | ||
| | 7 | Without doing anything else, you should be able to launch the application from Android Studio or XCode and see the appropriate alert to request access for tracking location. Grant "Always Allow" permission.<br>*Recommend using a real device connected to your computer over using device simulator.* | Location request prompt should display on application loaded through IDE | | ||
| | 8 | Once Location permission has been accepted you should see in the application console messages that indicate ```"ACPExtensionEventName" : "requestgetnearbyplaces"```, has been called. Switching between different locations in XCode or Android studio should produce entry events for specific POIs | "ACPExtensionEventName" : "requestgetnearbyplaces" should be displayed as you simulate different locations. | |
There was a problem hiding this comment.
POINT 8
Description
Once Location permission has been accepted. The Places SDK will to retrieve the current location of the device and the Places Monitor extension will start monitoring the 20 closest POIs from the current location
iOS
[AdobeExperienceSDK DEBUG <Places>]: Requesting 20 nearby POIs for device location (<lat>, <longitude>)
[AdobeExperienceSDK DEBUG <Places>]: Response from Places Query Service contained <n> nearby POIs
[AdobeExperienceSDK DEBUG <com.adobe.placesMonitor>]: Received a new list of POIs from Places: (
"<ACPPlacePoi: 0x600002b75a40> Name: <poi name>; ID:<poi id>; Center: (<lat>, <long>); Radius: <radius>”,
..
..)
Android
PlacesMonitor - PlacesMonitorInternal : New location obtained: <latitude> <longitude> Attempting to get the near by pois
PlacesExtension - Dispatching nearby places event with n POIs
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
PlacesMonitor - Attempting to Monitor POI with id <poi id> name <poi name> latitude <lat> longitude <longitude>
….
PlacesMonitor - Successfully added n fences for monitoring
PravinPK
reviewed
Oct 29, 2019
| | 6 | Create GPX files for each POI that you want to test. GPX files can be used in local development environment to simulate a location entry. See links below for information on creating and using GPX files. <br>https://stackoverflow.com/questions/17292783/gpx-files-for-ios-simulator<br>https://mapstogpx.com/mobiledev.php<br>https://blackpixel.com/writing/2013/05/simulating-locations-with-xcode.html<br>https://qacumtester.wordpress.com/2014/02/27/location-testing-in-mobile-apps/ | GPX files created and loaded into app project | | ||
| | 7 | Without doing anything else, you should be able to launch the application from Android Studio or XCode and see the appropriate alert to request access for tracking location. Grant "Always Allow" permission.<br>*Recommend using a real device connected to your computer over using device simulator.* | Location request prompt should display on application loaded through IDE | | ||
| | 8 | Once Location permission has been accepted you should see in the application console messages that indicate ```"ACPExtensionEventName" : "requestgetnearbyplaces"```, has been called. Switching between different locations in XCode or Android studio should produce entry events for specific POIs | "ACPExtensionEventName" : "requestgetnearbyplaces" should be displayed as you simulate different locations. | | ||
| | 9 | If the Location you have selected is close to nearby POIs the Monitor extension will start monitoring the 20 closest POIs from the current location. Message in the console will be similar to:```[AdobeExperienceSDK DEBUG <com.adobe.placesMonitor>]: Received a new list of POIs from Places:```| Switching between different locations in XCode or Android studio should produce entry events for specific POIs | |
There was a problem hiding this comment.
POINT 9
Description
Switching between different locations in XCode or Android studio should produce entry events for specific POIs. The below logs are expected on entry to a POI
iOS
[AdobeExperienceSDK TRACE <Places>]: Dispatching Places region entry event for place ID <poiId>
Android
PlacesExtension - Dispatching Places Region Event for <poi name> with eventType entry
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.