この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

CampaignMember

キャンペーンと、リードまたは取引先責任者との間の関連を表します。

サポートされているコール

API バージョン 15.0 以前: create()、delete()、describeLayout()、describeSObjects()、getDeleted()、getUpdated()、query()、retrieve()、update()、upsert()

API バージョン 16.0 以降: upsert()

特別なアクセスルール

カスタマーポータルユーザはこのオブジェクトにアクセスできません。

項目

項目	詳細
CampaignId	型 reference プロパティ Create、Filter、Group、Sort 説明必須。Lead または Contact が関連付けられる Campaign の ID。
City	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の住所の市区郡。
CompanyOrAccount	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の会社または取引先。
ContactId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明必須。Campaign に関連付けられている Contact の ID。
CurrencyIsoCode	型 picklist プロパティ Create、Defaulted on create、Filter、Nillable、Restricted picklist、Update 説明複数の currency 機能を有効化している組織にのみ使用できます。組織で使用できる currency の ISO コードが指定されています。
Country	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の住所の国。
Description	型 textarea プロパティ Nillable 説明関連付けられたリードまたは取引先責任者の説明。
DoNotCall	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明取引先責任者が電話による連絡を希望しないことを示します。
Email	型 email プロパティ Filter、Group、Nillable、Sort 説明取引先責任者またはリードのメールアドレス。
Fax	型 phone プロパティ Filter、Group、Nillable、Sort 説明取引先責任者またはリードの FAX 番号。
FirstName	型 string プロパティ Filter、Group、Nillable、Sort 説明取引先責任者またはリードの名。
FirstRespondedDate	型 date プロパティ Filter、Group、Nillable、Sort 説明キャンペーンメンバーが、最初にレスポンスありの状況に指定された日付を示します。
HasOptedOutOfEmail	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明取引先責任者またはリードが Salesforce からのメールの受信を希望しないか (`true`)、希望するか (`false`) を示します。
HasOptedOutOfFax	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明取引先責任者またはリードが FAX による連絡を希望しないことを示します。
HasResponded	型 boolean プロパティ Defaulted on create、Filter、Group、Sort 説明キャンペーンメンバーが、キャンペーンにレスポンスを行ったか (`true`)、否か (`false`) を示します。表示ラベルは Responded です。
LastName	型 string プロパティ Filter、Group、Nillable、Sort 説明取引先責任者またはリードの姓。最大 80 文字です。
LeadId	型 reference プロパティ Create、Filter、Group、Nillable、Sort 説明必須。Campaign に関連付けられている Lead の ID。
LeadOrContactId	型 reference プロパティ Filter、Group、Nillable、Sort 説明関連付けられたリードまたは取引先責任者の ID。
LeadOrContactOwnerId	型 reference プロパティ Filter、Group、Nillable、Sort 説明関連付けられたリードまたは取引先責任者の所有者の ID。
LeadSource	型 picklist プロパティ Filter、Group、Nillable、Sort 説明リードの取得元。
MobilePhone	型 phone プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の携帯電話番号。
Name	型 string プロパティ Filter、Group、Nillable、Sort 説明キャンペーンメンバーが関連付けられている取引先責任者またはリードの氏名。
Phone	型 phone プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の電話番号。
PostalCode	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の郵便番号。
RecordTypeId	型 reference プロパティ Create、Filter、Nillable、Update 説明このオブジェクトに割り当てられるレコードタイプの ID。レコードタイプを変更するには、関連付けられた Campaign の CampaignMemberRecordTypeId 項目を変更します。
Salutation	型 picklist プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の敬称。
State	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の住所の都道府県。最大 80 文字です。
Status	型 picklist プロパティ Create、Filter、Group、Nillable、Sort、Update 説明このオブジェクトの HasResponded フラグを制御します。HasResponded フラグは参照のみであるため直接設定できません。この項目を create コールまたは update コールで設定することで間接的に設定することができます。それぞれの事前定義された値は、HasResponded フラグ値を意味します。この項目を更新するごとに、HasResponded フラグが暗黙的に更新されます。Salesforce ユーザインターフェースでは、マーケティングユーザが、Status 選択リスト項目の有効な状況値を定義できます。デフォルトの状況として、1 つの状況を選択できます。Status 項目の各値を対象に、「レスポンスあり」としてカウントする値を選択することもできます。つまり、それらの値に対しては、HasResponded フラグが `true` に設定されます。最大 40 文字です。キャンペーンメンバーの作成や更新では、CampaignMemberStatus オブジェクトの ID ではなく、Status のテキスト値を使用します。メモ
Street	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の住所の町名・番地。
Title	型 string プロパティ Filter、Group、Nillable、Sort 説明リードまたは取引先責任者の役職。
Type	型 string プロパティ Filter、Group、Nillable、Sort 説明キャンペーンメンバーがリードまたは取引先責任者かどうかを示します。

CampaignMember データを Salesforce にインポートし、CreatedDate など、監査項目に値を設定する必要がある場合は、Salesforce にご連絡ください。これらの項目を自身で設定する必要がない限り、監査項目は API 操作時に自動的に更新されます。

メモ

使用方法

各レコードには一意の ID があり、ContactId または LeadId のいずれかを指定する必要がありますが、両方を指定することはできません。両方を指定して 1 つのレコードを作成しようとすると、挿入処理自体は正常に行われますが、ContactId のみが挿入されます。ただし、1 つの Campaign に 2 つのレコードを個別に作成できます。1 つは Lead、もう 1 つは Contact のレコードです。

Contact またはLead の標準項目は、CampaignMember オブジェクトに関連付けられていますが、直接照会することはできません。たとえば、リードのPhone をクエリに含めるには、Lead オブジェクトの項目を照会します。

1SELECT Id, (SELECT Phone FROM Lead)
2FROM CampaignMember

このオブジェクトは、マーケティング機能を使用でき、有効なマーケティングライセンスを付与されている組織にのみ定義されています。組織にマーケティング機能または有効なマーケティングライセンスが付与されていない場合、このオブジェクトは describeGlobal() コールに表示されず、CampaignMember オブジェクトでは、describeSObjects() または query() を使用できません。

API バージョン 16.0 以降では create() コールはレコードを作成するのみですが、それ以前のバージョンでは create() コールはレコードを作成し、更新します。API は、指定された CampaignId および ContactId または LeadId にレコードが存在するかどうかを特定します。

取引先責任者に変換するリードベースのキャンペーンメンバーを追跡する場合を除き、ContactId または LeadId のいずれかを使用し、2 つ同時に使用しないようにします。

メモ

API を使用する場合、create() コールでは、キャンペーンへの「参照」アクセス権のみが必要です。

指定された ContactId または LeadId にレコードが存在しない場合、新しいレコードが作成されます。レコードが存在する場合、エラーが返され、更新は行われません。既存のレコードを更新するには、更新する CampaignMember レコードの ID を指定します。

API バージョン 15.0 以前では、1 つの create 要求を使用して複数のレコードを送信し、複数のレコードが既存のレコードに一致した場合、送信した最初のレコードに基づいて既存のレコードが更新されます。送信されたレコード間で一致があり、かつ、既存のレコードに一致するものがないという場合は、送信された最後のレコードに基づいて作成が実行されます。

upsert() コールは、API バージョン 16.0 以降でサポートされていません。このオブジェクトに upsert() コールを使用するには、まずレコード ID 以外の ID 項目のすべてのデータを削除する必要があります。

レコードを削除するには、削除する CampaignMember レコードの ID を指定します。

レコードを作成または更新する場合、コールで指定された Status 項目値は、指定された Campaign で有効な状況がどうかが検証されます。

指定された Status 値が有効な状況である場合、値が更新され、HasResponded に関連付けられた Status の値に応じて、HasResponded 項目が true または false に更新されます。
指定された Status の値が有効な状況ではない場合、API はデフォルトの状況を Status 項目に割り当て、関連付けられた値で HasResponded 項目を更新します。ただし、指定された Campaign にデフォルトの状況がない場合、API はコールで指定された値を Status 項目に割り当て、HasResponded 項目は false に設定します。

Salesforce および Lightning プラットフォームのオブジェクトリファレンス

CampaignMember

サポートされているコール

特別なアクセスルール

項目

使用方法

関連項目: