Collaborative Ads

Collaborative Ads werden zusätzlich zu Advantage+ Catalog Ads angeboten. Sie ermöglichen Werbetreibenden einer Marke die sichere Zusammenarbeit mit einem Händler oder einem Marketingpartner und das Erreichen der Werbeziele, wie z. B. ein Zielprodukt für den Verkauf durch vom Händler bereitgestellte Inhalte.

Der Händler oder Marketingpartner sollte ein Katalogsegment mit all seinen Produkten mit dem Werbetreibenden der Marke teilen. Dieses Segment ist ein Teil seines Katalogs oder ein Superset an Produktpaletten. Der Werbetreibende der Marke kann dann dieses Katalogsegment akzeptieren und mit diesem Katalogsegment Advantage+ Catalog Ads schalten. Werbetreibende einer Marke können das Katalogsegment nicht bearbeiten, aber sie können daraus eigene Produktpaletten erstellen.

Ein Werbetreibender führt im Wesentlichen eine Advantage+ Catalog Ads-Kampagne für Katalogverkäufe mit einem Produktkatalog durch. Daher kann er Standardberichte für Facebook-Werbeanzeigen verwenden, die jetzt Kennzahlen zum Katalogsegment enthalten.

Zusätzlich kannst du Berichte auf Produkt- und auf Händlerebene verwenden, um dem Werbetreibenden der Marke ausschließlich die Käufe der Marke anzuzeigen.

Wichtige Schritte

Für Händler und Marketingpartner:

  • Schritt 1: Onboarding für Collaborative Ads
  • Schritt 2: Katalogsegment erstellen – Das Segment muss Produkte enthalten, die einem seiner potenziellen Markenpartner gehören.
  • Schritt 3: Katalogsegment mit Werbepartner teilen
  • (Nur für Marketingpartner) Schritt 4: Discovery-Tools für Marken bereitstellen

Für Marken:

  • Schritt 1: Katalogsegment akzeptieren
  • Schritt 2: Werbekampagne mit Katalogsegment erstellen
  • Schritt 3: Berichte ansehen – Sieh dir die Berichte zu den Produkten im Katalogsegment an.
  • Optionaler Schritt 4: Debugging – Verwende Tools zur Diagnose und Behebung von Problemen (siehe Advantage+ Catalog Ads, Debugging-Tools).

Schritte für Händler und Marketingpartner

Schritt 1: Onboarding für Collaborative Ads

Um diesen Schritt durchzuführen, benötigt deine App business_management- und catalog_management-Berechtigungen.

Derzeit wird dies nicht über die API unterstützt und muss über die UI durchgeführt werden. Um diesen Prozess zu starten, klicke im Collaborative Ads-Händlerverzeichnis auf „Werde ein Handelspartner“.

Schritt 2: Katalogsegment erstellen

Um diesen Schritt durchzuführen, benötigt deine App business_management- und catalog_management-Berechtigungen.

Erstelle ein Katalogsegment aus einem deiner bestehenden Kataloge. Das Segment muss alle Produkte enthalten, die du mit deinem Markenpartner teilen möchtest.

Um ein Katalogsegment über die API zu erstellen, sende eine POST-Anfrage an die owned_product_catalogs-Edge. Die folgenden Felder sind für die Erstellung von Katalogsegmenten erforderlich:

  • parent_catalog_id: Der übergeordnete Katalog, aus dem dein Segment erstellt wurde. Dieser Katalog muss mit Collaborative Ads konform sein. Den Status deines Katalogs findest du im Commerce Manager.
  • catalog_segment_filter: Eine JSON-kodierte Regel, die zum Erstellen des Katalogsegments verwendet wird.

Schritt 3: Katalogsegment teilen

Um diesen Schritt durchzuführen, benötigt deine App business_management- und catalog_management-Berechtigungen.

Teile dein Katalogsegment mit deinem Markenpartner. Um dies über die API zu tun, sende eine POST-Anfrage an /{catalog_segment_id}/agencies. In deinem Aufruf kannst du die folgenden Felder hinzufügen:

FeldBeschreibung

business

Typ: Numerischer String oder Integer

Erforderlich.

ID für das Unternehmen, mit dem der Katalog geteilt wird.

permitted_tasks

Typ: Array < enum {MANAGE, ADVERTISE} >

Erforderlich.

Aufgaben, die das Unternehmen ausführen darf. Verfügbare Optionen sind: ['ADVERTISE', 'MANAGE'].

utm_settings

Typ: JSON-Objekt {enum{campaign_source,campaign_medium,campaign_name}: string}

Optional.

Du kannst campaign_source, campaign_medium und campaign_name angeben.


Zum Beispiel: {campaign_source: “fb_campaign_source”}.

(Nur für Marketingpartner) Schritt 4: Discovery-Tools für Marken bereitstellen

Um diesen Schritt durchzuführen, benötigt deine App die business_management-Berechtigung. Der API-Aufruf muss einen Nutzer-Zugriffsschlüssel enthalten und dieser Nutzer muss über die Berechtigung für den vorgeschlagenen Partner, das Unternehmen oder die Zusammenarbeitsanfrage verfügen.

Als Marketingpartner solltest du Marken eine Möglichkeit bieten, mögliche Collaborative Ads-Partner zu entdecken. Du kannst folgende Endpunkte verwenden, um Händler zu finden, mit denen du arbeiten kannst:

Wenn eine Marke einen Partner findet, könnt ihr euch mit einer Kooperationsanfrage an den Händler wenden. Sende hierfür eine POST-Anfrage an /{cpas-collaboration-request-id}:

{business-id}/collaborative_ads_collaboration_requests?
brands=”[“[BRAND NAME]”, “[BRAND NAME 2]”]”&
contact_email=[CONTACT_EMAIL]&
contact_first_name=[CONTACT_FIRST_NAME]&
contact_last_name=[CONTACT_LAST_NAME]&
phone_number=[PHONE NUMBER]&
receiver_business=[RECEIVING BUSINESS ID]
requester_agency_or_brand=[REQUESTING ENTITY - AGENCY, BRAND or MERCHANT]

Behalte mit den folgenden Endpunkten den Überblick über deine Anfragen:

Schritte für Marken

Schritt 1: Katalogsegment akzeptieren

Wenn deine Marke die Nutzungsbedingungen für das neue geteilte Unternehmen nicht akzeptiert hat, musst du dies tun.

Nach Erhalt des geteilten Assets muss der*die Admin-Nutzer*in des Unternehmens die folgenden Schritte durchführen:

  1. Rufe das Collaboration Center auf.
  2. Wähle das Unternehmen aus, für das du die Nutzungsbedingungen akzeptierst.
  3. Wähle Partner aus dem linken Navigationsbereich aus.
  4. Klicke auf den Button Assets akzeptieren, um den Akzeptanz-Workflow zu starten.

Nachdem deine Marke die Bedingungen akzeptiert hat, kann sie Personen mit dem Endpunkt /{product-catalog-id}/assigned_users zum Katalogsegment hinzufügen. Hinweis: Dies erfordert die Berechtigung business_management.

Schritt 2: Werbekampagne erstellen

Um diesen Schritt abzuschließen, benötigt deine App die business_management- und ads_management-Berechtigungen.

Deine Marke kann das akzeptierte Katalogsegment verwenden, um Werbekampagnen zu erstellen. Du solltest für jeden Händler, für den du Collaborative Ads schalten möchtest, ein eigenes Werbekonto verwenden. Sobald das dedizierte Werbekonto mit einem Händler verbunden ist, kann es nur noch Katalogsegmente auswählen, die zu diesem bestimmten Händler gehören.

Um Werbeanzeigen zu erstellen und zu schalten, gehst du so vor, wie du es normalerweise für deinen eigenen Produktkatalog tun würdest. Du solltest jedoch die catalog_segment_ID anstatt einer Katalog-ID angeben:

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<CATALOG_SEGMENT_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

Wenn der Vorgang erfolgreich ist, erhältst du eine neue Werbekampagnen-ID:

{
"id": "<CAMPAIGN_ID>"
}

Es gibt vier Felder, die du normalerweise mit Advantage+ Catalog Ads einstellen kannst, was wiederum mit einem Katalogsegment nicht möglich ist:

  • multi_share_end_card ist standardmäßig auf false festgelegt. Dies lässt sich nicht ändern.
  • Du kannst description nicht in template_data ändern.
  • template_url_spec, die du für Deeplink-URLs verwenden kannst, muss zur Website des Händlers führen.

Schritt 3: Berichte ansehen

Sobald die Werbeanzeigen geschaltet sind, können Markenwerbetreibende Kennzahlen zur Performance von Werbeanzeigen erhalten. Wir verfügen über mehrere neue Insights-Kennzahlen auf verschiedenen Anzeigenobjekt-Ebenen. Siehe catalog_segment_value und verwandte Kennzahlen für:

catalog_segment_value enthält eine Aufschlüsselung der Conversion-Events, einschließlich Käufe, Produkte im Einkaufswagen und Produkte für das Katalogsegment auf jeder Anzeigenobjektebene. Es führt Events über Websites, Mobilgeräte und Omni-Channel-Quellen zusammen. Erfahre mehr über Geschätzte Kennzahlen und Insight-Kennzahlen in der Entwicklung.

Schritt 4: Probleme debuggen und diagnostizieren

Marken sollten Probleme debuggen und beheben, die bei geschalteten Advantage+ Catalog Ads für das Katalogsegment auftreten.

Siehe Debugging-Tools für Advantage+ Catalog Ads.

Insights

Die folgenden geschätzten Kennzahlen beziehen sich auf Collaborative Ads – siehe Geschätzte, in Entwicklung befindliche und Drittanbieter-Kennzahlen.

So fragst du unsere Berichtskennzahlen ab:

  • Deine App benötigt die ads_management- und business_management-Berechtigungen. Siehe App-Review.
  • Du benötigst einen Nutzer-Zugriffsschlüssel und dieser Nutzer muss Berichte für das betreffende Werbekonto anzeigen dürfen.

Abfragen können zu folgenden Objekten gestellt werden: Werbekonto, Werbekampagne, Anzeigengruppe und Anzeige.

Die action_converted_product_id-Aufschlüsselung wird auf Werbekontoebene nicht unterstützt.

MetricDescription

catalog_segment_value

Value from conversion events, including a breakdown of purchases, add-to-carts and view products for the catalog segment at each ad object level.

catalog_segment_value_omni_purchase_roas

Total return on ad spend (ROAS) from purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailer' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_website_purchase_roas

Total return on ad spend (ROAS) from website purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_value_mobile_purchase_roas

The total return on ad spend (ROAS) from mobile app purchases of items shared between Brand and Retailer. This number is based on information received from one or more Retailers' connected Facebook Business Tools. The amount is attributed to your ads.

catalog_segment_actions

Similar to catalog_segment_value, when using this metric a breakdown of actions is given for the catalog segment at each ad object level.

converted_product_value

Value of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

converted_product_quantity

Quantity of conversions driven by your ads for a given product ID. This number is recorded by your Retailer partner's Pixel or App SDK.


The API only returns Product IDs —see /{product-item-id} for information. If you want to get brand names as well, please use Ads Manager.

Aufschlüsselungen

Aufschlüsselungen werden verwendet, um deine Insights-Ergebnisse in verschiedene Sets zu gruppieren – siehe Aufschlüsselungen. Du kannst folgende Aufschlüsselungen mit Collaborative Ads-Kennzahlen verwenden:

  • Datum: Erhalte Insights für einen bestimmten Zeitraum. Um diese Aufschlüsselung zu verwenden, füge time_range zu deiner Abfrage hinzu. Zum Beispiel: &time_range[since]=2020-03-01&time_range[until]=2020-04-01.

  • Produktebene: Erhalte Insights für ein bestimmtes Produkt. Verwende diese Aufschlüsselung für converted_product_value und converted_product_quantity metrics, indem du &action_breakdowns=action_converted_product_id zu deiner Abfrage hinzufügst.

Aufschlüsselungen kombinieren

Verwende die folgenden Aufschlüsselungskombinationen für Collaborative Ads:

Die action_converted_product_id-Aufschlüsselung wird auf Werbekontoebene nicht unterstützt.

  • action_converted_product_id
  • action_type, action_converted_product_id