Asset Customization für Platzierung

Verwende diese Lösung, um die Anzeigengestaltung in verschiedenen Anzeigenplatzierungen anzupassen. Behalte die Kontrolle über die Anzeigengestaltung, während du verschiedene Platzierungen verwendest.

Die Placement Asset Customization ist eine unserer drei APIs, die Asset Customization-Regeln verwenden. Erfahre hier mehr über die Asset Customization-Regeln.

Erste Schritte

Schritt 1: Erstelle eine Anzeigenkampagne und Anzeigengruppe
Schritt 2: Stelle Anzeigengestaltung und personalisierte Assets bereit
Schritt 3: Erstelle deine Werbeanzeige
Optionaler Schritt 4: Erhalte Insights und analysiere Ergebnisse
Optionaler Schritt 5: Lies den Inhalt der Werbeanzeige

Die Placement Asset Customization mit bestehenden Beiträgen wird über die API nicht mehr unterstützt. Diese Option ist nur im Werbeanzeigenmanager verfügbar.

Schritt 2: Anzeigengestaltung bereitstellen

Verwende asset_feed_spec, um deine Anzeigengestaltung bereitzustellen. Du kannst mehrere Anzeigengestaltungen für jeden Asset-Typ angeben, einschließlich Bilder, Videos, Carousels, Headlines und Überschriften und Haupttext. Stelle nur eine Link-Beschreibung bereit, da sie nicht pro Platzierung angepasst werden kann.

So wendest du die Personalisierung an:

Lege asset_customization_rules in deiner asset_feed_spec fest.
Füge für jede Regel customization_spec und Asset-Label hinzu.

Für die Placement Asset Customization muss jede asset_feed_spec über mehrere Customization-Regeln verfügen.

Siehe Asset Customization Rules.

Unterstützte Eigenschaften

Eigenschaftsname Beschreibung

Eigenschaftsname	Beschreibung
`customization_spec` Typ: Unterstützte Felder	Erforderlich. Platzierungen, an denen die Assets angezeigt werden sollen.
`image_label` Format: `{"name": "{LABEL_NAME}"}`	Erforderlich für `SINGLE_IMAGE`-Format. Label für das Bild, das du anzeigen möchtest. Es wird an die Bild-Assets in `asset_feed_spec` angehängt.
`video_label` Format: `{"name": "{LABEL_NAME}"}`	Für das `SINGLE_VIDEO`-Format erforderlich. Label für das Video, das du anzeigen möchtest. Es wird an die Video-Assets in `asset_feed_spec` angehängt.
`carousel_label` -Format: `{"name": "{LABEL_NAME}"}`	Erforderlich für `CAROUSELS`-Format. Label des Carousels, das du anzeigen möchtest. Es wird an die Carousel-Assets in `asset_feed_spec` angehängt. Hinweis: Wenn Carousels über Asset Customization für Platzierungen bereitgestellt werden, müssen alle untergeordneten Anhänge mit der Asset-Feed-Spezifikation definiert und über „adlabels“ referenziert werden. Untergeordnete Anhänge können nicht inline definiert werden. Unter Optionen für Asset-Feed-Spezifikationen findest du weitere Details zum `carousels`-Format.

customization_spec

Typ: Unterstützte Felder

Erforderlich.

Platzierungen, an denen die Assets angezeigt werden sollen.

image_label

Format: {"name": "{LABEL_NAME}"}

Erforderlich für SINGLE_IMAGE-Format.

Label für das Bild, das du anzeigen möchtest. Es wird an die Bild-Assets in asset_feed_spec angehängt.

video_label

Format: {"name": "{LABEL_NAME}"}

Für das SINGLE_VIDEO-Format erforderlich.

Label für das Video, das du anzeigen möchtest. Es wird an die Video-Assets in asset_feed_spec angehängt.

carousel_label
-Format: {"name": "{LABEL_NAME}"}

Erforderlich für CAROUSELS-Format.

Label des Carousels, das du anzeigen möchtest. Es wird an die Carousel-Assets in asset_feed_spec angehängt.

Hinweis: Wenn Carousels über Asset Customization für Platzierungen bereitgestellt werden, müssen alle untergeordneten Anhänge mit der Asset-Feed-Spezifikation definiert und über „adlabels“ referenziert werden. Untergeordnete Anhänge können nicht inline definiert werden. Unter Optionen für Asset-Feed-Spezifikationen findest du weitere Details zum carousels-Format.

Unterstützte Felder in `customization_spec`

Eigenschaftsname	Beschreibung
`publisher_platforms`	Erforderlich. Mögliche Platzierungen für deine Werbeanzeige. Optionen sind: `facebook`, `instagram`, `messenger` und `audience_network`.
`facebook_positions`	Optional, aber erforderlich, wenn Facebook in `publisher_platforms` ausgewählt wurde. Facebook-spezifische Platzierung. Optionen sind: `feed`, `right_hand_column`, `marketplace`, `video_feeds`, `search` und `story`.
`instagram_positions`	Optional, aber erforderlich, wenn Instagram in `publisher_platforms` ausgewählt wurde. Instagram-spezifische Platzierungen. Optionen sind: `stream`, `story`, `explore`, `explore_home`, `profile_feed` und `ig_search`. Hinweis: Die `explore_home` Platzierung unterstützt nur das `SINGLE_IMAGE`-Format.
`messenger_positions`	Optional, aber erforderlich, wenn Messenger in `publisher_platforms` ausgewählt wurde. Messenger-spezifische Platzierungen. Optionen sind: `messenger_home`, `sponsored_messages` und `story`.
`audience_network_positions`	Optional, aber erforderlich, wenn Audience Network in `publisher_platforms` ausgewählt wurde. Audience Network-spezifische Platzierung. Optionen sind: `classic`, `instream_video` und `rewarded_video`.

Erfahre mehr über unsere verfügbaren Platzierungsoptionen.

Beispiel – Feed-Setup

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

Beispiel — Instagram Explore-Home Asset Customization

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

Beispiel - Instagram-Suchergebnisse Asset-Customization

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

Hier findest du alle verfügbaren Optionen für die Asset-Feed-Spezifikation.

Schritt 5: Lies den Inhalt der Werbeanzeige

Für Platzierungs-Asset Customization-Werbung sollten Felder der Anzeigengestaltung für Instagram über {ad-account-id}/ads abgefragt werden. Zum Beispiel: