시작하기

다음의 단계에 따라 마케팅 API로 첫 광고를 만드세요.

시작하기 전에

그래프 API 및 Facebook의 광고 캠페인 구조를 알고 있어야 합니다. 호출할 준비가 되면 다음 항목이 필요합니다.

Facebook 개발자 계정: 개발자 도구에 액세스하고 Facebook 앱을 만드는 데 사용됩니다.
Facebook 앱: 빌드하는 모든 유형의 Facebook 광고 기능에 대한 컨테이너입니다.
액세스 토큰: 시스템 사용자 액세스 토큰 또는 장기 실행되는 사용자 액세스 토큰을 가져올 수 있습니다.
권한: API 사용 방식에 따라 다릅니다.
광고 계정: 광고, 청구 설정, 지출 한도에 대한 액세스를 관리하기 위한 광고 계정이 필요합니다. 광고 관리자의 광고 계정 설정에서 계정 번호를 찾으세요.

이제 시작할 수 있습니다. 마케팅 API를 사용하기 위한 일반 모범 사례도 잊지 말고 확인하세요.

1단계: 캠페인 만들기

Campaign 클래스에서 새 캠페인 목표를 생성하는 프로세스를 시작합니다. 이 단계에서는 광고의 목표를 설정해야 하는데, 광고 목표란 캠페인의 전체적인 목표를 의미합니다. 테스트하는 동안 청구되지 않도록 먼저 PAUSED 캠페인을 만드는 것이 좋습니다.

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

성공하면 새로 생성된 광고 캠페인의 ID가 반환됩니다. 이 ID를 잊지 말고 저장하세요. 광고 관리자에서 생성된 캠페인을 확인할 수도 있습니다.

리소스:

2단계: 타게팅 정의

참조 문서

광고 세트를 만들기 전에 타겟 대상을 정의해야 합니다. 다음 단계에서는 광고 세트를 만들고 타겟의 속성을 지정합니다.

여러 타게팅 옵션을 사용할 수 있습니다. 이 예시에서는 타게팅 검색을 사용하여 타겟을 설정하는 데 사용할 수 있는 사전 정의된 값을 검색합니다.

먼저 'united'라는 단어가 포함된 사용 가능한 국가를 검색해 보겠습니다.

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=united' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

그런 다음, '영화'라는 단어를 포함한 관심사를 검색할 수 있습니다.

curl -G \
  -d 'type=adinterest' \
  -d 'q=movie' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

위의 호출에서 반환된 값을 보았을 때 미국에서 영화에 관심이 있는 사용자로 구성된 타겟을 생성할 수 있습니다. 타게팅 사양은 다음과 같습니다.

targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "interests": [{id: 6003139266461, 'name': 'Movies'}]
}

3단계: 광고 세트를 생성하고 예산, 청구, 최적화 및 기간 정의

광고 세트는 같은 일일 또는 총 예산, 일정, 청구, 최적화 및 타게팅 데이터를 공유하는 광고 그룹입니다. 이 단계에서는 AdSet 클래스에서 새 개체를 생성하고 다음을 지정해야 합니다.

기간: 광고가 게재되는 기간입니다. start_time과 end_time을 사용하여 설정합니다.
예산: 지출하고자 하는 금액입니다. daily_budget 또는 lifetime_budget을 사용합니다.
최적화: 광고를 통해 달성하고자 하는 결과입니다. optimization_goal을 사용하여 설정합니다.
청구: 원하는 결제 방식입니다. billing_event를 사용합니다.
입찰: 최적화 이벤트 발생에 부여할 가치입니다. bid_amount 필드를 사용합니다.
타게팅: 2단계에서 생성된 타게팅 사양을 사용합니다.

광고 세트를 만들려면 1단계에서 저장한 광고 캠페인 ID도 필요합니다.

curl \
  -F 'name=My Ad Set' \
  -F 'optimization_goal=REACH' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=2' \
  -F 'daily_budget=1000' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}, "interests": [{id: 6003139266461, "name": "Movies"}]}' \
  -F 'start_time=2024-10-06T04:45:17+0000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets

테스트하는 동안 요금이 부과되지 않도록 PAUSED 상태에서 광고 세트를 만드는 것이 좋습니다.

4단계: 광고 크리에이티브 제공하기

참조 문서

광고 크리에이티브

이 단계에서는 AdCreative 개체를 사용하여 광고의 시각적 요소를 제공할 것입니다. 제공해야 하는 정보는 목표에 따라 달라지지만 공통적인 속성은 다음과 같습니다.

이미지 및 동영상
제목 및 설명
링크
행동 유도 버튼

목표에 따라 고급 필드를 제공해야 할 수도 있습니다. 예를 들어 iOS 앱용 광고에는 App Store URL이 필요합니다.

크리에이티브를 광고 세트의 일부로 또는 독립적으로 정의할 수 있습니다. 어느 경우든 광고 계정의 크리에이티브 라이브러리에 광고 크리에이티브를 저장하고 광고에 사용할 수 있습니다.

예

이 예시는 이미지를 제공하고 AdCreative 개체를 생성하는 방법을 보여줍니다.

먼저 이미지 파일에서 AdImage 개체를 생성합니다.

curl \
  -F 'filename=@<IMAGE_PATH>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adimages

그런 다음 이미지 해시를 사용하여 AdCreative를 만듭니다.

curl -X POST \
  -F 'name="Sample Creative"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "image_hash": "<IMAGE_HASH>",
         "link": "https://facebook.com/<PAGE_ID>",
         "message": "try it out"
       }
     }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_IN"
        }
      }
    }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives

광고 관리자의 미디어 라이브러리로 이동하여 이미지 업로드를 확인합니다.

현재 링크가 포함된 AdCreative는 아직 광고 관리자에 표시되지 않습니다. 이 데이터는 광고를 예약한 후에 볼 수 있습니다. 그래프 API 탐색기로 광고 크리에이티브를 디버깅하고 읽으려는 필드를 지정할 수 있습니다.

GET /{my-creative-id} HTTP/1.1
Host: graph.facebook.com/?fields=object_story_spec

5단계: 게재 예약하기

마지막으로 광고 개체를 만들어 AdCreative와 AdSet를 연결합니다. Ad의 status를 paused로 설정하여 바로 주문되지 않도록 합니다.

curl -X POST \
  -F 'name="My Ad"' \
  -F 'adset_id="&lt;AD_SET_ID&gt;"' \
  -F 'creative={
       "creative_id": "<CREATIVE_ID>"
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/act_<AD_ACCOUNT_ID>/ads

광고 관리자에서 광고가 존재하는지 확인합니다. 방금 생성한 캠페인을 클릭한 다음, 광고 세트와 광고를 차례로 클릭합니다.

API를 사용하여 광고를 간편하게 예약한 후 상태를 active로 설정합니다. 우선 광고는 광고 검토를 받게 되며, 상태가 PENDING_REVIEW로 설정됩니다. 검토를 마친 후에는 ACTIVE 상태로 돌아갑니다.

광고 복사

기존 광고, 자산 또는 캠페인을 복사할 수 있습니다. 이 기능은 신속하게 캠페인을 복제하여 구성을 변경하거나 실험군을 만들어 성과 정보를 추출하는 데 도움이 됩니다. 자세한 내용은 다음을 참조하세요.