Leads
Marketo の組織のリードを作成、更新、削除、クエリします。
テーブル固有の情報
Select
すべてのカラムは '=' 演算子を使って指定される必要があります。Id およびEmail カラムでは、OR 論理演算子を使って複数の値を指定できます。 OldestUpdatedAt カラムはsince クライテリアとして動作します。until クライテリアを設定するLatestUpdatedAt カラムを追加することで範囲を指定することができます。
取得したい行とカラムだけを指定することで、サーバーからの応答時間を向上できます。
SELECT Id, FirstName, LastName FROM Leads WHERE Email = '[email protected]' OR Email = '[email protected]'
Insert
新しいLead レコードを作成するには、Lead に関するデータベースに入力する情報を指定します。
次の例では、新しいLead を挿入する方法を説明します。
INSERT INTO Leads (Email, FirstName, LastName) VALUES ('[email protected]', 'John', 'Mark')
Update
読み取り専用以外のフィールドは、すべて更新可能です。
UPDATE Leads SET MobilePhone = '111-222-3333' WHERE Id = '1'
Delete
Marketo API はLead の削除を直接サポートしていません。しかし、API 呼び出しから実行されるキャンペーンを作成し、キャンペーンのフローの一部としてLead の削除をトリガすることでLead を削除することができます。 このようなキャンペーンの作成方法についての詳細は、こちらから:http://developers.marketo.com/blog/delete-a-lead-with-the-marketo-api/
Marketo でキャンペーンを作成したら、削除するリードのId またはEmail カラムと併せてCampaignId またはCampaignName カラムのいずれかでキャンペーンを指定することで、削除リクエストを行うことができます。
DELETE FROM Leads WHERE Id = '1000195' AND CampaignId = '1027'
Columns
Name | Type | ReadOnly | Description |
Id [KEY] | Integer | True |
Marketo が割り当てた、アカウントの一意の識別子。 |
String | False |
リードのメールアドレス。 | |
Salutation | String | False |
リードの敬称。 |
FirstName | String | False |
リードのファーストネーム。 |
MiddleName | String | False |
リードのミドルネーム。 |
LastName | String | False |
リードのラストネーム。 |
DateofBirth | Date | False |
リードの生年月日。 |
Title | String | False |
リードの職位。 |
Address | String | False |
リードの住所。 |
City | String | False |
リードの住所(都市)。 |
State | String | False |
リードの住所(都道府県)。 |
PostalCode | String | False |
リードの住所(郵便番号)。 |
Country | String | False |
リードの住所(国)。 |
Website | String | False |
リードのウェブサイト。 |
Phone | String | False |
リードの電話番号。 |
MobilePhone | String | False |
リードの携帯電話。 |
Fax | String | False |
リードのファックス番号。 |
Company | String | False |
リードの企業名。 |
MainPhone | String | False |
リードの企業の電話番号。 |
SICCode | String | False |
リードの企業のSIC コード。 |
Site | String | False |
リードの企業のサイト。 |
BillingStreet | String | False |
リードの企業の請求先住所。 |
BillingCity | String | False |
リードの企業の請求先住所(都市)。 |
BillingState | String | False |
リードの企業の請求先住所(都道府県)。 |
BillingPostalCode | String | False |
リードの企業の請求先住所(郵便番号)。 |
BillingCountry | String | False |
リードの企業の請求先住所(国)。 |
NumberOfEmployees | Integer | False |
リードの企業の従業員数。 |
Industry | String | False |
リードの企業の業界。 |
AnnualRevenue | Decimal | False |
リードの企業の年間収益。 |
LeadScore | Integer | False |
リードのスコア。 |
Rating | String | False |
リードの評価。 |
Unsubscribed | Boolean | False |
リードが配信停止完了かどうかを決定します。 |
UnsubscribedReason | String | False |
リードの配信停止の理由。 |
AnonymousIP | String | False |
リードの匿名IP。 |
Department | String | False |
リードの部門。 |
DoNotCall | Boolean | False |
リードが連絡拒否リストに載っているかどうかを識別します。 |
DoNotCallReason | String | False |
リードが電話連絡拒否の理由。 |
InferredCompany | String | False |
リードの推測される企業。 |
InferredCountry | String | False |
リードの推測される国。 |
LeadRole | String | False |
リードのロール。 |
LeadSource | String | False |
リードのソース。 |
LeadStatus | String | False |
リードの現在のステータス。 |
ForeignSysPersonId | String | False |
外部システムからのリードのId。 |
ForeignSysType | String | False |
ForeignSysPersonId の値が由来する外部システムのタイプ。 |
MarketoSocialFacebookDisplayName | String | False |
リードのFacebook の表示名。 |
MarketoSocialFacebookId | String | False |
リードのFacebook Id。 |
MarketoSocialFacebookPhotoURL | String | False |
リードのFacebook の画像URL。 |
MarketoSocialFacebookProfileURL | String | False |
リードのFacebook のプロファイルURL。 |
MarketoSocialFacebookReach | Integer | False |
リードのFacebook のリーチ。 |
MarketoSocialFacebookReferredEnrollments | Integer | False |
リードのFacebook を参照元とする登録数。 |
MarketoSocialFacebookReferredVisits | Integer | False |
リードのFacebook を参照元とする訪問数。 |
MarketoSocialGender | String | False |
リードのソーシャルジェンダ。 |
MarketoSocialLastReferredEnrollment | Datetime | False |
リードのソーシャルを最後の参照元とする登録。 |
MarketoSocialLastReferredVisit | Datetime | False |
リードのソーシャルを最後の参照元とする訪問。 |
MarketoSocialLinkedInDisplayName | String | False |
リードのLinkedIn の表示名。 |
MarketoSocialLinkedInId | String | False |
リードのLinkedIn Id。 |
MarketoSocialLinkedInPhotoURL | String | False |
リードのLinkedIn の画像URL。 |
MarketoSocialLinkedInProfileURL | String | False |
リードのLinkedIn のプロファイルURL。 |
MarketoSocialLinkedInReach | Integer | False |
リードのLinkedIn のリーチ。 |
MarketoSocialLinkedInReferredEnrollments | Integer | False |
リードのLinkedIn を参照元とする登録数。 |
MarketoSocialLinkedInReferredVisits | Integer | False |
リードのLinkedIn を参照元とする訪問数。 |
MarketoSocialSyndicationId | String | False |
リードのソーシャルシンジケーションId。 |
MarketoSocialTotalReferredEnrollments | Integer | True |
リードのソーシャルを参照元とする総登録数。 |
MarketoSocialTotalReferredVisits | Integer | True |
リードのソーシャルを参照元とする総訪問数。 |
MarketoSocialTwitterDisplayName | String | False |
リードのTwitter の表示名。 |
MarketoSocialTwitterId | String | False |
リードのTwitter Id。 |
MarketoSocialTwitterPhotoURL | String | False |
リードのTwitter の画像URL。 |
MarketoSocialTwitterProfileURL | String | False |
リードのTwitter のプロファイルURL。 |
MarketoSocialTwitterReach | Integer | False |
リードのTwitter のリーチ。 |
MarketoSocialTwitterReferredEnrollments | Integer | False |
リードのTwitter を参照元とする登録数。 |
MarketoSocialTwitterReferredVisits | Integer | False |
リードのTwitter を参照元とする訪問数。 |
MarketoSocialYahooDisplayName | String | False |
リードのYahoo の表示名。 |
MarketoSocialYahooPhotoURL | String | False |
リードのYahoo の画像URL。 |
MarketoSocialYahooProfileURL | String | False |
リードのYahoo のプロファイルURL。 |
MarketoSocialYahooReach | Integer | False |
リードのYahoo のリーチ。 |
MarketoSocialYahooReferredEnrollments | Integer | False |
リードのYahoo を参照元とする登録数。 |
MarketoSocialYahooReferredVisits | Integer | False |
リードのYahoo を参照元とする訪問数。 |
MicrosoftAddress2 | String | False |
リードのMicrosoft 登録住所(2行目)。 |
MicrosoftAddress3 | String | False |
リードのMicrosoft 登録住所(3行目)。 |
MicrosoftBillingAddress2 | String | False |
リードのMicrosoft 登録の請求先住所(2行目)。 |
MicrosoftBillingAddress3 | String | False |
リードのMicrosoft 登録の請求先住所(3行目)。 |
MicrosoftDoNotEmail | Boolean | False |
リードがMicrosoft のメール連絡拒否リストに載っているかどうかを識別します。 |
MicrosoftDoNotFax | Boolean | False |
リードがMicrosoft のファックス連絡拒否リストに載っているかどうかを識別します。 |
MicrosoftDoNotSendMarketingMaterial | Boolean | False |
リードがMicrosoft のDo Not Send Marketing Material リストに載っているかどうかを識別します。 |
MicrosoftHomePhone | String | False |
リードのMicrosoft 登録の自宅電話番号。 |
MicrosoftPreferredMethodofContact | String | False |
リードのMicrosoft 登録の希望する連絡方法。 |
MicrosoftTopic | String | False |
リードのMicrosoft トピック。 |
SAP_CRM_ABCClassification | String | False |
リードのSAP ABC 分類。 |
SAP_CRM_AccountID | String | False |
リードのSAP アカウントId。 |
SAP_CRM_Account_CreatedOn | Datetime | False |
リードのSAP アカウント作成日。 |
SAP_CRM_Account_ExternalID | String | False |
リードのSAP アカウントの外部Id。 |
SAP_CRM_Account_Fax | String | False |
リードのSAP アカウントのファックス番号。 |
SAP_CRM_Account_HouseNumber | String | False |
リードのSAP アカウントの家屋番号。 |
SAP_CRM_Account_IsDeleted | Boolean | False |
リードのSAP アカウントが削除されたかどうかを識別します。 |
SAP_CRM_Account_Status | String | False |
リードのSAP アカウントのステータス。 |
SAP_CRM_BestReachedBy | String | False |
リードのSAP の希望コンタクト方法。 |
SAP_CRM_ContactID | String | False |
リードのSAP コンタクトId。 |
SAP_CRM_Contact_Name | String | False |
リードのSAP コンタクト名。 |
SAP_CRM_DepartmentFromBusinessCard | String | False |
名刺から取得したリードのSAP 部門。 |
SAP_CRM_EmployeeID | String | False |
リードのSAP 従業員Id。 |
SAP_CRM_ExternalSystem | String | False |
リードのSAP 外部システム。 |
SAP_CRM_Function | String | False |
リードのSAP ファンクション。 |
SAP_CRM_Lead_HouseNumber | String | False |
リードのSAP 家屋番号。 |
SAP_CRM_Name | String | False |
リードのSAP 名。 |
SAP_CRM_Person_Type | String | False |
リードのSAP パーソンタイプ。 |
SAP_CRM_PrimaryContact | String | False |
リードのSAP プライマリコンタクト。 |
SAP_CRM_Qualification | String | False |
リードのSAP クオリフィケーション。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
Name | Type | Description |
OldestUpdatedAt | Datetime |
GET の実行時に使用されます。指定した時間以降に更新されたすべてのリードを返します。 |
LatestUpdatedAt | Datetime |
GET の実行時に使用されます。指定した時間までに更新されたすべてのリードを返します。 |
StaticListId | Integer |
GET の実行時に使用されます。取得する静的リストのId。 |
StaticListName | String |
GET の実行時に使用されます。取得する静的リストの名前。 |
CampaignSource | String |
DELETE の実行時に使用されます。キャンペーンのソースを指定するために使用されます。有効な値は、MKTOWS またはSALES です。指定しない場合は、デフォルトでMKTOWS が使用されます。 |
CampaignId | Integer |
DELETE の実行時に使用されます。Delete Lead トリガを含むキャンペーンのId を指定するために使用されます。CampaignId およびCampaignName の両方を指定することはできません。 |
CampaignName | String |
DELETE の実行時に使用されます。Delete Lead トリガを含むキャンペーンの名前を指定するために使用されます。CampaignId およびCampaignName の両方を指定することはできません。 |