다언어 광고

광고의 이미지, 동영상, 텍스트 및 본문과 같이 광고 크리에이티브의 다양한 부분을 맞춤 설정하여 서로 다른 언어를 구사하는 사용자에게 도달하도록 합니다. Facebook은 적절한 사람에게 적절한 언어 버전을 표시하기 위해 광고를 최적화합니다.

이렇게 하면 광고를 여러 언어로 손쉽게 설정하는 데 도움이 되고, 광고에 적합한 광범위한 타게팅을 유지하면서도 시청자에게 광고에서 가장 개연성 있는 언어 버전을 제공할 수 있습니다. 그러면 시청자가 사용하는 언어를 근거로 개인화된 콘텐츠를 확보하면서도 비용 효율적인 광고를 유지할 수 있습니다.

이 기능에 대한 일반적인 정보는 광고주 지원 센터의 여러 언어로 광고하기 도움말을 참조하세요. 지원되는 광고 캠페인 목표를 참조하세요.

다언어 광고는 자산 맞춤화 규칙을 사용하는 3가지 API 중 하나입니다.

시작하기

시작하기 전에 이 제품의 제한 사항을 확인하세요. 사용 사례가 Facebook의 사양과 일치할 경우 다음 단계를 진행하세요.

1단계: 광고 캠페인 및 광고 세트 만들기
2단계: asset_feed_spec을 통해 크리에이티브 제공 —사용 가능한 언어를 참조하세요.
3단계: creative_spec에서 asset_feed_spec으로 광고 만들기
4단계(선택 사항): 광고 미리 보기

광고를 직접 번역할 리소스가 없다면 자동 번역 서비스를 참고하세요.

2단계: `asset_feed_spec`을 통해 크리에이티브 제공

다언어 광고 크리에이티브는 asset_feed_spec을 사용하여 지정합니다. 자산 피드는 이미지, 제목, 본문 등 여러 크리에이티브 요소의 컬렉션입니다. /adcreative에서 asset_feed_spec을 생성합니다.

asset_feed_spec을 만들려면 각 다른 언어에 대한 자산 배열을 제공합니다. 각 자산에 레이블을 추가해 태깅하고 해당 자산이 속한 언어를 식별합니다. Facebook은 asset_customization_rules의 레이블을 사용하여 언어별로 자산을 그룹화합니다. 자산 유형당 하나 이상의 자산을 제공해야 합니다.

사용 가능한 매개변수

asset_feed_spec에서 제공하는 매개변수:

속성 이름 설명

속성 이름	설명
`images` 유형: 배열	`SINGLE_IMAGE` 광고 형식에 필수입니다. `url` 또는 `hash`를 제공합니다. `url` 또는 `hash` 형태의 이미지입니다. 광고 계정의 이미지 라이브러리에 있는 이미지를 제공해야 합니다. 이 필드는 `{"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]}`의 배열로 제공합니다.
`videos` 유형: 배열	`SINGLE_VIDEO` 광고 형식에 필수입니다. `video_ids`의 배열입니다. 광고 계정의 동영상 라이브러리에 있는 동영상이어야 합니다. 이 필드는 `{"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]}`의 배열로 제공합니다.
`bodies` 유형: 배열	필수이지만 `url_tags`는 선택 사항입니다. 광고의 주요 메시지가 포함된 본문 배열입니다. 이 필드는 `{"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}`의 배열로 제공합니다.
`titles` 유형: 배열	필수이지만 `url_tags`는 선택 사항입니다. 제목의 배열입니다. 광고의 짧은 제목. 일반적으로 링크, 이미지 또는 동영상 옆에 표시됩니다. 이 필드는 `{"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}`의 배열로 제공합니다.
`descriptions` 유형: 배열	필수이지만 `url_tags`는 선택 사항입니다. 보조 설명 텍스트의 배열입니다. 이 필드는 `{"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}`의 배열로 제공합니다. 설명을 비워두려면 공백 한 칸으로 빈 문자열을 사용합니다
`link_urls` 유형: 배열	필수이지만 `display_url`과 `deeplink_url`은 선택 사항입니다. 링크 URL의 배열입니다. 이 필드는 `{"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"}`의 배열로 제공합니다.
`call_to_action_types` 유형: 배열	필수 항목. call-to-action-type 값의 배열입니다. 이 필드는 지원되는 행동 유도(`["<CALL_TO_ACTION>"]`)의 배열로 제공합니다.
`ad_formats`	필수 항목. 광고를 생성하고자 하는 Facebook 광고 형식의 배열입니다. 지원되는 형식: `SINGLE_IMAGE`, `SINGLE_VIDEO`. 이 필드는 지원되는 광고 형식(`["{<AD_FORMAT>}"]`)의 배열로 제공합니다.
`asset_customization_rules` 유형: 자산 맞춤화 규칙의 표를 참조하세요.	필수 항목. 자산 맞춤화 규칙의 배열입니다.

images

유형: 배열

SINGLE_IMAGE 광고 형식에 필수입니다. url 또는 hash를 제공합니다.

url 또는 hash 형태의 이미지입니다. 광고 계정의 이미지 라이브러리에 있는 이미지를 제공해야 합니다.

이 필드는 {"url": "<IMAGE_URL>", "hash": "<IMAGE_HASH>", "url_tags": "<TAG>", "adlabels": [{name: "<LABEL>"}]}의 배열로 제공합니다.

videos

유형: 배열

SINGLE_VIDEO 광고 형식에 필수입니다.

video_ids의 배열입니다. 광고 계정의 동영상 라이브러리에 있는 동영상이어야 합니다.

이 필드는 {"video_id": "<VIDEO_ID>","thumbnail_url": "{<THUMBNAIL_URL>}", "url_tags": "{<TAG>}", "adlabels": [{"name": "<LABEL>"}]}의 배열로 제공합니다.

bodies

유형: 배열

필수이지만 url_tags는 선택 사항입니다.

광고의 주요 메시지가 포함된 본문 배열입니다.

이 필드는 {"text": "<BODY_TEXT>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}의 배열로 제공합니다.

titles

유형: 배열

필수이지만 url_tags는 선택 사항입니다.

제목의 배열입니다. 광고의 짧은 제목. 일반적으로 링크, 이미지 또는 동영상 옆에 표시됩니다.

이 필드는 {"text": "<TITLE>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}의 배열로 제공합니다.

descriptions

유형: 배열

필수이지만 url_tags는 선택 사항입니다.

보조 설명 텍스트의 배열입니다.

이 필드는 {"text": "<DESCRIPTION>", "url_tags": "<TAG>", "adlabels": [{"name": "<LABEL>"}]}의 배열로 제공합니다. 설명을 비워두려면 공백 한 칸으로 빈 문자열을 사용합니다

link_urls

유형: 배열

필수이지만 display_url과 deeplink_url은 선택 사항입니다.

링크 URL의 배열입니다.

이 필드는 {"website_url": "<URL>", "adlabels": [{"name": "<LABEL>"}], "deeplink_url": "<DEEPLINK>", "display_url": "<URL>"}의 배열로 제공합니다.

call_to_action_types

유형: 배열

필수 항목.

call-to-action-type 값의 배열입니다.

이 필드는 지원되는 행동 유도(["<CALL_TO_ACTION>"])의 배열로 제공합니다.

ad_formats

필수 항목.

광고를 생성하고자 하는 Facebook 광고 형식의 배열입니다. 지원되는 형식: SINGLE_IMAGE, SINGLE_VIDEO.

이 필드는 지원되는 광고 형식(["{<AD_FORMAT>}"])의 배열로 제공합니다.

asset_customization_rules

유형: 자산 맞춤화 규칙의 표를 참조하세요.

필수 항목.

자산 맞춤화 규칙의 배열입니다.

소재 맞춤화 규칙

특정 언어를 사용하는 시청자에게 함께 표시되는 자산을 정의하는 데 도움을 줍니다. 각 규칙에 customization_spec이 있어 이것이 광고 전송 중에 자산을 보는 사람들의 로캘을 정의합니다.

단 하나의 기본 규칙만 제공합니다. 이 규칙에는 누군가의 기본 설정 언어가 자산 피드에 지정된 어떤 로캘과도 일치하지 않는 경우 Facebook이 표시하는 자산을 반드시 포함해야 합니다. 이렇게 하면 광고의 전달 부족을 예방하는 데 도움이 됩니다.

속성 이름 설명

속성 이름	설명
`customization_spec` 유형: `{"locales": [<LOCALE1>, <LOCALE2>]}`	필수 항목. 이 규칙의 자산을 게재해야 하는 로캘을 정의합니다. 지원되는 로캘은 사용 가능한 언어를 참조하세요.
`image_label` 유형: `{"name": "<LABEL>"}`	`SINGLE_IMAGE` 광고 형식에 필수입니다. 자산 피드의 이미지 자산 중 하나에 첨부된 레이블입니다.
`video_label` 유형: `{"name": "<LABEL>"}`	`SINGLE_VIDEO` 광고 형식에 필수입니다. 자산 피드의 동영상 자산 중 하나에 첨부된 레이블입니다.
`body_label` 유형: `{"name": "<LABEL>"}`	필수 항목. 자산 피드의 본문 자산 중 하나에 첨부된 레이블입니다.
`title_label` 유형: `{"name": "<LABEL>"}`	필수 항목. 자산 피드의 제목 자산 중 하나에 첨부된 레이블입니다.
`description_label` 유형: `{"name": "<LABEL>"}`	필수 항목. 자산 피드의 설명 자산 중 하나에 첨부된 레이블입니다.
`link_url_label` 유형: `{"name": "<LABEL>"}`	필수 항목. 자산 피드의 `link_url` 자산 중 하나에 첨부된 레이블입니다.
`is_default` 유형: 부울	필수 항목. 기본 규칙을 식별하기 위한 부울 플래그입니다. `is_default` 플래그를 `true`로 지정한 규칙을 딱 하나 설정해야 합니다.

customization_spec

유형: {"locales": [<LOCALE1>, <LOCALE2>]}

필수 항목.

이 규칙의 자산을 게재해야 하는 로캘을 정의합니다. 지원되는 로캘은 사용 가능한 언어를 참조하세요.

image_label

유형: {"name": "<LABEL>"}

SINGLE_IMAGE 광고 형식에 필수입니다.

자산 피드의 이미지 자산 중 하나에 첨부된 레이블입니다.

video_label

유형: {"name": "<LABEL>"}

SINGLE_VIDEO 광고 형식에 필수입니다.

자산 피드의 동영상 자산 중 하나에 첨부된 레이블입니다.

body_label

유형: {"name": "<LABEL>"}

필수 항목.

자산 피드의 본문 자산 중 하나에 첨부된 레이블입니다.

title_label

유형: {"name": "<LABEL>"}

필수 항목.

자산 피드의 제목 자산 중 하나에 첨부된 레이블입니다.

description_label

유형: {"name": "<LABEL>"}

필수 항목.

자산 피드의 설명 자산 중 하나에 첨부된 레이블입니다.

link_url_label

유형: {"name": "<LABEL>"}

필수 항목.

자산 피드의 link_url 자산 중 하나에 첨부된 레이블입니다.

is_default

유형: 부울

필수 항목.

기본 규칙을 식별하기 위한 부울 플래그입니다. is_default 플래그를 true로 지정한 규칙을 딱 하나 설정해야 합니다.

사용 가능한 언어

customization_spec에서 제공하는 로캘은 광고 타게팅에서 지원되는 로캘 ID여야 합니다. 타게팅 및 노출 위치, 로캘을 참조하세요. /search 엔드포인트를 사용하여 특정 언어를 검색할 수 있습니다. q 매개변수를 사용하여 특정 언어 이름을 검색할 수 있습니다. 지원되는 모든 언어의 리스트를 얻으려면 이 매개변수를 비워두세요.

curl -G \
  -d "type=adlocale" \
  -d "q=en" \
  -d "limit=2" \
  -d "access_token=<ACCESS_TOKEN>" \ 
  https://graph.facebook.com/v21.0/search

성공하면 언어 리스트를 얻게 됩니다.

{
  "data": [
    {
      "key": 6,
      "name": "English (US)"
    },
    {
      "key": 24,
      "name": "English (UK)"
    }
  ],
  "paging": {
    "cursors": {
      "before": "MAZDZD",
      "after": "MAZDZD",
    }
  }
}

이러한 검색 결과의 키를 자산 맞춤화 규칙에서 로캘로 사용해야 합니다. 자세한 내용은 타게팅 검색을 참조하세요.

3단계: 자산 피드 사양을 사용하여 광고 만들기

자산 피드는 POST ad_account_ID/adcreatives의 asset_feed_spec 필드를 사용하여 만듭니다.

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Essayez notre délicieuse recette de guacamole!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "french"}],
         },
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}],
         },
         {
           "text": "Les meilleurs avocats!",
           "adlabels": [{"name": "french"}],
         },
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com/en",
           "adlabels": [{"name": "english"}],
         },
         {
           "website_url": "www.jaspersmarket.com/fr",
           "adlabels": [{"name": "french"}],
         },
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>",
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "asset_customization_rules": [
         {
           "customization_spec": {
             "locales": [9,44],
           },
           "title_label": {"name": "french"},
           "body_label": {"name": "french"},
           "description_label": {"name": "french"},
           "link_url_label": {"name": "french"},
         },
         {
             "is_default": true,
           "customization_spec": {
             "locales": [24]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"},
         },
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

성공하면 광고 크리에이티브의 ID를 얻게 됩니다.

{"id":"238474593777777"}

asset_feed_spec이 아래의 제한 사항에 부합하지 않으면 오류가 표시됩니다.

이 광고 크리에이티브 ID로 광고를 만들려면 POST act_AD_ACCOUNT_ID/ads를 호출합니다. 또는 광고의 creative 매개변수에 asset_feed_spec 및 object_story_spec을 제공하여 광고에 여러 가지 언어를 표시할 수도 있습니다.

새로운 asset_feed_spec을 인증하려면 광고 ID 또는 광고 크리에이티브 ID에서 GET을 호출합니다.

curl -G \
-d 'fields=object_story_spec,asset_feed_spec' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/<CREATIVE_ID>

4단계(선택 사항): 광고 미리 보기

generatepreview 엔드포인트를 사용하여 광고의 여러 가지 언어 버전을 미리 볼 수 있습니다. 규칙에 adlabel과 함께 dynamic_asset_label 필드를 추가하여 특정 언어 버전을 확인할 수 있습니다.

위의 크리에이티브 프랑스어 버전을 미리 보는 방법의 예시는 다음과 같습니다.

curl -G \
  --data-urlencode 'creative={ 
    "object_story_spec": { 
      "page_id": "<PAGE_ID>" 
    },
    "asset_feed_spec": {
      ...
    }
  }' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'dynamic_asset_label=french'
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/generatepreviews

자동 번역

광고를 직접 번역할 리소스가 없다면 Facebook의 자동 번역 서비스를 사용할 수 있습니다. 이 기능은 기본 광고 문구를 추가 언어로 번역해서 다언어 타겟에게 도달할 수 있도록 합니다.

자동 번역의 소스는 기본 자산 맞춤화 규칙에서 지정한 텍스트 자산에서 확인할 수 있습니다. 자동 번역된 광고 문구는 "자동으로 번역됨" 레이블이 표시됩니다.

광고 문구의 자동 번역 버전을 만들려면 autotranslate를 asset_feed_spec에 추가하세요. 그런 다음, 문구를 번역할 언어를 지정합니다. 예시를 확인해보세요.

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
       "ad_formats": ["SINGLE_IMAGE"],
       "autotranslate": ["fr_XX"],
       "bodies": [
         {
           "text": "Try our delicious guacamole recipe!",
           "adlabels": [{"name": "english"}],
         }
       ],
       "titles": [
         {
           "text": "Jaspers Market",
           "adlabels": [{"name": "english"}]
         }
       ],
       "descriptions": [
         {
           "text": "The best avocados!",
           "adlabels": [{"name": "english"}]
         }
       ],
       "link_urls": [
         {
           "website_url": "www.jaspersmarket.com",
           "adlabels": [{"name": "english"}]
         }
       ],
       "images": [
         {
           "hash": "<IMAGE_HASH>"
         },
       ],
       "call_to_action_types": ["SHOP_NOW"],
       "optimization_type": "LANGUAGE",
       "asset_customization_rules": [
         {
           "is_default": true,
           "customization_spec": {
             "locales": [6]
           },
           "title_label": {"name": "english"},
           "body_label": {"name": "english"},
           "description_label": {"name": "english"},
           "link_url_label": {"name": "english"}
         }
       ]
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

자동 번역된 문구는 크리에이티브에서 asset_feed_spec 필드를 호출하여 검토할 수 있습니다.

동일한 언어가 autotranslate 필드에 지정되어 있다면 사양에서 자동 번역된 문구의 수정 사항은 삭제됩니다. 이러한 수정 사항은 기본 광고 문구의 새로운 번역으로 대체됩니다. 수정이 꼭 필요한 경우에는 autotranslate 필드에서 언어를 제거하세요.

`link_urls`

자동 번역된 광고 버전에 맞춤 링크 URL을 추가할 수 있습니다.

이를 위해서는 adlabel과 함께 link_urls 필드에 language-specific URL을 추가하고 이 언어의 관련 로캘 코드 및 link_url_label을 포함하여 asset_customization_rules에 새 규칙을 추가합니다.

제한 사항

다음은 자산 피드의 제한 사항과 한도입니다.

광고 형식

asset_feed_spec당 광고 형식 1개만
SINGLE_IMAGE 형식의 경우 이미지를 하나 이상 제공해야 합니다.
SINGLE_VIDEO 형식의 경우 동영상을 하나 이상 제공해야 합니다.

자산, 일반

call_to_action_types를 제외한 모든 자산 유형에 최대 49개의 자산을 제공할 수 있습니다.
모든 목표에서 call_to_action_type 자산은 딱 한 개만 제공해야 합니다.

텍스트 자산

자산 피드의 모든 언어 버전에 한 개 이상의 텍스트 자산(예: title, 본문, description, link_urls)을 제공해야 합니다.
모든 텍스트 자산은 adlabels 필드가 있어야 합니다.
최대 길이: 제목은 255자, 본문은 4,096자, 설명은 10,000자입니다.

이미지 및 동영상 자산

노출 위치 및 개체별 권장 이미지 크기는 광고 가이드를 참조하세요.
adlabel 없이 이미지 또는 동영상 자산을 최대 1개 사용할 수 있습니다. 이 이미지 또는 동영상은 모든 언어 버전에 대하여 사용합니다.
추가 동영상 또는 이미지를 제공하는 경우 adlabel을 반드시 포함해야 하며 자산 맞춤화 규칙에 이러한 레이블을 제공해야 합니다.

링크 URL 자산

url_tags를 제공하는 경우, Facebook에서는 이를 광고 내 각 자산의 매개변수로서 link_url에 추가합니다.
APP_INSTALLS 목표를 사용하는 경우, link_url이 광고 세트의 promoted_object.object_store_url과 같아야 합니다.

소재 맞춤화 규칙

asset_feed_spec의 모든 언어 버전마다 자산 맞춤화 규칙을 하나씩 제공해야 합니다.
기본 규칙을 하나 제공해야 합니다. 이것은 is_default가 true로 설정된 자산 맞춤화 규칙입니다. 이것이 백업 규칙 역할을 하여 누군가의 로캘이 asset_feed_spec의 어떤 언어와도 일치하지 않는 경우에도 광고가 표시되도록 지원합니다.

노출 위치

다언어 광고는 모든 노출 위치를 지원합니다.

사용 가능한 목표와 랜딩 페이지 유형

LINK_CLICKS - Messenger를 제외한 웹사이트와 앱.
APP_INSTALLS - 데스크톱 또는 모바일 앱.
CONVERSIONS - Messenger를 제외한 웹사이트와 앱.
REACH - 모든 랜딩 페이지 유형.
BRAND_AWARENESS - 모든 랜딩 페이지 유형.
VIDEO_VIEWS - 모든 랜딩 페이지 유형

지원되는 구매 유형

REACH - 도달 및 빈도
AUCTION

지원되는 번역 방향

지원되는 번역 방향은 다음과 같습니다. autotranslate 필드에 해당 언어 코드를 사용하세요.

소스 언어	타겟 번역 언어	언어 코드
영어	스페인어	`es_XX`
영어	프랑스어	`fr_XX`
영어	독일어	`de_DE`
영어	포르투갈어	`pt_XX`
영어	이탈리아어	`it_IT`
영어	아랍어	`ar_AR`
영어	네덜란드어	`nl_XX`
영어	말레이시아어	`ms_MY`
영어	스웨덴어	`sv_SE`
영어	인도네시아어	`id_ID`
영어	폴란드어	`pl_PL`
영어	힌디어	`hi_IN`
영어	덴마크어	`da_DK`
영어	터키어	`tr_TR`
영어	타갈로그어	`tl_XX`
영어	루마니아어	`ro_RO`
독일어	영어	`en_XX`
아랍어	영어	`en_XX`
히브리어	영어	`en_XX`
스페인어	영어	`en_XX`
일본어	영어	`en_XX`
노르웨이어	영어	`en_XX`
프랑스어	영어	`en_XX`
네덜란드어	영어	`en_XX`
스웨덴어	영어	`en_XX`

다언어 광고

시작하기

2단계: asset_feed_spec을 통해 크리에이티브 제공

사용 가능한 매개변수

소재 맞춤화 규칙

사용 가능한 언어

3단계: 자산 피드 사양을 사용하여 광고 만들기

4단계(선택 사항): 광고 미리 보기

자동 번역

link_urls

제한 사항

광고 형식

자산, 일반

텍스트 자산

이미지 및 동영상 자산

링크 URL 자산

소재 맞춤화 규칙

노출 위치

사용 가능한 목표와 랜딩 페이지 유형

지원되는 구매 유형

지원되는 번역 방향

2단계: `asset_feed_spec`을 통해 크리에이티브 제공

`link_urls`