Merge pull request #682 from IABTechLab/gwh-APIDOCS-2504-mobile-troub…

…leshooting-info

To mobile docs, add FAQ/troubleshooting info

docs/getting-started/gs-faqs.md

@@ -20,6 +20,10 @@ Here are some frequently asked questions regarding the UID2 framework.
    - [When I send DII to UID2, does UID2 store the information?](#when-i-send-dii-to-uid2-does-uid2-store-the-information)
    - [Does UID2 allow the processing of HIPAA-regulated data?](#does-uid2-allow-the-processing-of-hipaa-regulated-data)
 
+:::note
+For FAQs relating to mobile publisher integrations, see [FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations).
+:::
+
 #### Will all integration partners in the EUID infrastructure (SSPs, third-party data providers, measurement providers) be automatically integrated with UID2?
 
 No. UID2 has its own framework, which is separate from EUID. As such, paperwork relating to accessing and using the EUID framework does not automatically grant usage and access to the UID2 framework. New contracts are required to be signed for UID2.

docs/guides/integration-mobile-client-server.md

@@ -33,6 +33,8 @@ UID2 provides mobile SDKs for [Android](../sdks/sdk-ref-android.md) and [iOS](..
 This guide uses the group term **UID2 mobile SDKs** to include both the SDK for Android and the SDK for iOS.
 :::
 
+For FAQs relating to mobile publisher integrations, see [FAQs for Mobile Integrations](integration-mobile-overview.md#faqs-for-mobile-integrations).
+
 You'll need to complete the following steps:
 
 1. [Complete the UID2 account setup](#complete-the-uid2-account-setup).

docs/guides/integration-mobile-client-side.md

@@ -32,6 +32,8 @@ UID2 provides mobile SDKs for [Android](../sdks/sdk-ref-android.md) and [iOS](..
 This guide uses the group term **UID2 mobile SDKs** to include both the SDK for Android and the SDK for iOS.
 :::
 
+For FAQs relating to mobile publisher integrations, see [FAQs for Mobile Integrations](integration-mobile-overview.md#faqs-for-mobile-integrations).
+
 To integrate with UID2 client-side, you'll need to complete the following steps:
 
 1. [Complete the UID2 account setup](#complete-the-uid2-account-setup).

docs/guides/integration-mobile-overview.md

@@ -57,3 +57,55 @@ For details, refer to one of the following guides:
 
 - [Client-Side Integration Guide for Mobile](integration-mobile-client-side.md)
 - [Client-Server Integration Guide for Mobile](integration-mobile-client-server.md)
+
+## FAQs for Mobile Integrations
+
+Here is some FAQ information relating to UID2 mobile integrations:
+
+- [iOS: Can I use Swift Package Manager and Cocoapods/Podspec together?](#ios-can-i-use-swift-package-manager-and-cocoapodspodspec-together)
+
+#### iOS: Can I use Swift Package Manager and Cocoapods/Podspec together?
+
+For your UID2 Mobile integration, you can install the UID2 Mobile SDK, the UID2 GMA Plugin, and the UID2 IMA Plugin by either Swift Package Manager or CocoaPods.
+
+Our recommendation:
+
+- If you already use CocoaPods, particularly if you use it to integrate the Google Ad Frameworks yourself, it's best to use CocoaPods to integrate the UID2 SDKs. 
+- If you're new to integrating dependencies, or you already have dependencies with Swift Package Manager, we recommend that you use Swift Package Manager for your UID2 mobile integration.
+
+
+:::caution
+If you already use Cocoapods, this does not prevent your app from using Swift Package Manager (SPM) to integrate the UID2 SDK and plugins. However, there is a potential conflict. If you already have GMA installed with CocoaPods, and you then install the UID2 Mobile SDK, which itself includes GMA, with Swift Package Manager, you end up with two copies of GMA in your implementation, which does not work.
+:::
+
+Therefore, if you already have GMA installed and want to install UID2, be sure that you first remove GMA from Cocoapods.
+
+:::tip
+Podspec is the name of the file in Cocoapods that defines the libraries to be integrated with the app.
+:::
+
+## Troubleshooting Tips for Mobile Integrations
+
+Here's some additional information to help you troubleshoot your UID2 mobile integrations:
+
+- [Android SDK cannot connect in Production environment](#android-sdk-cannot-connect-in-production-environment)
+
+#### Android SDK cannot connect in Production environment
+
+A good first step in troubleshooting is to look at the health check endpoint.
+
+From your mobile device or Android emulator, see if you can reach this endpoint:
+
+```
+https://prod.uidapi.com/ops/healthcheck
+```
+
+The response should be `OK`.
+
+Some error responses indicate  a networking problem resulting in your app not being able to reach the UID2 endpoint. For example:
+
+- `Caused by java.net.UnknownHostException: Unable to resolve host "prod.uidapi.com": No address associated with hostname`
+
+   The SDK tries to refresh the UID2 token in the background. If an error such as an IOException occurs, the SDK retries multiple times. If retry is not successful, this exception is displayed.
+
+Another good troubleshooting step is to enable logging. For details, see [Enable Logging](integration-mobile-client-side.md#enable-logging).

docs/sdks/sdk-ref-android.md

@@ -22,6 +22,8 @@ The following Android-related plugins, and associated documentation, are also av
 | To use the Google Mobile Ads (GMA) SDK to send <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 tokens</Link> as [secure signals](https://support.google.com/admob/answer/11556288) in ad requests from Android apps | [UID2 GMA Plugin for Android Integration Guide](../guides/mobile-plugin-gma-android.md) |
 | To use the Google Interactive Media Ads (IMA) SDK for Android to send <Link href="../ref-info/glossary-uid#gl-uid2-token">UID2 tokens</Link> as [secure signals](https://support.google.com/admob/answer/11556288) in ad requests from Android apps | [UID2 IMA Plugin for Android Integration Guide](../guides/mobile-plugin-ima-android.md) |
 
+For FAQs relating to mobile publisher integrations, see [FAQs for Mobile Integrations](../guides/integration-mobile-overview.md#faqs-for-mobile-integrations).
+
 ## Non-Mobile Android Device Support
 
 This SDK for Android can be used for non-mobile devices for Android platforms as well.