새로운 광고 크리에이티브를 포함한 Instagram 파트너십 광고
브랜디드 콘텐츠 미디어(예: 크리에이터가 브랜디드 콘텐츠로 태그한 게시물)로 파트너십 광고를 만들 수 있습니다.
이 문서에서는 다음을 수행하는 방법을 안내합니다.
- 본인을 기본 ID로 크리에이터를 보조 ID로 설정하여 광고 만들기
- 크리에이터를 기본 ID로 지정하고 회원님을 보조 ID로 지정하여 광고 만들기
시작하기 전에
파트너십 광고를 만드는 데 대한 요구 사항을 검토합니다.
새 크리에이티브 업로드
- 이미지를 업로드 및 관리하여 나중에 광고 크리에이티브에 사용합니다. 이미지 형식, 크기 및 디자인 가이드라인은 광고 유형에 따라 달라집니다. 자세한 내용은 광고 가이드 및 이미지 자르기를 참조하세요.
- 동영상을 업로드하려면 동영상 API 게시 가이드라인을 따르세요.
크리에이터의 Instagram ID 가져오기
크리에이터의 Instagram ID를 가져오려면 비즈니스 검색을 사용하는 것이 좋습니다.
요청 예시
이 샘플 쿼리는 Blue Bottle Coffee Instagram 계정의 크리에이터 Instagram ID를 가져오는 방법을 보여줍니다. 비즈니스 검색 쿼리는 데이터를 가져오려는 Instgram 비즈니스 또는 크리에이터 계정의 사용자 이름(이 예시에서는 bluebottle)이 아니라 Instagram 비즈니스 또는 크리에이터 계정의 ID(이 경우 17841405309211844)에서 수행됩니다.
curl -i -X GET \ "https://graph.facebook.com/v25.0/17841405309211844?fields=business_discovery.username(bluebottle)&access_token=<ACCESS_TOKEN>"
응답 예시
{
"business_discovery": {"id": "17841401441775531" // Blue Bottle's Instagram Account ID }
}
본인을 기본 ID로 설정하여 광고 만들기
/act_{ad-account-id}/adcreatives 엔드포인트로 POST 요청을 보냅니다. 이때 page_id 필드는 기본 ID의 브랜드 Facebook 페이지 ID로 설정합니다. 또한 sponsor_id(Instagram) 또는 sponsor_page_id(Facebook) 필드 중 하나를 전달하거나 둘 다 전달하여 파트너십 광고의 보조 ID로 설정됩니다.
참고:sponsor_id 또는 sponsor_page_id 중 하나만 제공할 경우, 연결된 Instagram 사용자 ID 또는 Facebook 페이지 ID가 자동으로 연결됩니다. Instagram 계정과 Facebook 계정 사이에 하드 링크가 없는 경우, 광고가 해당 특정 플랫폼에 게재되지 않습니다.
요청 예시
{ "degrees_of_freedom_spec": { // required field to be passed "creative_features_spec": { "standard_enhancements": { // required field to be passed "action_metadata": { "type": "DEFAULT" }, "enroll_status": "OPT_IN" } }, "degrees_of_freedom_type": "USER_ENROLLED_AUTOFLOW" }, "facebook_branded_content": { "sponsor_page_id": "255033446395141" // Creator Page ID (test rithiky brand) }, "instagram_branded_content": { "sponsor_id": "90010551992170" // Creator IG ID (test_rithiky_brand) }, "object_story_spec": { "page_id": "110001241469329", // Advertiser Page ID (test vitaan brand new) "link_data": { "attachment_style": "link", "call_to_action": { "type": "LEARN_MORE" }, "link": "www.instagram.com", // sample url "image_hash": "1b7a65956006e9941608b3914d3964f5" //sample image hash } } }
응답 예시
{
"id": <CREATIVE_ID>
}
광고 예시
위의 샘플 요청이 어떻게 광고를 출력하는지 살펴보겠습니다.
크리에이터를 기본 ID로 설정하여 광고 만들기
page_id 필드를 크리에이터의 Facebook 페이지 ID로 설정하여 POST 요청을 /act_{ad-account-id}/adcreatives 엔드포인트로 보냅니다.
크리에이터가 기존 Facebook 페이지를 가지고 있지 않을 경우, 페이지 ID를 page_id 필드로 전달할 수 있지만 광고는 Facebook에 게재되지 않습니다.
참고: Instagram 사용자 ID는 object_story_spec 필드에서 전달된 Facebook 페이지 ID에서 자동으로 생성됩니다.
요청 예시
{ "degrees_of_freedom_spec": { // required field to be passed "creative_features_spec": { "standard_enhancements": { // required field to be passed "action_metadata": { "type": "DEFAULT" }, "enroll_status": "OPT_IN" } }, "degrees_of_freedom_type": "USER_ENROLLED_AUTOFLOW" }, "facebook_branded_content": { "sponsor_page_id": "255033446395141" // Advertiser Page ID (test vitaan brand) }, "instagram_branded_content": { "sponsor_id": "35302227070484" // Advertiser IG ID (test_vitaan_brand) }, "object_story_spec": { "page_id": "255033446395141", // Creator Page ID (test rithiky brand) "link_data": { "attachment_style": "link", "call_to_action": { "type": "LEARN_MORE" }, "link": "www.instagram.com", // sample url "image_hash": "1b7a65956006e9941608b3914d3964f5" //sample image hash } } }
응답 예시
{
"id": <CREATIVE_ID>
}
광고 예시
위의 샘플 요청이 어떻게 광고를 출력하는지 살펴보겠습니다.
광고 만들기
위의 섹션 중 하나를 사용하여 제공한 광고 크리에이티브로 광고를 만들려면 /act_{ad-account-id}/ads 엔드포인트로 POST 요청을 보냅니다. 이때 name 필드는 광고 이름으로 설정하고, adset_id 필드는 광고 세트 ID로 설정하며, creative 매개변수가 포함된 creative_id 필드는 수신한 광고 크리에이티브 ID로 설정하고, status는 처음에 PAUSED로 설정합니다.
요청 예시
curl -X POST \ -F 'name": "My Ad's Name"' \ -F 'adset_id: <ADSET_ID>' \ -F 'creative: {"creative_id": <CREATIVE_ID>}' \ -F 'status: "PAUSED"' \ -F 'access_token=<ACCESS_TOKEN>'\ 'https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads'
응답 예시
성공 시 앱이 광고 ID를 받습니다.
{
"id": <AD_ID>
}
반환된 광고 ID는 광고를 게시하는 데 사용할 수 있습니다.