Marketing API
Versi Graph API

Ad Creative Link Data Image Layer Spec

Membaca

How to render text and frame overlays on an image for a dynamic item in Dynamic Ads

Contoh

Graph API Explorer
GET v21.0/...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"...?fields={fieldname_of_type_AdCreativeLinkDataImageLayerSpec}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Jika Anda ingin mempelajari cara menggunakan Graph API, baca Menggunakan panduan Graph API kami.

Parameter

Titik akhir ini tidak memiliki parameter.

Kolom

KolomKeterangan
blending_mode
enum {lighten, multiply, normal}

Combine the product image and frame image together using a certain blend mode. This field is only valid for frame_overlay.

Default
content
AdCreativeLinkDataImageTextOverlayContent

The content of text_overlay. It includes five fields, type, price, low_price, high_price and auto_show_enroll_status.

Default
frame_auto_show_enroll_status
enum

This field indicates whether the ad is eligible for frame overlay automation which could conditionally not display frame for some users if it predicts that doing so would increase ad engagement.

Default
frame_image_hash
string

The hash string for a frame image that you can use in creatives.This field is required for frame_overlay.

Default
frame_source
enum {custom}

The source of the frame image. Currently, we only support custom. This field is required for frame_overlay.

Default
image_source
enum {catalog}

The source of the product image. Currently, we only support catalog. This field is required for image layer.

Default
layer_type
enum {frame_overlay, image, text_overlay}

Each layer can be a layer of image, frame_overlay or text_overlay. This field is required for each layer.

Default
opacity
int32

The opacity of the text or frame image. This field is valid for both text_overlay and frame_overlayFor text, the valid values are 75 and 100, For frame image, the valid value is from 10 to 100. The bigger number means more opaque.

Default
overlay_position
enum {bottom, bottom_left, bottom_right, center, left, right, top, top_left, top_right}

Position for overlay on an image. This field is valid for both text_overlay and frame_overlay

Default
overlay_shape
enum {circle, none, pill, rectangle, triangle}

The background shape of text_overlay. The value none means no shape underneath the text.

Default
scale
int32

The scale resizes the frame image by multiples of ten from 10 to 100. 100 means the original size of frame image, 10 means the smallest size.This field is only valid for frame_overlay.

Default
shape_color
string

The color of the background in text_overlay. It should be represented as a three-digit or six-digit hexadecimal number. For example, 09C, FFFFFF.

Default
text_color
string

The color of the text in text_overlay. It should be represented as a three-digit or six-digit hexadecimal number. For example, 09C, FFFFFF.

Default
text_font
enum {droid_serif_regular, lato_regular, noto_sans_regular, nunito_sans_bold, open_sans_bold, open_sans_condensed_bold, pt_serif_bold, roboto_condensed_regular, roboto_medium}

Font type for text strings. If you choose a text font which does not support the language you are using, it will fallback to the default font.This field is only valid for text_overlay.

Default

Membuat

Anda tidak dapat melakukan operasi ini pada titik akhir ini.

Memperbarui

Anda tidak dapat melakukan operasi ini pada titik akhir ini.

Menghapus

Anda tidak dapat melakukan operasi ini pada titik akhir ini.