Looker의 Salesforce 캠페인 통합을 사용하여 Salesforce에서 캠페인을 생성하고 Looker Explore 또는 Look의 리드 및 연락처를 캠페인 구성원에게 채울 수 있습니다. 새 캠페인을 만들거나 Looker의 기존 캠페인에 사용자를 추가할 수 있습니다.
설정 요구사항
Salesforce API v42.0 이상(2018년 봄 출시)
사용자는 캠페인 객체에서 '만들기' 및 '수정' 권한(기본적으로 '마케팅 사용자' 프로필에 연결됨) 및 사용자 프로필에서 선택한 '마케팅 사용자' 체크박스가 필요합니다.
권한이 없으면 다음 오류 메시지가 표시될 수 있습니다. entity type cannot be inserted...
설정 안내
사용자 속성을 만들어 작업에 대한 액세스를 제어하고 Salesforce 도메인을 지정합니다. 관리자 메뉴의 사용자 섹션에 있는 사용자 속성 페이지에서 사용자 속성 만들기를 클릭합니다. 신규 사용자 속성을 정의합니다.
이름: salesforce_campaigns_action_domain
라벨: Salesforce 캠페인 작업 도메인
데이터 유형: 문자열
사용자 액세스 권한: 보기
값 숨기기: No
기본값 없음
저장을 선택합니다.
사용자 속성을 정의하면 Salesforce 도메인(예: 'https://MyDomainName.my.salesforce.com')을 작업을 사용할 개별 사용자 및 사용자 그룹에 값으로 할당할 수 있습니다. 사용자 속성 페이지 상단에서 사용자 값 및 그룹 값 탭을 선택하여 개별 사용자와 사용자 그룹에게 각각 값을 할당합니다.
사용자마다 다른 도메인(예: 스테이징 또는 개발 Salesforce 인스턴스)을 타겟팅할 수 있으며 언제든지 도메인 값을 업데이트할 수 있습니다.
할당된 값이 없는 사용자에게는 이 작업이 도착 옵션으로 표시되지 않습니다.
그런 다음 작업을 사용 설정합니다. 관리 메뉴의 플랫폼 섹션에서 작업 페이지로 이동하여 Salesforce 캠페인 작업 도메인 작업 옆에 있는 사용 설정을 선택합니다. Salesforce 캠페인 작업 도메인 페이지에서 사용 설정됨 전환 버튼을 사용 설정하고 Salesforce 도메인 입력란에 Salesforce 캠페인 작업 도메인 사용자 속성을 선택합니다. 저장을 클릭합니다.
원하는 경우 연락처 및 리드 필드에 각각 LookML 태그 sfdc_contact_id 및 sfdc_lead_id를 설정합니다. 또는 작업이 /contact id/i 및 /lead id/i(대소문자를 구분하지 않음) 표현식과 필드 라벨을 정규식 일치시키려고 시도합니다.
Salesforce 캠페인 액션 사용
Salesforce 캠페인 작업이 구성되면 Looker 스케줄러에서 이 작업을 사용할 수 있습니다.
이 작업을 처음 사용하는 경우 Salesforce에 로그인하라는 메시지가 표시됩니다. 로그인을 클릭합니다.
OAuth 동의 화면에서 허용을 클릭하고 Looker 스케줄러 창으로 돌아갑니다.
사용자 인증 정보 확인을 선택합니다. Looker 스케줄러 내에서 Salesforce에 로그인한 후 Salesforce 캠페인 작업 양식을 작성하여 Look 또는 Explore 제공의 세부정보를 구성합니다.
만들기 또는 추가: 새 캠페인을 만들려면 만들기를, 기존 캠페인을 수정하려면 추가를 선택합니다.
캠페인 이름: 새 캠페인의 이름을 입력하거나 기존 캠페인을 선택합니다.
회원 상태: 캠페인 회원의 상태를 선택합니다. 이 목록은 Salesforce 인스턴스의 사용 가능한 상태로 채워집니다.
Looker에서 Salesforce 오류 표시: Yes로 설정하면 Looker의 예약된 작업 상태 세부정보에 캠페인 회원을 설정할 때 발생하는 Salesforce 오류를 표시할 수 있습니다. 이렇게 하면 관리 메뉴의 일정 기록 페이지에 있는 Looker의 예약된 작업 상태에 오류가 기록되어 회원 수준의 오류를 해결하는 데 유용합니다. 캠페인 회원과 관련된 모든 오류를 무시하려면 No로 설정합니다(기본값). 이렇게 하면 캠페인 회원을 설정할 때 발생하는 오류와 관계없이 완료 상태가 기록됩니다.
전송을 위한 다른 옵션을 지정하세요.
보내기를 선택합니다.
Salesforce 캠페인 액션 삭제
연결된 Salesforce 인스턴스를 전환하거나 Salesforce 인스턴스에서 Looker 작업을 연결 해제하려면 Salesforce 계정 내에서 Looker 애플리케이션에 대한 연결을 취소하면 됩니다.
제한사항
이 작업은 최대 5,000개의 행으로 제한됩니다. 모든 결과를 전송하는 기능은 현재 개발 중입니다.
각 Salesforce 버전에는 24시간 동안 허용되는 API 호출 수에 제한이 있습니다. 인스턴스의 API 한도를 알아보려면 Salesforce API 요청 한도 및 할당 문서를 참고하세요. 이 작업은 sObject Collection과 함께 POST 요청을 활용하여 단일 요청으로 여러 레코드(API 호출당 200개의 레코드)를 실행합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-30(UTC)"],[],[],null,["# Sending data to Salesforce Campaigns\n\nYou can use Looker's Salesforce Campaigns integration to create campaigns in Salesforce and populate the campaign members with leads and contacts from a Looker Explore or Look. You can choose to create a new campaign or append users to an existing campaign in Looker.\n\nSetup requirements\n------------------\n\n- Salesforce API v42.0 and later (released Spring 2018)\n- Users will need \"Create\" and \"Edit\" [permissions](https://help.salesforce.com/s/articleView?id=sf.admin_userperms.htm&type=5) on the Campaigns object (this is associated with the \"Marketing User\" profile by default) as well as the \"Marketing User\" checkbox selected on their user profile\n - If you do not have sufficient permissions, you may see the following error message: `entity type cannot be inserted...`\n\nSetup instructions\n------------------\n\n1. Create a [user attribute](/looker/docs/admin-panel-users-user-attributes#creating_user_attributes) to control access to the action and specify the Salesforce domain. On the **User Attributes** page in the **Users** section of the **Admin** menu, click **Create user attribute**. Define your new user attribute:\n\n - Name: **salesforce_campaigns_action_domain**\n - Label: **Salesforce Campaigns Action Domain**\n - Data Type: **String**\n - User Access: **View**\n - Hide Values: **No**\n - No default value\n\n Select **Save**.\n2. Once you define a user attribute, you can assign Salesforce domain (for example, \"https://MyDomainName.my.salesforce.com\") as a *value* to the individual users and user groups that will use the action. Select the **User Values** and **Group Values** tabs at the top of the **User Attributes** page to assign values to [individual users](/looker/docs/admin-panel-users-user-attributes#assigning_values_to_individual_users) and [user groups](/looker/docs/admin-panel-users-user-attributes#assigning_values_to_user_groups), respectively.\n\n - Different users can target different domains (for example, a Staging or Development Salesforce instance), and you can update the domain value at any time.\n - Users who do not have an assigned value will not see the action as a destination option.\n3. Next, enable the action. Go to the **Actions** page in the **Platform** section of the **Admin** menu, and select **Enable** next to the **Salesforce Campaigns Action Domain** action. On the **Salesforce Campaigns Action Domain** page, enable the **Enabled** toggle, and select the **Salesforce Campaigns Action Domain** user attribute for the **Salesforce domain** field. Click **Save**.\n\n4. Optionally, set up LookML tags `sfdc_contact_id` and `sfdc_lead_id` for contacts and lead fields, respectively. Alternatively, the action will attempt to regex match the field label with the following expressions: `/contact id/i` and `/lead id/i` (case insensitive).\n\nUsing the Salesforce Campaigns action\n-------------------------------------\n\nOnce the Salesforce Campaigns action has been configured, you can use it in the Looker Scheduler:\n\n1. From a Look or an Explore, [create a schedule or select the option to **Send** a one-time delivery](/looker/docs/delivering-looks-explores#creating_a_delivery).\n2. Under **Where should this data go?** , select the **Salesforce Campaigns** action.\n3. The first time you use the action, you will be prompted to log in to Salesforce. Click **Log in**.\n4. On the OAuth consent screen, click **Allow** and return to the Looker Scheduler window.\n5. Select **Verify credentials** . Once you've logged in to Salesforce within the Looker Scheduler, fill out the **Salesforce Campaigns** action form to configure the details of your Look or Explore delivery:\n\n 1. **Create or Append** : Select **Create** create a new campaign or **Append** to modify an existing campaign.\n 2. **Campaign Name**: Enter the name for the new campaign or select an existing campaign.\n 3. **Member Status**: Select the status of the campaign members. This list will be populated from available statuses from your Salesforce instance.\n 4. **Surface Salesforce Errors In Looker** : Set this to **Yes** to surface any Salesforce errors with setting campaign members in Looker's scheduled job status detail. This will record an **Error** in Looker's scheduled job status on the **Schedule History** page in the **Admin** menu, which is useful for troubleshooting errors on a member level. Set this to **No** to ignore all errors related to campaign members (default). This will record a **Complete** status, regardless of any errors that might have occurred when you set up the campaign members.\n6. Specify any other options for your delivery.\n\n7. Select **Send**.\n\nRemoving the Salesforce Campaigns action\n----------------------------------------\n\nIf you want to switch the connected Salesforce instance or disconnect the Looker action from your Salesforce instance, you can [revoke the connection](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_request_manage.htm&) to the Looker application from within your Salesforce account.\n\nLimitations\n-----------\n\n- This action is limited to a maximum of 5,000 rows. The functionality to send all results is currently being developed.\n- Each Salesforce Edition has a limit to the number of API calls that are allowed in a 24-hour period. Refer to the [Salesforce API Request Limits and Alloctions](https://developer.salesforce.com/docs/atlas.en-us.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_api.htm) documentation to learn your instance's API limits. This action leverages POST requests with [sObject Collections](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_composite_sobjects_collections_create.htm) to execute multiple records (200 records per API call) in a single request."]]
