버전 2.11

마케팅 API

출시 2017년 11월 7일 | 블로그 게시물

• 새로운 기능
• 핵심 변경 사항
• 사용 중단 사항
• 즉각적인 사용 중단 사항

새로운 기능

새로워진 비즈니스 관리자 API

이제 고객과 에이전시를 새로운 관계로 나타낼 수 있습니다. 과거에는 user도 없었습니다. 성과 문제를 유발하는 bid/userpermissions를 통해 비즈니스와 비즈니스의 자산에 대한 모든 액세스 권한과 초대를 처리했습니다. 새로운 API의 주요 내용은 다음과 같습니다.

• 비즈니스 범위 사용자 - 새 사용자는 특정 비즈니스에 연결되며 이 비즈니스에 한정된 권한을 가집니다. 사용자는 프로필, 권한 및 해당 비즈니스와 연결된 자산 액세스 권한을 관리할 수 있습니다.
• 초대 - 사람들을 새 엔드포인트를 통해 비즈니스에 액세스하도록 초대하세요. 이러한 엔드포인트에서 사용자 초대의 상태를 확인하고 업데이트하세요.
• 자산 카테고리 - 여러 유형의 자산을 카테고리로 분할하고 각 카테고리에 별도의 엔드포인트를 제공하세요. 이렇게 하면 자산을 읽을 때 결과 페이지를 더 쉽게 구분할 수 있습니다. 또한 비즈니스의 자산 수천 개를 관리하는 경우 성과 문제가 감소합니다. 재디자인을 위해 새 엔드포인트가 여러 개 추가되었습니다.

비즈니스의 사용자에 액세스하려면:

• BUSINESS_ID/business_users
• BUSINESS_ID/system_users
• BUSINESS_ID/pending_users

사용자에게 할당된 자산에 액세스하려면:

• BUSINESS_USER_ID/assigned_pages
• BUSINESS_USER_ID/assigned_ad_accounts
• BUSINESS_USER_ID/assigned_product_catalogs
• SYSTEM_USER_ID/assigned_pages
• SYSTEM_USER_ID/assigned_ad_accounts
• SYSTEM_USER_ID/assigned_product_catalogs
• PENDING_USER_ID/assigned_pages
• PENDING_USER_ID/assigned_ad_accounts
• PENDING_USER_ID/assigned_product_catalogs

비즈니스 페이지에 액세스하려면:

• BUSINESS_ID/owned_pages - 비즈니스 소유의 페이지 리스트 가져오기
• BUSINESS_ID/client_pages - 비즈니스 고객의 페이지 리스트 가져오기
• BUSINESS_ID/pending_owned_pages - 승인 대기 중인 비즈니스 소유의 페이지 리스트 가져오기
• BUSINESS_ID/pending_client_pages - 승인 대기 중인 비즈니스 고객 소유의 페이지 리스트 가져오기

비즈니스 광고 계정에 액세스하려면:

• BUSINESS_ID/owned_ad_accounts - 비즈니스 소유의 광고 계정 리스트 가져오기
• BUSINESS_ID/client_ad_accounts - 비즈니스 고객의 광고 계정 리스트 가져오기
• BUSINESS_ID/pending_owned_ad_accounts - 승인 대기 중인 비즈니스 소유의 광고 계정 리스트 가져오기
• BUSINESS_ID/pending_client_ad_accounts - 승인 대기 중인 비즈니스 고객의 광고 계정 리스트 가져오기

비즈니스 제품 카탈로그에 액세스하려면:

• BUSINESS_ID/owned_product_catalogs - 비즈니스 소유의 제품 카탈로그 리스트 가져오기
• BUSINESS_ID/client_product_catalogs - 비즈니스 고객 소유의 제품 카탈로그 리스트 가져오기

비즈니스 앱에 액세스하려면:

• BUSINESS_ID/owned_apps - 비즈니스 소유의 앱 리스트 가져오기
• BUSINESS_ID/client_apps - 비즈니스 고객의 앱 리스트 가져오기
• BUSINESS_ID/pending_client_apps - 승인 대기 중인 비즈니스 고객 소유의 앱 리스트 가져오기

자세한 내용은 비즈니스 관리자, API, 비즈니스 관리자, 시스템 사용자, Business Asset Management API 및 비즈니스 관리자 API, 모범 사례를 참조하세요.

슬라이드 광고, 실시간 위치

이제 실시간 위치를 보여주는 첨부 파일로 슬라이드 광고를 만들 수 있습니다. AD_CREATIVE_ID/object_story_spec의 place_data에 type=REALTIME 및 location_source_id = PAGE_ID 옵션이 추가되었습니다. 다음 항목의 object_story_spec 필드에서 사용할 수 있습니다.

• POST /AD_ACCOUNT_ID/adcreatives
• GET CREATIVE_ID

매장 방문, 지리적 위치 타게팅

이제 매장 위치 주변의 반경을 벗어난 지리적 영역을 타게팅할 수 있습니다. 매장 방문 목표의 광고를 만들 때 targeting_specs 필드에 geo_locations 매개변수가 추가되었습니다. 제한적으로 이용할 수 있으므로 Facebook 담당자에게 액세스할 수 있는지 확인하세요.매장 방문 목표를 참조하세요.

• POST AD_ACCOUNT_ID/adsets에 새 옵션이 있습니다.
• 타게팅 사양, 위치에서 country_groups에 의한 타게팅 및 travel_in 위치 유형 외에 모든 지리적 영역을 지원합니다.
• 제한적으로 STORE_VISITS 목표의 광고를 만들 수 있습니다. 매장 방문을 참조하세요.

광고 세트, 랜딩 페이지 유형

여기에는 광고가 연결되는 랜딩 페이지, 다시 말해 누군가 광고를 클릭하거나 광고의 행동 유도 버튼을 클릭할 때 이동하는 페이지의 유형이 반영됩니다. 따라서, 광고 세트의 모든 광고에 일관된 랜딩 페이지 유형이 제공되므로 해당 광고에는 다른 유형의 광고 크리에이티브만 포함됩니다. 광고 세트, 랜딩 페이지 유형을 참조하세요.

• 광고 세트에 대한 destination_type이 추가되었습니다.
• /ADSET_ID에서 사용할 수 있습니다.

KPI

캠페인 또는 캠페인의 광고 개체에 대해 추적할 KPI의 유형을 설명하는 AD_ACCOUNT_ID/CAMPAIGN_ID에 새 필드 kpi_type이 추가되었습니다. kpi_results의 kpi_type에 의한 인사이트 데이터를 보려면 다음을 호출하세요.

• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights

자세한 내용은 광고 캠페인, 참고 자료를 참조하세요.

핵심 변경 사항

광고 관리

• right_hand_column광고 타게팅 무효화 - AD_ACCOUNT_ID/adsets에서 right_hand_column에 대한 잘못된 크리에이티브로 이 위치를 타게팅하는 광고는 오류를 반환합니다 right_hand_column 전용 노출 위치는 동영상, 컬렉션 또는 캔버스 광고 형식과 함께 사용할 수 없습니다. right_hand_column 전용 노출 위치의 경우 단일 이미지 및 슬라이드 형식만 사용할 수 있습니다.

• GET VERSION/RF_PREDICTION_ID/pause_periods변경됨 - 이제 더 쉽게 처리할 수 있도록 String이 아니라 Array를 반환합니다.

비즈니스 관리자 API

• 필드 이름 변경됨 - admin_system_user 필드 이름이 admin, system_user 필드 이름이 employee으로 변경되었습니다. 다음 에지에 영향을 미칩니다.

  • /{business-id}/userpermissions
  • /{business-id}/system_users

사용 중단 사항

광고 관리

VIDEO_VIEWS최적화 사용 중단됨 - VIDEO_VIEWS 목표의 캠페인에서 더 이상 CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT, POST_ENGAGEMENT 또는 REACH를 최적화 목표로 사용할 수 없습니다.

• 이러한 최적화 목표로 광고 세트를 만들면 오류가 반환됩니다.
• REACH 최적화 목표의 광고 세트를 복사하면 VIDEO_VIEWS 최적화 목표로 자동 전환됩니다.
• CLICKS, IMPRESSIONS, PAGE_ENGAGEMENT 또는 POST_ENGAGEMENT가 최적화 목표인 광고 세트를 복사하면 오류가 반환됩니다. 기존 광고 세트에서 광고를 만들거나 복사하면 이러한 최적화 목표를 다시 사용하려고 하기 때문입니다.

다음과 같은 에지가 이 변경 사항의 영향을 받습니다.

• POST ACCOUNT_ID/adsets
• POST AD_ACCOUNT_ID/ads
• POST CAMPAIGN_ID/copies
• POST ADSET_ID/copies
• POST AD_ID/copies

reach사용 중단됨 - 브랜드 인지도 목표의 optimization_goal로 더 이상 사용되지 않습니다. /adset의 경우 삭제되었습니다. 광고 상기도 최적화에만 사용할 수 있습니다. 도달을 사용 중단된 목표로 사용하는 경우 혼동을 피할 수 있습니다.

BRAND_AWARENESS최적화 사용 중단됨 - AD_RECALL_LIFT로 대체됩니다. 여기에는 더 효율적인 새 광고 게재 모델이 반영됩니다. 새 최적화 모델은 같은 광고 세트의 이미지 및 동영상 광고와 수동 입찰 등 혼합된 크리에이티브를 지원합니다. BRAND_AWARENESS는 더 이상 다음에서 사용할 수 없습니다.

• POST /ADSET_ID
• GET /ADSET_ID
• POST /AD_ACCOUNT_ID/adsets

frequency_cap사용 중단됨- 다음에서는 lifetime_frequency_cap 및 frequency_cap_reset_period 필드가 포함됩니다.

• POST AD_ACCOUNT_ID/adsets
• GET /ADSET_ID
• POST /ADSET_ID

대신 frequency_control_specs를 사용합니다.

POST_ENGAGEMENT행동당 비용 사용 중단됨 - POST_ENGAGEMENT를 더 이상 이 목표의 billing_event로 사용할 수 없습니다. 따라서 광고 게재와 측정이 더 효율적으로 조정됩니다. /AD_SET_ID 엔드포인트에 영향을 미칩니다.

광고 인사이트 및 측정

다음에서 video_15_sec_watched_actions사용 중단됨:

• GET AD_ACCOUNT_ID/insights
• GET CAMPAIGN_ID/insights
• GET ADSET_ID/insights
• GET AD_ID/insights
• POST AD_ACCOUNT_ID/insights
• POST CAMPAIGN_ID/insights
• POST ADSET_ID/insights
• POST AD_ID/insights

recurrence_value사용 중단됨 - 고급 측정 API에서. 이 필드는 Atlas API 아래에서 보고 일정으로도 알려져 있었습니다. recurrence_values로 대체되었습니다. 고급 측정, 보고 일정을 참조하세요.

비즈니스 관리

새로운 비즈니스 관리자 API를 위해 사용 중단된 엔드포인트:

• BUSINESS_ID/userpermissions
• BUSINESS_ID/business_persona
• business_persona_id

자산을 관리하기 위해 사용 중단된 엔드포인트:

• BUSINESS_ID/pages
• BUSINESS_ID/adaccounts
• BUSINESS_ID/product_catalogs
• BUSINESS_ID/apps

자산에 엑세스하려면 BUSINESS_ID/owned_ASSET 또는 BUSINESS_ID/client_ASSET을 사용하세요.

다른 비즈니스 소유의 자산을 관리하기 위해 사용 중단된 엔드포인트:

• BUSINESS_ID/assigned_ad_accounts
• BUSINESS_ID/assigned_pages
• BUSINESS_ID/assigned_product_catalogs

대신 BUSINESS_USER_ID/assigned_ASSET을 사용하세요.

즉각적인 사용 중단 사항

이 사용 중단은 모든 API 버전에 영향을 미치며 2017년 11월 14일에 적용됩니다.

이벤트 광고 및 링크 광고

유효한 페이지에 연결되지 않은 이벤트 광고 또는 링크 광고 만들기 및 수정 기능이 사용 중단되었습니다. 다음 형식은 더 이상 유효하지 않으며 오류가 반환됩니다.

사용 중단되는 서명:

• 이벤트 광고

  • 목표: EVENT_RESPONSES
  • 크리에이티브 필드: body, object_id
• 링크 광고

  • 목표: LINK_CLICKS
  • 크리에이티브 필드: title, body, object_url(image_file 또는 image_hash)

지원되는 서명

• 이벤트 광고

  • 목표: EVENT_RESPONSES
  • 크리에이티브 필드: object_story_id 또는 object_story_spec
• 링크 광고

  • 목표: LINK_CLICKS
  • 크리에이티브 필드: object_story_id 또는 object_story_spec

이전에 만든 기존의 이벤트 및 링크 광고는 계속 게재되지만 이 변경 사항이 적용된 후에는 광고의 크리에이티브를 수정하거나 새 광고를 만들 수 없습니다. 그럴 경우 오류가 반환됩니다. 이벤트 및 주변 지역 광고와 광고, 참고 자료를 참조하세요.