참고 자료

게시물

엔드포인트설명

/{ad-account-id}/ads

광고를 만듭니다.

/{agreement-request-id}

대기 중인 비즈니스 계약 요청을 승인하거나 거부합니다.

/{business-creative-folder-id}

비즈니스 크리에이티브 폴더를 만들고 업데이트합니다.

/{business-id}/creative_folders

비즈니스 크리에이티브 폴더를 제공합니다.

/{business-id}/images

크리에이티브 폴더에 이미지를 업로드합니다.

/{business-id}/videos

크리에이티브 폴더에 동영상을 업로드합니다.

/{business-creative-folder-id}/agencies

크리에이티브 폴더에 파트너를 추가합니다.

/{business-creative-folder-id}/assigned_users

비즈니스 크리에이티브 폴더에 대한 액세스 권한이 있는 사용자의 리스트를 가져옵니다.

읽기

엔드포인트설명

/{business-creative-folder-id}

비즈니스 크리에이티브 폴더에 대한 상세 정보를 가져옵니다.

/{business-id}/creative_folders

비즈니스가 액세스할 수 있는 비즈니스 크리에이티브 폴더의 리스트를 가져옵니다.

/{business-id}/creatives

비즈니스의 비즈니스 이미지와 비즈니스 동영상을 가져옵니다.

/{business-id}/initiated_sharing_agreement

대기 중인 계약 요청의 리스트를 가져옵니다.


이 엔드포인트는 2020년 5월에 다시 도입되었습니다. 앞서 /initiated_sharing_agreement그래프 API V6.0이 출시되면서 사용 중단되었습니다.

/{business-image-id}

이미지의 상세 정보를 가져옵니다.

/{business-image-id}/insights

공유된 이미지에 대한 인사이트를 가져옵니다.

/{business-video-id}

공유된 동영상의 상세 정보를 가져옵니다.

/{business-video-id}/insights

공유된 동영상의 인사이트를 가져옵니다.

/{business-creative-folder-id}/agencies

크리에이티브 폴더에 대한 액세스 권한이 있는 비즈니스의 리스트를 가져옵니다.

/{business-creative-folder-id}/assigned_users

크리에이티브 폴더에 대한 액세스 권한이 있는 사용자의 리스트를 가져옵니다.

삭제

엔드포인트설명
/{business-creative-folder-id}

크리에이티브 폴더를 삭제합니다.

/{business-creative-folder-id}/agencies

크리에이티브 폴더에서 파트너를 삭제합니다.

/{business-creative-folder-id}/assigned_users

크리에이티브 폴더에서 사용자를 삭제합니다.

/{business-image-id}

공유된 이미지를 삭제합니다.

/{business-video-id}

공유된 동영상을 삭제합니다.

허용된 작업

비즈니스 사용자의 허용된 작업설명

CREATE_CONTENT

이 사용자는 폴더를 만들 수 있습니다.

MANAGE_CONTENT

이 사용자는 크리에이티브 폴더 자산을 관리할 수 있습니다.

MANAGE_PERMISSIONS

이 사용자는 비즈니스 크리에이티브 폴더 권한을 관리할 수 있습니다.

VIEW_CONTENT

이 사용자는 크리에이티브 폴더에서 자산을 확인할 수 있습니다.

VIEW_INSIGHTS

이 사용자는 크리에이티브 자산에 대한 인사이트를 확인할 수 있습니다.

인사이트

이러한 지표는 개발 중입니다.

지표 이름설명
impressions

이미지 또는 동영상이 광고에 표시된 횟수입니다.

inline_link_clicks

광고에서 링크를 클릭한 횟수입니다. 인라인 링크 클릭은 고정된 1일 클릭 기여 기간을 사용합니다.

video_play_actions

동영상이 재생되기 시작한 횟수입니다. Facebook에서는 동영상이 노출될 때마다 이 값을 계수하며 다시 보기는 제외합니다.

actions

광고를 통해 발생한 사용자의 총 행동 횟수입니다. 행동에는 참여, 클릭 또는 전환이 포함될 수 있습니다. 지원되는 유형에 대한 전체 리스트는 이 문서를 참조하세요.

video_thruplay_watched_actions

동영상이 끝까지 또는 최소 15초 이상 재생된 횟수입니다.

quality_ranking

광고의 인지된 품질 순위입니다. 품질은 광고 피드백과 클릭 후 경험을 사용하여 측정됩니다. 광고의 순위는 동일한 타겟에 대해 경쟁하는 다른 광고와 비교하여 결정됩니다.


가능한 값은 다음과 같습니다.

  • BELOW_AVERAGE_10
  • BELOW_AVERAGE_20
  • BELOW_AVERAGE_35
  • AVERAGE
  • ABOVE_AVERAGE
  • UNKNOWN(광고에 대한 정보가 충분하지 않은 경우).

이는 광고 관련성 진단과 관련이 있습니다.

다음 분석 데이터를 사용할 수 있습니다.

  • age
  • gender
  • country
  • objective
  • publisher_platform
  • platform_position
  • device_platform
  • optimization_goal