참여 맞춤 타겟

Facebook 또는 Instagram에서 자신의 콘텐츠에 참여한 사용자를 기반으로 맞춤 타겟을 만듭니다. 현재 지원되는 타겟 유형에는 페이지, Instagram 비즈니스 프로필, 잠재 고객용 광고, 인스턴트 경험 광고, 쇼핑 및 증강 현실이 포함됩니다.

이 가이드에서는 페이지 참여 타겟을 예시로 API에 대해 설명합니다. Facebook은 페이지에 참여한 사용자를 지속적으로 추가하는 방법으로 페이지 참여에 대한 맞춤 타겟을 업데이트합니다. 이 타겟을 처음 생성할 때 Facebook이 특정 잔류 기간에 페이지에 이미 참여한 사용자 리스트로 타겟을 미리 채웁니다.

2018년 9월 이후로 웹사이트 맞춤 타겟, 앱 맞춤 타겟, 참여 맞춤 타겟, 오프라인 전환 데이터의 타겟에 대해 subtype을 지원하지 않습니다. 단, 동영상의 참여 맞춤 타겟에 대해서는 subtype이 계속 지원됩니다.
유럽에서 타겟을 만들거나 유럽에 있는 사용자를 타게팅할 경우 2020년 12월 2일, 버전을 관리하지 않는 변경 사항을 참조하세요.

타겟 만들기

참여 맞춤 타겟을 만들려면 광고 관리자의 광고 계정에서 맞춤 타겟 서비스 약관을 수락해야 합니다.

page_engaged 이벤트에 기반하여 페이지에 참여한 사용자 리스트로 구성된 타겟을 만드는 방법은 다음과 같습니다.

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

매개변수

이름	설명
`name` 문자열	필수 항목. 맞춤 타겟의 이름.
`rule` JSON 개체	필수 항목. 타겟을 정의하기 위한 규칙. 웹사이트 맞춤 타겟과 동일한 구문을 따릅니다.

참여 맞춤 타겟은 맞춤 타겟의 유형입니다. 모든 사용 가능한 필드는 맞춤 타겟 참고 자료를 참조하세요.

참고: 각 광고 계정은 최대 500개의 참여 맞춤 타겟을 만들 수 있습니다.

참여 규칙

Facebook이 타겟 규칙으로 누군가를 맞춤 타겟에 추가했는지 여부를 확인할 수 있습니다.

규칙의 event_sources에 있는 type과 id 필드를 지정하여 참여 개체의 type과 id를 표시합니다. id 필드에는 단일 개체 ID 또는 같은 유형의 ID 배열을 입력할 수 있습니다.

지원되는 이벤트 소스와 해당 참여 개체 ID는 다음과 같습니다.

page: Facebook 페이지 ID.
lead: 잠재 고객 양식 ID.
ig_lead_generation: 잠재 고객 양식 ID.
canvas: 캔버스 ID.
ig_business: Instagram 비즈니스 프로필 ID.
shopping_page: Facebook Shop 페이지 ID.
shopping_ig: Instagram Shop ID.
ar_experience: AR 효과를 사용하는 인스턴트 경험.
ar_effects: 자신이 소유한 Facebook 또는 Instagram 효과. 여기에는 광고에 사용된 효과는 포함되지 않습니다.

각 규칙은 object_id와 event_name으로 구성됩니다.

페이지

object_id를 페이지 ID로 설정합니다. event_name에서 다음의 참여 이벤트 중 하나를 사용합니다.

page_engaged: Facebook 또는 Messenger에서 페이지를 방문했거나 페이지 콘텐츠 또는 광고에 참여했던 사용자. 가장 포괄적인 참여 유형으로, 다른 모든 유형의 참여를 포함합니다.
page_visited: 페이지를 방문했던 사용자.
page_liked: 현재 페이지에 좋아요를 누른 사용자(잔류 상세 정보 및 페이지 좋아요 관련 규칙 참조).
page_messaged: 페이지에 메시지를 전송한 사용자.
page_cta_clicked: 페이지에서 행동 유도 버튼을 클릭한 사용자(예: "문의하기" 또는 "지금 구매하기").
page_or_post_save: 페이지나 페이지 게시물을 저장한 사용자.
page_post_interaction: 페이지 게시물과 상호작용한 사용자. 상호작용에는 공감(좋아요, 최고예요, 웃겨요, 멋져요, 슬퍼요, 화나요), 공유, 댓글, 링크 클릭, 슬라이드 스와이프가 포함됩니다.

잠재 고객용 광고

object_id를 FORM_ID로 설정하고 rule을 다음 잠재 고객용 광고 이벤트 중 하나를 추적하도록 설정해야 합니다.

lead_generation_submitted: 양식을 작성하고 제출한 모든 사용자.
lead_generation_dropoff: 양식을 제출하지 않고 종료한 모든 사용자. 이들은 필드를 작성했을 수도 있고 하지 않았을 수도 있습니다.
lead_generation_opened: 양식 제출 여부와 관계없이 잠재 고객 확보 양식을 열었던 모든 사용자.

인스턴트 경험

object_id를 "CANVAS_ID"로 설정합니다. rule은 다음 이벤트 중 하나를 추적해야 합니다.

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Instagram 비즈니스 프로필

object_id는 "INSTAGRAM_BUSINESS_PROFILE_ID"가 되어야 하고 rule은 다음 Instagram 비즈니스 프로필 이벤트 중 하나를 추적해야 합니다.

ig_business_profile_all: Instagram 비즈니스 프로필을 방문했거나 Instagram 비즈니스 프로필의 콘텐츠 또는 광고에 참여했던 사용자. 가장 포괄적인 참여 유형으로, 다른 모든 유형의 참여를 포함합니다. ig_business_profile_engaged, ig_user_messaged_business 및 ig_user_messaged_business를 결합한 것입니다.
ig_business_profile_engaged: Instagram 비즈니스 프로필에 참여했거나 Instagram 비즈니스 프로필의 콘텐츠 또는 광고에 참여했던 사용자.
ig_user_messaged_business: Instagram 비즈니스 프로필에 메시지를 보냈던 사용자.
ig_business_profile_visit: Instagram 비즈니스 프로필을 방문했던 사용자.
ig_business_profile_ad_saved: Instagram 비즈니스 프로필에서 유기적 콘텐츠 또는 광고를 저장했던 사용자.
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

현재 Instagram 미디어 크리에이터 유형은 동영상 맞춤 타겟 생성에는 지원되지 않습니다.

쇼핑

쇼핑 참여 규칙은 다음 이벤트 중 하나를 추적해야 합니다.

VIEW_CONTENT: 제품 상세 정보 페이지를 조회한 사용자. 이 옵션은 전 세계에서 사용 가능합니다.
ADD_TO_CART: 제품을 장바구니에 담은 사용자. 결제가 활성화된 비즈니스와 미국의 소비자에게만 제공됩니다.
PURCHASE: 제품을 구매한 사용자. 결제를 활성화한 비즈니스와 미국 내 소비자에게만 제공됩니다.

제품을 조회한 사용자를 추가하는 규칙을 만드는 방법은 다음과 같습니다.

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

새로운 공개 범위 규정으로 인해 유럽에서는 page_messaged와 ig_user_messaged_business 매개변수를 사용하지 못할 수 있습니다.

증강 현실

증강 현실 참여 맞춤 타겟에는 AR 경험과 AR 효과, 이렇게 두 부분을 포함할 수 있습니다.

AR 경험 참여 맞춤 타겟의 경우 object_id를 AR 광고 데이터 컨테이너 ID로 설정하고 event_name 필드에는 ar_camera_open 또는 camera_cta_click을 사용합니다.
AR 효과 참여 맞춤 타겟의 경우 object_id를 AR 효과 ID로 설정하고 event_name 필드에 ar_effect_open을 사용합니다.

최대 잔류 기간

법률 및 개인정보 보호 요건을 준수하기 위해 각 이벤트 소스 유형에 대한 최대 잔류 기간은 다르게 적용될 수 있습니다.

잠재 고객 확보 광고: 90일
Instagram 비즈니스 프로필: 730일
페이지: 730일
- 참고: 페이지 좋아요 타겟은 잔류가 없습니다.
인스턴트 경험(구 캔버스): 730일
쇼핑: 365일. 데이터는 2020년 4월 이후부터 제공됩니다.
증강 현실: 365일

제외 섹션이 포함된 참여 규칙

참여 타겟 규칙은 웹사이트 맞춤 타겟 규칙과 호환됩니다. 그러므로 여러 개의 포함 및 제외 규칙이 있을 수 있습니다. 하나 이상의 규칙과 일치되는 사용자가 타겟에 추가됩니다.

다음 예시에서는 페이지를 방문하거나 페이지에 참여한 사용자를 포함하고 행동 유도를 클릭한 사용자를 제외하는 타겟을 만듭니다.

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

자세한 내용은 웹사이트의 맞춤 타겟을 참조하세요.

여러 규칙

참여 타겟은 여러 규칙을 적용할 수 있으며, 하나 이상의 규칙과 일치하는 사용자가 타겟에 추가됩니다. 페이지에 메시지를 보낸 사용자나 행동 유도를 클릭한 사용자를 포함하여 타겟을 만드는 방법의 예시는 다음과 같습니다.

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

여러 페이지

규칙은 단일 페이지로 제한되지 않습니다. 페이지마다 다른 규칙이 적용될 수 있으며 페이지 중 한 개 이상에 참여한 사용자가 있을 수 있습니다. Facebook에서는 이를 타겟에 포함합니다.

3개의 페이지 중 1개 이상을 방문한 모든 사용자를 포함한 예시는 다음과 같습니다.

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

맞춤 타겟에 대한 자세한 내용은 맞춤 타겟 참고 자료를 참조하세요.

페이지 좋아요 잔류 및 규칙

페이지 좋아요 타겟은 잔류가 없습니다(retention_seconds=0). 또한 페이지 좋아요 규칙은 다른 페이지 이벤트와 결합할 수 없습니다.

페이지 좋아요 타겟을 만드는 예시는 다음과 같습니다.

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences