Advantage+ Catalog Ads für mobile Apps

Du kannst Advantage+ Catalog Ads mit Facebook-SDKs in mobilen Apps einrichten. Füge Deep Links und aufgeschobene Deep Links in deine App ein und biete den Personen, die deine App nutzen, so das bestmögliche Nutzungserlebnis:

Schritt 1: Facebook Mobile SDK für iOS/Android einrichten

Integriere das Facebook-SDK für iOS oder Android.

Schritt 2: Mobile App-Events einrichten

Nutze im Web Meta-Pixel-Events wie ViewContent, um Event-Interaktionen zu verfolgen. Auf Mobilgeräten kannst du dieselben Events mit App-Events verfolgen.

Von deiner App aus musst du dieselben drei erforderlichen Events senden wie von deinem Pixel: ViewContent, AddToCart und Purchase. Advantage+ Catalog Ads benötigt diese Events für eine korrekte Funktionsweise.

iOS-Event	Android-Event	Web-Äquivalent
`FBSDKAppEventNameViewedContent`	`AppEventsConstants:: EVENT_NAME_VIEWED_CONTENT`	`ViewContent`
`FBSDKAppEventNameAddedToCart`	`AppEventsConstants:: EVENT_NAME_ADDED_TO_CART`	`AddToCart`
`[[FBSDKAppEvents shared] logPurchase:(double) currency:(NSString ) parameters:(NSDictionary )];`	`AppEventsConstants:: EVENT_NAME_PURCHASED`	`Purchase`

Beispielweise wird ein ViewContent-Event ausgelöst, wenn jemand ein Produkt über eine App anzeigt:

[[FBSDKAppEvents shared] logEvent:FBSDKAppEventNameViewedContent
  valueToSum:54.23
  parameters:@{
    FBSDKAppEventParameterNameCurrency    : @"USD",
    FBSDKAppEventParameterNameContentType : @"product",
    FBSDKAppEventParameterNameContentID   : @"123456789"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "1234");

logger.logEvent(AppEventsConstants.EVENT_NAME_VIEWED_CONTENT,
                120.00,
                parameters);

Du kannst auch ein JSON-Array mit Werten für die Produkt-ID bereitstellen, wenn ein Event für mehrere Produkte stattfindet. Du kannst z. B. mehrere Produkte mit dem Event Purchase senden.

[[FBSDKAppEvents shared] logPurchase:54.23 currency : @"USD" parameters:@{
  FBSDKAppEventParameterNameContentID   : @"['1234','5678']",
  FBSDKAppEventParameterNameContentType : @"product"
  }
];

Bundle parameters = new Bundle();
parameters.putString(AppEventsConstants.EVENT_PARAM_CURRENCY, "USD");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_TYPE, "product");
parameters.putString(AppEventsConstants.EVENT_PARAM_CONTENT_ID, "['1234', '5678']");

logger.logEvent(AppEventsConstants.EVENT_NAME_PURCHASED,
                180.00,
                parameters);

Mehrere Content-IDs

Wenn du über mehrere Content-IDs verfügst, stellst du ein JSON-Array mit Escape-Sequenz bereit, zum Beispiel:

"[\"1234\",\"5678\"]"

Optionale Parameter

Du kannst zusätzliche Parameter für jedes App-Event senden. Sende diese Parameter, wenn jemand einen Kauf tätigt:

Name	Beschreibung
`_valueToSum` String	Optional. Wert des Produkts oder Kaufbetrags
`fb_currency` String	Optional. Währung des Produkts oder Kaufbetrags

Verwendung eines Mobile Measurement Partner (MMP)

Wenn du einen zugelassenen Mobile Measurement Partner (MMP) verwendest, um Events an Facebook zu melden, kannst du deine Implementierung so anpassen, dass auch die erforderlichen Events gesendet werden. Dieser Vorgang variiert je nach MMP, sieht jedoch für gewöhnlich wie folgt aus:

Passe deine Integration so an, dass die drei erforderlichen Events an den MMP gemeldet werden, zusammen mit den erforderlichen Parametern.
Ordne deine Event-Namen mithilfe deines MMP den Event-Namen auf Facebook zu.
App-Events testen.

Erforderliche Events für MMP

Die folgenden Events sind erforderlich:

Name	Beschreibung
`fb_mobile_content_view`	Wenn ein Konto der Kontenübersicht ein Produkt angezeigt hat
`fb_mobile_add_to_cart`	Wenn ein Artikel zum Einkaufswagen hinzugefügt wurde
`fb_mobile_purchase`	Wenn (ein) Artikel gekauft wurde(n)

Du musst außerdem zwei zusätzliche Parameter senden, damit Advantage+ Catalog Ads funktionieren:

Die ID des angezeigten, zum Einkaufswagen hinzugefügten oder gekauften Artikels
Ob die ID ein product oder eine product_group ist

Die verfügbaren zusätzlichen Parameter sind die Folgenden:

Name	Beschreibung
`fb_content_type` String	Entweder `product` oder `product_group`
`fb_content_id` String	Erforderlich. Ein String mit einem JSON-kodierten Array der Produkt- oder Produktgruppen-IDs des Einzelhändlers
`_valueToSum` String	Optional. Wert des gekauften Produkts
`fb_currency` String	Optional. Währung des Produkts oder Kaufbetrags

Hinweis: Du solltest auch die Parameter _valueToSum und fb_currency senden, wenn jemand Artikel kauft.

Testen von App-Events

Ob deine Integration funktioniert, kannst du am einfachsten mit dem App Ads-Hilfstool testen. Damit kannst du die Events und Parameter in Echtzeit sehen, die an Facebook gemeldet werden.

Wähle eine App aus.
Am Ende der Seite werden dir zwei Tools angezeigt. Wähle App-Events testen aus.
Du hast zwei Möglichkeiten: Zeige Events an, die von dir gemeldet werden, oder Events mit einer speziellen Werbe-ID. In den meisten Fällen reicht es aus, wenn du Von mir auswählst. Stelle sicher, dass Facebook auf deinem Gerät installiert ist und dass du angemeldet bist.
Wenn du Handlungen mit deiner App ausführst, erscheinen in dem Tool Events und ihre Parameter.

Es werden dir diese drei Event-Namen angezeigt, wenn deine Integration erfolgreich war:

FB_MOBILE_CONTENT_VIEW
FB_MOBILE_ADD_TO_CART
FB_MOBILE_PURCHASE

Erfahre mehr über App-Events für iOS und Android.

Um deine App-Events-Funktion zu überprüfen, kannst du kürzliche Events im

Facebook Events Manager

prüfen

Schritt 3: Deep Linking einrichten

Über Deep Links in deinem Produkt-Feed gelangen Personen, die mit deiner Anzeige auf Facebook interagieren, direkt zu einem speziellen Bereich deiner App. Wenn jemand beispielsweise über ein Mobilgerät auf eine Anzeige auf Facebook klickt, sieht diese Person das Produkt in deiner mobilen App. Weitere Informationen findest du unter Deep Linking und Deep Links bestätigen.

Fallback zu Web im Vergleich zum App Store

Wenn du Deep Links verwendest, kannst du festlegen, wie das Fallback-Verhalten aussehen soll, wenn jemand deine App noch nicht installiert hat. Wenn du Deep Links in deinen Produkt-Feed einfügst, sehen Personen ohne deine App in der Anzeige die Web-URL für das Produkt.

Da dein Ziel wahrscheinlich darin besteht, den Katalogumsatz zu steigern, sollen Personen wohl eher die Produktseiten sehen statt deiner App. Deshalb zeigen wir standardmäßig die Web-URLs an. Du kannst für mehr Kontrolle aber auch ein anderes Verhalten festlegen. Lege das Fallback-Verhalten auf applink_treatment fest, wenn du deine Advantage+ Catalog Ads erstellst, und verwende eine dieser Optionen:

Name	Beschreibung
`web_only`	Leite Personen immer an die angegebene Web-URL weiter. Alle Deep Links in deinem Feed werden hierdurch überschrieben.
`deeplink_with_web_fallback`	Leite Personen an deine App weiter, wenn diese installiert ist und wir über deine entsprechenden Deep Links verfügen. Leite sie an die URL der Webseite weiter, wenn eine dieser Bedingungen nicht erfüllt ist.
`deeplink_with_appstore_fallback`	Leite Personen an die App weiter, wenn diese installiert ist und wir über die entsprechenden Deep Link-Informationen verfügen. Sende die Person an den App Store, damit sie die App installieren kann, wenn das noch nicht geschehen ist.

Schritt 4: Produkt-Feed einrichten

Nun musst du für deine Advantage+ Catalog Ads richtige Deep Links angeben. Weitere Informationen findest du unter Produktkatalog, Deep Linking.

Schritt 5: Tracking-Spezifikationen

Achte darauf, dass die Tracking-Spezifikationen aller Advantage+ Catalog Ads für die folgenden Events richtig eingestellt sind, damit du Conversion-Events von deiner Website und deinen mobilen Apps messen kannst:

Event	Tracking-Spezifikation
`offsite_conversion`	`{ 'action.type': 'offsite_conversion', 'fb_pixel': FB_PIXEL_ID }`
`app_custom_event`	`{'action.type':'app_custom_event','application':APP_ID}`
`mobile_app_install`	`{'action.type':'mobile_app_install','application':APP_ID}`

Facebook kann dadurch Events verfolgen, die von einer Advantage+ Catalog Ad ausgehen, unabhängig davon, ob jemand sie auf deiner Website oder deiner App anzeigt. So legst du diese Tracking-Spezifikationen fest:

use FacebookAds\Object\Ad;
use FacebookAds\Object\Fields\AdFields;

$ad = new Ad(<AD_ID>);

$ad->{'tracking_spec'} = array(
  array(
    'action.type' => array('app_custom_event'),
    'application' => array($app_id),
  ),
  array(
    'action.type' => array('offsite_conversion'),
    'offsite_pixel' => array(<PIXEL_ID>),
  ),
  array(
    'action.type' => array('mobile_app_install'),
    'application' => array($app_id),
  ),

);
$ad->update();

curl \
  -F 'tracking_spec=[ 
    {"action.type":["app_custom_event"],"application":["101"]}, 
    {"action.type":["offsite_conversion"],"offsite_pixel":["<PIXEL_ID>"]}, 
    {"action.type":["mobile_app_install"],"application":["101"]} 
  ]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v2.11/<AD_ID>