Developers » AS2 tagging » Android » Campagnes » Campagnes marketing 2.3.0
Campagnes marketing
Avant-propos
Le SDK AT Internet vous permet de marquer vos différents types de campagnes (publicité, affiliation, liens sponsorisés, email marketing)
Pour bien débuter
Une fois votre marqueur initialisé, vous pouvez ajouter les informations de campagne à votre hit décran.
Dans le cas où vous souhaitez utiliser des variables, veillez à importer les classes ATInternet, Tracker, Screen et Campaign dans votre Activity.
Referrer
Le SDK AT Internet permet la récupération du referrer de l’application Android afin de mesurer la campagne à l’origine de l’installation de l’application.
Pour cela, vous devez respecter certaines implémentations pour que la campagne soit prise en compte.
Dans le lien qui redirige vers le PlayStore, la variable « &referrer= » doit contenir « &xtor= »
Attention, la variable referrer contenue dans le lien de redirection vers le Play Store doit être encodée afin de récupérer la source !
Exemple de lien : « https://play.google.com/store/apps/details?id=com.atinternet.android&hl=fr&referrer=test%26xtor%3dAD-123 »
Puis, dans votre application, il faut définir la classe ReferrerReceiver du SDK comme étant le récupérateur du referrer :
<application android:name="com.atinternet.tracker.ATInternet" android:allowBackup="true" android:icon="@drawable/at_logo" android:label="@string/app_name" android:theme="@style/AppTheme"> <!--Add this block--> <receiver android:name="com.atinternet.tracker.ReferrerReceiver" android:exported="true"> <intent-filter> <action android:name="com.android.vending.INSTALL_REFERRER" /> </intent-filter> </receiver>
Si toutefois vous implémentez votre propre BroadcastReceiver pour la récupération du referrer, vous devez le faire hériter de celui présent dans le SDK :
package com.atinternet.atinternetdemo; import android.content.Context; import android.content.Intent; import com.atinternet.tracker.ReferrerReceiver; public class DemoReceiver extends ReferrerReceiver { @Override public void onReceive(Context context, Intent intent) { super.onReceive(context, intent); } }
Marquage
L’objet Screen met à disposition une méthode Campaign. Cette méthode prend un paramètre :
- campaignId de type string qui est l’identifiant de la campagne
Cette méthode renvoie un objet de type Campaign.
Le SDK vous permet de gérer deux modes de rémanence de campagne. Vous pouvez choisir de sauvegarder la première campagne ou la dernière campagne détectée durant une durée définie via la configuration (par défaut, la première campagne sera sauvegardée). Cette information se retrouvera dans la variable xtor de votre hit. Pour modifier le mode de rémanence, procédez comme suit :
- La première campagne détectée sera sauvegardée pendant la durée définie dans la configuration (par défaut, 30 jours)
package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import android.util.Log; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.SetConfigCallback; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); tracker.setConfig("campaignLastPersistence", false, new SetConfigCallback() { @Override public void setConfigEnd() { Log.d(null, "Campaign configuration is now set"); } }); } }
- La dernière campagne détectée sera sauvegardée pendant la durée définie dans la configuration (par défaut, 30 jours)
package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import android.util.Log; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.SetConfigCallback; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); tracker.setConfig("campaignLastPersistence", true, new SetConfigCallback() { @Override public void setConfigEnd() { Log.d(null, "Campaign configuration is now set"); } }); } }
Exemples de marquage
Une interface est accessible via notre marketplace si vous désirez simplifier le marquage de vos liens sans avoir besoin de connaître la signification de chaque champ. Veuillez noter que l’interface a été créé par notre communauté et peut être améliorée, n’hésitez pas à nous envoyer tous vos retours !
- Marquage d’une campagne publicitaire
Le format de l’identifiant de campagne dans le cadre d’une publicité doit respecter les règles suivantes :
Obligatoire
– A (source) : préfixe AD
– B : valeur de l’identifiant de campagne (donné par AT Internet)Facultatif :
– C : création (selon le format [libellé] ou id[libellé]).
– D : variante (selon le format [libellé] ou id[libellé]).
– E : format (selon des identifiants donnés par AT Internet et mis entre []. Vous pouvez également spécifier tout autre format de votre choix en utilisant la nomenclature suivante : « [name] ». Exemple : vous pouvez saisir soit un libellé : [button], soit une taille : [120×40]).
– F : site (en précisant lURL selon le format [url]).
– G : emplacement général sur lensemble du site (selon des identifiants donnés par AT Internet et mis entre []).
– H : détail de lemplacement sur la page web.package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); } @Override protected void onResume() { super.onResume(); Screen s = tracker.Screens().add("Ad"); s.Campaign("AD-3030-[ad_Version_7]-[without_text]-[468]-[www.site.com]-[GT]-[top_page]"); s.sendView(); } }
- Marquage d’une campagne d’affiliation
Le format de l’identifiant de campagne dans le cadre d’une affiliation doit respecter les règles suivantes :
Obligatoire
– A (source) : préfixe AL
– B : valeur de l’identifiant de campagne (selon le format [libellé] ou id[libellé])Facultatif :
– C : type affilié (selon le format [libellé] ou id[libellé]).
– D : identifiant affilié (selon format numérique ou id[libelle]).
– E : format de la publicité daffiliation (selon des identifiants prédéfinis. Vous pouvez également spécifier tout autre format de votre choix en utilisant la nomenclature suivante : « [name] ». Exemple : vous pouvez saisir soit un libellé : [button], soit une taille : [120×40]).
– F : identifiant création (selon le format [libellé] ou id[libellé])
– G : variante (selon le format [libellé] ou id[libellé])
– C1* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).
– C2* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).
– C3* : variable personnalisée à déclarer dans l’interface (selon le format id[libelle]).* non disponible dans l’Analytics Suite, pour tout besoin d’information nous vous invitons à contacter notre support
package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); } @Override protected void onResume() { super.onResume(); Screen s = tracker.Screens().add("Affiliation"); s.Campaign("AL-3030-1[comparison_shopper]-34253-[468]-4[cars_advertisement]-6[blue_version]|233[customer_name]-3425[id_contract]"); s.sendView(); } }
- Marquage d’une campagne de liens sponsorisés
Le format de l’identifiant de campagne dans le cadre de liens sponsorisés doit respecter les règles suivantes :
Obligatoire :
– A (source) : préfixe SEC
– B : valeur de l’identifiant de campagne (donné par AT Internet)Facultatif :
– C : identifiant de la plateforme (uniquement si votre campagne est distincte selon chaque plateforme)
– D : groupe dannonces (selon le format [libellé] ou id[libellé]). Cette variable est obligatoire dans le cadre de limport de données issues de Google Adwords.
– E : variante de lannonce (selon le format [libellé] ou id[libellé]). En saisissant exactement [{creative}] sur Google, Google placera un ID de variante unique qui permettra dêtre relié aux résultats lors des imports de data depuis Google.
– F : « S » ou « C » selon que la provenance vient du résultat de recherche (« S » pour Search) ou des publicités sur les réseaux de contenus (« C » pour « Content »).
– G : mot clé précis acheté. En saisissant exactement [{keyword}] pour une campagne sur Google, Google place automatiquement le mot clé précis acheté (qui peut légèrement différer du mot clé saisi). Le principe est similaire pour Yahoo ([{YSMKEY}]).package com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); } @Override protected void onResume() { super.onResume(); Screen s = tracker.Screens().add("Sponsored Link"); s.Campaign("SEC-300-GOO-[group_1]-[Var_1]-{ifContent:C}{ifSearch:S}-[{keyword}]&xts=1111111"); s.sendView(); }
- Marquage d’une campagne d’email marketing
Le format de l’identifiant de campagne dans le cadre d’un emailing doit respecter les règles suivantes :
Obligatoire :
– A (source) : préfixe EREC, EPR ou ES
– B : valeur de l’identifiant de campagne
– C : identifiant de lemailing au format [libellé] ou id[libellé] (sans ce libellé, il ne sera pas possible d’obtenir l’analyse overlay de l’emailing) »Facultatif :
– D : Date du mail en format court : AAAAMMJJ
– E : id du lien au format « [libellé] » (renseigné par vos soins en fonction du lien). A ne renseigner que si vous souhaitez le détail précis du clic de linternaute (et notamment les analyses doverlay sur lemailing).
La précision du clic reste à lappréciation du client : chaque lien ou uniquement les principales zones.
– F : liste de contacts avec identifiant du contact selon id@liste (par exemple 1435@1 pour le contact 1435 de la liste 1).
– G : Date et heure précise en format long : AAAMMJJHHMMSSpackage com.atinternet.atinternetdemo; import android.app.Activity; import android.os.Bundle; import com.atinternet.tracker.ATInternet; import com.atinternet.tracker.Tracker; public class MainActivity extends Activity { private Tracker tracker; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); tracker = ATInternet.getInstance().getDefaultTracker(); } @Override protected void onResume() { super.onResume(); Screen s = tracker.Screens().add("eMailing"); s.Campaign("EPR-300-[Presentation_service]-20070304-[link2]-1435@1-20070304130405"); s.sendView(); } }
Classe Campaign
Propriétés
Nom | Type | Valeur par défaut | Description |
---|---|---|---|
campaignId | String | Chaîne vide | Obtient ou définit l’identifiant de la campagne |
Forcer la source marketing d’une visite
Ce marqueur n’est disponible que pour l’analyse sur l’Analytics Suite Delta.
La source forcée est prise en compte à partir du lendemain. Les fonctionnalités en temps réel (exports granulaires Data Query, ou Data Flow) se basent toujours sur la détection classique des sources.
Il est possible de forcer la source marketing d’une visite même si une différente a déjà été renseignée sur des events précédents.
Pour cela, vous devez renseigner la propriété src_force
(boolean) à true
:
tracker.setProp("b:src_force", "true", false);
Dernière mise à jour : 04/04/2022Si plusieurs sources sont forcées au cours d’une visite, la dernière renseignée sera celle qui sera conservée.