Premium-Optionen für Partner

Premium-Optionen sorgen für stärkere Partnerschaften zwischen Einzelhändlern und Marken, die unsere Lösung für Collaborative Ads mit einzigartigen Targeting- und Insight-Gewinnungsfunktionen verwenden. Über Premium-Optionen können Einzelhändler Markenpartnern Add-ons für Collaborative Ads anbieten.

Verfügbare Konfigurationen

Kategorie-Targeting

Durch erweitertes Zielgruppen-Retargeting können Marken und Werbetreibende ihre Werbeanzeigen auf kategoriebasierte Zielgruppen ausrichten. Diese bestehen aus Personen, die Produkte einer bestimmten Kategorie angesehen bzw. in den Einkaufswagen gelegt haben, zu der auch die Marke zählt.

Warenkorb-Insights

Warenkorb-Insights bieten Informationen zu den Kategorien anderer Käufe, die zusammen mit dem Produkt aus der Werbeanzeige der Marke oder des Werbetreibenden getätigt wurden.

Retailer Custom Audiences

Retailer Custom Audiences ermöglichen es Einzelhändlern, Zielgruppen mit integriertem Domain-Schutz mit ihren Marken- und Werbepartnern zu teilen. Der Domain-Schutz sorgt dafür, dass diese Zielgruppen nur von Markenpartnern verwendet werden können und dass der Traffic der Kampagnen ausschließlich zur Website der Einzelhändler geleitet wird.

Premium-Optionen abrufen

Verwende einen GET-API-Aufruf, um die Einstellungen der Premium-Optionen eines Katalogsegments abzurufen. Du kannst entweder die catalog_segment_id und die partner_business_id oder auch nur die vendor_id angeben. Wenn du beides angibst, stelle sicher, dass die catalog_segment_id dem angegebenen Anbieter gehört.

Anfrage

So rufst du die Einstellungen mit der catalog_segment_id und partner_business_id ab:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .catalog_segment_id(CATALOG_SEGMENT_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  .vendor_id(VENDOR_ID) \
  &access_token=ACCESS_TOKEN"

So rufst du die Einstellungen nur mit der vendor_id ab:

curl -i -X GET \
  "https://graph.facebook.com/v21.0/BUSINESS_ID?fields= \
  collaborative_ads_partner_premium_options \
  .vendor_id(VENDOR_ID) \
  .partner_business_id(PARTNER_BUSINESS_ID) \
  &access_token=ACCESS_TOKEN"

Parameter

Name	Beschreibung
`business_id` Numerischer String oder Ganzzahl	Erforderlich. ID für das Unternehmen des Katalogs oder Anbieters.
`catalog_segment_id` Numerischer String oder Ganzzahl	Optional. ID des zu aktualisierenden Katalogsegments. Dieses Feld oder das Feld `vendor_id` muss angegeben werden.
`vendor_id` String	Optional. ID des zu aktualisierenden Anbieters. Dieses Feld oder das Feld `catalog_segment_id` muss angegeben werden.
`partner_business_id` Numerischer String oder Ganzzahl	Erforderlich. ID des abzurufenden Unternehmens des Partners.

Antwort

Wenn der Vorgang erfolgreich ist, siehst du die aktuellen Einstellungen für die Premium-Optionen:

{
  "collaborative_ads_partner_premium_options": {
    "enable_extended_audience_retargeting": bool,
    "enable_basket_insight": bool,
    "retailer_custom_audience_config": {
      "audience_id": [
        AUDIENCE_ID_1,
        AUDIENCE_ID_2,
        AUDIENCE_ID_3
      ]
    }
  }
}

Premium-Optionen aktualisieren

Sende einen POST-API-Aufruf an den /{business_id}/partner_premium_options-Endpunkt, um die Informationen der Premium-Optionen zu aktualisieren.

Anfrage

So aktualisierst du die Einstellungen mit der catalog_segment_id und partner_business_id:

curl -i -X POST \
  "https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?catalog_segment_id=CATALOG_SEGMENT_ID \
  &partner_business_id=PARTNER_BUSINESS_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

So aktualisierst du die Einstellungen nur mit der vendor_id:

curl -i -X POST \
"https://graph.facebook.com/v21.0/BUSINESS_ID/partner_premium_options \
  ?vendor_id=VENDOR_ID \
  &enable_extended_audience_retargeting=BOOL \
  &enable_basket_insight=BOOL \
  &retailer_custom_audience_config=JSON_OBJECT \
  &access_token=ACCESS_TOKEN"

Parameter

Name	Beschreibung
`business_id` Numerischer String oder Ganzzahl	Erforderlich. ID für das Unternehmen des Katalogs oder Anbieters.
`catalog_segment_id` Numerischer String oder Ganzzahl	Optional. ID des zu aktualisierenden Katalogsegments. Dieses Feld oder das Feld `vendor_id` muss angegeben werden.
`vendor_id` String	Optional. ID des zu aktualisierenden Anbieters. Dieses Feld oder das Feld `catalog_segment_id` muss angegeben werden.
`partner_business_id` Numerischer String oder Ganzzahl	Erforderlich. ID des abzurufenden Unternehmens des Partners.
`enable_extended_audience_retargeting` Boolescher Wert	Erforderlich. Aktiviere oder deaktiviere das erweiterte Zielgruppen-Retargeting.
`enable_basket_insight` Boolescher Wert	Erforderlich. Aktiviere oder deaktiviere Warenkorb-Insights.
`retailer_custom_audience_config` JSON-Objekt {`audience_id`: array of strings}	Erforderlich. Enthält die Liste der `audience_ids`, mit denen dieses Katalogsegment geteilt werden soll. Um das Teilen zu deaktivieren, gibt ein leeres Array ein. Beispiel:`{'audience_id':[AUDIENCE_IDs]}`

Antwort

{
  "status": "success"
}

Zielgruppen-IDs aus dem Collaboration Center abrufen

Du kannst die Zielgruppen-ID aus dem Zielgruppen-Tool im Collaboration Center abrufen. Wenn die Spalte Zielgruppen-ID nicht sichtbar ist, klicke oben rechts auf der Seite auf das Dropdown-Menü Spalten und aktiviere das Kontrollkästchen Zielgruppen-ID.

Mehr dazu

Collaborative Ads