introduction to data.com apis

36
Introduction to Data.com APIs Ali Sadat, Sr. Dir. Prod Management – Data.com API & Data Platform @alisadat James Mak, Sr. Product Manager – Data.com API @jmak_sfdc #APInation Pilot

Upload: salesforce-developers

Post on 29-Nov-2014

352 views

Category:

Technology


0 download

DESCRIPTION

Join us to learn more about the new pilot Data.com APIs built on the Force.com platform. First, we'll walk through how you can use these new APIs to interact with the DatacloudCompany and DatacloudContact objects in Salesforce. Then, we'll dive deep into how to use the new Search and Match APIs to enhance your users' experience with Data.com.

TRANSCRIPT

Page 1: Introduction to Data.com APIs

Introduction to Data.com APIs

Ali Sadat, Sr. Dir. Prod Management – Data.com API & Data Platform@alisadat

James Mak, Sr. Product Manager – Data.com API@jmak_sfdc

#APInation

Pilot

Page 2: Introduction to Data.com APIs

Safe harborSafe harbor statement under the Private Securities Litigation Reform Act of 1995: This presentation may contain forward-looking statements that involve risks, uncertainties, and assumptions. If any such uncertainties materialize or if any of the assumptions proves incorrect, the results of salesforce.com, inc. could differ materially from the results expressed or implied by the forward-looking statements we make. All statements other than statements of historical fact could be deemed forward-looking, including any projections of product or service availability, subscriber growth, earnings, revenues, or other financial items and any statements regarding strategies or plans of management for future operations, statements of belief, any statements concerning new, planned, or upgraded services or technology developments and customer contracts or use of our services. The risks and uncertainties referred to above include – but are not limited to – risks associated with developing and delivering new functionality for our service, new products and services, our new business model, our past operating losses, possible fluctuations in our operating results and rate of growth, interruptions or delays in our Web hosting, breach of our security measures, the outcome of any litigation, risks associated with completed and any possible mergers and acquisitions, the immature market in which we operate, our relatively limited operating history, our ability to expand, retain, and motivate our employees and manage our growth, new releases of our service and successful customer deployment, our limited history reselling non-salesforce.com products, and utilization and selling to larger enterprise customers. Further information on potential factors that could affect the financial results of salesforce.com, inc. is included in our annual report on Form 10-K for the most recent fiscal year and in our quarterly report on Form 10-Q for the most recent fiscal quarter. These documents and others containing important disclosures are available on the SEC Filings section of the Investor Information section of our Web site. Any unreleased services or features referenced in this or other presentations, press releases or public statements are not currently available and may not be delivered on time or at all. Customers who purchase our services should make the purchase decisions based upon features that are currently available. Salesforce.com, inc. assumes no obligation and does not intend to update these forward-looking statements.

Page 3: Introduction to Data.com APIs

{ "agenda": [ { "topic": "Data.com Overview", "who": "Ali" }, { "topic": "API Overview", "who": "Ali" }, { "topic": "Demo", "who": "James" }, { "topic": "API Pilot", "who": "James" }, { "topic": "Q&A", "who": "James and Ali" } ]}

Page 4: Introduction to Data.com APIs

Ali SadatSr. Dir. Product Management – Data.com API & Data Platform@alisadat

Page 5: Introduction to Data.com APIs

Built Together: The Best Data, The #1 Sales App

Clean

Leading account and contact data right inside Sales Cloud

SellMarket

Page 6: Introduction to Data.com APIs

World’s Premier Sources of Accounts & Contacts Directly in Sales Cloud

Company Information From D&B

Millions of Crowd-Sourced Contacts

Clean your Sales Cloud With One Click

Instant Access and Real-time Updates In the Cloud

Page 7: Introduction to Data.com APIs

API Overview

Page 8: Introduction to Data.com APIs

Data.com API Goals and Motivation

Allow customers to create rich custom Data.com experiences that can be integrated into their

processes.

Page 9: Introduction to Data.com APIs

Possible Use Cases Enabled by Data.com APIUse Cases Search/Purchase

APIMatch API

Fill-in White Space ✓

Selective Automated Cleaning ✓

On-Demand Automated Cleaning

Search in DDC before Create ✓

Custom Build a List ✓

Web2Lead (Clean) ✓

Lookup by DUNS Future ✓

Build Visual Account Hierarchy Future

Mobile Experience ✓ ✓

Page 10: Introduction to Data.com APIs

Data.com APIs generally act and feel like other Force.com APIs

Page 11: Introduction to Data.com APIs

How does Data.com data show up in your org?

Accounts Contacts Leads

DatacloudCompany

DatacloudContact

Force.com OrgDatacloud (External) sObjects

Page 12: Introduction to Data.com APIs

Datacloud sObjects and APIs (Pilot)

Force Technology DDC API

DatacloudCompany DatacloudContact

sObject ✔ ✔

REST

Search ✔ ✔

Purchase* ✔ ✔

Retrieve ✔ ✔

Match ✔ ✔

APEX

Search ✔ ✔

Purchase ✔ ✔

Retrieve ✔ ✔

Match Future Future

* Purchase is a process that involves inserting into multiple objects

Page 13: Introduction to Data.com APIs

Searching Contacts / Companies

Page 14: Introduction to Data.com APIs

Search: SOQL

SELECT

ContactId, FirstName, LastName, Title, Email, CompanyName, Street, City, CompanyId, Country, State, Zip, Phone, IsInactive, IsOwned

FROM DatacloudContact

WHERE CompanyName Like 'salesforce.com'

AND City = 'San Francisco'

AND FirstName Like 'Ali'

Order by LastName

Page 15: Introduction to Data.com APIs

Contact Search: ResultContactId FirstName LastName Title Email CompanyName Street City State Zip Phone IsInactive IsOwned

55280504Alisa Distaso Principal Sales Engineer

[email protected]

Salesforce.com, Inc. 1 Market San

Francisco CA 94105-1596

+1.703.463.3168

FALSE TRUE

34436669A****** G****** ****** ******@salesforce.com

Salesforce.com, Inc. ****** San

Francisco CA 9****** +*.***.***.**** FALSE FALSE

61751292Alison Guzenski Campus Recruiter Non-technical

[email protected]

Salesforce.com, Inc. 1 Market San

Francisco CA 94105-1596

+1.415.547.8637

FALSE TRUE

9041336A****** H****** ****** ******@salesforce.com

Salesforce.com, Inc. ****** San

Francisco CA 9****** +*.***.***.**** FALSE FALSE

50285112A****** K****** ****** ******@jigsaw.com Salesforce.com, Inc. ****** San

Francisco CA 9****** +*.***.***.**** FALSE FALSE

31487887A****** L****** ****** ******@salesforce.com

Salesforce.com, Inc. ****** San

Francisco CA 9****** +*.***.***.**** FALSE FALSE

53554176A****** N****** ****** ******@salesforce.com

Salesforce.com, Inc. ****** San

Francisco CA 9****** +*.***.***.**** FALSE FALSE

45003056Ali Sadat

Senior Director Product Management Data com

[email protected]

Salesforce.com, Inc.

1 Market Ste 300

San Francisco CA 94105-

5102

+1.415.778.3357

FALSE TRUE

Masked fields if Not Owned (purchased).

Page 16: Introduction to Data.com APIs

Search: Masked Fields in Result• Some fields masked if IsOwned = false• Purchase via API or Data.com tab to see all fields

Page 17: Introduction to Data.com APIs

Company Search

SELECT AnnualRevenue,City,Industry,Name,NumberOfEmployees,Street,Website,YearStarted

FROM DatacloudCompany

WHERE Country = 'United States'

AND Name Like 'Salesforce'

ORDER BY City

LIMIT 50

Just Like Contact Search

Page 18: Introduction to Data.com APIs

Purchasing Records

Page 19: Introduction to Data.com APIs

Search•• SOQL - Filters

Get Transaction Id•• Create

DatacloudPurchaseUsage

Buy Records•• Create

DatacloudOwnedEntity

Get Details•• SOQL – record Id

Purchasing Data is a Multi-Step Process

Page 20: Introduction to Data.com APIs

Purchase Object Relationships

DatacloudOwnedEntity

• DatacloudEntityType• DataDotComKey• PurchaseUsageId

DatacloudContact

• ContactId

DatacloudCompany

• CompanyId

DatacloudPurchaseUsage

• Id• DatacloudEntityType• Description

EntityType=0

EntityType=1

Note: Create only. Purchase is FINAL.

Page 21: Introduction to Data.com APIs

Match returns Single High Confidence result.

Match ≠ Search

Page 22: Introduction to Data.com APIs

Match APIStyle: RESTURLs:

▪ /services/data/v29.0/match/DatacloudMatchEngine/DatacloudCompany

▪ /services/data/v29.0/match/DatacloudMatchEngine/DatacloudContact

2. GET List of available fields and Max Batch Size3. POST Match request

Page 23: Introduction to Data.com APIs

Match Response: Get List of Fields

{

"fieldSets":

"[IsInactive, Country, FirstName, Zip, LastName, IsOwned,

Phone, CompanyId, Email, ContactId, Street, CompanyName,

City, Title, State]",

"maxBatchSize": "30"

}

Page 24: Introduction to Data.com APIs

Contact Match: RequestPost …/services/data/v29.

0/match/DatacloudMatchEngine/DatacloudContact

Body:{ "entities":[ { "attributes":{ "type":"DatacloudContact" }, "FirstName":"Ali", "LastName":"Sadat", "Email":"[email protected]", "CompanyName":"Sale" } ], "fields":[ "FirstName", "LastName", "Email", "Phone", "CompanyName", "CompanyId", "Title", "Street", "City", "State", "Country", "Zip" ]}

Input to Match

List of Fields to include in Result

Page 25: Introduction to Data.com APIs

Contact Match: Result[ { "errorMessage": null, "errorCode": 0, "matchRecords": [ { "entity": { "attributes": { "type": "DatacloudContact" }, "Phone": "+1.415.778.3357", "Street": "1 Market Ste 300", "Email": "[email protected]", "State": "CA", "CompanyId": "159110", "FirstName": "Ali", "Zip": "94105-5102", "CompanyName": "Salesforce.com, Inc.", "Country": "United States", "LastName": "Sadat", "City": "San Francisco", "Title": "Senior Director Product Management Data com" }, "matchDiffs": [ "CompanyName" ] } ] }]

Match ResultsSame order as

Request

Fields that were different from

Request

Page 26: Introduction to Data.com APIs

Company MatchWorks just like Contact Match.GET…/services/data/v29.

0/match/DatacloudMatchEngine/DatacloudCompany

{ "fieldSets" : "[Site, Description, Sic, Country, YearStarted, CompanyId, NaicsCode, DunsNumber, Street, TickerSymbol,

NumberOfEmployees, Phone, Ownership, IsInactive, SicDesc, Zip,

Name, Website, NaicsDesc, State, City, TradeStyle, AnnualRevenue,

Fax, IsOwned, Industry]",

"maxBatchSize" : "30" }

Page 27: Introduction to Data.com APIs

Data.com API Availability by ProductProspector Clean

API Object Corporate Premium Corporate Premium

Search1Contact ✔ ✔

Company ✔ ✔

Purchase1Contact ✔ ✔

Company ✔ ✔

Retrieve2DnB Company

✔ ✔

Match1Contact ✔ ✔

Company ✔ ✔

1. Available at Pilot 2.Available at GA

Page 28: Introduction to Data.com APIs

Daily API Requests Quota LimitAPI sObject Org Level Daily Limit*

SearchContact

Max Calls = 1000/user * # Lic users; Max 100 results / pageCompany

PurchaseContact

No LimitCompany

RetrieveDnB Company

No Limit

MatchContact

Max Calls = 1000/user * # Lic users; Max 30 Match Requests / callCompany

Page 29: Introduction to Data.com APIs

James MakSr. Product Manager, Data.com API@jmak_sfdc

Page 30: Introduction to Data.com APIs

Demo

Page 31: Introduction to Data.com APIs

Winter ‘14 Pilot Overiew - Why & Who • We Hear You!

• Many customers have requested features we do not support in Prospector or Clean applications today

• Search before Create (dupe prevention); Real-time lead clean/nurturing; Enrich web-leads; …

• ISV / Partners want to build apps using high quality data

• Data.com API will be Generally Available by Spring’ 14 to ALL Data.com Prospecting and Clean customers

• Data.com API Pilot now available to selected Data.com customers. Contact us.

Page 32: Introduction to Data.com APIs

Winter ‘14 Pilot Overiew - What & WhenPilot – Winter ‘14 Release – NOW

• Search & Purchase • Match• Reference apps with source code

GA – Spring’14 Release• D&B Company (Premium fields)• Additional Search filters• Contact Dept and Level for Search and Match

Page 33: Introduction to Data.com APIs

Pilot Reference Apps Demo

Page 34: Introduction to Data.com APIs

Ali Sadat

Sr. Dir PM Data.com,@alisadat

James Mak

Sr. PM Data.com API,@jmak_sfdc

Page 35: Introduction to Data.com APIs

We want to hear from YOU!

Please take a moment to complete our session survey

Surveys can be found in the “My Agenda” portion of the Dreamforce app

Page 36: Introduction to Data.com APIs