광고 크리에이티브

노출 위치 소재 맞춤화

이 솔루션을 사용하여 서로 다른 광고 노출 위치에 표시된 크리에이티브 자산을 맞춤화하세요. 서로 다른 여러 노출 위치를 사용하면서 크리에이티브 관리도 유지하세요.

노출 위치 소재 맞춤화는 소재 맞춤화 규칙을 사용하는 Meta의 세 가지 API 중 하나입니다. 소재 맞춤화 규칙에 대해 자세히 알아보세요.

시작하기

기존 게시물을 사용한 노출 위치 소재 맞춤화는 더 이상 이 API를 통해 지원되지 않습니다. 이 옵션은 광고 관리자에서만 사용할 수 있습니다.

2단계: 크리에이티브 제공

asset_feed_spec을 사용하여 크리에이티브를 제공합니다. 각 소재 유형(예: 이미지, 동영상, 슬라이드, 제목, 본문 텍스트)에 여러 크리에이티브 소재를 지정할 수 있습니다. 링크 설명은 노출 위치별로 맞춤화할 수 없으므로 링크 설명은 하나만 제공하세요.

맞춤화를 적용하는 방법:

  1. asset_feed_spec 내에 asset_customization_rules를 설정합니다.
  2. 각각의 규칙에 대해 customization_spec 및 소재 레이블을 추가합니다.

노출 위치 소재 맞춤화의 경우 각 asset_feed_spec에는 두 개 이상의 맞춤화 규칙이 연결되어 있어야 합니다.

소재 맞춤화 규칙을 참조하세요.

지원되는 속성


속성 이름 설명

customization_spec

유형: 지원되는 필드

필수 항목.

소재를 표시하고자 하는 노출 위치입니다.

image_label

형식: {"name": "{LABEL_NAME}"}

SINGLE_IMAGE 형식에 필수입니다.

표시하고자 하는 이미지의 레이블입니다. 이는 asset_feed_spec의 이미지 소재에 연결됩니다.

video_label

형식: {"name": "{LABEL_NAME}"}

SINGLE_VIDEO 형식에 필수입니다.

표시하고자 하는 동영상의 레이블입니다. 이는 asset_feed_spec의 동영상 소재에 연결됩니다.

carousel_label
형식: {"name": "{LABEL_NAME}"}

CAROUSELS 형식에 필수입니다.

표시하고자 하는 슬라이드의 레이블입니다. 이는 asset_feed_spec의 슬라이드 소재에 연결됩니다.

참고: 노출 위치 소재 맞춤화를 통해 슬라이드를 제공하는 경우 모든 하위 첨부 파일을 자산 피드 사양 내에 정의하고 광고 레이블을 통해 참조해야 합니다. 하위 첨부 파일은 인라인으로 정의되지 않을 수 있습니다. carousels 형식에 대한 자세한 내용은 자산 피드 사양 옵션을 참조하세요.

customization_spec에서 지원되는 필드


속성 이름 설명

publisher_platforms

필수 항목.

광고에 사용 가능한 노출 위치입니다. 옵션으로는 facebook, instagram, messenger 및 audience_network가 있습니다.

facebook_positions

선택 사항이지만 publisher_platforms에서 Facebook을 선택한 경우에는 필수입니다.

Facebook 전용 노출 위치입니다. 옵션으로는 feed, right_hand_column, marketplace, video_feeds, search 및 story가 있습니다.

instagram_positions

선택 사항이지만 publisher_platforms에서 Instagram을 선택한 경우에는 필수입니다.

Instagram 전용 노출 위치입니다. 옵션으로는 stream, story, explore, explore_home, profile_feed 및 ig_search가 있습니다.

참고:explore_home 노출 위치는 SINGLE_IMAGE 형식만 지원합니다.

messenger_positions

선택 사항이지만 publisher_platforms에서 Messenger를 선택한 경우에는 필수입니다.

Messenger 전용 노출 위치입니다. 옵션으로는 messenger_home, sponsored_messages 및 story가 있습니다.

audience_network_positions

선택 사항이지만 publisher_platforms에서 Audience Networks를 선택한 경우에는 필수입니다.

Audience Network 전용 노출 위치입니다. 옵션으로는 classic, instream_video 및 rewarded_video가 있습니다.

사용 가능한 노출 위치 옵션에 대해 자세히 알아보세요.

예 - 피드 설정

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>",
     }' \
  -F 'asset_feed_spec={
      "videos": [
      {
        "adlabels": [
          {
            "name": "labelfb"
          }
        ],
        "video_id": "<VIDEO_ID>"
      },
      {
        "adlabels": [
          {
            "name": "labelig"
          }
        ],
        "video_id": "<VIDEO_ID>"
      }
    ],
    "bodies": [
      {
        "text": "Begin Your Adventure"
      }
    ],
    "link_urls": [
      {
        "website_url": "<WEBSITE_URL>",
        "display_url": "<DISPLAY_URL>"
      }
    ],
    "titles": [
      {
        "text": "Level Up"
      }
    ],
    "ad_formats": [
      "SINGLE_VIDEO"
    ],
    "call_to_action_types": [
      "WATCH_MORE"
    ],
    "descriptions": [
      {
        "text": "Description"
      }
    ],
    "asset_customization_rules": [
      {
        "customization_spec": {          
          "publisher_platforms": [
            "facebook"
          ],          
          "facebook_positions": [
            "feed",
            "instream_video"
          ]
        },
        "video_label": {
          "name": "labelfb"
        }
      },
      {
        "customization_spec": {          
          "publisher_platforms": [
            "instagram"
          ],          
          "instagram_positions": [
            "stream"           
          ]
        },
        "video_label": {
          "name": "labelig"
        }
      }
    ]
  }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

예 - Instagram 둘러보기 홈 소재 맞춤화

curl \
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "<IMAGE-LABEL>"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "explore_home"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "<IMAGE-HASH>",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "<IMAGE-HASH>",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "",
            "display_url": "",
            "deeplink_url": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

예 - Instagram 검색 결과 소재 맞춤화

curl 
  -F 'object_story_spec={
       "page_id": "<PAGE-ID>",
       "instagram_actor_id": "<INSTAGRAM-ID>",
     }' \
  -F 'asset_feed_spec={
        "ad_formats": [
          "SINGLE_IMAGE"
        ],
        "asset_customization_rules": [
          {
            "image_label": {
              "name": "placement_asset_f1048d832ecd558_1661539731099"
            },
            "customization_spec": {
              "publisher_platforms": [
                "instagram"
              ],
              "instagram_positions": [
                "ig_search"
              ]
            }
          }
        ],
        "bodies": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "call_to_action_types": [
          "LEARN_MORE"
        ],
        "images": [
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "adlabels": [
              {
                "name": "adlabel1"
              }
            ]
          },
          {
            "hash": "9ffd7307eae1f9c6e5250fc8760d285f",
            "image_crops": {
              "100x100": [
                [
                  604,
                  0
                ],
                [
                  1659,
                  1055
                ]
              ]
            },
            "adlabels": [
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "link_urls": [
          {
            "website_url": "<WEBSITE_URL>",
            "display_url": "<DISPLAY_URL>",
            "deeplink_url": "<DEEPLINK_URL>",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ],
        "optimization_type": "PLACEMENT",
        "titles": [
          {
            "text": "",
            "adlabels": [
              {
                "name": "adlabel1"
              },
              {
                "name": "adlabel2"
              }
            ]
          }
        ]
      }' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adcreatives

소재 피드 사양에 이용 가능한 모든 옵션을 참조하세요.

5단계(선택 사항): 광고 크리에이티브 읽기

노출 위치 소재 맞춤화 광고의 경우, Instagram 관련 크리에이티브 필드는 {ad-account-id}/ads를 통해 검색해야 합니다. 예를 들면 다음과 같습니다.

https://graph.facebook.com/v21.0/{ad-account-id}/ads?fields=creative{effective_instagram_story_id,instagram_permalink_url}