인사이트 API에 대한 마케팅 믹스 모델링 분석 데이터

인사이트 API에 대한 마케팅 믹스 모델링 분석 데이터는 고객이 Meta 마케팅 사이언스 파트너나 제삼자 대행사 및 모바일 측정 파트너를 거치지 않고 마케팅 믹스 모델링에 대한 Meta 광고 데이터를 빠르고 쉽고 내보내는 데 사용할 수 있는 셀프 서비스 데이터 추출 옵션입니다.

API 호출은 breakdowns=mmm 매개변수를 사용하여 인사이트 API 내로 구축됩니다. 다른 분석 데이터와 달리, 이는 다른 breakdowns 또는 action_breakdowns와의 조합을 지원하지 않습니다.

응답에는 광고 보고서의 마케팅 믹스 모델링 데이터 내보내기에서 제공하는 결과와 유사한 지표와 분석 데이터가 포함됩니다. 마케팅 믹스 모델링 데이터는 광고 세트 수준에서만 제공되며, 이것이 기본 동작입니다(level=adset 매개변수와 동일). 현재 마케팅 믹스 모델링 데이터에 지원되는 지표는 impressions와 spend입니다. 참고:spend는 추산된 지표입니다. 자세한 내용은 인사이트 API, 추산 및 사용 중단된 지표를 참조하세요.

빠른 시작

마케팅 믹스 모델링 데이터를 가져오는 방법은 다음과 같습니다.

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

인사이트 API는 호출에 지정되지 않은 매개변수에 기본값을 사용합니다. time_range 및 date_preset 매개변수를 사용하는 것이 좋습니다. time_increment를 사용하여 응답의 세분화 수준을 더욱 향상할 수 있습니다.

예시

이 API 호출은 지난주의 일일 마케팅 믹스 모델링 데이터를 가져옵니다.

curl \
  -F "access_token=ACCESS_TOKEN" \ 
  -F "breakdowns=mmm" \ 
  -F "date_preset=last_7d" \ 
  -F "time_increment=1” \ 
  "https://graph.facebook.com/v21.0/act_AD_ACCOUNT_ID/insights"

인사이트 API 및 마케팅 API에 온보딩하는 방법에 대한 자세한 내용은 인사이트 API 빠른 시작을 참조하세요.

비즈니스 관리자 수준에서 쿼리

하나의 비즈니스 관리자에 대해 마케팅 믹스 모델링 데이터를 가져오는 것이 일반적입니다. 이 작업이 직접적으로 지원되지 않는 이유는 인사이트 API가 광고 계정 수준 이하에서 작동하기 때문입니다.

1. 비즈니스 관리자에 대해 데이터를 다운로드하려면 먼저 owned_ad_accounts 및 client_ad_accounts 엔드포인트로 사용 가능한 광고 계정을 쿼리해야 합니다.

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/owned_ad_accounts"
   

   curl \
     -F "access_token=ACCESS_TOKEN" \ 
     "https://graph.facebook.com/v21.0/BUSINESS_ID/client_ad_accounts"
   

2. 반환된 개별 광고 계정 ID를 반복 사용하여 각 광고 계정에 대해 마케팅 믹스 모델링 데이터를 쿼리합니다.

제한 및 모범 사례

마케팅 믹스 모델링 데이터는 세분화되어 있어서 많은 개수와 용량의 기록이 응답에 포함됩니다. 이로 인해 연산 중에 요청 시간이 초과될 수 있습니다. 이러한 문제를 완화하기 위해 time_range 및 filtering을 사용하여 요청 크기를 줄이고 섹션 단위로 총 시간 범위에 대해 쿼리하세요. 자세한 내용은 인사이트 API 제한 및 모범 사례를 참조하세요.

이 릴리스의 경우 마케팅 믹스 모델링 데이터를 쿼리하는 데 특정 filtering만 지원됩니다. 아래에 나와 있는 연산자 조합만 필드에 허용되며 그 외의 다른 방식으로 filtering을 사용하면 오류가 반환됩니다.

이 API가 필요하지 않은 경우, 광고 보고서의 마케팅 믹스 모델링 데이터 내보내기를 사용하여 과거 데이터를 내보내는 것이 좋습니다.

또는 인사이트 API 비동기식 작업 플로를 사용할 수도 있습니다. 그러면 비동기 방식으로 데이터를 연산하는 작업이 생성됩니다. 이 엔드포인트는 광고 보고서 실행 id를 포함하여 응답을 반환하며, 작업 상태에 대해 이를 쿼리하고 연산된 데이터를 가져올 수 있습니다. 그러나 일부 요청은 비동기식 작업에서도 시간이 초과될 수 있습니다. 자세한 내용은 인사이트 API 비동기식 작업을 참조하세요.

이 릴리스는 광고 보고서의 마케팅 믹스 모델링 데이터 내보내기와는 열 제목 매핑과 열 제목 순서가 다소 다를 수 있습니다. 또한 이 API에서 쿼리된 다른 테이블과 마케팅 믹스 모델링 분석 데이터의 기본 데이터를 자유롭게 결합할 수 있습니다.