From f04c9b8e85d0b32165de8dd20cac74d0840c4569 Mon Sep 17 00:00:00 2001 From: Dirk Dougherty Date: Sun, 20 Oct 2013 22:54:04 -0700 Subject: doc change: Update Google Play Services pages for gouda. Change-Id: I222c353a204fcf4594fd8b074889311b67b65ff7 --- docs/html/google/google_toc.cs | 17 ++- docs/html/google/index.jd | 10 +- docs/html/google/play-services/ads.jd | 85 +++++++++++ docs/html/google/play-services/id.jd | 195 ++++++++++++++++++++++++++ docs/html/google/play-services/setup.jd | 2 +- docs/html/google/play-services/wallet.jd | 87 ++++++++++++ docs/html/images/google/admob-money.png | Bin 3639 -> 0 bytes docs/html/images/google/google-mobile-ads.png | Bin 0 -> 785 bytes docs/html/images/google/gps-ads.png | Bin 0 -> 16633 bytes docs/html/images/google/gps-wallet.png | Bin 0 -> 49724 bytes 10 files changed, 389 insertions(+), 7 deletions(-) create mode 100644 docs/html/google/play-services/ads.jd create mode 100644 docs/html/google/play-services/id.jd create mode 100644 docs/html/google/play-services/wallet.jd delete mode 100644 docs/html/images/google/admob-money.png create mode 100644 docs/html/images/google/google-mobile-ads.png create mode 100644 docs/html/images/google/gps-ads.png create mode 100644 docs/html/images/google/gps-wallet.png diff --git a/docs/html/google/google_toc.cs b/docs/html/google/google_toc.cs index 999c44e1734e..77042d3fa0db 100644 --- a/docs/html/google/google_toc.cs +++ b/docs/html/google/google_toc.cs @@ -37,7 +37,22 @@
  • - Google Maps + Maps +
    +
    • +
  • +
    + Ads +
    + +
    • +
  • +
    + Wallet
  • diff --git a/docs/html/google/index.jd b/docs/html/google/index.jd index ce30bce8ba41..0e73b94922bc 100644 --- a/docs/html/google/index.jd +++ b/docs/html/google/index.jd @@ -112,7 +112,7 @@ cloud messaging.

    -

    Google Wallet Instant Buy

    Provide fast and easy checkout in your app when selling physical goods and services. Increase conversions by streamlining your purchase flow and reducing the amount of @@ -136,11 +136,11 @@ interaction patterns, and much more.

    - +
    -

    Google AdMob Ads

    -

    Display ads from AdMob offer you an alternative revenue opportunity that leverages +

    Google Mobile Ads

    +

    Display ads from Google Mobile Ads offer you an alternative revenue opportunity that leverages multiple ad networks with targeted ads and several display formats.

    diff --git a/docs/html/google/play-services/ads.jd b/docs/html/google/play-services/ads.jd new file mode 100644 index 000000000000..c666ce9a049f --- /dev/null +++ b/docs/html/google/play-services/ads.jd @@ -0,0 +1,85 @@ +page.title=Google Mobile Ads +page.tags="Ads","monetization", "AdMob", "Google Play services" +header.hide=1 + +@jd:body + + +
    + +
    + +
    +
    + +

    Google Mobile Ads

    +

    + Monetize your app with banner or interstitial ads from + Google's vast pool of advertisers. Integrate with top ad networks through + mediation to maximize your revenue from impressions. Take advantage of new + ad features and capabilities through Google Play services, without having to + add or update a library in your APK. +

    + +

    + Check out the Google Mobile Ads API reference and visit developers.google.com/mobile-ads-sdk + for more information about integrating Google Mobile Ads into your app. +

    +
    +
    + +
    +
    +

    Key Developer Features

    + +

    Seamless auto-updates

    +

    The Google Mobile Ads SDK is part of Google Play services, so you can take advantage of features + and capabilities in each new release of Google Play services, without needing to update your + APK.

    + +

    Monetize your apps

    +

    Connect with over a million Google advertisers and show relevant ads in your + app. Users engage with the ads, you make money. +
    + Learn more + and sign up.

    + +

    Innovative ads

    +

    Choose from a range of ads across mobile devices and tablets, including interactive + ad units.

    + +

    Flexible and powerful tools

    +

    Filters and controls help you manage your ads. If you want to use multiple ad + networks, you can do that too, with free ad network mediation.

    +
    + +
    +

    Getting Started

    +

    1. Get the Google Play services SDK

    +

    The Google Mobile Ads APIs are part of the Google Play services platform.

    +

    To get started, set up + the Google Play services SDK.

    + +

    2. Run the sample

    +

    Once you've installed the Google Play services package, the Google Mobile Ads sample is located + in <android-sdk>/extras/google-play-services/samples/ads and shows you how to + serve banner and interstitial ads using the Google Mobile Ads APIs.

    + +

    3. Read the documentation

    +

    Read the AdSense + Terms of Service and the AdMob + publisher guidelines and policies.

    +

    For quick access while developing your Android apps, the Google Mobile Ads API reference is available here on + developer.android.com.

    +

    Detailed documentation for Google Mobile Ads for Android is available with the rest of the Google + Mobile Ads developer documents at developers.google.com/mobile-ads-sdk.

    +

    Note: The SDK doesn’t currently support DFP, Ad Exchange or Search + Ads for Mobile Apps but support is coming soon.

    +
    +
    \ No newline at end of file diff --git a/docs/html/google/play-services/id.jd b/docs/html/google/play-services/id.jd new file mode 100644 index 000000000000..79698065c663 --- /dev/null +++ b/docs/html/google/play-services/id.jd @@ -0,0 +1,195 @@ +page.title=Advertising ID +page.tags="Ads","Advertising ID", "ID" +header.hide=1 + +@jd:body + +
    + +
    + +

    Advertising ID

    +

    The advertising ID is a user-specific, unique, resettable ID for advertising, provided by + Google Play services. Developers can use the advertising ID to deliver targeted ads to users in a consistent way. + At the same time, the advertising ID gives users control over their privacy and the ability to + op-out of interest-based ads at any time.

    + +

    The advertising ID is accessible through a straightforward API that you can implement in your apps. For details, +take a look at the +overview and the advertising ID API reference. + +

    +
    + +
    +
    +

    Key Developer Features

    + +

    Standard, simple ID

    +

    The advertising ID is a part of a standard, simple system for serving ads and performing analytics.

    + +

    Giving users control

    +

    Users can reset their advertising ID or opt out of interest-based ads at any time, right from the Google Settings app. + Their preferences apply across all ad companies that use the advertising ID.

    + +
    + +
    +

    Getting Started

    +

    1. Get the Google Play services SDK

    +

    The advertising ID APIs are part of the Google Play services platform.

    +

    To get started, set up + the Google Play services SDK.

    + +

    2. Read the docs and example code

    +

    Once you've installed the Google Play services package, review the overview + below, as well as the example.

    +

    + For detailed documentation, take a look at the + advertising ID API reference documentation. +

    +
    +
    + + +

    Using the Advertising ID

    + +

    + The advertising ID is a unique but + user-resettable string identifier that lets ad networks and other apps anonymously + identify a user. The user's advertising ID is made available to apps through APIs + provided in Google Play services. +

    +

    + Users can reset their advertising ID at any time, right from the Ads section of the + Google Settings app on their devices. From the same app, users can also + opt-out of targeted advertising based on the advertising ID by setting the appropriate + ad tracking preference. When the + user opts-out of targeted ads, this ad tracking preference is made available + to apps through a Google Play services API. +

    +

    + Apps making use of the advertising ID must check for and respect the + user's ad tracking preference. Also please note that any use of the advertising ID + must abide by the terms of Google Play Store policies. +

    + +

    Format of the Advertising ID

    + +

    + Google Play services APIs expose the user's advertising ID as a string format of UUID, + with values similar to this: +

    +

    “38400000-8cf0-11bd-b23e-10b96e40000d”

    + +

    Requirements

    + + + +

    Obtaining the user's advertising ID and ad tracking preference

    + +

    + If you want to use the advertising ID in your app, you must first install the Google + Play services SDK. As noted in the requirements above, you should install the + SDK for Google Play services 4.0 or higher if you will develop using the advertising ID + APIs. For information about how to get started, see Set Up Google Play services. +

    +

    + The advertising ID APIs are available in the + com.google.android.gms.ads.identifier package in the Google + Play Services library. To obtain the user's advertising ID and tracking preference, + call the method + + getAdvertisingIdInfo(), which returns an + AdvertisingIdClient.Info encapsulating the user's current Advertising ID + and tracking preference. +

    + +

    + Note: The getAdvertisingIdInfo() method is a + blocking call, so you must not call it on the main (UI) thread. If called on + the main thread, the method throws IllegalStateException. +

    + +

    + Once you've retrieved the AdvertisingIdClient.Info object, you + can use it's + getId() and + isLimitAdTrackingEnabled() methods to access the advertising ID and + ad tracking preference. +

    + + + + + + + + + + + + + + +
    MethodDescription
    public String getId()Retrieves the advertising ID.
    public boolean isLimitAdTrackingEnabled()Retrieves whether the user has limit ad tracking enabled or not.
    + +

    + The advertising ID APIs do not include a "reset" method. Only users can initiate a + reset of their own advertising IDs, through the Google Settings application. +

    +

    + For more information about the advertising ID APIs, see the + reference documentation. +

    + +

    Example implementation

    + +

    + Here's a basic illustration of how you can retrieve the user's advertising ID and ad + tracking preference in your app: +

    + +
    +import com.google.android.gms.ads.identifier.AdvertisingIdClient;
+import com.google.android.gms.ads.identifier.AdvertisingIdClient.Info;
+import com.google.android.gms.common.GooglePlayServicesAvailabilityException;
+import com.google.android.gms.common.GooglePlayServicesNotAvailableException;
+import java.io.IOException;
+...
+
+// Do not call this function from the main thread. Otherwise, 
+// an IllegalStateException will be thrown.
+public void getIdThread() {
+
+  Info adInfo = null;
+  try {
+    adInfo = AdvertisingIdClient.getAdvertisingIdInfo(mContext);
+
+  } catch (IOException e) {
+    // Unrecoverable error connecting to Google Play services (e.g.,
+    // the old version of the service doesn't support getting AdvertisingId).
+ 
+  } catch (GooglePlayServicesAvailabilityException e) {
+    // Encountered a recoverable error connecting to Google Play services. 
+
+  } catch (GooglePlayServicesNotAvailableException e) {
+    // Google Play services is not available entirely.
+  }
+  final String id = adInfo.getId();
+  final boolean isLAT = adInfo.isLimitAdTrackingEnabled();
+}
    \ No newline at end of file diff --git a/docs/html/google/play-services/setup.jd b/docs/html/google/play-services/setup.jd index a7de7092575c..6553c1840f90 100644 --- a/docs/html/google/play-services/setup.jd +++ b/docs/html/google/play-services/setup.jd @@ -1,4 +1,4 @@ -page.title=Setup Google Play Services SDK +page.title=Set Up Google Play Services SDK @jd:body diff --git a/docs/html/google/play-services/wallet.jd b/docs/html/google/play-services/wallet.jd new file mode 100644 index 000000000000..e83debe66237 --- /dev/null +++ b/docs/html/google/play-services/wallet.jd @@ -0,0 +1,87 @@ +page.title=Google Wallet Instant Buy for Android +page.tags="Wallet","payments","Google Play Services" +header.hide=1 + +@jd:body + +
    +
    + + +

    Google Wallet Instant Buy

    +

    Add fast, secure checkout for users buying physical goods and + services from your app. Transactions are monitored for fraud 24/7. Keep your existing + payments infrastructure and integrate Google Wallet quickly, easily and free of charge.

    + +

    Apply for + production access before launching Instant Buy in your app. We recommend applying + before starting development. Note that Instant Buy is currently only available to + US-based merchants.

    + +

    Check out the Instant Buy API reference and visit + developers.google.com/mobile-ads-sdk + for complete information about integrating Google Wallet Instant Buy into your app.

    + +
    +
    + +
    +
    +

    Key Developer Features

    + +

    Add the "Buy with Google" button

    +

    Easily embed a “Buy with Google” button in your flow to let customers purchase instantly + from your app. Customers can grant you access to their payment information with just + a few clicks. +
    + Add a "Buy with Google" button.

    + +

    Streamline Purchases with Google+ Sign-On

    +

    For users ready to purchase, you can simplify the login and account creation steps + by adding Google+ sign in. Users can sign in with a single click and share their + profile information during the purchase. +
    + Add Google+ Sign-In for Wallet.

    + +

    Minimize User Data Entry

    +

    Google Wallet provides auto-completion of addresses, minimizing user data entry. You can also + retrieve billing and shipping addresses directly from the user’s Wallet to-do form pre-fills.
    + Get + billing addresses.

    +
    + + +
    +

    Getting Started

    +

    1. Get the Google Play services SDK

    +

    The Google Wallet Android APIs are part of the Google Play services platform.

    +

    To get started, set up + the Google Play services SDK. Then see the tutorial + to learn how to set up your app. +

    +

    2. Run the sample

    +

    Once you've installed the Google Play services package, try the Google Wallet + sample located in <android-sdk>/extras/google-play-services/samples/wallet. + The sample shows you how to use the major components of the Instant Buy API.

    +

    The Quick + Start guide provides directions on how to get the Wallet sample up and running

    +

    3. Read the documentation

    +

    For quick access while developing your Android apps, the Google Wallet + API reference is available here on developer.android.com.

    + +

    Detailed documentation for the Instant Buy API is available at developers.google.com/wallet/instant-buy/

    + + +
    +
    \ No newline at end of file diff --git a/docs/html/images/google/admob-money.png b/docs/html/images/google/admob-money.png deleted file mode 100644 index 63db3c9eb674..000000000000 Binary files a/docs/html/images/google/admob-money.png and /dev/null differ diff --git a/docs/html/images/google/google-mobile-ads.png b/docs/html/images/google/google-mobile-ads.png new file mode 100644 index 000000000000..bc35c7578c11 Binary files /dev/null and b/docs/html/images/google/google-mobile-ads.png differ diff --git a/docs/html/images/google/gps-ads.png b/docs/html/images/google/gps-ads.png new file mode 100644 index 000000000000..caad65b83b60 Binary files /dev/null and b/docs/html/images/google/gps-ads.png differ diff --git a/docs/html/images/google/gps-wallet.png b/docs/html/images/google/gps-wallet.png new file mode 100644 index 000000000000..70d4f52a7aa8 Binary files /dev/null and b/docs/html/images/google/gps-wallet.png differ -- cgit v1.2.3-59-g8ed1b